Move-Item

Move-Item
    [-Path] <String[]>
    [[-Destination] <String>]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Move-Item
    [[-Destination] <String>]
    -LiteralPath <String[]>
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Move-Item cmdlet 将项（包括其属性、内容和子项）从一个位置移到另一个位置。 这些位置必须由同一提供程序支持。

例如，它可以将文件或子目录从一个目录移到另一个目录，或者将注册表子项从一个键移到另一个键。 移动项时，会将其添加到新位置并从其原始位置中删除。

此命令将 Test.txt 文件从 C: 驱动器移动到 E:\Temp 目录，并将其从 test.txt 重命名为 tst.txt。

Move-Item -Path C:\test.txt -Destination E:\Temp\tst.txt

此命令将 C:\Temp 目录及其内容移动到 C:\Logs 目录。 Temp 目录及其所有子目录和文件，然后显示在 Logs 目录中。

Move-Item -Path C:\Temp -Destination C:\Logs

此命令将当前目录中的所有文本文件（*.txt）移动到 . 目录（由点（C:\Logs）表示。

Move-Item -Path .\*.txt -Destination C:\Logs

此命令以递归方式将所有文本文件从当前目录和所有子目录移动到 C:\TextFiles 目录。

Get-ChildItem -Path ".\*.txt" -Recurse | Move-Item -Destination "C:\TextFiles"

该命令使用 Get-ChildItem cmdlet 获取当前目录中的所有子项（由点（.）及其具有 *.txt 文件扩展名的子目录。 它使用 Recurse 参数进行递归检索，Include 参数将检索限制为 *.txt 文件。

管道运算符（|）将此命令的结果发送到 Move-Item，这会将文本文件移动到 TextFiles 目录。

如果要移动到 C:\Textfiles 的文件具有相同的名称，Move-Item 会显示错误并继续，但它只移动一个每个名称的文件以 C:\Textfiles。 其他文件保留在原始目录中。

如果 Textfiles 目录（或目标路径的任何其他元素）不存在，命令将失败。 即使使用 Force 参数，也不会为你创建缺少的目录。 Move-Item 将第一项移动到名为 Textfiles 的文件，然后显示一个错误，说明该文件已存在。

此外，默认情况下，Get-ChildItem 不会移动隐藏的文件。 若要移动隐藏文件，请将 Force 参数与 Get-ChildItem一起使用。

此命令将 MyCompany 中 HKLM\Software 注册表项中的注册表项和值移动到 MyNewCompany 键。 通配符（*）指示应移动 MyCompany 键的内容，而不是键本身。 在此命令中，省略可选 路径 和 目标 参数名称。

Move-Item "HKLM:\software\mycompany\*" "HKLM:\software\mynewcompany"

此命令将 Logs[Sept`06] 目录（及其内容）移动到 Logs[2006] 目录中。

Move-Item -LiteralPath 'Logs[Sept`06]' -Destination 'Logs[2006]'

使用 LiteralPath 参数，而不是 Path，因为原始目录名称包括左括号和右括号字符（[ 和 ]）。 路径还用单引号（'）括起来，以便反引号符号（`）不会被误解。

Destination 参数也必须用单引号括起来，因为它包含可被误解的括号。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将包含路径的字符串传递给此 cmdlet。

默认情况下，此 cmdlet 不返回任何输出。

使用 PassThru 参数时，此 cmdlet 返回表示移动项的对象。

PowerShell 包含以下与 Move-Item相关的别名：

• 所有平台：

  • mi
  • move

• 窗户：

  • mv

• 此 cmdlet 将在同一提供程序支持的驱动器之间移动文件，但只会在同一驱动器中移动目录。

• 由于 Move-Item 命令移动项的属性、内容和子项，因此默认情况下，所有移动都是递归的。

• 此 cmdlet 的设计目的是与任何供应商公开的数据进行协作。 若要列出会话中可用的提供程序，请键入 Get-PSProvider。 有关详细信息，请参阅 about_Providers。