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]
    [-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]
    [-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副本中包含目录，请从 Path 中删除该\*目录。例如：

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 将脚本从\\Server01\Share目录复制到Get-Widget.ps1\\Server12\ScriptArchive目录。作为复制操作的一部分，该命令会将项名称从 Get-Widget.ps1 其 Get-Widget.ps1.txt更改为，以便可以附加到电子邮件。

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