Dela via

Copy-Item

  • Referens
Modul:
Microsoft.PowerShell.Management

Kopierar ett objekt från en plats till en annan.

Syntax

Copy-Item
    [-Path] <String[]>
    [[-Destination] <String>]
    [-Container]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-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]
    [-UseTransaction]
    [-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]
    [-UseTransaction]
    [<CommonParameters>]
Copy-Item
    -LiteralPath <String[]>
    [[-Destination] <String>]
    [-Container]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

Description

Cmdleten Copy-Item kopierar ett objekt från en plats till en annan plats 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 målparametern. Om du vill byta namn på ett objekt och inte kopiera det använder du cmdleten Rename-Item .

Exempel

Exempel 1: Kopiera en fil till den angivna katalogen

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

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

Exempel 2: Kopiera kataloginnehåll till en befintlig katalog

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

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

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

Kommentar

Om sökvägen C:\Drawings inte finns kopierar cmdleten alla filer från mappträdet Logfiles till en enda mapp C:\Drawingsoch skriver över alla filer med samma namn.

Exempel 3: Kopiera katalog och innehåll till en ny katalog

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

Om du vill inkludera 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

Kommentar

Om sökvägen innehåller \*kopieras alla katalogens filinnehåll, inklusive underkatalogträden, till den nya målkatalogen. Till exempel:

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

Exempel 4: Kopiera en fil till den angivna katalogen och byt namn på filen

I det här exemplet används cmdleten Copy-Item för att kopiera skriptet Get-Widget.ps1 \\Server01\Share från katalogen till \\Server12\ScriptArchive katalogen. 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 säkert till e-postmeddelanden.

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

Exempel 5: Kopiera en fil till en fjärrdator

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

Cmdleten kopieras test.log från D:\Folder001 mappen till C:\Folder001_Copy mappen på fjärrdatorn med hjälp av sessionsinformationen som lagras i variabeln $Session Copy-Item. 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

Exempel 6: Kopiera en mapp till en fjärrdator

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

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

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

Exempel 7: Kopiera hela innehållet i en mapp rekursivt till en fjärrdator

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

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

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

Exempel 8: Kopiera en fil till en fjärrdator och byt sedan namn på filen

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

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

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

Exempel 9: Kopiera en fjärrfil till den lokala datorn

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

Cmdleten Copy-Item kopieras test.log från fjärrplatsen C:\MyRemoteData\ till den lokala D:\MyLocalData mappen 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

Exempel 10: Kopiera hela innehållet i en fjärrmapp till den lokala datorn

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

Cmdleten Copy-Item kopierar hela innehållet från fjärrmappen 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

Exempel 11: Kopiera hela innehållet i en fjärrmapp rekursivt till den lokala datorn

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

Cmdleten Copy-Item kopierar hela innehållet från fjärrmappen 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 mappen scripts 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"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\scripts" -FromSession $Session -Recurse

Exempel 12: Kopiera filer rekursivt från ett mappträd till den aktuella mappen

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 containerparametern 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.

Exempel 13: Använda filter för att kopiera objekt utan rekursion

Det här exemplet visar resultatet med hjälp av parametern Inkludera 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 Copy-Item anropas 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 Inkludera tillämpas på innehållet i D:\temp\tree mappen för att kopiera alla objekt som matchar ex*. Observera att utan rekursion D:\temp\out\examples kopieras mappen, men inget av innehållet kopieras.

Exempel 14: Använda filter för att kopiera objekt med rekursion

Det här exemplet visar resultatet med hjälp av parametern Inkludera 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 Copy-Item anropas 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 Inkludera tillämpas på innehållet i D:\temp\tree mappen för att kopiera alla objekt som matchar ex*. Observera att med rekursion D:\temp\out\examples kopieras mappen tillsammans med alla filer och undermappar. Kopian innehåller filer som inte matchar inkluderingsfiltret. När du använder Copy-Itemgäller filtren endast för den översta nivån som anges av parametern Sökväg . Sedan tillämpas rekursion på de matchande objekten.

Kommentar

Beteendet för parametern Exkludera är detsamma som i det här exemplet, förutom att det begränsar åtgärden till endast de sökvägar som inte matchar mönstret.

Exempel 15: Begränsa filerna till att rekursivt kopiera från en sökväg med jokertecken

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 en sökväg med jokertecken kan parametern Inkludera 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 använder du Get-ChildItem parametrarna Recurse och Filter och skicka resultatet till Copy-Item.ex*

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-ItemTill skillnad från gäller filterparametern för Get-ChildItem de objekt som identifierades under rekursionen. På så sätt kan du hitta, filtrera och sedan kopiera objekt rekursivt.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Container

Anger att den här cmdleten bevarar containerobjekt under kopieringsåtgärden. Som standard är containerparametern inställd på Sant.

Typ:SwitchParameter
Position:Named
Standardvärde:True
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Kommentar

Den här parametern stöds inte av några leverantörer som är installerade med PowerShell. Om du vill personifiera en annan användare eller höja dina autentiseringsuppgifter när du kör den här cmdleten använder du Invoke-Command.

Typ:PSCredential
Position:Named
Standardvärde:Current user
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Destination

Anger sökvägen till den nya platsen. Standardvärdet är den aktuella katalogen.

Om du vill byta namn på objektet som kopieras anger du ett nytt namn i värdet för målparametern.

Typ:String
Position:1
Standardvärde:Current directory
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Exclude

Anger ett eller flera sökvägselement eller mönster, till exempel "*.txt", för att begränsa cmdletens åtgärd. Värdet för den här parametern filtreras mot jokerteckenmatchningsresultatet för parametern Path , inte det slutliga resultatet. Den här parametern är endast effektiv när sökvägen anges med ett eller flera jokertecken. Eftersom den här parametern endast filtrerar på sökvägarna som har lösts för parametern Path filtrerar den inte några objekt som identifieras när de upprepas via underordnade mappar med parametern Recurse .

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-Filter

Anger ett filter för att kvalificera parametern Sökväg . FileSystem-providern är den enda installerade PowerShell-providern som stöder användning av filter. Du hittar syntaxen för filterspråket FileSystem i about_Wildcards. Filter är effektivare än andra parametrar eftersom providern tillämpar dem när cmdleten hämtar objekten i stället för att PowerShell filtrerar objekten när de har hämtats.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-Force

Anger att den här cmdleten kopierar objekt som annars inte kan ändras, till exempel kopiering över en skrivskyddad fil eller ett alias.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FromSession

Det här är en dynamisk parameter som görs tillgänglig av FileSystem-providern .

Ange det PSSession-objekt som en fjärrfil kopieras från. När du använder den här parametern refererar parametrarna Path och LiteralPath till den lokala sökvägen på fjärrdatorn.

Mer information finns i about_FileSystem_Provider.

Typ:PSSession
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Include

Anger ett eller flera sökvägselement eller mönster, till exempel "*.txt", för att begränsa cmdletens åtgärd. Värdet för den här parametern filtreras mot jokerteckenmatchningsresultatet för parametern Path , inte det slutliga resultatet. Den här parametern är endast effektiv när sökvägen anges med ett eller flera jokertecken. Eftersom den här parametern endast filtrerar på sökvägarna som har lösts för parametern Path filtrerar den inte några objekt som identifieras när de upprepas via underordnade mappar med parametern Recurse .

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-LiteralPath

Anger en sökväg till en eller flera platser. Värdet för LiteralPath används exakt som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.

Mer information finns i about_Quoting_Rules.

Typ:String[]
Alias:PSPath
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger sökvägen till de objekt som ska kopieras som en strängmatris. Jokertecken tillåts.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-Recurse

Anger att denna cmdlet gör en rekursiv kopia.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ToSession

Det här är en dynamisk parameter som görs tillgänglig av FileSystem-providern .

Ange det PSSession-objekt som en fjärrfil kopieras till. När du använder den här parametern refererar målparametern till den lokala sökvägen på fjärrdatorn.

Mer information finns i about_FileSystem_Provider.

Typ:PSSession
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UseTransaction

Innehåller kommandot i den aktiva transaktionen. Den här parametern är endast giltig när en transaktion pågår. Mer information finns i about_Transactions.

Typ:SwitchParameter
Alias:usetx
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

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

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

PSObject

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

Kommentarer

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

  • copy
  • cp
  • cpi

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 about_Providers.