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
    [[-Destination] <String>]
    -LiteralPath <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>]

Cmdleten Copy-Item kopierar ett objekt från en plats till en annan i samma namnområde. Den kan till exempel kopiera en fil till en mapp, men den kan inte kopiera en fil till en certifikatenhet.

Den här cmdleten klipper inte ut eller tar bort de objekt som kopieras. De specifika objekt som cmdleten kan kopiera beror på vilken PowerShell-provider som exponerar objektet. Den kan till exempel kopiera filer och kataloger på en filsystemenhet och registernycklar och poster på registerenheten.

Den här cmdleten kan kopiera och byta namn på objekt i samma kommando. Om du vill byta namn på ett objekt anger du det nya namnet i värdet för parametern Destination. Om du vill byta namn på ett objekt och inte kopiera det använder du cmdleten Rename-Item.

I det här exemplet kopieras filen mar1604.log.txt till katalogen C:\Presentation. Den ursprungliga filen tas inte bort.

Copy-Item "C:\Wabash\Logfiles\mar1604.log.txt" -Destination "C:\Presentation"

I det här exemplet kopieras innehållet i katalogen C:\Logfiles till den befintliga katalogen C:\Drawings. Katalogen Logfiles kopieras inte.

Om katalogen Logfiles har filer i underkataloger kopieras dessa underkataloger med sina filträd intakta. Som standard är parametern Container inställd på True, som bevarar katalogstrukturen.

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

Det här exemplet kopierar innehållet i C:\Logfiles källkatalogen och skapar en ny målkatalog. Den nya målkatalogen \Logs skapas i C:\Drawings.

Om du vill ta med källkatalogens namn kopierar du till en befintlig målkatalog enligt Exempel 2. Eller ge den nya målkatalogen samma namn som källkatalogen.

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

I det här exemplet används cmdleten Copy-Item för att kopiera Get-Widget.ps1-skriptet från katalogen \\Server01\Share till katalogen \\Server12\ScriptArchive. Som en del av kopieringsåtgärden ändrar kommandot objektnamnet från Get-Widget.ps1 till Get-Widget.ps1.txt, så att det kan kopplas till e-postmeddelanden på ett säkert sätt.

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

En session skapas till fjärrdatorn med namnet Server01 med autentiseringsuppgifterna för Contoso\User01 och lagrar resultatet i variabeln med namnet $Session.

Cmdleten Copy-Item kopierar test.log från mappen D:\Folder001 till mappen C:\Folder001_Copy på fjärrdatorn med hjälp av sessionsinformationen som lagras i variabeln $Session. Den ursprungliga filen tas inte bort.

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

En session skapas till fjärrdatorn med namnet Server01 med autentiseringsuppgifterna för Contoso\User01 och lagrar resultatet i variabeln med namnet $Session.

Cmdleten Copy-Item kopierar mappen D:\Folder002 till katalogen C:\Folder002_Copy på fjärrdatorn med hjälp av sessionsinformationen som lagras i variabeln $Session. Undermappar eller filer kopieras inte utan att använda växeln Recurse. Åtgärden skapar mappen Folder002_Copy om den inte redan finns.

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

En session skapas till fjärrdatorn med namnet Server01 med autentiseringsuppgifterna för Contoso\User01 och lagrar resultatet i variabeln med namnet $Session.

Cmdleten Copy-Item kopierar hela innehållet från mappen D:\Folder003 till katalogen C:\Folder003_Copy på fjärrdatorn med hjälp av sessionsinformationen som lagras i variabeln $Session. Undermapparna kopieras med sina filträd intakta. Åtgärden skapar mappen Folder003_Copy om den inte redan finns.

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

En session skapas till fjärrdatorn med namnet Server01 med autentiseringsuppgifterna för Contoso\User01 och lagrar resultatet i variabeln med namnet $Session.

Cmdleten Copy-Item kopierar scriptingexample.ps1 från mappen D:\Folder004 till mappen C:\Folder004_Copy på fjärrdatorn med hjälp av sessionsinformationen som lagras i variabeln $Session. Den ursprungliga filen tas inte bort.

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

En session skapas till fjärrdatorn med namnet Server01 med autentiseringsuppgifterna för Contoso\User01 och lagrar resultatet i variabeln med namnet $Session.

Cmdleten Copy-Item kopierar test.log från fjärrmappen C:\MyRemoteData\ till den lokala mappen D:\MyLocalData med hjälp av sessionsinformationen som lagras i variabeln $Session. Den ursprungliga filen tas inte bort.

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

En session skapas till fjärrdatorn med namnet Server01 med autentiseringsuppgifterna för Contoso\User01 och lagrar resultatet i variabeln med namnet $Session.

Cmdleten Copy-Item kopierar hela innehållet från mappen remote C:\MyRemoteData\scripts till den lokala D:\MyLocalData-mappen med hjälp av sessionsinformationen som lagras i variabeln $Session. Om skriptmappen har filer i undermappar kopieras dessa undermappar med sina filträd intakta.

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

En session skapas till fjärrdatorn med namnet Server01 med autentiseringsuppgifterna för Contoso\User01 och lagrar resultatet i variabeln med namnet $Session.

Cmdleten Copy-Item kopierar hela innehållet från mappen remote C:\MyRemoteData\scripts till den lokala D:\MyLocalData\scripts-mappen med hjälp av sessionsinformationen som lagras i variabeln $Session. Eftersom parametern Recurse används skapar åtgärden skriptmappen om den inte redan finns. Om skriptmappen har filer i undermappar kopieras dessa undermappar med sina filträd intakta.

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

Det här exemplet visar hur du kopierar filer från en mappstruktur på flera nivåer till en enda platt mapp. De första tre kommandona visar den befintliga mappstrukturen och innehållet i två filer, båda namnen 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

Cmdleten Copy-Item har parametern Container inställd på $false. Detta gör att innehållet i källmappen kopieras men bevarar inte mappstrukturen. Observera att filer med samma namn skrivs över i målmappen.

Det här exemplet visar resultatet med parametern Include för att välja de objekt som ska kopieras.

I det här exemplet används följande mappstruktur som innehåller de filer som ska kopieras:

• 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

I det här exemplet anropas Copy-Item med ett jokertecken för parametrarna Path och Include. Om du anger ett jokertecken för parametern Path ser du till att alla filer och mappar som matchar D:\temp\tree\*bearbetas. Parametern Include filtrerar listan över objekt som ska bearbetas, vilket begränsar åtgärden till endast de sökvägar som börjar med 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

Parametern Include tillämpas på innehållet i D:\temp\tree mapp för att kopiera alla objekt som matchar ex*. Observera att mappen D:\temp\out\examples kopieras utan rekursion, men inget av innehållet kopieras.

Det här exemplet visar resultatet med parametern Include för att välja de objekt som ska kopieras.

I det här exemplet används följande mappstruktur som innehåller de filer som ska kopieras:

• 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

I det här exemplet anropas Copy-Item med ett jokertecken för parametrarna Path och Include. Om du anger ett jokertecken för parametern Path ser du till att alla filer och mappar som matchar D:\temp\tree\*bearbetas. Parametern Include filtrerar listan över objekt som ska bearbetas, vilket begränsar åtgärden till endast de sökvägar som börjar med 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

Parametern Include tillämpas på innehållet i D:\temp\tree mapp för att kopiera alla objekt som matchar ex*. Observera att mappen D:\temp\out\examples kopieras tillsammans med alla filer och undermappar med rekursion. Kopian innehåller filer som inte matcha inkluderingsfiltret. När du använder Copy-Itemgäller filtren endast för den översta nivån som anges av parametern Path. Sedan tillämpas rekursion på de matchande objekten.

Det här exemplet visar hur du begränsar de filer som rekursivt kopieras från en sökväg med jokertecken till en annan mapp. Exempel 13 visar att eftersom parametern Include endast filtrerar på sökvägarna som matchas för ett jokertecken som anger Sökväg, kan parametern Include inte användas för att begränsa de filer som kopieras rekursivt från en mapp. I stället kan du använda Get-ChildItem för att hitta de objekt som du vill kopiera och skicka objekten till Copy-Item.

I det här exemplet används följande mappstruktur som innehåller de filer som ska kopieras:

• 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

Om du vill kopiera alla objekt som börjar med ex*använder du Get-ChildItem med parametrarna Recurse och Filter och skicka resultatet till 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

Till skillnad från Copy-Itemgäller parametern Filter för Get-ChildItem för de objekt som identifierades under rekursionen. På så sätt kan du hitta, filtrera och sedan kopiera objekt rekursivt.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka en sträng som innehåller en sökväg till den här cmdleten.

Som standard returnerar den här cmdleten inga utdata.

När du använder parametern PassThru returnerar den här cmdleten ett objekt som representerar det kopierade objektet.

PowerShell innehåller följande alias för Copy-Item:

• Alla plattformar:
  • copy
  • cpi
• Windows:
  • cp

Den här cmdleten är utformad för att fungera med data som exponeras av alla leverantörer. Om du vill visa en lista över tillgängliga leverantörer i sessionen skriver du Get-PSProvider. Mer information finns i om_Leverantörer.