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

Description

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.

Exempel

Exempel 1: Kopiera en fil till den angivna katalogen

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"

Exempel 2: Kopiera kataloginnehåll till en befintlig katalog

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 innehåller 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

Not

Om du behöver ta med katalogen Logfiles i kopian tar du bort \* från Path. Till exempel:

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

Exempel 3: Kopiera kataloginnehåll till en ny katalog

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

Not

Om den sökvägen innehåller \*kopieras alla katalogens filinnehåll, utan 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 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.

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