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>]

说明

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

此 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如果目录包含子目录中的文件，则复制这些子目录时，其文件树保持不变。默认情况下， Container 参数设置为 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

注意

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

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"