Move-Item

Move-Item [-LiteralPath] <string[]> [[-Destination] <string>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Bestätigung] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Move-Item [-Path] <string[]> [[-Destination] <string>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Bestätigung] [-WhatIf] [-UseTransaction] [<CommonParameters>]

C:\PS>move-item -path C:\test.txt -destination E:\Temp\tst.txt

Beschreibung
-----------
Mit diesem Befehl wird die Datei "test.txt" von Laufwerk "C:" in das Verzeichnis "E:\Temp" verschoben und von "test.txt" in "tst.txt" umbenannt.

C:\PS>move-item -path C:\Temp -destination C:\Logs

Beschreibung
-----------
Mit diesem Befehl wird das Verzeichnis "C:\Temp" mit seinem Inhalt in das Verzeichnis "C:\Logs" verschoben. Das Verzeichnis "Temp" befindet sich dann mit allen Unterverzeichnissen und Dateien im Verzeichnis "Logs".

C:\PS>move-item -path .\*.txt -destination C:\Logs

Beschreibung
-----------
Mit diesem Befehl werden alle Textdateien ("*.txt") im aktuellen Verzeichnis (dargestellt durch einen Punkt (.)) in das Verzeichnis "C:\Logs" verschoben.

C:\PS>get-childitem -path . -recurse -include *.txt | move-item -destination C:\TextFiles

Beschreibung
-----------
Mit diesem Befehl werden alle Textdateien aus dem aktuellen Verzeichnis und rekursiv aus allen Unterverzeichnissen in das Verzeichnis "C:\TextFiles" verschoben. 

Im Befehl werden mit dem Cmdlet "Get-ChildItem" alle untergeordneten Elemente im aktuellen Verzeichnis (dargestellt durch den Punkt [.]) und dessen Unterverzeichnissen abgerufen, die die Dateinamenerweiterung "*.txt" aufweisen. Mit dem Recurse-Parameter wird ein rekursiver Abrufvorgang festgelegt, und mit dem Include-Parameter wird der Abrufvorgang auf Dateien im Format "*.txt" beschränkt.

Mit dem Pipelineoperator (|) werden die Ergebnisse dieses Befehls an Move-Item übergeben, mit dem die Textdateien in das Verzeichnis "C:\TextFiles" verschoben werden.

Wenn nach "C:\TextFiles" verschobene Dateien denselben Namen aufweisen, wird von Move-Item ein Fehler angezeigt und der Vorgang fortgesetzt, es wird jedoch nur eine Datei mit dem betreffenden Namen in das Verzeichnis "C:\TextFiles" verschoben. Die anderen Dateien verbleiben in ihren ursprünglichen Verzeichnissen.

Wenn das Verzeichnis "Textfiles" (oder ein anderes Element des Zielpfads) nicht vorhanden ist, tritt bei dem Befehl ein Fehler auf. Das fehlende Verzeichnis wird nicht erstellt, auch wenn Sie den Force-Parameter verwenden. Move-Item verschiebt das erste Element in die eine Datei mit dem Namen "Textfiles" und zeigt dann einen Fehler mit der Meldung an, dass die Datei bereits vorhanden ist. 

Zudem werden mit Get-ChildItem standardmäßig keine versteckten Dateien verschoben. Um versteckte Dateien zu verschieben, verwenden Sie Get-ChildItem mit dem Force-Parameter.

C:\PS>move-item hklm:\software\mycompany\* hklm:\software\mynewcompany

Beschreibung
-----------
Mit diesem Befehl werden die Registrierungsschlüssel und -werte im Registrierungsschlüssel "MyCompany" unter "HKLM\Software" in den Schlüssel "MyNewCompany" verschoben. Das Platzhalterzeichnen (*) gibt an, dass der Inhalt des Schlüssels "MyCompany" und nicht der Schlüssel selbst verschoben werden soll. In diesem Befehl wurden die optionalen Parameternamen "Path" und "Destination" ausgelassen.

C:\PS>move-item -literalpath 'Logs[Sept`06]' -destination 'Logs[2006]'

Beschreibung
-----------
Mit diesem Befehl wird das Verzeichnis "Logs[Sept`06]" (mit seinem Inhalt) in das Verzeichnis "Logs[2006]" verschoben. 

Der LiteralPath-Parameter wird anstelle von "Path" verwendet, weil der ursprüngliche Verzeichnisname Zeichen für linke und rechte eckige Klammern ("[" und "]") enthält. Zudem wird der Pfad in einfache Anführungszeichen (' ') eingeschlossen, damit das Graviszeichen (`) nicht falsch interpretiert wird. 

Der Destination-Parameter erfordert keinen literalen Pfad, weil die Variable "Destination" auch in einfache Anführungszeichen eingeschlossen werden muss, da sie eckige Klammern enthält, die ebenfalls falsch interpretiert werden können.