Freigeben über

Copy-Item

  • Referenz
Modul:
Microsoft.PowerShell.Management

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

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" -Recurse

Hinweis

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" -Recurse

Hinweis

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 $Session

Beispiel 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 $Session

Beispiel 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 -Recurse

Beispiel 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 $Session

Beispiel 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 $Session

Beispiel 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 $Session

Beispiel 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 -Recurse

Beispiel 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 subfolder

Das 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.ps1
  • D:\temp\tree\example.txt
  • D:\temp\tree\examples\
  • D:\temp\tree\examples\example_1.txt
  • D:\temp\tree\examples\example_2.txt
  • D:\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.txt

Der 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.ps1
  • D:\temp\tree\example.txt
  • D:\temp\tree\examples\
  • D:\temp\tree\examples\example_1.txt
  • D:\temp\tree\examples\example_2.txt
  • D:\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.txt

Der 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.ps1
  • D:\temp\tree\example.txt
  • D:\temp\tree\examples\
  • D:\temp\tree\examples\example_1.txt
  • D:\temp\tree\examples\example_2.txt
  • D:\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.txt

Copy-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, LP
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

-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

String

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.

PSObject

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet ein Objekt zurück, das das kopierte Element darstellt.

Hinweise

PowerShell enthält die folgenden Aliase für Copy-Item:

  • Alle Plattformen:
    • copy
    • cpi
  • Windows:
    • cp

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.