Kopiert ein Element innerhalb eines Namespaces von einem Speicherort an einen anderen Speicherort.
Syntax
Copy-Item [-LiteralPath] <string[]> [[-Destination] <string>] [-Container] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Recurse] [-Bestätigung] [-WhatIf] [-UseTransaction] [<CommonParameters>] Copy-Item [-Path] <string[]> [[-Destination] <string>] [-Container] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Recurse] [-Bestätigung] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Beschreibung
Das Cmdlet "Copy-Item" kopiert ein Element innerhalb eines Namespaces von einem Speicherort an einen anderen Speicherort. Durch Copy-Item werden die kopierten Elemente nicht gelöscht. Die Elemente, die vom Cmdlet kopiert werden können, hängen von den verfügbaren Windows PowerShell-Anbietern ab. Wenn beispielsweise der FileSystem-Anbieter verwendet wird, können Dateien und Verzeichnisse kopiert werden. Bei Verwendung mit dem Registry-Anbieter können Registrierungsschlüssel und -einträge kopiert werden.
Parameter
-Container
Behält Containerobjekte während des Kopiervorgangs bei.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Credential <PSCredential>
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01", oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Cmdlet "Get-Credential" generiertes Objekt. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Dieser Parameter wird nicht von mit Windows PowerShell installierten Anbietern unterstützt.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Destination <string>
Gibt den Pfad zu dem Speicherort an, an den die Elemente kopiert werden sollen.
|
Erforderlich? |
false |
|
Position? |
2 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Exclude <string[]>
Lässt die angegebenen Elemente aus. Platzhalter sind zulässig.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Filter <string>
Gibt einen Filter im Format oder in der Sprache des Anbieters an. Der Path-Parameter wird durch den Wert dieses Parameters qualifiziert. Die Syntax des Filters einschließlich der Verwendung von Platzhaltern ist vom Anbieter abhängig. Filter sind effizienter als andere Parameter, da sie beim Abrufen der Objekte vom Anbieter angewendet werden und die Objekte nicht erst nach dem Abrufen von Windows PowerShell gefiltert werden.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Force
Ermöglicht dem Cmdlet das Kopieren von Elementen, die anderweitig nicht geändert werden können, z. B. das Kopieren über eine schreibgeschützte Datei oder einen schreibgeschützten Alias.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Include <string[]>
Gibt nur die Elemente an, auf die das Cmdlet angewendet wird, und schließt alle anderen aus.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-LiteralPath <string[]>
Gibt den Pfad zum Element an. Der Wert des LiteralPath-Parameters wird genau so verwendet, wie er eingegeben wurde. 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 veranlassen Windows PowerShell, Zeichen nicht als Escapesequenzen zu interpretieren.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-PassThru
Gibt ein Objekt zurück, das jedes kopierte Element darstellt. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Path <string[]>
Gibt den Pfad zu den zu kopierenden Elementen an.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue, ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Recurse
Gibt einen rekursiven Kopiervorgang an.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-UseTransaction
Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter "about_Transactions".
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.String Sie können eine Zeichenfolge mit einem Pfad über die Pipeline an Copy-ItemProperty übergeben. |
|
Ausgaben |
Keiner oder ein Objekt, das das kopierte Element darstellt. Wenn Sie den PassThru-Parameter verwenden, gibt Copy-Item ein Objekt zurück, das das kopierte Element darstellt. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert. |
Hinweise
Copy-Item entspricht den Befehlen "cp" oder "copy" in anderen Shells.
Das Cmdlet "Copy-Item" ist für die Verwendung mit Daten konzipiert, die von beliebigen Anbietern verfügbar gemacht werden. Um die in der Sitzung verfügbaren Anbieter aufzuführen, geben Sie "Get-PsProvider" ein. Weitere Informationen finden Sie unter "about_Providers".
Beispiel 1
C:\PS>copy-item C:\Wabash\Logfiles\mar1604.log.txt -destination C:\Presentation Beschreibung ----------- Mit diesem Befehl wird die Datei "mar1604.log.txt" in das Verzeichnis "C:\Presentation" kopiert. Die ursprüngliche Datei wird durch den Befehl nicht gelöscht.
Beispiel 2
C:\PS>copy-item C:\Logfiles -destination C:\Drawings -recurse Beschreibung ----------- Mit diesem Befehl wird der gesamte Inhalt des Verzeichnisses "Logfiles" in das Verzeichnis "Drawings" kopiert. Wenn im Quellverzeichnis Dateien in Unterverzeichnissen vorhanden sind, werden diese Unterverzeichnisse unter Beibehaltung der Dateistruktur kopiert. Der Container-Parameter ist standardmäßig auf "True" festgelegt. Dadurch bleibt die Verzeichnisstruktur erhalten.
Beispiel 3
C:\PS>copy-item C:\Logfiles -destination C:\Drawings\Logs -recurse Beschreibung ----------- Mit diesem Befehl wird der gesamte Inhalt des Verzeichnisses "C:\Logfiles" in das Verzeichnis "C:\Drawings\Logs" kopiert. Dabei wird das Unterverzeichnis "\Logs" erstellt, wenn es nicht bereits vorhanden ist.
Siehe auch