Copy-Item
Kopiuje element z jednej lokalizacji do innej.
Składnia
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>]
Opis
Polecenie Copy-Item cmdlet kopiuje element z jednej lokalizacji do innej lokalizacji w tej samej przestrzeni nazw.
Na przykład może skopiować plik do folderu, ale nie może skopiować pliku na dysk certyfikatu.
To polecenie cmdlet nie powoduje wycinania ani usuwania kopiowanych elementów. Określone elementy, które polecenie cmdlet może skopiować, zależy od dostawcy programu PowerShell, który uwidacznia element. Na przykład może kopiować pliki i katalogi na dysku systemu plików oraz klucze rejestru i wpisy na dysku rejestru.
To polecenie cmdlet może kopiować i zmieniać nazwy elementów w tym samym poleceniu. Aby zmienić nazwę elementu, wprowadź nową nazwę w wartości parametru Destination . Aby zmienić nazwę elementu i nie skopiować go, użyj Rename-Item polecenia cmdlet .
Przykłady
Przykład 1. Kopiowanie pliku do określonego katalogu
Ten przykład kopiuje mar1604.log.txt plik do C:\Presentation katalogu. Oryginalny plik nie jest usuwany.
Copy-Item "C:\Wabash\Logfiles\mar1604.log.txt" -Destination "C:\Presentation"
Przykład 2. Kopiowanie zawartości katalogu do istniejącego katalogu
W tym przykładzie zawartość C:\Logfiles katalogu jest kopiowana do istniejącego C:\Drawings katalogu. Katalog Logfiles nie jest kopiowany.
Logfiles Jeśli katalog zawiera pliki w podkatalogach, te podkatalogi są kopiowane wraz z drzewami plików bez zmian. Domyślnie parametr Kontener jest ustawiony na wartość True, co zachowuje strukturę katalogów.
Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings" -Recurse
Uwaga
Jeśli ścieżka C:\Drawings nie istnieje, polecenie cmdlet kopiuje wszystkie pliki z Logfiles drzewa folderów do jednego folderu C:\Drawings, zastępując wszystkie pliki o tej samej nazwie.
Przykład 3. Kopiowanie katalogu i zawartości do nowego katalogu
Ten przykład kopiuje zawartość katalogu źródłowego C:\Logfiles i tworzy nowy katalog docelowy. Nowy katalog \Logs docelowy jest tworzony w pliku C:\Drawings.
Aby dołączyć nazwę katalogu źródłowego, skopiuj do istniejącego katalogu docelowego, jak pokazano w przykładzie 2. Możesz też nazwać nowy katalog docelowy tym samym co katalog źródłowy.
Copy-Item -Path "C:\Logfiles" -Destination "C:\Drawings\Logs" -Recurse
Uwaga
Jeśli ścieżka zawiera \*plik , wszystkie zawartość pliku katalogu, w tym drzewa podkatalogu, zostaną skopiowane do nowego katalogu docelowego. Na przykład:
Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings\Logs" -Recurse
Przykład 4. Kopiowanie pliku do określonego katalogu i zmienianie nazwy pliku
W tym przykładzie użyto Copy-Item polecenia cmdlet do skopiowania Get-Widget.ps1 skryptu \\Server01\Share z katalogu do \\Server12\ScriptArchive katalogu. W ramach operacji kopiowania polecenie zmienia nazwę elementu z Get-Widget.ps1 na Get-Widget.ps1.txt, aby można było bezpiecznie dołączyć ją do wiadomości e-mail.
Copy-Item "\\Server01\Share\Get-Widget.ps1" -Destination "\\Server12\ScriptArchive\Get-Widget.ps1.txt"
Przykład 5. Kopiowanie pliku na komputer zdalny
Sesja jest tworzona na komputerze zdalnym o nazwie Server01
Polecenie Copy-Item cmdlet kopiuje test.log z D:\Folder001 folderu do C:\Folder001_Copy folderu na komputerze zdalnym przy użyciu informacji o sesji przechowywanych w zmiennej $Session . Oryginalny plik nie jest usuwany.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "D:\Folder001\test.log" -Destination "C:\Folder001_Copy\" -ToSession $Session
Przykład 6. Kopiowanie folderu na komputer zdalny
Sesja jest tworzona na komputerze zdalnym o nazwie Server01
Polecenie Copy-Item cmdlet kopiuje D:\Folder002 folder do C:\Folder002_Copy katalogu na komputerze zdalnym przy użyciu informacji o sesji przechowywanych w zmiennej $Session . Żadne podfoldery lub pliki nie są kopiowane bez użycia przełącznika Recurse . Operacja tworzy Folder002_Copy folder, jeśli jeszcze nie istnieje.
$Session = New-PSSession -ComputerName "Server02" -Credential "Contoso\User01"
Copy-Item "D:\Folder002\" -Destination "C:\Folder002_Copy\" -ToSession $Session
Przykład 7. Rekursywnie skopiuj całą zawartość folderu na komputer zdalny
Sesja jest tworzona na komputerze zdalnym o nazwie Server01
Polecenie Copy-Item cmdlet kopiuje całą zawartość z D:\Folder003 folderu do C:\Folder003_Copy katalogu na komputerze zdalnym przy użyciu informacji o sesji przechowywanych w zmiennej $Session . Podfoldery są kopiowane z drzewami plików nienaruszonymi. Operacja tworzy Folder003_Copy folder, jeśli jeszcze nie istnieje.
$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
Copy-Item "D:\Folder003\" -Destination "C:\Folder003_Copy\" -ToSession $Session -Recurse
Przykład 8: Kopiowanie pliku na komputer zdalny, a następnie zmienianie nazwy pliku
Sesja jest tworzona na komputerze zdalnym o nazwie Server01
Polecenie Copy-Item cmdlet kopiuje scriptingexample.ps1 z D:\Folder004 folderu do C:\Folder004_Copy folderu na komputerze zdalnym przy użyciu informacji o sesji przechowywanych w zmiennej $Session . Oryginalny plik nie jest usuwany.
$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
Copy-Item "D:\Folder004\scriptingexample.ps1" -Destination "C:\Folder004_Copy\scriptingexample_copy.ps1" -ToSession $Session
Przykład 9. Kopiowanie pliku zdalnego na komputer lokalny
Sesja jest tworzona na komputerze zdalnym o nazwie Server01
Polecenie Copy-Item cmdlet kopiuje test.log z lokalizacji zdalnej C:\MyRemoteData\ do folderu lokalnego D:\MyLocalData przy użyciu informacji o sesji przechowywanych w zmiennej $Session . Oryginalny plik nie jest usuwany.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\test.log" -Destination "D:\MyLocalData\" -FromSession $Session
Przykład 10: Kopiowanie całej zawartości folderu zdalnego na komputer lokalny
Sesja jest tworzona na komputerze zdalnym o nazwie Server01
Polecenie Copy-Item cmdlet kopiuje całą zawartość z folderu zdalnego C:\MyRemoteData\scripts do folderu lokalnego D:\MyLocalData przy użyciu informacji o sesji przechowywanych w zmiennej $Session . Jeśli folder scripts zawiera pliki w podfolderach, te podfoldery są kopiowane ze swoimi drzewami plików nienaruszonymi.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\" -FromSession $Session
Przykład 11: Rekursywnie skopiuj całą zawartość folderu zdalnego na komputer lokalny
Sesja jest tworzona na komputerze zdalnym o nazwie Server01
Polecenie Copy-Item cmdlet kopiuje całą zawartość z folderu zdalnego C:\MyRemoteData\scripts do folderu lokalnego D:\MyLocalData\scripts przy użyciu informacji o sesji przechowywanych w zmiennej $Session .
Ponieważ jest używany parametr Recurse, operacja tworzy folder scripts, jeśli jeszcze nie istnieje. Jeśli folder scripts zawiera pliki w podfolderach, te podfoldery są kopiowane ze swoimi drzewami plików nienaruszonymi.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\scripts" -FromSession $Session -Recurse
Przykład 12: Cykliczne kopiowanie plików z drzewa folderów do bieżącego folderu
W tym przykładzie pokazano, jak skopiować pliki ze struktury folderów wieloszczepowych do pojedynczego folderu płaskiego.
Pierwsze trzy polecenia pokazują istniejącą strukturę folderów i zawartość dwóch plików, obie nazwy 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
Polecenie Copy-Item cmdlet ma parametr Container ustawiony na $falsewartość . Powoduje to skopiowanie zawartości folderu źródłowego, ale nie zachowuje struktury folderów. Zwróć uwagę, że pliki o tej samej nazwie są zastępowane w folderze docelowym.
Przykład 13. Używanie filtrów do kopiowania elementów bez rekursji
W tym przykładzie przedstawiono wyniki przy użyciu parametru Include w celu wybrania elementów do skopiowania.
W tym przykładzie użyto następującej struktury folderów zawierającej pliki do skopiowania:
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
W tym przykładzie Copy-Item jest wywoływana symbol wieloznaczny zarówno dla parametrów Path , jak i Include . Określenie symbolu wieloznakowego dla parametru Ścieżka gwarantuje, że przetwarza wszystkie pliki i foldery zgodne z D:\temp\tree\*parametrem .
Parametr Include filtruje listę elementów do przetworzenia, ograniczając operację tylko do tych ścieżek rozpoczynających się od 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 jest stosowany do zawartości D:\temp\tree folderu, aby skopiować wszystkie elementy zgodne z ex*parametrem . Zwróć uwagę, że bez rekursji D:\temp\out\examples folder jest kopiowany, ale żadna z jego zawartości nie jest kopiowana.
Przykład 14. Używanie filtrów do kopiowania elementów z rekursją
W tym przykładzie przedstawiono wyniki przy użyciu parametru Include w celu wybrania elementów do skopiowania.
W tym przykładzie użyto następującej struktury folderów zawierającej pliki do skopiowania:
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
W tym przykładzie Copy-Item jest wywoływana symbol wieloznaczny zarówno dla parametrów Path , jak i Include . Określenie symbolu wieloznakowego dla parametru Ścieżka gwarantuje, że przetwarza wszystkie pliki i foldery zgodne z D:\temp\tree\*parametrem .
Parametr Include filtruje listę elementów do przetworzenia, ograniczając operację tylko do tych ścieżek rozpoczynających się od 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 jest stosowany do zawartości D:\temp\tree folderu, aby skopiować wszystkie elementy zgodne z ex*parametrem . Zwróć uwagę, że przy rekursji D:\temp\out\examples folder jest kopiowany wraz ze wszystkimi plikami i podfolderami. Kopia zawiera pliki, które nie są zgodne z filtrem dołączania. W przypadku używania Copy-Itemfiltrów mają zastosowanie tylko do najwyższego poziomu określonego przez parametr Path . Następnie rekursja jest stosowana do tych pasujących elementów.
Uwaga
Zachowanie parametru Exclude jest takie samo, jak opisano w tym przykładzie, z tą różnicą, że ogranicza operację tylko do tych ścieżek, które nie są zgodne ze wzorcem.
Przykład 15. Ogranicz pliki do cyklicznego kopiowania ze ścieżki określonej symbolem wieloznacznymi
W tym przykładzie pokazano, jak ograniczyć pliki rekursywnie skopiowane ze ścieżki dopasowania symboli wieloznacznych do innego folderu. W przykładzie 13 pokazano, że ponieważ parametr Include filtruje tylko w ścieżkach rozpoznanych dla ścieżki określającej symbol wieloznaczny, parametr Include nie może służyć do ograniczenia plików rekursywnie kopiowanych z folderu. Zamiast tego możesz użyć Get-ChildItem polecenia , aby znaleźć elementy, które chcesz skopiować i przekazać te elementy do elementu Copy-Item.
W tym przykładzie użyto następującej struktury folderów zawierającej pliki do skopiowania:
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
Aby skopiować wszystkie elementy rozpoczynające się od ex*elementu , użyj parametrów Get-ChildItem Recurse i Filter i potoku wyników do 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
W przeciwieństwie do parametru Copy-Item, parametr Filter dla Get-ChildItem programu ma zastosowanie do elementów odnalezionych podczas rekursji. Dzięki temu można wyszukiwać, filtrować i kopiować elementy rekursywnie.
Parametry
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Container
Wskazuje, że to polecenie cmdlet zachowuje obiekty kontenera podczas operacji kopiowania. Domyślnie parametr kontenera ma wartość True.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | True |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Credential
Uwaga
Ten parametr nie jest obsługiwany przez żadnych dostawców zainstalowanych w programie PowerShell. Aby personifikować innego użytkownika lub podnieść poziom poświadczeń podczas uruchamiania tego polecenia cmdlet, użyj polecenia Invoke-Command.
Właściwości parametru
| Typ: | PSCredential |
| Domyślna wartość: | Current user |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Destination
Określa ścieżkę do nowej lokalizacji. Domyślnie jest to katalog bieżący.
Aby zmienić nazwę skopiowanego elementu, określ nową nazwę w wartości parametru Destination .
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | Current directory |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 1 |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Exclude
Określa co najmniej jeden element ścieżki lub wzorce, takie jak "*.txt", aby ograniczyć operację tego polecenia cmdlet. Wartość tego parametru filtruje względem wyniku dopasowywania symboli wieloznacznych parametru Path , a nie wyników końcowych. Ten parametr jest skuteczny tylko wtedy, gdy ścieżka jest określona z co najmniej jednym symbolem wieloznacznymi. Ponieważ ten parametr filtruje tylko ścieżki rozpoznane dla parametru Ścieżka , nie filtruje żadnych elementów odnalezionych podczas powtarzania za pomocą folderów podrzędnych za pomocą parametru Recurse .
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Filter
Określa filtr, aby zakwalifikować parametr Ścieżka . Dostawca systemu plików jest jedynym zainstalowanym dostawcą programu PowerShell, który obsługuje korzystanie z filtrów. Składnię języka filtru Systemu plików można znaleźć w about_Wildcards. Filtry są bardziej wydajne niż inne parametry, ponieważ dostawca stosuje je, gdy polecenie cmdlet pobiera obiekty, zamiast filtrować obiekty programu PowerShell po ich pobraniu.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Force
Wskazuje, że to polecenie cmdlet kopiuje elementy, których nie można zmienić w inny sposób, na przykład kopiowanie pliku lub aliasu tylko do odczytu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-FromSession
Jest to parametr dynamiczny udostępniany przez dostawcę systemu plików.
Określ obiekt PSSession, z którego jest kopiowany plik zdalny. W przypadku użycia tego parametru parametry Path i LiteralPath odwołują się do ścieżki lokalnej na maszynie zdalnej.
Aby uzyskać więcej informacji, zobacz about_FileSystem_Provider.
Właściwości parametru
| Typ: | PSSession |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Include
Określa co najmniej jeden element ścieżki lub wzorce, takie jak "*.txt", aby ograniczyć operację tego polecenia cmdlet. Wartość tego parametru filtruje względem wyniku dopasowywania symboli wieloznacznych parametru Path , a nie wyników końcowych. Ten parametr jest skuteczny tylko wtedy, gdy ścieżka jest określona z co najmniej jednym symbolem wieloznacznymi. Ponieważ ten parametr filtruje tylko ścieżki rozpoznane dla parametru Ścieżka , nie filtruje żadnych elementów odnalezionych podczas powtarzania za pomocą folderów podrzędnych za pomocą parametru Recurse .
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-LiteralPath
Określa ścieżkę do co najmniej jednej lokalizacji. Wartość LiterałuPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze znaki cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.
Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Zestawy parametrów
LiteralPath
| Position: | Named |
| Obowiązkowe: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-PassThru
Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Path
Określa jako tablicę ciągów ścieżkę do elementów do skopiowania. Dozwolone są symbole wieloznaczne.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
Zestawy parametrów
Path
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Recurse
Wskazuje, że to polecenie cmdlet wykonuje cykliczną kopię.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ToSession
Jest to parametr dynamiczny udostępniany przez dostawcę systemu plików.
Określ obiekt PSSession, do którego jest kopiowany plik zdalny. Jeśli używasz tego parametru , parametr Docelowy odwołuje się do ścieżki lokalnej na maszynie zdalnej.
Aby uzyskać więcej informacji, zobacz about_FileSystem_Provider.
Właściwości parametru
| Typ: | PSSession |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-UseTransaction
Zawiera polecenie w aktywnej transakcji. Ten parametr jest prawidłowy tylko wtedy, gdy transakcja jest w toku. Aby uzyskać więcej informacji, zobacz about_Transactions.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | usetx |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
String
Możesz potokować ciąg zawierający ścieżkę do tego polecenia cmdlet.
Dane wyjściowe
None
Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.
PSObject
Jeśli używasz parametru PassThru , to polecenie cmdlet zwraca obiekt reprezentujący skopiowany element.
Uwagi
Program Windows PowerShell zawiera następujące aliasy dla programu Copy-Item:
copycpcpi
To polecenie cmdlet jest przeznaczone do pracy z danymi udostępnianymi przez dowolnego dostawcę. Aby wyświetlić listę dostawców dostępnych w sesji, wpisz Get-PSProvider. Aby uzyskać więcej informacji, zobacz about_Providers.
