Move-Item

dec. 18, 2021
Modul: Microsoft.PowerShell.Management

Mută un element dintr-o locație în alta.

Sintaxa

Descriere

Cdlet-ul Move-Item mută un element, inclusiv proprietățile, conținutul și elementele copil, de la o locație la o altă locație. Locațiile trebuie să fie suportate de același furnizor.De exemplu, poate muta un fișier sau un subdirector de la un director la altul sau poate muta o subcheie de registru de la o cheie la alta.Când mutați un element, acesta este adăugat în noua locație și șters din locația sa inițială.

Exemple

Exemplu 1: Mutarea unui fișier într-un alt director și redenumirea lui

Această comandă mută fișierul Test.txt de pe unitatea C: în directorul E:\Temp și îl redenumeștede la test.txt la tst.txt.

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

Exemplu 2: Mutarea unui director și a conținutului său într-un alt director

Această comandă mută directorul C:\Temp și conținutul său în directorul C:\Logs.Directorul „Temp”, precum și toate subdirectoarele și fișierele sale, apar apoi în directorul „Logs”.

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

Exemplu 3: Mutarea tuturor fișierelor cu o extensie specificată din directorul curent în alt director

Această comandă mută toate fișierele text (*.txt) din directorul curent (reprezentat printr-un punct(.)) în directorul C:\Logs.

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

Exemplu 4: Mutarea recurentă a tuturor fișierelor cu o extensie specificată din directorul curent în alt director

Această comandă mută toate fișierele text din directorul curent și din toate subdirectoarele,recursiv, în directorul „C:\TextFiles”.

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

Comanda utilizează cmdlet-ul Get-ChildItem pentru a obține toate elementele copil din directorul curent(reprezentat prin punct ) și din subdirectoarele sale care au un „.txt” cu extensia numelui de fișier.Utilizează parametrul Recurse pentru a face recuperarea recursivă și parametrul Include pentru a limita recuperarea la fișierele „.txt”.

Operatorul pipeline (|) trimite rezultatele acestei comenzi către Move-Item, care mută fișierele text în directorul „TextFiles”.

Dacă fișierele care trebuie mutate în „C:\Textfiles” au același nume, Move-Item afișează o eroareși continuă, dar mută doar un singur fișier cu fiecare nume în „C:\Textfiles”.Celelalte fișiere rămân în directoarele lor originale.

Dacă directorul „Textfiles” (sau orice alt element al căii de destinație) nu există, comanda eșuează.Directorul lipsă nu este creat pentru dumneavoastră, chiar dacă utilizați parametrul Force.Move-Item mută primul element într-un fișier numit „Textfiles” și apoi afișează o eroare explicândcă fișierul există deja.

De asemenea, în mod implicit, Get-ChildItem nu mută fișiere ascunse.Pentru a muta fișiere ascunse, utilizați parametrul Force cu Get-ChildItem.

Nota

În Windows PowerShell 2.0, atunci când se utilizează parametrul Recurse al cmdletului Get-ChildItem, valoarea parametrului Path trebuie să fie un container. utilizați parametrul Include pentru a specifica filtrul de extensie a numelui de fișier .txt(Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles).

Exemplu 5: Mutarea cheilor și valorilor din registru către o altă cheie

Această comandă mută cheile și valorile din registrul „MyCompany” dinHKLM\Software către cheia „MyNewCompany”.Caracterul wildcard (*) indică faptul că trebuie mutat conținutul cheii „MyCompany”, nu cheia în sine.În această comandă, numele opționale ale parametrilor Path și Destination sunt omise.

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

Exemplu 6: Mutarea unui director și a conținutului său într-un subdirectoriu al directorului specificat

Această comandă mută directorul „Logs” (și conținutul său) în directorul „Logs”-uri.

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

Se folosește parametrul LiteralPath în loc de Path, deoarece numele original al directoruluiinclude caracterele de paranteză stânga și paranteză dreapta („”).Calea este, de asemenea, închisă între ghilimele simple (‘ ‘), astfel încât simbolul backtick (`) să nu fie interpretat greșit.

Parametrul Destination nu necesită o cale literală, deoarece variabila Destination de asemeneatrebuie să fie închisă în ghilimele simple, deoarece include paranteze care pot fi interpretate greșit.

Parameters

-Confirm

Vă solicită confirmarea înainte de a executa cmdlet-ul.

Type: SwitchParameter
Aliases: cf
Position: Numit
Valoare implicită: False
Aceptă intrare în conductă: False
Acceptă caractere wildcard: False
-Credential

Note

Acceptă caractere wildcard:

False

Credential

Note

Acceptă caractere wildcardPentru a impersona un alt utilizator sau pentru a vă ridica acreditările atunci când executați acest cmdlet,utilizați Invoke-Command.

Tip: PSCredential
Poziție: Numit
Valoare implicită: Utilizator curent
Acceptă intrarea în conductă: True
Acceptă caractere wildcard: False
-Destination

Specifică calea către locația în care sunt mutate elementele.Valoarea implicită este directorul curent.Sunt permise caractere wildcards, dar rezultatul trebuie să specifice o singură locație.

Pentru a redenumi elementul care se mută, specificați un nume nou în valoarea parametrului Destination.

Tip: Stringere
Poziție: 1
Valoare implicită: Directorul curent
Acceptă intrarea în conductă: True
Acceptă caractere wildcard: True
-Exclude

Specifică, ca matrice de șiruri, un element sau elemente pe care acest cmdlet le exclude din operație. Valoarea acestui parametru califică parametrul Path. Introduceți un element sau un model de cale, cum ar fi*.txt. Sunt permise caractere wildcard. Parametrul Exclude este eficient numai atunci cândcomanda include conținutul unui element, cum ar fi C:\Windows\*, unde caracterul wildcard specifică conținutul directorului C:\Windows.

Tip: Șir de caractere
Poziție: Numit
Valoare implicită: Nimic
Acceptă intrarea în conductă: False
Acceptă caractere wildcard: True
-Filter

Specifică un filtru pentru a califica parametrul Path. Furnizorul FileSystemprovider este singurul furnizor PowerShell instalat care acceptă utilizarea de filtre. Puteți găsi sintaxa pentru limbajul de filtrare FileSystem în about_Wildcards.Filtrele sunt mai eficiente decât alți parametri, deoarece furnizorul le aplică atunci când cmdletarul primește obiectele, în loc ca PowerShell să filtreze obiectele după ce acestea sunt recuperate.

Tip: Stringă
Poziție: Numit
Valoare implicită: Nimic
Acceptă intrarea în conductă: False
Acceptă caractere wildcard: True
-Force

Forțează comanda să ruleze fără a cere confirmarea utilizatorului.Implementarea variază de la furnizor la furnizor. pentru mai multe informații, consultați about_Providers.

Tip: SwitchParameter
Poziție: Numit
Valoare implicită: False
Acceptă intrarea în conductă: False
Acceptă caractere wildcard: False
-Include

Specifică, ca matrice de șiruri, un element sau elemente pe care acest cmdlet le include în operație. Valoarea acestui parametru califică parametrul Path. Introduceți un element sau un model de cale, cum ar fi"*.txt". Sunt permise caractere wildcard. Parametrul Include este eficient numai atunci cândcomanda include conținutul unui element, cum ar fi C:\Windows\*, unde caracterul joker specifică conținutul directorului C:\Windows.

Tip: Șir de caractere
Poziție: Numit
Valoare implicită: Nimic
Acceptă intrarea în conductă: False
Acceptă caractere wildcard: True
-LiteralPath

Specifică o cale către una sau mai multe locații. Valoarea lui LiteralPath este utilizată exact așa cum este tastată. Niciun caracter nu este interpretat ca wildcards. În cazul în care calea include caractere de evadare, aceasta trebuie să fie între ghilimele simple. Ghilimelele simple îi spun lui PowerShell să nu interpreteze nici un caracterca secvențe de evadare.

Pentru mai multe informații, consultați about_Quoting_Rules.

Type: String
Aliase: PSPath, LP
Position: Numit
Valoare implicită: Nimic
Aceptă intrare în conductă: True
Acceptă caractere wildcard: False
-PassThru

Întoarce un obiect care reprezintă elementul cu care se lucrează.În mod implicit, acest cmdlet nu generează niciun rezultat.

Tip: SwitchParameter
Poziție: Numit
Valoare implicită: False
Acceptă intrarea în conductă: False
Acceptă caractere wildcard: False
-Path

Specifică calea către locația curentă a elementelor.Valoarea implicită este directorul curent.Sunt permise caractere wildcard.

Tip: Șir de caractere
Poziție: 0
Valoare implicită: Directorul curent
Acceptă intrarea în conductă: True
Acceptă caractere wildcard: True
-WhatIf

Află ce s-ar întâmpla dacă cmdlet-ul se execută.cmdlet-ul nu este executat.

Type: SwitchParameter
Aliases: wi
Position: Numit
Valoare implicită: False
Acceptă intrare în conductă: False
Acceptă caractere wildcard: False

Intrări

String

Puteți direcționa un șir care conține o cale către acest cmdlet.

Outputs

Nimic sau un obiect care reprezintă elementul mutat

Când utilizați parametrul PassThru, acest cmdlet generează un obiect care reprezintă elementul mutat. în caz contrar, acest cmdlet nu generează nicio ieșire.

Note

  • Acest cmdlet va muta fișiere între unități care sunt acceptate de același furnizor, dar va muta directoare numai în cadrul aceleiași unități.
  • Pentru că o comandă Move-Item mută proprietățile, conținutul și elementele copil ale unui element, toate mutările sunt recursive în mod implicit.
  • Acest cmdlet este conceput pentru a lucra cu datele expuse de orice furnizor.Pentru a lista furnizorii disponibili în sesiunea dumneavoastră, tastați Get-PSProvider.Pentru mai multe informații, consultați about_Providers.
  • Clear-Item
  • Copy-Item
  • Get-Item
  • Invoke-Item
  • New-Item
  • Remove-Item
  • Rename-Item
  • Set-Item
  • about_Providers

.

Lasă un răspuns

Adresa ta de email nu va fi publicată.