Copy-Item

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 gleichen Namespace. Für instance kann es eine Datei in einen Ordner kopieren, aber keine Datei auf ein Zertifikatlaufwerk kopieren.

Dieses Cmdlet schneidet oder löscht die kopierten Elemente nicht. Welche Elemente das Cmdlet kopieren kann, hängt vom PowerShell-Anbieter ab, der das Element verfügbar macht. Für instance können Dateien und Verzeichnisse auf einem Dateisystemlaufwerk sowie Registrierungsschlüssel und Einträge auf dem Registrierungslaufwerk kopiert werden.

Dieses Cmdlet kann Elemente im selben Befehl kopieren und umbenennen. Um ein Element umzubenennen, geben Sie den neuen Namen im Wert des Zielparameters ein. Verwenden Sie das Rename-Item Cmdlet, um ein Element umzubenennen und 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 intakter Dateistruktur kopiert. Standardmäßig ist der Container-Parameter auf True festgelegt, wodurch die Verzeichnisstruktur beibehalten wird.

Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings" -Recurse

Hinweis

Wenn der Pfad C:\Drawings nicht vorhanden ist, kopiert das Cmdlet alle Dateien aus dem Logfiles Ordner in eine einzelne Datei C:\Drawings.

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 in ein vorhandenes Zielverzeichnis, wie in Beispiel 2 gezeigt. Oder benennen Sie das neue Zielverzeichnis mit demselben wie das 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. 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 von Get-Widget.ps1 in 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

Auf dem Remotecomputer wird eine Sitzung mit dem Namen Server01 mit den Anmeldeinformationen von Contoso\User01 erstellt und speichert die Ergebnisse in der Variablen namens $Session.

Das Copy-Item Cmdlet kopiert test.log aus dem D:\Folder001 Ordner unter Verwendung der C:\Folder001_Copy in der Variablen gespeicherten Sitzungsinformationen in den Ordner auf dem $Session 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

Auf dem Remotecomputer wird eine Sitzung mit dem Namen Server01 mit den Anmeldeinformationen von Contoso\User01 erstellt und speichert die Ergebnisse in der Variablen namens $Session.

Das Copy-Item Cmdlet kopiert den D:\Folder002 Ordner mithilfe der in der C:\Folder002_Copy Variablen gespeicherten Sitzungsinformationen in das Verzeichnis auf dem $Session Remotecomputer. Alle Unterordner oder Dateien werden nicht kopiert, ohne den Schalter Recurse zu verwenden. Der Vorgang erstellt den Folder002_Copy Ordner, wenn 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

Auf dem Remotecomputer wird eine Sitzung mit dem Namen Server01 mit den Anmeldeinformationen von 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 unter Verwendung der C:\Folder003_Copy in der Variablen gespeicherten Sitzungsinformationen in das Verzeichnis auf dem $Session Remotecomputer. Die Unterordner werden mit intakten Dateistrukturen kopiert. Der Vorgang erstellt den Folder003_Copy Ordner, wenn 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 anschließendes Umbenennen der Datei

Auf dem Remotecomputer wird eine Sitzung mit dem Namen Server01 mit den Anmeldeinformationen von Contoso\User01 erstellt und speichert die Ergebnisse in der Variablen namens $Session.

Das Copy-Item Cmdlet kopiert scriptingexample.ps1 aus dem D:\Folder004 Ordner unter Verwendung der C:\Folder004_Copy in der Variablen gespeicherten Sitzungsinformationen in den Ordner auf dem $Session 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

Auf dem Remotecomputer wird eine Sitzung mit dem Namen Server01 mit den Anmeldeinformationen von Contoso\User01 erstellt und speichert die Ergebnisse in der Variablen namens $Session.

Das Copy-Item Cmdlet kopiert test.log aus dem Remoteordner C:\MyRemoteData\ unter Verwendung der in der Variablen gespeicherten Sitzungsinformationen in den $Session lokalen D:\MyLocalData Ordner. 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

Auf dem Remotecomputer wird eine Sitzung mit dem Namen Server01 mit den Anmeldeinformationen von 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 unter Verwendung der in der Variablen gespeicherten Sitzungsinformationen in den $Session lokalen D:\MyLocalData Ordner. Wenn der Skriptordner Dateien in Unterordnern enthält, werden diese Unterordner mit intakter Dateistruktur 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

Auf dem Remotecomputer wird eine Sitzung mit dem Namen Server01 mit den Anmeldeinformationen von 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 unter Verwendung der in der Variablen gespeicherten Sitzungsinformationen in den $Session lokalen D:\MyLocalData\scripts Ordner. Da der Recurse-Parameter verwendet wird, erstellt der Vorgang den Skriptordner, sofern er noch nicht vorhanden ist. Wenn der Skriptordner Dateien in Unterordnern enthält, werden diese Unterordner mit intakter Dateistruktur 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 an.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

Für Copy-Item das Cmdlet ist der Container-Parameter auf $falsefestgelegt. Dadurch wird der Inhalt des Quellordners kopiert, die Ordnerstruktur wird jedoch nicht beibehalten. 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, die den Include-Parameter verwenden, 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 mit einem Feldhalter für die Parameter Path und Include aufgerufen. Durch Das Angeben eines Feldhalters für den Path-Parameter wird sichergestellt, dass alle Dateien und Ordner verarbeitet werden, die mit übereinstimmen D:\temp\tree\*. Der Include-Parameter filtert die Liste der zu verarbeitenden Elemente und beschränkt den Vorgang auf nur die Pfade, die mit exbeginnen.

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 Ordners D:\temp\tree angewendet, um alle Elemente zu kopieren, die mit übereinstimmen ex*. 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, die den Include-Parameter verwenden, 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 mit einem Feldhalter für die Parameter Path und Include aufgerufen. Durch Das Angeben eines Feldhalters für den Path-Parameter wird sichergestellt, dass alle Dateien und Ordner verarbeitet werden, die mit übereinstimmen D:\temp\tree\*. Der Include-Parameter filtert die Liste der zu verarbeitenden Elemente und beschränkt den Vorgang auf nur die Pfade, die mit exbeginnen.

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 Ordners D:\temp\tree angewendet, um alle Elemente zu kopieren, die mit übereinstimmen ex*. Beachten Sie, dass der D:\temp\out\examples Ordner mit der Rekursion 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 die Rekursion auf diese übereinstimmenden Elemente angewendet.

Hinweis

Das Verhalten des Exclude-Parameters ist dasselbe wie in diesem Beispiel beschrieben, mit dem Unterschied, 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 angegebenen Pfad

In diesem Beispiel wird gezeigt, wie sie die Dateien einschränken, die rekursiv aus einem Pfad mit dem Abgleich mit dem Feldhalter in einen anderen Ordner kopiert werden. Beispiel 13 zeigt, dass der Include-Parameter nicht zum Einschränken der rekursiv aus einem Ordner kopierten Dateien verwendet werden kann, da der Include-Parameter nur nach den Pfaden filtert, die für einen Pfad aufgelöst werden. Stattdessen können Sie verwenden Get-ChildItem , um die Elemente zu suchen, die Sie kopieren möchten, und diese Elemente an übergeben Copy-Item.

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

Um alle Elemente zu kopieren, die mit ex*beginnen, verwenden Sie Get-ChildItem mit den Parametern Recurse und Filter , und leiten Sie die Ergebnisse an weiter 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 zu gilt der Filter-Parameter für Get-ChildItem für die Elemente, die während der Rekursion ermittelt werden. Dadurch 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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Container

Gibt an, dass dieses Cmdlet Containerobjekte während des Kopiervorgangs bei behält. Standardmäßig ist der Container-Parameter auf True festgelegt.

Type:	SwitchParameter
Position:	Named
Default value:	True
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 annehmen oder Ihre Anmeldeinformationen beim Ausführen dieses Cmdlets zu erhöhen.

Type:	PSCredential
Position:	Named
Default value:	Current user
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Destination

Gibt den Pfad zum neuen Speicherort an. Der Standardwert ist das aktuelle Verzeichnis.

Um das zu kopierende Element umzubenennen, geben Sie einen neuen Namen im Wert des Destination-Parameters an.

Type:	String
Position:	1
Default value:	Current directory
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Exclude

Gibt ein oder mehrere Pfadelemente oder Muster an, z "*.txt". B. , um den Vorgang dieses Cmdlets einzuschränken. Der Wert dieses Parameters filtert nach dem Abgleichsergebnis des Path-Parameters , 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 Parameter Recurse ermittelt werden.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 Filtersprache FileSystem finden Sie in about_Wildcards. Filter sind effizienter als andere Parameter, da der Anbieter sie anwendet, wenn das Cmdlet die Objekte abruft, anstatt die Objekte nach dem Abrufen von PowerShell filtern zu lassen.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	PSSession
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Include

Gibt ein oder mehrere Pfadelemente oder Muster an, z "*.txt". B. , um den Vorgang dieses Cmdlets einzuschränken. Der Wert dieses Parameters filtert nach dem Abgleichsergebnis des Path-Parameters , 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 Parameter Recurse ermittelt werden.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PassThru

Gibt ein -Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet keine Ausgabe.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

Gibt als Zeichenfolgenarray den Pfad zu den zu kopierenden Elementen an. Platzhalterzeichen sind zulässig.

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-Recurse

Gibt an, dass dieses Cmdlet eine rekursive Kopie durchführt.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 Parameter Destination auf den lokalen Pfad auf dem Remotecomputer.

Weitere Informationen finden Sie unter about_FileSystem_Provider.

Type:	PSSession
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

String

Sie können eine Zeichenfolge, die einen Pfad enthält, an dieses Cmdlet übergeben.

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 ist für die Arbeit mit den Daten konzipiert, die von einem beliebigen Anbieter verfügbar gemacht werden. Um die in Ihrer Sitzung verfügbaren Anbieter aufzulisten, geben Sie ein Get-PSProvider. Weitere Informationen finden Sie unter about_Providers.

Ähnliche Themen

• about_Providers
• Clear-Item
• Get-Item
• Get-PSProvider
• Invoke-Item
• Move-Item
• New-Item
• Remove-Item
• Rename-Item
• Set-Item