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

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 přejmenovat položku a nekopírovat ji, použijte rutinu Rename-Item .

Příklady

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

Tento příklad zkopíruje mar1604.log.txt soubor do C:\Presentation adresáře. 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 C:\Logfiles adresáře do existujícího C:\Drawings adresáře. Adresář Logfiles se nezkopíruje.

Logfiles Pokud adresář 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 cesta C:\Drawings neexistuje, rutina zkopíruje všechny soubory ze Logfiles stromu složek do jedné složky C:\Drawingsa přepíše všechny soubory se stejným názvem.

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

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

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říkladu 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 obsahuje \*, veškerý obsah souboru adresáře, včetně stromů podadresáře, se zkopírují do nového cílového adresáře. Pří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í Get-Widget.ps1 skriptu z \\Server01\Share adresáře do \\Server12\ScriptArchive adresáře. V rámci operace kopírování příkaz změní název položky na Get-Widget.ps1 Get-Widget.ps1.txt, aby mohl být bezpečně připojen k e-mailovým zprávům.

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