Copy-Item

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
    [[-Destination] <String>]
    -LiteralPath <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>]

Das Cmdlet Copy-Item 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 parameters Destination ein. Verwenden Sie das Cmdlet Rename-Item, um ein Element umzubenennen und es nicht zu kopieren.

In diesem Beispiel wird die mar1604.log.txt Datei in das verzeichnis C:\Presentation kopiert. Die ursprüngliche Datei wird nicht gelöscht.

Copy-Item "C:\Wabash\Logfiles\mar1604.log.txt" -Destination "C:\Presentation"

In diesem Beispiel wird der Inhalt des C:\Logfiles Verzeichnisses in das vorhandene C:\Drawings Verzeichnis kopiert. Das verzeichnis Logfiles wird nicht kopiert.

Wenn das verzeichnis Logfiles Dateien in Unterverzeichnissen enthält, werden diese Unterverzeichnisse mit ihren Dateistrukturen kopiert. Standardmäßig ist der parameter Container auf Truefestgelegt, wodurch die Verzeichnisstruktur erhalten bleibt.

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

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 2dargestellt in ein vorhandenes Zielverzeichnis. Oder benennen Sie das neue Zielverzeichnis mit dem Quellverzeichnis.

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

In diesem Beispiel wird das cmdlet Copy-Item verwendet, um das Get-Widget.ps1 Skript aus dem verzeichnis \\Server01\Share in das verzeichnis \\Server12\ScriptArchive 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.

$copyParams = @{
    Path        = "\\Server01\Share\Get-Widget.ps1"
    Destination = "\\Server12\ScriptArchive\Get-Widget.ps1.txt"
}
Copy-Item @copyParams

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

Das cmdlet Copy-Item kopiert test.log aus dem Ordner D:\Folder001 in den ordner C:\Folder001_Copy auf dem Remotecomputer mithilfe der sitzungsinformationen, die in der variablen $Session gespeichert sind. 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

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

Das Cmdlet Copy-Item kopiert den ordner D:\Folder002 mithilfe der sitzungsinformationen, die in der variablen C:\Folder002_Copy gespeichert sind, in das $Session Verzeichnis auf dem Remotecomputer. Alle Unterordner oder Dateien werden nicht kopiert, ohne den Schalter Recurse zu verwenden. Der Vorgang erstellt den ordner Folder002_Copy, sofern er noch nicht vorhanden ist.

$Session = New-PSSession -ComputerName "Server02" -Credential "Contoso\User01"
Copy-Item "D:\Folder002\" -Destination "C:\Folder002_Copy\" -ToSession $Session

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

Das Cmdlet Copy-Item kopiert den gesamten Inhalt aus dem Ordner D:\Folder003 in das verzeichnis C:\Folder003_Copy auf dem Remotecomputer mithilfe der sitzungsinformationen, die in der variablen $Session gespeichert sind. Die Unterordner werden mit ihren Dateistrukturen kopiert. Der Vorgang erstellt den ordner Folder003_Copy, sofern er noch nicht vorhanden ist.

$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
Copy-Item "D:\Folder003\" -Destination "C:\Folder003_Copy\" -ToSession $Session -Recurse

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

Das cmdlet Copy-Item kopiert scriptingexample.ps1 aus dem Ordner D:\Folder004 in den ordner C:\Folder004_Copy auf dem Remotecomputer mithilfe der sitzungsinformationen, die in der variablen $Session gespeichert sind. Die ursprüngliche Datei wird nicht gelöscht.

$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
$copyParams = @{
    Path        = "D:\Folder004\scriptingexample.ps1"
    Destination = "C:\Folder004_Copy\scriptingexample_copy.ps1"
    ToSession   = $Session
}
Copy-Item @copyParams

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

Das cmdlet Copy-Item kopiert test.log aus dem Remote-C:\MyRemoteData\ in den lokalen D:\MyLocalData Ordner mithilfe der sitzungsinformationen, die in der variablen $Session 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

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

Das cmdlet Copy-Item kopiert den gesamten Inhalt aus dem Remoteordner C:\MyRemoteData\scripts ordner in den lokalen D:\MyLocalData Ordner mithilfe der sitzungsinformationen, die in der variablen $Session gespeichert sind. 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

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

Das cmdlet Copy-Item kopiert den gesamten Inhalt aus dem Remoteordner C:\MyRemoteData\scripts ordner in den lokalen D:\MyLocalData\scripts Ordner mithilfe der sitzungsinformationen, die in der variablen $Session gespeichert sind. 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 ihren Dateistrukturen kopiert.

$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
$copyParams = @{
    Path        = "C:\MyRemoteData\scripts"
    Destination = "D:\MyLocalData\scripts"
    FromSession = $Session
    Recurse     = $true
}
Copy-Item @copyParams

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 Cmdlet Copy-Item hat den Parameter Container auf $falsefestgelegt. 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.

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 wird Copy-Item mit einem Wildcard für die Parameter Path und Include-Parameter aufgerufen. Durch Angeben eines Wildcards für den parameter Path wird sichergestellt, dass alle Dateien und Ordner verarbeitet werden, die mit D:\temp\tree\*übereinstimmen. 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 parameter "Include" wird auf den Inhalt D:\temp\tree Ordners angewendet, um alle Elemente zu kopieren, die ex*entsprechen. Beachten Sie, dass der D:\temp\out\examples Ordner ohne Rekursion kopiert wird, aber keiner seiner Inhalte kopiert wird.

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 wird Copy-Item mit einem Wildcard für die Parameter Path und Include-Parameter aufgerufen. Durch Angeben eines Wildcards für den parameter Path wird sichergestellt, dass alle Dateien und Ordner verarbeitet werden, die mit D:\temp\tree\*übereinstimmen. 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 parameter "Include" wird auf den Inhalt D:\temp\tree Ordners angewendet, um alle Elemente zu kopieren, die ex*entsprechen. Beachten Sie, dass mit Rekursion der ordner D:\temp\out\examples zusammen mit allen Dateien und Unterordnern kopiert wird. Die Kopie enthält Dateien, die nicht dem Includefilter entsprechen. Bei Verwendung von Copy-Itemgelten die Filter nur für die oberste Ebene, die durch den parameter Path angegeben wird. Anschließend wird rekursion auf diese übereinstimmenden Elemente angewendet.

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 filtert, um die Pfade zu filtern, die für einen Wildcard angegeben sind, der Path, der Include Parameter kann nicht verwendet werden, um die Dateien rekursiv aus einem Ordner zu beschränken. Stattdessen können Sie Get-ChildItem verwenden, um die Elemente zu finden, die Sie kopieren möchten, und diese Elemente an Copy-Itemübergeben.

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 der Recurse und Filter Parametern filtern und die Ergebnisse an Copy-Itemweiterzuführen.

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

Im Gegensatz zum Copy-Itemgilt der parameter Filter für Get-ChildItem für die während der Rekursion ermittelten Elemente. Auf diese Weise können Sie Elemente rekursiv suchen, filtern und dann kopieren.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können eine Zeichenfolge weiterleiten, die einen Pfad zu diesem Cmdlet enthält.

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

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

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

• Alle Plattformen:
  • copy
  • cpi
• Fenster:
  • cp

Dieses Cmdlet wurde entwickelt, um mit den Daten zu arbeiten, die von einem beliebigen Anbieter verfügbar gemacht werden. Geben Sie Get-PSProviderein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können. Weitere Informationen finden Sie unter über_Anbieter.