Move-Item

语法

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

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

说明

cmdlet 将 Move-Item 项（包括其属性、内容和子项）从一个位置移动到另一个位置。 但这些位置必须由同一提供程序支持。 例如，它可以将文件或子目录从一个目录移动到另一个目录，或将注册表子项从一个项移动到另一个项。 在你移动某个项时，该属性将被添加到新位置，并从其原来的位置删除。

示例

示例 1：将文件移到另一个目录并重命名

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

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

示例 2：将目录及其内容移到另一个目录

此命令将“C：\Temp”目录及其内容移动到“C：\Logs”目录。 “Temp”目录及其所有子目录和文件随后会显示在“日志”目录中。

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

示例 3：将指定扩展的所有文件从当前目录移到另一个目录

此命令将当前目录中的所有文本文件 (“*.txt”) 移动 (由点 (“表示。) ) 到“C：\Logs”目录。

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

示例 4：以递归方式将指定扩展的所有文件从当前目录移到另一个目录

此命令以递归方式将当前目录和所有子目录中的所有文本文件移动到“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。

注意：在 Windows PowerShell 2.0 中，使用 cmdlet 的 Get-ChildItemRecurse 参数时，Path 参数的值必须是容器。 使用 Include 参数指定 .txt 文件扩展名筛选器 (Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles)。

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

示例 5：将注册表项和值移到另一个键

此命令将“HKLM\Software”中的“MyCompany”注册表项和值移动到“MyNewCompany”项。 通配符 ('*') 指示应移动“MyCompany”键的内容，而不是密钥本身。 在此命令中，省略可选的 Path 和 Destination 参数名称。

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

示例 6：将目录及其内容移动到指定目录的子目录

此命令将“Logs[9'06]”目录 (及其内容) 移动到“Logs[2006]”目录。

使用 LiteralPath 参数而不是 Path，因为原始目录名称包含左括号和右括号字符 (“[”和“]”) 。 也可将路径括在单引号 (' ') 中，以便不会曲解倒引号 (`)。

Destination 参数不需要文本路径，因为 Destination 变量也必须用单引号引起来，因为它包含可以错误解释的括号。

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

参数

-Confirm

-Credential

-Destination

-Exclude

-Filter

-Force

-Include

-LiteralPath

-PassThru

-Path

-UseTransaction

-WhatIf

输入

String

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

输出

None or an object representing the moved item.

使用 PassThru 参数时，此 cmdlet 将生成表示移动项的对象。 否则，此 cmdlet 将不生成任何输出。

备注

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

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

此 cmdlet 用于处理由任何提供程序公开的数据。 若要列出会话中可用的提供程序，请键入 Get-PSProvider。 有关详细信息，请参阅 about_Providers。

相关链接

• Clear-Item
• Copy-Item
• Get-Item
• Invoke-Item
• New-Item
• Remove-Item
• Rename-Item
• Set-Item
• about_Providers