Move-Item

Move-Item
    [-Path] <String[]>
    [[-Destination] <String>]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

Move-Item
    [[-Destination] <String>]
    -LiteralPath <String[]>
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

Das Cmdlet Move-Item verschiebt ein Element, einschließlich seiner Eigenschaften, Inhalte und untergeordneten Elemente, von einem Speicherort an einen anderen Speicherort. Die Speicherorte müssen vomselben Anbieter unterstützt werden. Sie kann z. B. eine Datei oder ein Unterverzeichnis aus 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 dem neuen Speicherort hinzugefügt und von seinem ursprünglichen Speicherort gelöscht.

Mit diesem Befehl wird die Datei "Test.txt" aus dem laufwerk C: in das Verzeichnis "E:\Temp" verschoben und von "test.txt" in "tst.txt" umbenannt.

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

Mit diesem Befehl wird das Verzeichnis "C:\Temp" und dessen Inhalt in das Verzeichnis "C:\Logs" verschoben. Das Verzeichnis "Temp" und alle zugehörigen Unterverzeichnisse und Dateien werden dann im Verzeichnis "Protokolle" angezeigt.

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

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

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

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

Der Befehl verwendet das Cmdlet Get-ChildItem, um alle untergeordneten Elemente im aktuellen Verzeichnis abzurufen (dargestellt durch den Punkt [.]) und seine Unterverzeichnisse mit einer Dateinamenerweiterung ".txt". Es verwendet den Recurse Parameter, um den Abruf rekursiv zu machen, und den Include-Parameter, um den Abruf auf ".txt" Dateien zu beschränken.

Der Pipelineoperator (|) sendet die Ergebnisse dieses Befehls an Move-Item, wodurch die Textdateien in das Verzeichnis "TextFiles" verschoben werden.

Wenn Dateien, die in "C:\Textfiles" verschoben werden sollen, denselben Namen haben, zeigt Move-Item einen Fehler an und wird fortgesetzt, aber es verschiebt nur eine Datei mit jedem Namen in "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 der Befehl fehl. Das fehlende Verzeichnis wird nicht für Sie erstellt, auch wenn Sie den Parameter Force verwenden. Move-Item verschiebt das erste Element in eine Datei namens "Textfiles" und zeigt dann einen Fehler an, der erläutert, dass die Datei bereits vorhanden ist.

Standardmäßig werden Get-ChildItem auch ausgeblendete Dateien nicht verschoben. Um ausgeblendete Dateien zu verschieben, verwenden Sie den Parameter Force mit Get-ChildItem.

Hinweis: In Windows PowerShell 2.0 muss bei Verwendung des Recurse-Parameters des Cmdlets Get-ChildItem der Wert des parameters Path ein Container sein. Verwenden Sie den Parameter Include, um den .txt Dateinamenerweiterungsfilter (Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles) anzugeben.

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

Mit diesem Befehl werden die Registrierungsschlüssel und Werte im Registrierungsschlüssel "MyCompany" in "HKLM\Software" in den Schlüssel "MyNewCompany" verschoben. Das Wildcardzeichen ('*') gibt an, dass der Inhalt des Schlüssels "MyCompany" verschoben werden soll, nicht der Schlüssel selbst. In diesem Befehl werden die optionalen Path und Destination Parameternamen weggelassen.

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

Mit diesem Befehl wird das Verzeichnis "Logs[Sept'06]" (und dessen Inhalt) in das Verzeichnis "Logs[2006]" verschoben.

Der LiteralPath Parameter wird anstelle von Pathverwendet, da der ursprüngliche Verzeichnisname linke Klammern und rechte Klammerzeichen ("[" und "]") enthält. Der Pfad wird auch in einfache Anführungszeichen (' ') eingeschlossen, sodass das Backtick-Symbol (') nicht falsch interpretiert wird.

Der parameter Destination erfordert keinen Literalpfad, da die Zielvariable auch in einfache Anführungszeichen eingeschlossen werden muss, da sie eckige Klammern enthält, die falsch interpretiert werden können.

Move-Item -LiteralPath 'Logs[Sept`06]' -Destination 'Logs[2006]'

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.

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

Mit diesem Cmdlet werden Dateien zwischen Laufwerken verschoben, die vomselben Anbieter unterstützt werden, aber es werden Verzeichnisse nur innerhalb desselben Laufwerks verschoben.

Da ein Move-Item Befehl die Eigenschaften, Inhalte und untergeordneten Elemente eines Elements verschiebt, sind alle Verschiebungen standardmäßig rekursiv.

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.