Copy-Item
Kopiert ein Element von einem Speicherort an einen anderen Speicherort.
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>]Copy-Item
[-Path] <String[]>
[[-Destination] <String>]
[-Container]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Recurse]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]Copy-Item
-LiteralPath <String[]>
[[-Destination] <String>]
[-Container]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Recurse]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]Beschreibung
Das Copy-Item Cmdlet kopiert ein Element von einem Speicherort an einen anderen Speicherort im selben Namespace.
Beispielsweise kann sie eine Datei in einen Ordner kopieren, aber sie kann eine Datei nicht auf ein Zertifikatlaufwerk kopieren.
Mit diesem Cmdlet werden die kopierten Elemente nicht ausgeschnitten oder gelöscht. Die einzelnen Elemente, die das Cmdlet kopieren kann, hängen vom PowerShell-Anbieter ab, der das Element verfügbar macht. Sie kann z. B. Dateien und Verzeichnisse in einem Dateisystemlaufwerk und Registrierungsschlüssel und Einträge auf dem Registrierungslaufwerk kopieren.
Dieses Cmdlet kann Elemente im selben Befehl kopieren und umbenennen. Um ein Element umzubenennen, geben Sie den neuen Namen in den Wert des Destination-Parameters ein. Verwenden Sie das Rename-Item Cmdlet, um ein Element umzubenennen und es nicht zu kopieren.
Beispiele
Beispiel 1: Kopieren einer Datei in das angegebene Verzeichnis
In diesem Beispiel wird die mar1604.log.txt Datei in das C:\Presentation Verzeichnis kopiert. Die ursprüngliche Datei wird nicht gelöscht.
Copy-Item "C:\Wabash\Logfiles\mar1604.log.txt" -Destination "C:\Presentation"Beispiel 2: Kopieren von Verzeichnisinhalten in ein vorhandenes Verzeichnis
In diesem Beispiel wird der Inhalt des C:\Logfiles Verzeichnisses in das vorhandene C:\Drawings Verzeichnis kopiert. Das Logfiles Verzeichnis wird nicht kopiert.
Wenn das Logfiles Verzeichnis Dateien in Unterverzeichnissen enthält, werden diese Unterverzeichnisse mit ihren Dateistrukturen kopiert. Der Container-Parameter ist standardmäßig auf "True" festgelegt, wodurch die Verzeichnisstruktur erhalten bleibt.
Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings" -RecurseHinweis
Wenn der Pfad C:\Drawings nicht vorhanden ist, kopiert das Cmdlet alle Dateien aus der Logfiles Ordnerstruktur in einen einzelnen Ordner C:\Drawings, wobei alle Dateien mit demselben Namen überschrieben werden.
Beispiel 3: Kopieren von Verzeichnis und Inhalt in ein neues Verzeichnis
In diesem Beispiel wird der Inhalt des C:\Logfiles Quellverzeichnisses kopiert und ein neues Zielverzeichnis erstellt. Das neue Zielverzeichnis \Logs wird in C:\Drawingserstellt.
Um den Namen des Quellverzeichnisses einzuschließen, kopieren Sie wie in Beispiel 2 dargestellt in ein vorhandenes Zielverzeichnis. Oder benennen Sie das neue Zielverzeichnis mit dem Quellverzeichnis.
Copy-Item -Path "C:\Logfiles" -Destination "C:\Drawings\Logs" -RecurseHinweis
Wenn der Pfad enthält \*, werden alle Dateiinhalte des Verzeichnisses, einschließlich der Unterverzeichnisstrukturen, in das neue Zielverzeichnis kopiert. Zum Beispiel:
Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings\Logs" -Recurse
Beispiel 4: Kopieren einer Datei in das angegebene Verzeichnis und Umbenennen der Datei
In diesem Beispiel wird das Copy-Item Cmdlet verwendet, um das Get-Widget.ps1 Skript aus dem \\Server01\Share Verzeichnis in das \\Server12\ScriptArchive Verzeichnis zu kopieren. Im Rahmen des Kopiervorgangs ändert der Befehl den Elementnamen in Get-Widget.ps1 Get-Widget.ps1.txt", sodass er sicher an E-Mail-Nachrichten angefügt werden kann.
Copy-Item "\\Server01\Share\Get-Widget.ps1" -Destination "\\Server12\ScriptArchive\Get-Widget.ps1.txt"Beispiel 5: Kopieren einer Datei auf einen Remotecomputer
Eine Sitzung wird auf dem Remotecomputer mit dem Namen Server01 mit den Anmeldeinformationen Contoso\User01 erstellt und speichert die Ergebnisse in der Variablen namens $Session.
Das Copy-Item Cmdlet kopiert test.log den Ordner mithilfe der sitzungsinformationen, die in der $Session Variablen gespeichert sind, aus dem D:\Folder001 Ordner in den C:\Folder001_Copy Ordner auf dem Remotecomputer. Die ursprüngliche Datei wird nicht gelöscht.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "D:\Folder001\test.log" -Destination "C:\Folder001_Copy\" -ToSession $SessionBeispiel 6: Kopieren eines Ordners auf einen Remotecomputer
Eine Sitzung wird auf dem Remotecomputer mit dem Namen Server01 mit den Anmeldeinformationen Contoso\User01 erstellt und speichert die Ergebnisse in der Variablen namens $Session.
Das Copy-Item Cmdlet kopiert den Ordner mithilfe der D:\Folder002 in der $Session Variablen gespeicherten Sitzungsinformationen in das C:\Folder002_Copy Verzeichnis auf dem Remotecomputer. Alle Unterordner oder Dateien werden nicht kopiert, ohne die Option "Rekurse " zu verwenden. Der Vorgang erstellt den Folder002_Copy Ordner, falls er noch nicht vorhanden ist.
$Session = New-PSSession -ComputerName "Server02" -Credential "Contoso\User01"
Copy-Item "D:\Folder002\" -Destination "C:\Folder002_Copy\" -ToSession $SessionBeispiel 7: Rekursives Kopieren des gesamten Inhalts eines Ordners auf einen Remotecomputer
Eine Sitzung wird auf dem Remotecomputer mit dem Namen Server01 mit den Anmeldeinformationen Contoso\User01 erstellt und speichert die Ergebnisse in der Variablen namens $Session.
Das Copy-Item Cmdlet kopiert den gesamten Inhalt aus dem D:\Folder003 Ordner in das C:\Folder003_Copy Verzeichnis auf dem Remotecomputer mithilfe der sitzungsinformationen, die in der $Session Variablen gespeichert sind. Die Unterordner werden mit ihren Dateistrukturen kopiert. Der Vorgang erstellt den Folder003_Copy Ordner, falls er noch nicht vorhanden ist.
$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
Copy-Item "D:\Folder003\" -Destination "C:\Folder003_Copy\" -ToSession $Session -RecurseBeispiel 8: Kopieren einer Datei auf einen Remotecomputer und Umbenennen der Datei
Eine Sitzung wird auf dem Remotecomputer mit dem Namen Server01 mit den Anmeldeinformationen Contoso\User01 erstellt und speichert die Ergebnisse in der Variablen namens $Session.
Das Copy-Item Cmdlet kopiert scriptingexample.ps1 den Ordner mithilfe der sitzungsinformationen, die in der $Session Variablen gespeichert sind, aus dem D:\Folder004 Ordner in den C:\Folder004_Copy Ordner auf dem Remotecomputer. Die ursprüngliche Datei wird nicht gelöscht.
$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
Copy-Item "D:\Folder004\scriptingexample.ps1" -Destination "C:\Folder004_Copy\scriptingexample_copy.ps1" -ToSession $SessionBeispiel 9: Kopieren einer Remotedatei auf den lokalen Computer
Eine Sitzung wird auf dem Remotecomputer mit dem Namen Server01 mit den Anmeldeinformationen Contoso\User01 erstellt und speichert die Ergebnisse in der Variablen namens $Session.
Das Copy-Item Cmdlet kopiert test.log aus dem Remotebereich C:\MyRemoteData\ in den lokalen D:\MyLocalData Ordner mithilfe der sitzungsinformationen, die in der $Session Variablen gespeichert sind. Die ursprüngliche Datei wird nicht gelöscht.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\test.log" -Destination "D:\MyLocalData\" -FromSession $SessionBeispiel 10: Kopieren des gesamten Inhalts eines Remoteordners auf den lokalen Computer
Eine Sitzung wird auf dem Remotecomputer mit dem Namen Server01 mit den Anmeldeinformationen Contoso\User01 erstellt und speichert die Ergebnisse in der Variablen namens $Session.
Das Copy-Item Cmdlet kopiert den gesamten Inhalt aus dem Remoteordner C:\MyRemoteData\scripts mithilfe der sitzungsinformationen, die in der $Session Variablen gespeichert sind, in den lokalen D:\MyLocalData Ordner. Wenn der Skriptordner Dateien in Unterordnern enthält, werden diese Unterordner mit ihren Dateistrukturen kopiert.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\" -FromSession $SessionBeispiel 11: Rekursives Kopieren des gesamten Inhalts eines Remoteordners auf den lokalen Computer
Eine Sitzung wird auf dem Remotecomputer mit dem Namen Server01 mit den Anmeldeinformationen Contoso\User01 erstellt und speichert die Ergebnisse in der Variablen namens $Session.
Das Copy-Item Cmdlet kopiert den gesamten Inhalt aus dem Remoteordner C:\MyRemoteData\scripts mithilfe der sitzungsinformationen, die in der $Session Variablen gespeichert sind, in den lokalen D:\MyLocalData\scripts Ordner. Da der Recurse-Parameter verwendet wird, erstellt der Vorgang den Skriptordner, wenn er noch nicht vorhanden ist. Wenn der Skriptordner Dateien in Unterordnern enthält, werden diese Unterordner mit ihren Dateistrukturen kopiert.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\scripts" -FromSession $Session -RecurseBeispiel 12: Rekursives Kopieren von Dateien aus einer Ordnerstruktur in den aktuellen Ordner
In diesem Beispiel wird gezeigt, wie Dateien aus einer Ordnerstruktur mit mehreren Ebenen in einen einzelnen flachen Ordner kopiert werden.
Die ersten drei Befehle zeigen die vorhandene Ordnerstruktur und den Inhalt von zwei Dateien, beide Namen 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 subfolderDas Copy-Item Cmdlet hat den Parameter Container auf festgelegt $false. Dies bewirkt, dass der Inhalt des Quellordners kopiert wird, die Ordnerstruktur jedoch nicht erhalten bleibt. Beachten Sie, dass Dateien mit demselben Namen im Zielordner überschrieben werden.
Beispiel 13: Verwenden von Filtern zum Kopieren von Elementen ohne Rekursion
Dieses Beispiel zeigt die Ergebnisse mithilfe des Include-Parameters , um die zu kopierenden Elemente auszuwählen.
In diesem Beispiel wird die folgende Ordnerstruktur verwendet, die die zu kopierenden Dateien enthält:
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
In diesem Beispiel Copy-Item wird ein Wildcard für die Parameter "Path " und "Include " aufgerufen. Durch Angeben eines Wildcards für den Path-Parameter wird sichergestellt, dass alle Dateien und Ordner verarbeitet werden, die übereinstimmen D:\temp\tree\*. Der Include-Parameter filtert die Liste der zu verarbeitenden Elemente, wobei der Vorgang nur auf die Pfade beschränkt wird, die mit 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.txtDer Include-Parameter wird auf den Inhalt des D:\temp\tree Ordners angewendet, um alle übereinstimmenden ex*Elemente zu kopieren. Beachten Sie, dass der D:\temp\out\examples Ordner ohne Rekursion kopiert wird, aber keiner seiner Inhalte kopiert wird.
Beispiel 14: Verwenden von Filtern zum Kopieren von Elementen mit Rekursion
Dieses Beispiel zeigt die Ergebnisse mithilfe des Include-Parameters , um die zu kopierenden Elemente auszuwählen.
In diesem Beispiel wird die folgende Ordnerstruktur verwendet, die die zu kopierenden Dateien enthält:
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
In diesem Beispiel Copy-Item wird ein Wildcard für die Parameter "Path " und "Include " aufgerufen. Durch Angeben eines Wildcards für den Parameter "Path " wird sichergestellt, dass alle Dateien und Ordner verarbeitet werden, die übereinstimmen D:\temp\tree\*. Der Include-Parameter filtert die Liste der zu verarbeitenden Elemente, wobei der Vorgang nur auf die Pfade beschränkt wird, die mit 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.txtDer Include-Parameter wird auf den Inhalt des D:\temp\tree Ordners angewendet, um alle übereinstimmenden ex*Elemente zu kopieren. Beachten Sie, dass mit rekursion der D:\temp\out\examples Ordner zusammen mit allen Dateien und Unterordnern kopiert wird. Die Kopie enthält Dateien, die nicht mit dem Includefilter übereinstimmen. Bei Verwendung Copy-Itemgelten die Filter nur für die oberste Ebene, die durch den Path-Parameter angegeben wird. Anschließend wird rekursion auf diese übereinstimmenden Elemente angewendet.
Hinweis
Das Verhalten des Exclude-Parameters entspricht der in diesem Beispiel beschriebenen Vorgehensweise, mit der Ausnahme, dass der Vorgang nur auf die Pfade beschränkt wird, die nicht mit dem Muster übereinstimmen.
Beispiel 15: Beschränken der Dateien auf rekursives Kopieren aus einem durch Einen Wildcard angegebenen Pfad
In diesem Beispiel wird gezeigt, wie Sie die Dateien rekursiv aus einem Pfad mit Einem Wildcardabgleich in einen anderen Ordner kopieren. In Beispiel 13 wird gezeigt, dass der Include-Parameter nur Filter auf den Pfaden filtert, die für einen pfad angebenden Pfad aufgelöst wurden, der Include-Parameter kann nicht verwendet werden, um die Dateien rekursiv aus einem Ordner zu beschränken. Stattdessen können Get-ChildItem Sie die Elemente suchen, die Sie kopieren und an diese Elemente Copy-Itemübergeben möchten.
In diesem Beispiel wird die folgende Ordnerstruktur verwendet, die die zu kopierenden Dateien enthält:
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
Verwenden Sie Get-ChildItem zum Kopieren aller Elemente, die mit ex*den Parametern "Recurse" und "Filter" beginnen, und führen Sie die Ergebnisse an 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.txtCopy-ItemIm Gegensatz zum Parameter "Filter" für Get-ChildItem die elemente, die während der Rekursion ermittelt wurden. Auf diese Weise können Sie Elemente rekursiv suchen, filtern und dann kopieren.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Container
Gibt an, dass dieses Cmdlet Containerobjekte während des Kopiervorgangs behält. Der Container-Parameter ist standardmäßig auf "True" festgelegt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | True |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Credential
Hinweis
Dieser Parameter wird von anbietern, die mit PowerShell installiert sind, nicht unterstützt. Verwenden Sie "Invoke-Command", um die Identität eines anderen Benutzers zu imitieren oder Ihre Anmeldeinformationen beim Ausführen dieses Cmdlets zu erhöhen.
| Typ: | PSCredential |
| Position: | Named |
| Standardwert: | Current user |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Destination
Gibt den Pfad zum neuen Speicherort an. Der Standardwert ist das aktuelle Verzeichnis.
Um das kopierte Element umzubenennen, geben Sie einen neuen Namen im Wert des Destination-Parameters an.
| Typ: | String |
| Position: | 1 |
| Standardwert: | Current directory |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Exclude
Gibt ein oder mehrere Pfadelemente oder Muster an, z "*.txt". B. zum Einschränken des Vorgangs dieses Cmdlets. Der Wert dieses Parameters filtert nach dem Ergebnis des Pfadparameters und nicht nach den endgültigen Ergebnissen. Dieser Parameter ist nur wirksam, wenn der Pfad mit einem oder mehreren Wildcards angegeben wird. Da dieser Parameter nur nach den Pfaden filtert, die für den Path-Parameter aufgelöst wurden, werden keine Elemente gefiltert, die beim Rekursieren durch untergeordnete Ordner mit dem Recurse-Parameter ermittelt werden.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | True |
-Filter
Gibt einen Filter an, um den Path-Parameter zu qualifizieren. Der FileSystem-Anbieter ist der einzige installierte PowerShell-Anbieter, der die Verwendung von Filtern unterstützt. Die Syntax für die Dateisystemfiltersprache finden Sie in about_Wildcards. Filter sind effizienter als andere Parameter, da der Anbieter sie anwendet, wenn das Cmdlet die Objekte abruft, anstatt powerShell nach dem Abrufen der Objekte zu filtern.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | True |
-Force
Gibt an, dass dieses Cmdlet Elemente kopiert, die andernfalls nicht geändert werden können, z. B. das Kopieren über eine schreibgeschützte Datei oder einen Alias.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-FromSession
Dies ist ein dynamischer Parameter, der vom FileSystem-Anbieter zur Verfügung gestellt wird.
Geben Sie das PSSession-Objekt an, aus dem eine Remotedatei kopiert wird. Wenn Sie diesen Parameter verwenden, verweisen die Parameter Path und LiteralPath auf den lokalen Pfad auf dem Remotecomputer.
Weitere Informationen finden Sie unter about_FileSystem_Provider.
| Typ: | PSSession |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Include
Gibt ein oder mehrere Pfadelemente oder Muster an, z "*.txt". B. zum Einschränken des Vorgangs dieses Cmdlets. Der Wert dieses Parameters filtert nach dem Ergebnis des Pfadparameters und nicht nach den endgültigen Ergebnissen. Dieser Parameter ist nur wirksam, wenn der Pfad mit einem oder mehreren Wildcards angegeben wird. Da dieser Parameter nur nach den Pfaden filtert, die für den Path-Parameter aufgelöst wurden, werden keine Elemente gefiltert, die beim Rekursieren durch untergeordnete Ordner mit dem Recurse-Parameter ermittelt werden.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | True |
-LiteralPath
Gibt einen Pfad zu einem oder mehreren Speicherorten an. Der Wert von LiteralPath wird genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.
Weitere Informationen finden Sie unter about_Quoting_Rules.
| Typ: | String[] |
| Aliase: | PSPath |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-PassThru
Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet keine Ausgabe.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Path
Gibt als Zeichenfolgenarray den Pfad zu den zu kopierenden Elementen an. Platzhalterzeichen sind zulässig.
| Typ: | String[] |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | True |
-Recurse
Gibt an, dass dieses Cmdlet eine rekursive Kopie ausführt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ToSession
Dies ist ein dynamischer Parameter, der vom FileSystem-Anbieter zur Verfügung gestellt wird.
Geben Sie das PSSession-Objekt an, in das eine Remotedatei kopiert wird. Wenn Sie diesen Parameter verwenden, bezieht sich der Destination-Parameter auf den lokalen Pfad auf dem Remotecomputer.
Weitere Informationen finden Sie unter about_FileSystem_Provider.
| Typ: | PSSession |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseTransaction
Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn gerade eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter about_Transactions.
| Typ: | SwitchParameter |
| Aliase: | usetx |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
Sie können eine Zeichenfolge weiterleiten, die einen Pfad zu diesem Cmdlet enthält.
Ausgaben
None
Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.
Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet ein Objekt zurück, das das kopierte Element darstellt.
Hinweise
Windows PowerShell enthält die folgenden Aliase für Copy-Item:
copycpcpi
Dieses Cmdlet wurde entwickelt, um mit den Daten zu arbeiten, die von einem beliebigen Anbieter verfügbar gemacht werden. Geben Sie ein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können Get-PSProvider. Weitere Informationen finden Sie unter about_Providers.
