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
    [-Path] <string[]>
    [[-Destination] <string>]
    [-Container]
    [-Force]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Copy-Item
    [[-Destination] <string>]
    -LiteralPath <string[]>
    [-Container]
    [-Force]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [<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 目录的子目录中包含文件，则会复制这些子目录，并保留其文件树。默认情况下，Container 参数设置为 True，这将保留目录结构。

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

注意

如果该路径 C:\Drawings 不存在，则 cmdlet 会将文件夹树中的所有文件 Logfiles 复制到单个文件夹中 C:\Drawings，覆盖具有相同名称的任何文件。

此示例会复制 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"