Copy-Item

參考

模組:: Microsoft.PowerShell.Management

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

Syntax

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

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

注意

如果您需要在 Logfiles 複本中包含目錄，請從Path中移除 \* 。例如：

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"