Copy-Item

Reference

Modul:: Microsoft.PowerShell.Management

Zkopíruje položku z jednoho umístění do jiného.

Syntaxe

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

Rutina Copy-Item zkopíruje položku z jednoho umístění do jiného umístění ve stejném oboru názvů. Může například zkopírovat soubor do složky, ale nemůže zkopírovat soubor na jednotku certifikátu.

Tato rutina neodstraní zkopírované položky nebo je neodstraní. Konkrétní položky, které může rutina kopírovat, závisí na poskytovateli PowerShellu, který položku zveřejňuje. Může například kopírovat soubory a adresáře v jednotce systému souborů a klíče registru a položky v jednotce registru.

Tato rutina může kopírovat a přejmenovat položky ve stejném příkazu. Pokud chcete položku přejmenovat, zadejte nový název do hodnoty parametru Destination. Pokud chcete položku přejmenovat a nekopírovat, použijte rutinu Rename-Item.

Příklady

Příklad 1: Zkopírování souboru do zadaného adresáře

Tento příklad zkopíruje soubor mar1604.log.txt do adresáře C:\Presentation. Původní soubor se neodstraní.

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

Příklad 2: Kopírování obsahu adresáře do existujícího adresáře

Tento příklad zkopíruje obsah adresáře C:\Logfiles do existujícího adresáře C:\Drawings. Adresář Logfiles se nekopíruje.

Pokud adresář Logfiles obsahuje soubory v podadresářích, zkopírují se tyto podadresáře s nedotčenými stromy souborů. Ve výchozím nastavení je parametr Container nastaven na hodnotu True, která zachovává adresářovou strukturu.

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

Poznámka

Pokud potřebujete do kopie zahrnout adresář , odeberte zcesty . Například:

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

Příklad 3: Kopírování obsahu adresáře do nového adresáře

Tento příklad zkopíruje obsah zdrojového adresáře C:\Logfiles a vytvoří nový cílový adresář. Nový cílový adresář, \Logs se vytvoří v C:\Drawings.

Pokud chcete zahrnout název zdrojového adresáře, zkopírujte ho do existujícího cílového adresáře, jak je znázorněno v Příklad 2. Nebo pojmenujte nový cílový adresář se stejným názvem jako zdrojový adresář.

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

Poznámka

Pokud Cesta zahrnuje \*, veškerý obsah souboru adresáře bez stromů podadresáře se zkopíruje do nového cílového adresáře. Například:

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

Příklad 4: Zkopírování souboru do zadaného adresáře a přejmenování souboru

Tento příklad používá rutinu Copy-Item ke zkopírování skriptu Get-Widget.ps1 z adresáře \\Server01\Share do adresáře \\Server12\ScriptArchive. V rámci operace kopírování příkaz změní název položky z Get-Widget.ps1 na Get-Widget.ps1.txt, aby se mohl připojit k e-mailovým zprávům.

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