Syntax

Beschreibung

Das Cmdlet Move-Item verschiebt ein Element, einschließlich seiner Eigenschaften, Inhalte und untergeordneten Elemente, von einem Speicherort an einen anderen. Es kann beispielsweise eine Datei oder ein Unterverzeichnis von einem Verzeichnis in ein anderes verschieben oder einen Registrierungsunterschlüssel von einem Schlüssel in einen anderen verschieben.Wenn Sie ein Element verschieben, wird es am neuen Speicherort hinzugefügt und am ursprünglichen Speicherort gelöscht.

Beispiele

Beispiel 1: Eine Datei in ein anderes Verzeichnis verschieben und umbenennen

Dieser Befehl verschiebt die Datei Test.txt vom Laufwerk C: in das Verzeichnis E:\Temp und benennt sie von test.txt in tst.txt um.

Move-Item -Path C:\test.txt -Destination E:\Temp\tst.txt

Beispiel 2: Verschieben eines Verzeichnisses und seines Inhalts in ein anderes Verzeichnis

Dieser Befehl verschiebt das Verzeichnis C:\Temp und seinen Inhalt in das Verzeichnis C:\Logs Das Verzeichnis „Temp“ und alle seine Unterverzeichnisse und Dateien erscheinen dann im Verzeichnis „Logs“.

Move-Item -Path C:\Temp -Destination C:\Logs

Beispiel 3: Alle Dateien mit einer bestimmten Erweiterung aus dem aktuellen Verzeichnis in ein anderes Verzeichnis verschieben

Dieser Befehl verschiebt alle Textdateien (*.txt) im aktuellen Verzeichnis (dargestellt durch einen Punkt (.)) in das Verzeichnis C:\Logs.

Move-Item -Path .\*.txt -Destination C:\Logs

Beispiel 4: Rekursives Verschieben aller Dateien mit einer bestimmten Erweiterung aus dem aktuellen Verzeichnis in ein anderes Verzeichnis

Dieser Befehl verschiebt alle Textdateien aus dem aktuellen Verzeichnis und allen Unterverzeichnissen rekursiv in das Verzeichnis „C:\TextFiles“.

Get-ChildItem -Path ".\*.txt" -Recurse | Move-Item -Destination "C:\TextFiles"

Der Befehl verwendet das Cmdlet Get-ChildItem, um alle untergeordneten Elemente im aktuellen Verzeichnis (durch den Punkt dargestellt) und seinen Unterverzeichnissen abzurufen, die eine „.Der Befehl verwendet den Recurse-Parameter, um den Abruf rekursiv zu gestalten, und den Include-Parameter, um den Abruf auf „.txt“-Dateien zu beschränken.

Der Pipelineoperator (|) sendet die Ergebnisse dieses Befehls an Move-Item, der die Textdateien in das Verzeichnis „TextFiles“ verschiebt.

Wenn Dateien, die nach „C:\Textfiles“ verschoben werden sollen, denselben Namen haben, zeigt Move-Item eine Fehlermeldung an und fährt fort, verschiebt aber nur eine Datei mit jedem Namen nach „C:\Textfiles“.Die anderen Dateien verbleiben in ihren ursprünglichen Verzeichnissen.

Wenn das Verzeichnis „Textfiles“ (oder ein anderes Element des Zielpfads) nicht vorhanden ist, schlägt derBefehl fehl.Das fehlende Verzeichnis wird nicht für Sie erstellt, selbst wenn Sie den Force-Parameter verwenden.Move-Item verschiebt das erste Element in eine Datei mit dem Namen „Textfiles“ und zeigt dann eine Fehlermeldung an, die erklärt, dass die Datei bereits vorhanden ist.

Außerdem verschiebt Get-ChildItem standardmäßig keine versteckten Dateien.Um versteckte Dateien zu verschieben, verwenden Sie den Force-Parameter mit Get-ChildItem.

Beispiel 5: Registrierungsschlüssel und -werte in einen anderen Schlüssel verschieben

Dieser Befehl verschiebt die Registrierungsschlüssel und -werte im Registrierungsschlüssel „MyCompany“ inHKLM\Software in den Schlüssel „MyNewCompany“.Das Platzhalterzeichen (*) gibt an, dass der Inhalt des Schlüssels „MyCompany“ verschoben werden soll, nicht der Schlüssel selbst.

Move-Item "HKLM:\software\mycompany\*" "HKLM:\software\mynewcompany"

Beispiel 6: Verschieben eines Verzeichnisses und seines Inhalts in ein Unterverzeichnis des angegebenen Verzeichnisses

Dieser Befehl verschiebt das Verzeichnis „Logs“ (und seinen Inhalt) in das Verzeichnis „Logs“.

Move-Item -LiteralPath 'Logs' -Destination 'Logs'

Der Parameter „LiteralPath“ wird anstelle von „Path“ verwendet, da der ursprüngliche Verzeichnisname linke und rechte Klammerzeichen („“) enthält.Der Pfad wird außerdem in einfache Anführungszeichen (‚ ‚) gesetzt, damit das Backtick-Symbol (`) nicht falsch interpretiert wird.

Für den Parameter „Destination“ ist kein wörtlicher Pfad erforderlich, da die Variable „Destination“ ebenfalls in einfache Anführungszeichen eingeschlossen werden muss, da sie Klammern enthält, die falsch interpretiert werden können.

Parameter

Inputs

String

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

Ausgaben

Keine oder ein Objekt, das das verschobene Element darstellt

Wenn Sie den PassThru-Parameter verwenden, generiert dieses Cmdlet ein Objekt, das das verschobene Element darstellt, ansonsten generiert dieses Cmdlet keine Ausgabe.

Hinweise

• Dieses Cmdlet verschiebt Dateien zwischen Laufwerken, die vom selben Anbieter unterstützt werden, aber es verschiebt Verzeichnisse nur innerhalb desselben Laufwerks.
• Da ein Move-Item-Befehl die Eigenschaften, den Inhalt und die untergeordneten Elemente eines Elements verschiebt, sind alle Verschiebungen standardmäßig rekursiv.
• Dieses Cmdlet ist so konzipiert, dass es mit den von jedem Anbieter bereitgestellten Daten arbeitet.Um die in Ihrer Sitzung verfügbaren Anbieter aufzulisten, geben Sie Get-PSProvider ein. Weitere Informationen finden Sie unter about_Providers.

• Clear-Item
• Copy-Item
• Get-Item
• Invoke-Item
• New-Item
• Remove-Item
• Rename-Item
• Set-Item
• about_Providers