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

Beschreibung

Das Copy-Item Cmdlet kopiert ein Element von einem Speicherort in einen anderen Speicherort im gleichen Namespace. Sie kann beispielsweise eine Datei in einen Ordner kopieren, aber sie kann keine Datei in ein Zertifikatlaufwerk kopieren.

Dieses Cmdlet wird nicht ausgeschnitten oder gelöscht, die Elemente kopiert werden. Die bestimmten 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ägen auf dem Registrierungslaufwerk kopieren.

Dieses Cmdlet kann Elemente im gleichen Befehl kopieren und umbenennen. Geben Sie zum Umbenennen eines Elements 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 ihren Dateibäumen intakt kopiert. Standardmäßig wird der Containerparameter auf True festgelegt, wodurch die Verzeichnisstruktur beibehalten wird.

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

Hinweis

Wenn Sie das Verzeichnis in die Kopie einschließen müssen, entfernen Sie den Logfiles\*Pfad. Beispiel:

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

Beispiel 3: Kopieren von Verzeichnis und Inhalt in ein neues Verzeichnis

In diesem Beispiel wird der Inhalt des C:\Logfiles Quellverzeichniss kopiert und ein neues Zielverzeichnis erstellt. Das neue Zielverzeichnis \Logs wird in C:\Drawings.

Wenn Sie den Namen des Quellverzeichniss einschließen möchten, kopieren Sie sie in ein vorhandenes Zielverzeichnis, wie in Beispiel 2 dargestellt. 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 Cmdlet verwendet, um das Copy-ItemGet-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 zu Get-Widget.ps1.txt" so dass er an E-Mail-Nachrichten angefügt werden kann.

Copy-Item "\\Server01\Share\Get-Widget.ps1" -Destination "\\Server12\ScriptArchive\Get-Widget.ps1.txt"