Copy-Item

模組:: Microsoft.PowerShell.Management Module

將項目從某個位置複製到另一個位置。

語法

Path (Default) - FileSystem provider

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

LiteralPath - FileSystem provider

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

Path (Default) - All providers

Copy-Item
    [-Path] <string[]>
    [[-Destination] <string>]
    [-Container]
    [-Force]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LiteralPath - All providers

Copy-Item
    [[-Destination] <string>]
    -LiteralPath <string[]>
    [-Container]
    [-Force]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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

備註

如果路徑 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，以便安全地附加至電子郵件訊息。

$copyParams = @{
    Path        = "\\Server01\Share\Get-Widget.ps1"
    Destination = "\\Server12\ScriptArchive\Get-Widget.ps1.txt"
}
Copy-Item @copyParams