Copy-Item
Zkopíruje položku z jednoho umístění do jiného.
Syntax
Path (Default) - FileSystem provider
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>]
LiteralPath - FileSystem provider
Copy-Item
[[-Destination] <String>]
-LiteralPath <String[]>
[-Container]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Recurse]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-FromSession <PSSession>]
[-ToSession <PSSession>]
[<CommonParameters>]
Path (Default) - All providers
Copy-Item
[-Path] <String[]>
[[-Destination] <String>]
[-Container]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Recurse]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
LiteralPath - All providers
Copy-Item
[[-Destination] <String>]
-LiteralPath <String[]>
[-Container]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Recurse]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<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 cesta C:\Drawings neexistuje, rutina zkopíruje všechny soubory ze stromu složek Logfiles 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 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 obsahuje \*, veškerý obsah souboru adresáře, včetně stromů podadresáře, se zkopírují 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 bezpečně připojit k e-mailovým zprávům.
Copy-Item "\\Server01\Share\Get-Widget.ps1" -Destination "\\Server12\ScriptArchive\Get-Widget.ps1.txt"
Příklad 5: Zkopírování souboru do vzdáleného počítače
Relace se vytvoří na vzdáleném počítači s názvem Server01 s přihlašovacími údaji Contoso\User01 a uloží výsledky do proměnné s názvem $Session.
Rutina Copy-Item zkopíruje test.log ze složky D:\Folder001 do složky C:\Folder001_Copy ve vzdáleném počítači pomocí informací o relaci uložených v proměnné $Session. Původní soubor se neodstraní.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "D:\Folder001\test.log" -Destination "C:\Folder001_Copy\" -ToSession $Session
Příklad 6: Zkopírování složky do vzdáleného počítače
Relace se vytvoří na vzdáleném počítači s názvem Server01 s přihlašovacími údaji Contoso\User01 a uloží výsledky do proměnné s názvem $Session.
Rutina Copy-Item zkopíruje složku D:\Folder002 do adresáře C:\Folder002_Copy ve vzdáleném počítači pomocí informací o relaci uložených v proměnné $Session. Žádné podsložky ani soubory se nekopírují bez použití přepínače Recurse. Operace vytvoří složku Folder002_Copy, pokud ještě neexistuje.
$Session = New-PSSession -ComputerName "Server02" -Credential "Contoso\User01"
Copy-Item "D:\Folder002\" -Destination "C:\Folder002_Copy\" -ToSession $Session
Příklad 7: Rekurzivně zkopírujte celý obsah složky do vzdáleného počítače.
Relace se vytvoří na vzdáleném počítači s názvem Server01 s přihlašovacími údaji Contoso\User01 a uloží výsledky do proměnné s názvem $Session.
Rutina Copy-Item zkopíruje celý obsah ze složky D:\Folder003 do adresáře C:\Folder003_Copy ve vzdáleném počítači pomocí informací o relaci uložených v proměnné $Session. Podsložky se zkopírují se stromy souborů beze změny. Operace vytvoří složku Folder003_Copy, pokud ještě neexistuje.
$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
Copy-Item "D:\Folder003\" -Destination "C:\Folder003_Copy\" -ToSession $Session -Recurse
Příklad 8: Zkopírování souboru do vzdáleného počítače a následné přejmenování souboru
Relace se vytvoří na vzdáleném počítači s názvem Server01 s přihlašovacími údaji Contoso\User01 a uloží výsledky do proměnné s názvem $Session.
Rutina Copy-Item zkopíruje scriptingexample.ps1 ze složky D:\Folder004 do složky C:\Folder004_Copy ve vzdáleném počítači pomocí informací o relaci uložených v proměnné $Session. Původní soubor se neodstraní.
$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
Copy-Item "D:\Folder004\scriptingexample.ps1" -Destination "C:\Folder004_Copy\scriptingexample_copy.ps1" -ToSession $Session
Příklad 9: Zkopírování vzdáleného souboru do místního počítače
Relace se vytvoří na vzdáleném počítači s názvem Server01 s přihlašovacími údaji Contoso\User01 a uloží výsledky do proměnné s názvem $Session.
Rutina Copy-Item zkopíruje test.log ze vzdáleného C:\MyRemoteData\ do místní složky D:\MyLocalData pomocí informací o relaci uložených v proměnné $Session. Původní soubor se neodstraní.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\test.log" -Destination "D:\MyLocalData\" -FromSession $Session
Příklad 10: Zkopírování celého obsahu vzdálené složky do místního počítače
Relace se vytvoří na vzdáleném počítači s názvem Server01 s přihlašovacími údaji Contoso\User01 a uloží výsledky do proměnné s názvem $Session.
Rutina Copy-Item zkopíruje celý obsah ze vzdálené složky C:\MyRemoteData\scripts do místní složky D:\MyLocalData pomocí informací o relaci uložených v proměnné $Session. Pokud složka skriptů obsahuje soubory v podsložkách, zkopírují se tyto podsložky se stromy souborů beze změny.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\" -FromSession $Session
Příklad 11: Rekurzivně zkopírujte celý obsah vzdálené složky do místního počítače.
Relace se vytvoří na vzdáleném počítači s názvem Server01 s přihlašovacími údaji Contoso\User01 a uloží výsledky do proměnné s názvem $Session.
Rutina Copy-Item zkopíruje celý obsah ze vzdálené složky C:\MyRemoteData\scripts do místní složky D:\MyLocalData\scripts pomocí informací o relaci uložených v proměnné $Session. Protože se používá parametr Recurse, operace vytvoří složku skriptů, pokud ještě neexistuje. Pokud složka skriptů obsahuje soubory v podsložkách, zkopírují se tyto podsložky se stromy souborů beze změny.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\scripts" -FromSession $Session -Recurse
Příklad 12: Rekurzivní kopírování souborů ze stromu složek do aktuální složky
Tento příklad ukazuje, jak kopírovat soubory z víceúrovňové struktury složek do jedné ploché složky.
První tři příkazy zobrazují existující strukturu složek a obsah dvou souborů, oba názvy 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
Rutina Copy-Item má parametr Container nastavený na $false. To způsobí, že se obsah zdrojové složky zkopíruje, ale nezachová strukturu složek. Všimněte si, že soubory se stejným názvem se přepíšou v cílové složce.
Příklad 13: Kopírování položek bez rekurze pomocí filtrů
Tento příklad ukazuje výsledky pomocí parametru Include k výběru položek, které se mají zkopírovat.
V tomto příkladu se používá následující struktura složek obsahující soubory, které se mají zkopírovat:
D:\temp\tree\example.ps1D:\temp\tree\example.txtD:\temp\tree\examples\D:\temp\tree\examples\example_1.txtD:\temp\tree\examples\example_2.txtD:\temp\tree\examples\subfolder\D:\temp\tree\examples\subfolder\test.txt
V tomto příkladu se Copy-Item volá se zástupným znakem pro parametry Path a Include. Zadání zástupné ikony pro parametr Cesta zajišťuje, že zpracovává všechny soubory a složky, které odpovídají D:\temp\tree\*. Parametr Zahrnout filtruje seznam položek ke zpracování a omezuje operaci pouze na cesty začínající 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
Parametr Include se použije na obsah složky D:\temp\tree ke zkopírování všech položek, které odpovídají ex*. Všimněte si, že bez rekurze se složka D:\temp\out\examples zkopíruje, ale žádný z jeho obsahu se nezkopíruje.
Příklad 14: Kopírování položek s rekurzí pomocí filtrů
Tento příklad ukazuje výsledky pomocí parametru Include k výběru položek, které se mají zkopírovat.
V tomto příkladu se používá následující struktura složek obsahující soubory, které se mají zkopírovat:
D:\temp\tree\example.ps1D:\temp\tree\example.txtD:\temp\tree\examples\D:\temp\tree\examples\example_1.txtD:\temp\tree\examples\example_2.txtD:\temp\tree\examples\subfolder\D:\temp\tree\examples\subfolder\test.txt
V tomto příkladu se Copy-Item volá se zástupným znakem pro parametry Path a Include. Zadání zástupné ikony pro parametr Cesta zajistí, že zpracuje všechny soubory a složky, které odpovídají D:\temp\tree\*. Parametr Zahrnout filtruje seznam položek ke zpracování a omezuje operaci pouze na cesty začínající 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
Parametr Include se použije na obsah složky D:\temp\tree ke zkopírování všech položek, které odpovídají ex*. Všimněte si, že při rekurzi se složka D:\temp\out\examples zkopíruje spolu se všemi soubory a podsložkami. Kopie obsahuje soubory, které neodpovídají filtru zahrnutí. Při použití Copy-Itemse filtry vztahují pouze na nejvyšší úroveň určenou parametrem Path. Rekurze se pak použije u odpovídajících položek.
Poznámka:
Chování parametru Exclude je stejné jako v tomto příkladu s tím rozdílem, že omezuje operaci pouze na cesty, které neodpovídají vzoru.
Příklad 15: Omezte soubory na rekurzivní kopírování ze zástupné cesty určené zástupným znakem.
Tento příklad ukazuje, jak omezit rekurzivní kopírování souborů z cesty odpovídající zástupným znakům do jiné složky. Příklad 13 ukazuje, že vzhledem k tomu, že parametr Include filtruje pouze cesty určené pro cestu se zástupným znakem určeným Cesta, Zahrnout parametr nelze použít k omezení rekurzivního kopírování souborů ze složky. Místo toho můžete pomocí Get-ChildItem najít položky, které chcete zkopírovat, a předat je Copy-Item.
V tomto příkladu se používá následující struktura složek obsahující soubory, které se mají zkopírovat:
D:\temp\tree\example.ps1D:\temp\tree\example.txtD:\temp\tree\examples\D:\temp\tree\examples\example_1.txtD:\temp\tree\examples\example_2.txtD:\temp\tree\examples\subfolder\D:\temp\tree\examples\subfolder\test.txt
Pokud chcete zkopírovat všechny položky, které začínají ex*, použijte Get-ChildItem s a Filtr parametry a výsledky přetáčte na 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
Na rozdíl od Copy-Itemplatí parametr Filter pro Get-ChildItem pro položky zjištěné během rekurze. To umožňuje rekurzivně vyhledávat, filtrovat a kopírovat položky.
Parametry
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Container
Označuje, že tato rutina zachovává objekty kontejneru během operace kopírování. Ve výchozím nastavení je parametr Container nastaven na hodnotu True.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | True |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Credential
Poznámka:
Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými v PowerShellu. Pokud chcete zosobnit jiného uživatele nebo zvýšit oprávnění při spuštění této rutiny, použijte Invoke-Command.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | Current user |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Destination
Určuje cestu k novému umístění. Výchozí hodnota je aktuální adresář.
Chcete-li přejmenovat zkopírovanou položku, zadejte nový název v hodnotě parametru Destination.
Vlastnosti parametru
| Typ: | String |
| Default value: | Current directory |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Exclude
Určuje jeden nebo více prvků cesty nebo vzorů, například "*.txt", pro omezení operace této rutiny. Hodnota tohoto parametru filtruje výsledek porovnávání se zástupnými znaky parametru Path, nikoli konečných výsledků. Tento parametr je efektivní pouze v případě, že je cesta zadána pomocí jednoho nebo více zástupných znaků. Vzhledem k tomu, že tento parametr filtruje pouze cesty vyřešené pro parametr Path, nefiltruje žádné položky zjištěné při opakování prostřednictvím podřízených složek pomocí parametru Recurse.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Filter
Určuje filtr pro kvalifikaci parametru Path. Zprostředkovatel FileSystem je jediným nainstalovaným poskytovatelem PowerShellu, který podporuje použití filtrů. Syntaxi jazyka filtru FileSystem najdete v about_Wildcards. Filtry jsou efektivnější než jiné parametry, protože je poskytovatel použije, když rutina získá objekty místo toho, aby objekty po jejich načtení vyfiltrovala PowerShell.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Označuje, že tato rutina kopíruje položky, které se jinak nedají změnit, například kopírování přes soubor nebo alias jen pro čtení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-FromSession
Toto je dynamický parametr zpřístupněný poskytovatelem FileSystem.
Zadejte PSSession objekt, ze kterého se kopíruje vzdálený soubor. Pokud použijete tento parametr, Cesta a LiteralPath parametry odkazují na místní cestu na vzdáleném počítači.
Pro více informací se podívejte na about_FileSystem_Provider.
Vlastnosti parametru
| Typ: | PSSession |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Include
Určuje jeden nebo více prvků cesty nebo vzorů, například "*.txt", pro omezení operace této rutiny. Hodnota tohoto parametru filtruje výsledek porovnávání se zástupnými znaky parametru Path, nikoli konečných výsledků. Tento parametr je efektivní pouze v případě, že je cesta zadána pomocí jednoho nebo více zástupných znaků. Vzhledem k tomu, že tento parametr filtruje pouze cesty vyřešené pro parametr Path, nefiltruje žádné položky zjištěné při opakování prostřednictvím podřízených složek pomocí parametru Recurse.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-LiteralPath
Určuje cestu k jednomu nebo více místům. Hodnota LiteralPath se používá přesně tak, jak je zadána. Žádný znak není interpretován jako zástupný znak. Pokud cesta obsahuje únikové znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby žádné znaky neinterpretoval jako únikové sekvence.
Další informace najdete v about_Quoting_Rules.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Sady parametrů
LiteralPath
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Vrátí objekt, který představuje položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Path
Určuje cestu k položkám, které se mají zkopírovat, jako pole řetězců. Jsou povoleny zástupné znaky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
Path
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Recurse
Označuje, že tato rutina provede rekurzivní kopírování.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ToSession
Toto je dynamický parametr zpřístupněný poskytovatelem FileSystem.
Zadejte PSSession objekt, do kterého se kopíruje vzdálený soubor. Při použití tohoto parametru odkazuje parametr Destination na místní cestu na vzdáleném počítači.
Pro více informací se podívejte na about_FileSystem_Provider.
Vlastnosti parametru
| Typ: | PSSession |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-UseTransaction
Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace najdete v tématu about_Transactions.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | usetx |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Cmdlet se nespustil.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
Řetězec, který obsahuje cestu, můžete předat tomuto cmdletu.
Výstupy
None
Ve výchozím nastavení tato rutina nevrací žádný výstup.
PSObject
Pokud použijete parametr PassThru, vrátí tato rutina objekt představující zkopírovanou položku.
Poznámky
Windows PowerShell obsahuje následující aliasy pro Copy-Item:
copycpcpi
Tato rutina je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem. Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište Get-PSProvider. Pro více informací viz about_Providers.
