Move-Item
Hiermee verplaatst u een item van de ene locatie naar de andere.
Syntax
Move-Item
[-Path] <String[]>
[[-Destination] <String>]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Move-Item
-LiteralPath <String[]>
[[-Destination] <String>]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Met de Move-Item
cmdlet wordt een item, inclusief de eigenschappen, inhoud en onderliggende items, van de ene locatie naar de andere locatie verplaatst. 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.
Voorbeelden
Voorbeeld 1: Een bestand verplaatsen naar een andere map en de naam ervan wijzigen
Met deze opdracht verplaatst u het Test.txt
bestand van het C:
station naar de E:\Temp
map en wijzigt u de naam ervan in test.txt
tst.txt
.
Move-Item -Path C:\test.txt -Destination E:\Temp\tst.txt
Voorbeeld 2: Een map en de inhoud ervan verplaatsen naar een andere map
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 Logs
map.
Move-Item -Path C:\Temp -Destination C:\Logs
Voorbeeld 3: Alle bestanden van een opgegeven extensie van de huidige map naar een andere map verplaatsen
Met deze opdracht worden alle tekstbestanden (*.txt
) in de huidige map (vertegenwoordigd door een punt (.
)) naar de C:\Logs
map verplaatst.
Move-Item -Path .\*.txt -Destination C:\Logs
Voorbeeld 4: Alle bestanden van een opgegeven extensie recursief verplaatsen van de huidige map naar een andere map
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 Get-ChildItem
cmdlet om alle onderliggende items op te halen in de huidige map (vertegenwoordigd door de punt (.
)) en de submappen met een *.txt
bestandsnaamextensie. De parameter Recurse wordt gebruikt om recursief te maken en de parameter Opnemen om het ophalen van bestanden te *.txt
beperken.
De pijplijnoperator (|
) verzendt de resultaten van deze opdracht naar Move-Item
, waarmee de tekstbestanden naar de TextFiles
map worden verplaatst.
Als bestanden die moeten worden verplaatst C:\Textfiles
met dezelfde naam, geeft u Move-Item
een fout weer en gaat u door, maar het verplaatst slechts één bestand met elke naam naar C:\Textfiles
. 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 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.
Get-ChildItem
Standaard worden ook geen verborgen bestanden verplaatst. Als u verborgen bestanden wilt verplaatsen, gebruikt u de parameter Force met Get-ChildItem
.
Notitie
Wanneer u in Windows PowerShell 2.0 de recurseparameter van de Get-ChildItem
cmdlet gebruikt, moet de waarde van de parameter Path een container zijn. Gebruik de parameter Opnemen om het *.txt
bestandsextensiefilter (Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles
) op te geven.
Voorbeeld 5: Registersleutels en -waarden verplaatsen naar een andere sleutel
Met deze opdracht worden de registersleutels en -waarden binnen de MyCompany
registersleutel naar HKLM\Software
de MyNewCompany
sleutel verplaatst. Het jokerteken (*
) geeft aan dat de inhoud van de MyCompany
sleutel moet worden verplaatst, niet de sleutel zelf. In deze opdracht worden de optionele pad - en doelparameternamen weggelaten.
Move-Item "HKLM:\software\mycompany\*" "HKLM:\software\mynewcompany"
Voorbeeld 6: Een map en de inhoud ervan verplaatsen naar een submap van de opgegeven map
Met deze opdracht wordt de Logs[Sept`06]
map (en de inhoud) naar de Logs[2006]
map verplaatst.
Move-Item -LiteralPath 'Logs[Sept`06]' -Destination 'Logs[2006]'
De parameter LiteralPath wordt gebruikt in plaats van Pad, omdat de oorspronkelijke mapnaam linkerhaak- en rechterhaaktekens ([
en ]
) bevat. Het pad wordt ook tussen enkele aanhalingstekens ('
) geplaatst, zodat het backtick-symbool (`
) niet verkeerd wordt geïnterpreteerd.
De doelparameter moet ook tussen enkele aanhalingstekens worden geplaatst omdat deze vierkante haken bevat die verkeerd kunnen worden geïnterpreteerd.
Parameters
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Notitie
Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met PowerShell. Als u een andere gebruiker wilt imiteren of uw referenties wilt verhogen bij het uitvoeren van deze cmdlet, gebruikt u Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Destination
Hiermee geeft u het pad naar de locatie waar de items worden verplaatst. De standaardwaarde is de huidige map. Jokertekens zijn toegestaan, maar het resultaat moet één locatie opgeven.
Als u de naam van het item wilt wijzigen dat wordt verplaatst, geeft u een nieuwe naam op in de waarde van de doelparameter.
Type: | String |
Position: | 1 |
Default value: | Current directory |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Exclude
Hiermee geeft u, als tekenreeksmatrix, een item of items op die door deze cmdlet worden uitgesloten in de bewerking. De waarde van deze parameter komt in aanmerking voor de path-parameter . Voer een padelement of -patroon in, zoals *.txt
. Jokertekens zijn toegestaan. De parameter Uitsluiten is alleen van kracht wanneer de opdracht de inhoud van een item bevat, zoals C:\Windows\*
, waarbij het jokerteken de inhoud van de C:\Windows
map aangeeft.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Hiermee geeft u een filter op om de path-parameter te kwalificeren. De FileSystem-provider is de enige geïnstalleerde PowerShell-provider die ondersteuning biedt voor het gebruik van filters. U vindt de syntaxis voor de filtertaal Bestandssysteem in about_Wildcards. Filters zijn efficiënter dan andere parameters, omdat de provider ze toepast wanneer de cmdlet de objecten ophaalt in plaats van PowerShell de objecten te filteren nadat ze zijn opgehaald.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Hiermee dwingt u de opdracht uit te voeren zonder om bevestiging van de gebruiker te vragen. Implementatie varieert van provider tot provider. Zie about_Providers voor meer informatie.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Hiermee geeft u, als tekenreeksmatrix, een item of items op die deze cmdlet bevat in de bewerking. De waarde van deze parameter komt in aanmerking voor de path-parameter . Voer een padelement of -patroon in, zoals *.txt
. Jokertekens zijn toegestaan. De parameter Opnemen is alleen van kracht wanneer de opdracht de inhoud van een item bevat, zoals C:\Windows\*
, waarbij het jokerteken de inhoud van de C:\Windows
map aangeeft.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Hiermee geeft u een pad naar een of meer locaties. De waarde van LiteralPath wordt exact gebruikt terwijl deze wordt getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens ('
). Enkele aanhalingstekens geven PowerShell aan dat u geen tekens als escape-reeksen interpreteert.
Zie about_Quoting_Rules voor meer informatie.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Retourneert een object dat het verplaatste item vertegenwoordigt. Deze cmdlet genereert standaard geen uitvoer.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Hiermee geeft u het pad naar de huidige locatie van de items. De standaardwaarde is de huidige map. Jokertekens zijn toegestaan.
Type: | String[] |
Position: | 0 |
Default value: | Current directory |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
U kunt een tekenreeks met een pad naar deze cmdlet doorsluisen.
Uitvoerwaarden
None or an object representing the moved item
Wanneer u de parameter PassThru gebruikt, genereert deze cmdlet een object dat het verplaatste item vertegenwoordigt. Anders genereert deze cmdlet geen uitvoer.
Notities
- Met deze cmdlet worden bestanden verplaatst tussen stations die worden ondersteund door dezelfde provider, maar worden mappen alleen binnen hetzelfde station verplaatst.
- Omdat met een
Move-Item
opdracht de eigenschappen, inhoud en onderliggende items van een item worden 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_Providers voor meer informatie.