Move-Item

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

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

De cmdlet Move-Item verplaatst een item, inclusief de eigenschappen, inhoud en onderliggende items, van de ene locatie naar de andere locatie. De locaties moeten worden ondersteund door dezelfde provider.

Het kan bijvoorbeeld een bestand of submap van de ene map naar de andere verplaatsen of een registersubsleutel van de ene sleutel naar de andere verplaatsen. Wanneer u een item verplaatst, wordt het toegevoegd aan de nieuwe locatie en verwijderd van de oorspronkelijke locatie.

Met deze opdracht verplaatst u het Test.txt bestand van het C: station naar de E:\Temp map en wijzigt u de naam van het test.txt in tst.txt.

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

Met deze opdracht verplaatst u de C:\Temp map en de inhoud ervan naar de C:\Logs map. De Temp map en alle bijbehorende submappen en bestanden worden vervolgens weergegeven in de map Logs.

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

Met deze opdracht worden alle tekstbestanden (*.txt) verplaatst in de huidige map (vertegenwoordigd door een punt (.)) naar de C:\Logs map.

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

Met deze opdracht worden alle tekstbestanden uit de huidige map en alle submappen recursief verplaatst naar de C:\TextFiles map.

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

De opdracht gebruikt de cmdlet Get-ChildItem om alle onderliggende items in de huidige map op te halen (vertegenwoordigd door de punt (.)) en de submappen met een *.txt bestandsnaamextensie. De parameter Recurse wordt gebruikt om recursief voor het ophalen en de parameter Include te maken om het ophalen van *.txt bestanden te beperken.

De pijplijnoperator (|) verzendt de resultaten van deze opdracht naar Move-Item, waardoor de tekstbestanden naar de TextFiles map worden verplaatst.

Als bestanden die moeten worden verplaatst naar C:\Textfiles dezelfde naam hebben, geeft Move-Item een fout weer en gaat het door, maar er wordt slechts één bestand met elke naam naar C:\Textfilesverplaatst. De andere bestanden blijven in de oorspronkelijke mappen staan.

Als de Textfiles map (of een ander element van het doelpad) niet bestaat, mislukt de opdracht. De ontbrekende map 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.

Bovendien worden Get-ChildItem standaard geen verborgen bestanden verplaatst. Als u verborgen bestanden wilt verplaatsen, gebruikt u de parameter Force met Get-ChildItem.

Met deze opdracht worden de registersleutels en -waarden binnen de MyCompany registersleutel in HKLM\Software verplaatst naar de MyNewCompany sleutel. Het jokerteken (*) geeft aan dat de inhoud van de MyCompany sleutel moet worden verplaatst, niet de sleutel zelf. In deze opdracht worden de optionele Path en Destination parameternamen weggelaten.

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

Met deze opdracht verplaatst u de Logs[Sept`06] map (en de inhoud ervan) naar de Logs[2006] map.

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

De parameter LiteralPath wordt gebruikt in plaats van Pad, omdat de oorspronkelijke mapnaam[ en rechterhaaktekens ([ en ) bevat. Het pad staat ook tussen enkele aanhalingstekens ('), zodat het backtick-symbool (`) niet verkeerd wordt geïnterpreteerd.

De parameter Destination moet ook tussen enkele aanhalingstekens staan, omdat deze haakjes bevat die verkeerd kunnen worden geïnterpreteerd.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een tekenreeks die een pad naar deze cmdlet bevat, doorgeven.

Deze cmdlet retourneert standaard geen uitvoer.

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een object dat het verplaatste item vertegenwoordigt.

PowerShell bevat de volgende aliassen voor Move-Item:

• Alle platforms:

  • mi
  • move

• Windows:

  • mv

• Met deze cmdlet worden bestanden verplaatst tussen stations die worden ondersteund door dezelfde provider, maar worden mappen alleen binnen hetzelfde station verplaatst.

• Omdat een Move-Item opdracht de eigenschappen, inhoud en onderliggende items van een item verplaatst, zijn alle verplaatsingen standaard recursief.

• Deze cmdlet is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PSProvider. Zie about_Providersvoor meer informatie.