Copy-Item

参考

模块:: Microsoft.PowerShell.Management

将项从一个位置复制到另一个位置。

语法

Copy-Item
    [-Path] <String[]>
    [[-Destination] <String>]
    [-Container]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-FromSession <PSSession>]
    [-ToSession <PSSession>]
    [<CommonParameters>]

Copy-Item
    -LiteralPath <String[]>
    [[-Destination] <String>]
    [-Container]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-FromSession <PSSession>]
    [-ToSession <PSSession>]
    [<CommonParameters>]

说明

Copy-Item cmdlet 将项从一个位置复制到同一命名空间中的另一个位置。例如，它可以将文件复制到文件夹，但无法将文件复制到证书驱动器。

此 cmdlet 不会剪切或删除正在复制的项。 cmdlet 可以复制的特定项取决于公开该项的 PowerShell 提供程序。例如，它可以复制文件系统驱动器中的文件和目录以及注册表驱动器中的注册表项和条目。

此 cmdlet 可以复制和重命名同一命令中的项。若要重命名项，请在 Destination 参数的值中输入新名称。若要重命名项而不复制它，请使用 Rename-Item cmdlet。

示例

示例 1：将文件复制到指定目录

此示例将 mar1604.log.txt 文件复制到 C:\Presentation 目录。不会删除原始文件。

Copy-Item "C:\Wabash\Logfiles\mar1604.log.txt" -Destination "C:\Presentation"

此示例将 C:\Logfiles 目录的内容复制到现有 C:\Drawings 目录中。不会复制 Logfiles 目录。

如果 Logfiles 目录包含子目录中的文件，这些子目录将随文件树一起复制。默认情况下，容器参数设置为 True，这将保留目录结构。

Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings" -Recurse

注意

如果需要在副本中包含 Logfiles 目录，请从路径中删除 \*。例如：

Copy-Item -Path "C:\Logfiles" -Destination "C:\Drawings" -Recurse

此示例复制 C:\Logfiles 源目录的内容并创建新的目标目录。新的目标目录，\Logs 是在 C:\Drawings中创建的。

若要包含源目录的名称，请复制到现有目标目录，如 示例 2所示。或者，将新目标目录命名为与源目录相同的目录。

Copy-Item -Path "C:\Logfiles" -Destination "C:\Drawings\Logs" -Recurse

注意

如果路径包括 \*，则所有目录的文件内容（不含子目录树）都会复制到新的目标目录。例如：

Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings\Logs" -Recurse

示例 4：将文件复制到指定的目录并重命名该文件

此示例使用 Copy-Item cmdlet 将 Get-Widget.ps1 脚本从 \\Server01\Share 目录复制到 \\Server12\ScriptArchive 目录。作为复制操作的一部分，该命令将项名称从 Get-Widget.ps1 更改为 Get-Widget.ps1.txt，以便可以附加到电子邮件。

Copy-Item "\\Server01\Share\Get-Widget.ps1" -Destination "\\Server12\ScriptArchive\Get-Widget.ps1.txt"