Move-Item

dec 18, 2021
Modul: Microsoft.PowerShell.Management

Flytter et element fra et sted til et andet.

Syntaks

Beskrivelse

Cmdletten Move-Item flytter et element, herunder dets egenskaber, indhold og underordnede elementer, fra et sted til et andet sted. Placeringerne skal understøttes af den samme udbyder. den kan f.eks. flytte en fil eller en undermappe fra en mappe til en anden eller flytte en registreringsundernøgle fra en nøgle til en anden. når du flytter et element, tilføjes det til den nye placering og slettes fra den oprindelige placering.

Eksempler

Eksempel 1: Flyt en fil til en anden mappe og omdøb den

Denne kommando flytter filen Test.txt fra drevet C: til mappen E:\Temp og omdøber den fra test.txt til tst.txt.

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

Eksempel 2: Flyt en mappe og dens indhold til en anden mappe

Denne kommando flytter mappen C:\Temp og dens indhold til mappen C:\Logs. mappen “Temp” og alle dens undermapper og filer vises derefter i mappen “Logs”.

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

Eksempel 3: Flyt alle filer med en specificeret udvidelse fra den aktuelle mappe til en anden mappe

Denne kommando flytter alle tekstfiler (*.txt) i den aktuelle mappe (repræsenteret ved et punktum(.)) til mappen C:\Logs.

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

Eksempel 4: Recursivt flytte alle filer med en angivet udvidelse fra den aktuelle mappe til en anden mappe

Denne kommando flytter alle tekstfiler fra den aktuelle mappe og alle undermapper,rekursivt, til mappen “C:\TextFiles”.

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

Kommandoen bruger cmdlet Get-ChildItem til at hente alle underordnede elementer i den aktuelle mappe (repræsenteret ved punktummet ) og dens undermapper, der har et “.Den bruger parameteren Recurse til at gøre hentningen rekursiv og parameteren Include til at begrænse hentningen til “.txt”-filer.

Pipeline-operatoren (|) sender resultaterne af denne kommando til Move-Item, som flytter tekstfilerne til mappen “TextFiles”.

Hvis de filer, der skal flyttes til “C:\Textfiles”, har samme navn, viser Move-Item en fejl og fortsætter, men den flytter kun én fil med hvert navn til “C:\Textfiles”.De andre filer forbliver i deres oprindelige mapper.

Hvis mappen “Textfiles” (eller et andet element i destinationsstien) ikke findes, mislykkes kommandoen.Den manglende mappe oprettes ikke for dig, selv hvis du bruger parameteren Force.Move-Item flytter det første element til en fil med navnet “Textfiles” og viser derefter en fejl, der forklarer, at filen allerede findes.

Det er også standard, at Get-ChildItem ikke flytter skjulte filer.Hvis du vil flytte skjulte filer, skal du bruge Force-parameteren sammen med Get-ChildItem.

Note

I Windows PowerShell 2.0, når du bruger parameteren Recurse i cmdlet Get-ChildItem, skal værdien af Path-parameteren være en container.Brug parameteren Include til at angive filteret for udvidelse af .txt-filnavne (Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles).

Eksempel 5: Flyt registreringsdatabasenøgler og -værdier til en anden nøgle

Denne kommando flytter registreringsdatabasenøgler og -værdier inden for registreringsdatabasenøglen “MyCompany” iHKLM\Software til nøglen “MyNewCompany”.Jokertegnet (*) angiver, at indholdet af nøglen “MyCompany” skal flyttes og ikke selve nøglen.I denne kommando udelades de valgfrie parameternavne Path og Destination.

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

Eksempel 6: Flyt en mappe og dens indhold til en undermappe til den angivne mappe

Denne kommando flytter mappen “Logs” (og dens indhold) til mappen “Logs”.

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

Parameteren LiteralPath anvendes i stedet for Path, fordi det oprindelige mappenavninkluderer tegn i venstre parentes og højre parentes (“”).Stien er også omsluttet af anførselstegn (‘ ‘), så backtick-symbolet (`) ikke fejlfortolkes.

Destinationsparameteren kræver ikke en bogstavelig sti, fordi destinationsvariablen også skal være omsluttet af enkelt citationstegn, fordi den indeholder parenteser, der kan misfortolkes.

Parametre

-Bekræft

Forespørger dig om bekræftelse, før du kører cmdletten.

Type: SwitchParameter
Aliases: cf
Position: Named
Standardværdi: False
Accept pipeline input: False
Accepter jokertegn: False
-Credential

Note

Denne parameter understøttes ikke af nogen udbydere, der er installeret med PowerShell.Hvis du vil udgive dig for en anden bruger eller hæve dine legitimationsoplysninger, når du kører denne cmdlet, skal du bruge Invoke-Command.

Type: PSCredential
Position: Named
Standardværdi: Current user
Accept pipeline input: True
Accept wildcard-tegn: False
-Destination

Angiver stien til den placering, hvor elementerne flyttes.Standardværdien er den aktuelle mappe.Jokertegn er tilladt, men resultatet skal angive en enkelt placering.

For at omdøbe det element, der flyttes, skal du angive et nyt navn i værdien af destinationsparameteren.

Type: String
Position: 1
Standardværdi: Aktuel mappe
Accepter pipelineinput: True
Accepter jokertegn: True

-Exclude

Angiver, som et strengarray, et eller flere elementer, som denne cmdlet udelukker i operationen. Værdien af denne parameter kvalificerer Path-parameteren. Indtast et stielement eller et mønster, f.eks.*.txt. Wildcard-tegn er tilladt. Parameteren Exclude er kun effektiv, når kommandoen omfatter indholdet af et element, f.eks. C:\Windows\*, hvor jokertegnet angiver indholdet af mappen C:\Windows.

Type: String
Position: Named
Standardværdi: None
Accept pipeline input: False
Accepter wildcard-tegn: True
-Filter

Angiver et filter til at kvalificere Path-parameteren. FileSystemprovider er den eneste installerede PowerShell-provider, der understøtter brugen af filtre. Du kan finde syntaksen for FileSystem-filtersproget i about_Wildcards.Filtre er mere effektive end andre parametre, fordi provideren anvender dem, når cmdletgetterne henter objekterne, i stedet for at PowerShell filtrerer objekterne, efter at de er hentet.

Type: String
Position: Named
Standardværdi: None
Accept pipeline input: Falsk
Accepter wildcard-tegn: True
-Force

Forcerer kommandoen til at køre uden at bede om brugerens bekræftelse.Implementeringen varierer fra udbyder til udbyder.Du kan finde flere oplysninger under about_Providers.

Type: SwitchParameter
Position: Named
Standardværdi: False
Accepter input fra rørledningen: False
Accepter jokertegn: False
-Include

Angiver, som et strengarray, et eller flere elementer, som denne cmdlet inkluderer i operationen. Værdien af denne parameter kvalificerer Path-parameteren. Indtast et stielement eller et mønster, f.eks."*.txt". Wildcard-tegn er tilladt. Parameteren Include er kun effektiv, når kommandoen omfatter indholdet af et element, f.eks. C:\Windows\*, hvor jokertegnet angiver indholdet af mappen C:\Windows.

Type: String
Position: Named
Standardværdi: None
Accept pipeline input: False
Accepterer jokertegn: True
-LiteralPath

Angiver en sti til et eller flere steder. Værdien af LiteralPath anvendes nøjagtigt som den er indtastet. Ingen tegn fortolkes som wildcards. Hvis stien indeholder escape-tegn, skal den omsluttes af enkelte anførselstegn. Enkelte anførselstegn fortæller PowerShell, at den ikke skal fortolke tegn som escape-sekvenser.

Fors yderligere oplysninger kan du se about_Quoting_Rules.

Type: String
Aliases: PSPath, LP
Position: Named
Standardværdi: None
Accept pipeline input: True
Acceptér jokertegn: False
-PassThru

Returnerer et objekt, der repræsenterer det emne, som du arbejder med.Som standard genererer denne cmdlet ikke noget output.

Type: SwitchParameter
Position: Named
Standardværdi: False
Accepter input fra pipeline: Falsk
Accepterer jokertegn: Falsk
-Sti

Angiver stien til den aktuelle placering af elementerne.Standardværdien er den aktuelle mappe.Jokertegn er tilladt.

Type: String
Position: 0
Standardværdi: Aktuel mappe
Accepter pipelineinput: True
Accepterer jokertegn: True
-WhatIf

Viser, hvad der ville ske, hvis cmdletten køres.Cmdletten bliver ikke kørt.

Type: SwitchParameter
Aliases: wi
Position: Named
Standardværdi: False
Accept pipeline input: Falsk
Accepter jokertegn: Falsk

Input

String

Du kan sende en streng, der indeholder en sti, via rørledning til denne cmdlet.

Outputs

Ingen eller et objekt, der repræsenterer det flyttede element

Når du bruger parameteren PassThru, genererer denne cmdlet et objekt, der repræsenterer det flyttede element.Ellers genererer denne cmdlet ikke noget output.

Notes

  • Denne cmdlet flytter filer mellem drev, der understøttes af den samme udbyder, men den flytter kun mapper inden for det samme drev.
  • Da en Move-Item-kommando flytter et elements egenskaber, indhold og underordnede elementer, er alle flytninger som standard rekursive.
  • Denne cmdlet er designet til at arbejde med de data, der udstilles af enhver udbyder.Du kan få vist en liste over de udbydere, der er tilgængelige i din session, ved at skrive Get-PSProvider.Du kan finde flere oplysninger under about_Providers.
  • Clear-Item
  • Copy-Item
  • Get-Item
  • Invoke-Item
  • New-Item
  • Remove-Item
  • Rename-Item
  • Set-Item
  • Afout_Providers

Skriv et svar

Din e-mailadresse vil ikke blive publiceret.