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

Description

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

注意

如果路徑 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，將腳本從\\Server01\Share目錄\\Server12\ScriptArchive複製到Get-Widget.ps1目錄。在複製作業中，命令會將專案名稱從 Get-Widget.ps1 變更為 Get-Widget.ps1.txt，以便安全地附加至電子郵件訊息。

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