Syntax

Description

Het cmdlet Move-Item verplaatst een item, inclusief de eigenschappen, inhoud en child-items, van de ene locatie naar de andere locatie. De locaties moeten door dezelfde provider worden ondersteund. Zo kan bijvoorbeeld een bestand of submap van de ene map naar de andere worden verplaatst of een registersubkey van de ene sleutel naar de andere. Wanneer u een item verplaatst, wordt het aan de nieuwe locatie toegevoegd en van de oorspronkelijke locatie verwijderd.

Voorbeelden

Voorbeeld 1: Verplaats een bestand naar een andere directory en geef het een andere naam

Deze opdracht verplaatst het bestand Test.txt van het station C: naar de directory E:\Temp en hernoemt het van test.txt naar tst.txt.

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

Voorbeeld 2: Verplaats een directory en de inhoud ervan naar een andere directory

Deze opdracht verplaatst de directory C:\Temp en de inhoud ervan naar de directory C:\Logs. De directory “Temp” en alle submappen en bestanden ervan verschijnen dan in de directory “Logs”.

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

Voorbeeld 3: Verplaats alle bestanden met een opgegeven extensie van de huidige directory naar een andere directory

Deze opdracht verplaatst alle tekstbestanden (*.txt) in de huidige directory (weergegeven door een punt(.)) naar de directory C:\Logs.

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

Voorbeeld 4: Verplaats alle bestanden met een opgegeven extensie recursief van de huidige directory naar een andere directory

Deze opdracht verplaatst alle tekstbestanden van de huidige directory en alle subdirectories recursief naar de directory “C:TextFiles”.

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

Dit commando gebruikt het cmdlet Get-ChildItem om alle child items in de huidige directory (weergegeven door de punt) en de submappen op te halen die een “.Het gebruikt de parameter Recurse om het ophalen recursief te maken en de parameter Include om het ophalen te beperken tot “.txt”-bestanden.

De pijplijnoperator (|) zendt de resultaten van dit commando naar Move-Item, die de tekstbestanden verplaatst naar de directory “TextFiles”.

Als de bestanden die naar “C:\Textfiles” moeten worden verplaatst dezelfde naam hebben, geeft Move-Item een fout weer en gaat verder, maar verplaatst slechts één bestand met elke naam naar “C:\Textfiles”. De andere bestanden blijven in hun oorspronkelijke directory’s.

Als de directory “Textfiles” (of een ander element van het bestemmingspad) niet bestaat, mislukt de opdracht. De ontbrekende directory wordt niet voor u gemaakt, zelfs niet als u de parameter Force gebruikt.Move-Item verplaatst het eerste item naar een bestand met de naam “Textfiles” en geeft vervolgens een fout weer waarin wordt uitgelegd dat het bestand al bestaat.

Ook verplaatst Get-ChildItem standaard geen verborgen bestanden.Om verborgen bestanden te verplaatsen, gebruikt u de parameter Force met Get-ChildItem.

Voorbeeld 5: Registersleutels en -waarden naar een andere sleutel verplaatsen

Deze opdracht verplaatst de registersleutels en -waarden binnen de registersleutel “MyCompany” inHKLM\Software naar de sleutel “MyNewCompany”.Het jokerteken (*) geeft aan dat de inhoud van de sleutel “MyCompany” moet worden verplaatst, niet de sleutel zelf. In deze opdracht zijn de optionele parameternamen Pad en Bestemming weggelaten.

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

Voorbeeld 6: Verplaats een directory en de inhoud ervan naar een subdirectory van de opgegeven directory

Deze opdracht verplaatst de directory “Logs” (en de inhoud ervan) naar de directory “Logs”.

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

De parameter LiteralPath wordt gebruikt in plaats van Path, omdat de oorspronkelijke directorynaam haakjes links en haakjes rechts bevat (“”). Het pad staat ook tussen enkele aanhalingstekens (‘ ‘), zodat het backtick-symbool (`) niet verkeerd wordt geïnterpreteerd.

De parameter Destination heeft geen letterlijk pad nodig, omdat de Destination variabele ook tussen enkele aanhalingstekens moet staan, omdat deze haakjes bevat die verkeerd geïnterpreteerd kunnen worden.

Parameters

Inputs

String

Je kunt een string die een pad bevat naar dit cmdlet pijpen.

Outputs

None of een object dat het verplaatste item weergeeft

Wanneer u de parameter PassThru gebruikt, genereert dit cmdlet een object dat het verplaatste item weergeeft.Anders genereert dit cmdlet geen uitvoer.

Notes

• Dit cmdlet zal bestanden verplaatsen tussen stations die worden ondersteund door dezelfde provider, maar het zal alleen mappen verplaatsen binnen hetzelfde station.
• Omdat een Move-Item commando de eigenschappen, inhoud, en child items van een item verplaatst, zijn alle verhuizingen standaard recursief.
• Dit cmdlet is ontworpen om te werken met de gegevens die door elke provider worden aangeboden.Typ Get-PSProvider voor een lijst van providers die beschikbaar zijn in uw sessie. Zie about_Providers voor meer informatie.

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