共用方式為


Copy-Item

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

語法

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"

範例 2:將目錄內容複製到現有的目錄

本範例會將目錄的內容 C:\Logfiles 複製到現有的 C:\Drawings 目錄中。 Logfiles不會複製目錄。

Logfiles如果目錄在子目錄中有檔案,則會以其檔案樹狀結構完整複製這些子目錄。 根據預設, Container 參數會設定為 True,以保留目錄結構。

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

注意

如果路徑 C:\Drawings 不存在,Cmdlet 會將資料夾中的所有檔案 Logfiles 複製到單一檔案 C:\Drawings

範例 3:將目錄和內容複製到新目錄

此範例會複製來源目錄的內容 C:\Logfiles ,並建立新的目的地目錄。 新的目的地目錄會在 \LogsC:\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"

範例 5:將檔案複製到遠端電腦

會話會使用 的認證Contoso\User01建立至名為 Server01 的遠端電腦,並將結果儲存在名為$Session的變數中。

Cmdlet 會Copy-Item使用儲存在 $Session 變數中的會話資訊,從D:\Folder001資料夾複製到test.logC:\Folder001_Copy遠端電腦上的資料夾。 不會刪除源檔。

$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "D:\Folder001\test.log" -Destination "C:\Folder001_Copy\" -ToSession $Session

範例 6:將資料夾複製到遠端電腦

會話會使用 的認證Contoso\User01建立至名為 Server01 的遠端電腦,並將結果儲存在名為$Session的變數中。

Cmdlet 會Copy-Item使用儲存在 $Session 變數中的會話資訊,將資料夾C:\Folder002_Copy複製到D:\Folder002遠端電腦上的目錄。 如果沒有使用 Recurse 參數,則不會複製任何子資料夾或檔案。 工作會在資料夾不存在時建立 Folder002_Copy 資料夾。

$Session = New-PSSession -ComputerName "Server02" -Credential "Contoso\User01"
Copy-Item "D:\Folder002\" -Destination "C:\Folder002_Copy\" -ToSession $Session

範例 7:以遞歸方式將資料夾的整個內容複製到遠端電腦

會話會使用 的認證Contoso\User01建立至名為 Server01 的遠端電腦,並將結果儲存在名為$Session的變數中。

Cmdlet 會Copy-Item使用儲存在 $Session 變數中的會話資訊,將資料夾C:\Folder003_Copy的整個內容複製到D:\Folder003遠端電腦上的目錄。 子資料夾會以其檔案樹狀結構完整複製。 工作會在資料夾不存在時建立 Folder003_Copy 資料夾。

$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
Copy-Item "D:\Folder003\" -Destination "C:\Folder003_Copy\" -ToSession $Session -Recurse

範例 8:將檔案複製到遠端電腦,然後重新命名檔案

會話會使用 的認證Contoso\User01建立至名為 Server01 的遠端電腦,並將結果儲存在名為$Session的變數中。

Cmdlet 會Copy-Item使用儲存在 $Session 變數中的會話資訊,從D:\Folder004資料夾複製到scriptingexample.ps1C:\Folder004_Copy遠端電腦上的資料夾。 不會刪除源檔。

$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
Copy-Item "D:\Folder004\scriptingexample.ps1" -Destination "C:\Folder004_Copy\scriptingexample_copy.ps1" -ToSession $Session

範例 9:將遠端檔案複製到本機電腦

會話會使用 的認證Contoso\User01建立至名為 Server01 的遠端電腦,並將結果儲存在名為$Session的變數中。

Cmdlet 會Copy-Item使用儲存在 變數中的$Session會話資訊,從遠端C:\MyRemoteData\複製到test.log本機D:\MyLocalData資料夾。 不會刪除源檔。

$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\test.log" -Destination "D:\MyLocalData\" -FromSession $Session

範例 10:將遠端資料夾的整個內容複製到本機電腦

會話會使用 的認證Contoso\User01建立至名為 Server01 的遠端電腦,並將結果儲存在名為$Session的變數中。

Cmdlet 會Copy-Item使用儲存在 變數中的$Session會話資訊,將遠端C:\MyRemoteData\scripts資料夾的整個內容複製到本機D:\MyLocalData資料夾。 如果 scripts 資料夾在子資料夾中有檔案,這些子資料夾會以其檔案樹狀結構完整複製。

$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\" -FromSession $Session

範例 11:以遞歸方式將遠端資料夾的整個內容複製到本機計算機

會話會使用 的認證Contoso\User01建立至名為 Server01 的遠端電腦,並將結果儲存在名為$Session的變數中。

Cmdlet 會Copy-Item使用儲存在 變數中的$Session會話資訊,將遠端C:\MyRemoteData\scripts資料夾的整個內容複製到本機D:\MyLocalData\scripts資料夾。 因為使用 Recurse 參數,所以作業如果腳本資料夾不存在,就會建立腳本資料夾。 如果 scripts 資料夾在子資料夾中有檔案,這些子資料夾會以其檔案樹狀結構完整複製。

$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\scripts" -FromSession $Session -Recurse

範例 12:以遞歸方式將檔案從資料夾樹狀結構複製到目前資料夾

此範例示範如何將檔案從多層次資料夾結構複製到單一一平面資料夾。 前三個命令會顯示現有的資料夾結構和兩個檔案的內容,兩個檔案的名稱 file3.txt都是 。

PS C:\temp\test> (Get-ChildItem C:\temp\tree -Recurse).FullName
C:\temp\tree\subfolder
C:\temp\tree\file1.txt
C:\temp\tree\file2.txt
C:\temp\tree\file3.txt
C:\temp\tree\subfolder\file3.txt
C:\temp\tree\subfolder\file4.txt
C:\temp\tree\subfolder\file5.txt

PS C:\temp\test> Get-Content C:\temp\tree\file3.txt
This is file3.txt in the root folder

PS C:\temp\test> Get-Content C:\temp\tree\subfolder\file3.txt
This is file3.txt in the subfolder

PS C:\temp\test> Copy-Item -Path C:\temp\tree -Filter *.txt -Recurse -Container:$false
PS C:\temp\test> (Get-ChildItem . -Recurse).FullName
C:\temp\test\subfolder
C:\temp\test\file1.txt
C:\temp\test\file2.txt
C:\temp\test\file3.txt
C:\temp\test\file4.txt
C:\temp\test\file5.txt

PS C:\temp\test> Get-Content .\file3.txt
This is file3.txt in the subfolder

Cmdlet Copy-ItemContainer 參數設定為 $false。 這會導致複製源資料夾的內容,但不會保留資料夾結構。 請注意,目的地資料夾中會覆寫同名的檔案。

範例 13:使用篩選來複製專案而不遞歸

此範例顯示使用 Include 參數來選取要複製的項目的結果。

此範例會使用包含要複製之檔案的下列資料夾結構:

  • D:\temp\tree\example.ps1
  • D:\temp\tree\example.txt
  • D:\temp\tree\examples\
  • D:\temp\tree\examples\example_1.txt
  • D:\temp\tree\examples\example_2.txt
  • D:\temp\tree\examples\subfolder\
  • D:\temp\tree\examples\subfolder\test.txt

在此範例中,Copy-Item會使用PathInclude參數的通配符來呼叫。 指定 Path 參數的通配符可確保其處理符合 D:\temp\tree\*的所有檔案和資料夾。 Include 參數會篩選要處理的專案清單,只將作業限制為開頭為 的ex那些路徑。

PS D:\temp\test\out> Copy-Item -Path D:\temp\tree\* -Include ex*
PS D:\temp\test\out> (Get-ChildItem -Recurse).FullName
D:\temp\out\examples
D:\temp\out\example.ps1
D:\temp\out\example.txt

Include 參數會套用至資料夾的內容D:\temp\tree,以複製符合 ex*的所有專案。 請注意,如果沒有遞歸,則會 D:\temp\out\examples 複製資料夾,但不會複製其內容。

範例 14:使用篩選以遞歸複製專案

此範例顯示使用 Include 參數來選取要複製的項目的結果。

此範例會使用包含要複製之檔案的下列資料夾結構:

  • D:\temp\tree\example.ps1
  • D:\temp\tree\example.txt
  • D:\temp\tree\examples\
  • D:\temp\tree\examples\example_1.txt
  • D:\temp\tree\examples\example_2.txt
  • D:\temp\tree\examples\subfolder\
  • D:\temp\tree\examples\subfolder\test.txt

在此範例中,Copy-Item會使用PathInclude參數的通配符來呼叫。 指定 Path 參數的通配符可確保其處理符合 D:\temp\tree\*的所有檔案和資料夾。 Include 參數會篩選要處理的專案清單,只將作業限制為開頭為 的ex那些路徑。

D:\temp\out> Copy-Item -Path D:\temp\tree\* -Include ex* -Recurse
D:\temp\out> (Get-ChildItem -Recurse).FullName
D:\temp\out\examples
D:\temp\out\example.ps1
D:\temp\out\example.txt
D:\temp\out\examples\subfolder
D:\temp\out\examples\example_1.txt
D:\temp\out\examples\example_2.txt
D:\temp\out\examples\subfolder\test.txt

Include 參數會套用至資料夾的內容D:\temp\tree,以複製符合 ex*的所有專案。 請注意,使用遞歸,資料夾 D:\temp\out\examples 會連同所有檔案和子資料夾一起複製。 此複本包含不符合 include 篩選條件的檔案。 使用 Copy-Item時,篩選只會套用至Path參數所指定的最上層。 然後遞歸會套用至那些相符的專案。

注意

Exclude 參數的行為與此範例中所述的行為相同,不同之處在於只會將作業限製為不符合模式的路徑。

範例 15:限制檔案從通配符指定的路徑遞歸複製

此範例示範如何限制從通配符比對路徑遞歸複製到另一個資料夾的檔案。 範例 13 顯示,因為 Include 參數只會篩選針對通配符指定 Path 解析的路徑, 因此 Include 參數無法用來限制從資料夾遞歸複製的檔案。 相反地,您可以使用 Get-ChildItem 來尋找您要複製的專案,並將這些項目傳遞至 Copy-Item

此範例會使用包含要複製之檔案的下列資料夾結構:

  • D:\temp\tree\example.ps1
  • D:\temp\tree\example.txt
  • D:\temp\tree\examples\
  • D:\temp\tree\examples\example_1.txt
  • D:\temp\tree\examples\example_2.txt
  • D:\temp\tree\examples\subfolder\
  • D:\temp\tree\examples\subfolder\test.txt

若要複製開頭ex*為 的所有專案,請使用 Get-ChildItem RecurseFilter 參數,並將結果傳送至 Copy-Item

D:\temp\out> Get-ChildItem -Path D:\temp\tree -Recurse -Filter ex* | Copy-Item
D:\temp\out> (Get-ChildItem -Recurse).FullName
D:\temp\out\examples
D:\temp\out\example_1.txt
D:\temp\out\example_2.txt
D:\temp\out\example.ps1
D:\temp\out\example.txt

Copy-Item不同於 ,的 Get-ChildItem Filter 參數會套用至遞歸期間探索到的專案。 這可讓您以遞歸方式尋找、篩選及複製專案。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Container

表示此 Cmdlet 會在複製作業期間保留容器物件。 根據預設, Container 參數會設定為 True

類型:SwitchParameter
Position:Named
預設值:True
必要:False
接受管線輸入:False
接受萬用字元:False

-Credential

注意

任何與 PowerShell 一起安裝的提供者都不支援此參數。 若要模擬其他使用者,或在執行此 Cmdlet 時提升您的認證,請使用 Invoke-Command

類型:PSCredential
Position:Named
預設值:Current user
必要:False
接受管線輸入:True
接受萬用字元:False

-Destination

指定新位置的路徑。 預設值是目前的目錄。

若要重新命名要複製的專案,請在 Destination 參數的值中指定新的名稱。

類型:String
Position:1
預設值:Current directory
必要:False
接受管線輸入:True
接受萬用字元:False

-Exclude

指定一或多個路徑專案或模式,例如 "*.txt",以限制此 Cmdlet 的作業。 此參數的值會根據Path參數的通配符比對結果進行篩選,而不是最終結果。 只有在以一或多個通配符指定Path,此參數才有效。 因為此參數只會篩選 Path 參數解析的路徑,所以不會篩選使用 Recurse 參數遞歸子資料夾時探索到的任何專案。

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:True

-Filter

指定篩選條件以限定 Path 參數。 FileSystem 提供者是唯一支援使用篩選器的已安裝 PowerShell 提供者。 您可以在 about_Wildcards 中找到 FileSystem 篩選語言的語法。 篩選比其他參數更有效率,因為提供者會在 Cmdlet 取得物件時套用它們,而不是在擷取對象之後讓 PowerShell 篩選物件。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:True

-Force

表示此 Cmdlet 會複製無法變更的專案,例如透過只讀檔案或別名複製。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-FromSession

這是 FileSystem 提供者提供的動態參數。

指定要從中複製遠端檔案的 PSSession 物件。 當您使用此參數時, PathLiteralPath 參數會參考遠端電腦上的本機路徑。

如需詳細資訊,請參閱 about_FileSystem_Provider

類型:PSSession
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Include

指定一或多個路徑專案或模式,例如 "*.txt",以限制此 Cmdlet 的作業。 此參數的值會根據Path參數的通配符比對結果進行篩選,而不是最終結果。 只有在以一或多個通配符指定Path,此參數才有效。 因為此參數只會篩選 Path 參數解析的路徑,所以不會篩選使用 Recurse 參數遞歸子資料夾時探索到的任何專案。

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:True

-LiteralPath

指定一或多個位置的路徑。 LiteralPath 的值會完全依照其類型一樣使用。 不會將任何字元解譯為通配符。 如果路徑包含逸出字元,請以單引弧括住它。 單引號會告知PowerShell不要將任何字元解譯為逸出序列。

如需詳細資訊,請參閱 about_Quoting_Rules

類型:String[]
別名:PSPath, LP
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-PassThru

傳回 物件,表示您正在使用的專案。 根據預設,此 Cmdlet 不會產生任何輸出。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Path

指定要複製之項目的路徑,做為字串陣列。 允許通配符。

類型:String[]
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:True

-Recurse

表示此 Cmdlet 會執行遞歸複製。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-ToSession

這是 FileSystem 提供者提供的動態參數。

指定正在複製遠端檔案的 PSSession 物件。 當您使用此參數時, Destination 參數會參考遠端電腦上的本機路徑。

如需詳細資訊,請參閱 about_FileSystem_Provider

類型:PSSession
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

String

您可以使用管線傳送包含此 Cmdlet 路徑的字串。

輸出

None

根據預設,此 Cmdlet 不會傳回任何輸出。

PSObject

當您使用 PassThru 參數時,這個 Cmdlet 會傳回代表複製項目的物件。

備註

PowerShell 包含下列的 Copy-Item別名:

  • 所有平臺:
    • copy
    • cpi
  • Windows:
    • cp

此 Cmdlet 的設計目的是要處理任何提供者所公開的數據。 若要列出工作階段中可用的提供者,請輸入 Get-PSProvider。 如需詳細資訊,請參閱 about_Providers