Move-Item
Přesune položku z jednoho umístění do jiného.
Syntaxe
Path (Výchozí)
Move-Item
[-Path] <String[]>
[[-Destination] <String>]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
LiteralPath
Move-Item
[[-Destination] <String>]
-LiteralPath <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Move-Item přesune položku, včetně jejích vlastností, obsahu a podřízených položek, z jednoho umístění do jiného. Umístění musí být podporována stejným poskytovatelem.
Může například přesunout soubor nebo podadresář z jednoho adresáře do jiného nebo přesunout podklíč registru z jednoho klíče do druhého. Když položku přesunete, přidá se do nového umístění a odstraní se z původního umístění.
Příklady
Příklad 1: Přesunutí souboru do jiného adresáře a jeho přejmenování
Tento příkaz přesune soubor Test.txt z jednotky C: do adresáře E:\Temp a přejmenuje ho z test.txt do tst.txt.
Move-Item -Path C:\test.txt -Destination E:\Temp\tst.txt
Příklad 2: Přesunutí adresáře a jeho obsahu do jiného adresáře
Tento příkaz přesune C:\Temp adresář a jeho obsah do C:\Logs adresáře.
Adresář Temp a všechny jeho podadresáře a soubory se pak zobrazí v Logs adresáři.
Move-Item -Path C:\Temp -Destination C:\Logs
Příklad 3: Přesunutí všech souborů zadané přípony z aktuálního adresáře do jiného adresáře
Tento příkaz přesune všechny textové soubory (*.txt) v aktuálním adresáři (reprezentované tečkou (.)) do C:\Logs adresáře.
Move-Item -Path .\*.txt -Destination C:\Logs
Příklad 4: Rekurzivně přesuňte všechny soubory zadané přípony z aktuálního adresáře do jiného adresáře.
Tento příkaz přesune všechny textové soubory z aktuálního adresáře a všech podadresářů rekurzivně do C:\TextFiles adresáře.
Get-ChildItem -Path ".\*.txt" -Recurse | Move-Item -Destination "C:\TextFiles"
Příkaz pomocí rutiny Get-ChildItem získá všechny podřízené položky v aktuálním adresáři (reprezentované tečkou (.)) a jeho podadresáře, které mají příponu názvu souboru *.txt. Pomocí parametru Recurse nastaví rekurzivní načtení a parametr Include k omezení načítání na soubory *.txt.
Operátor kanálu (|) odešle výsledky tohoto příkazu do Move-Item, který přesune textové soubory do TextFiles adresáře.
Pokud se soubory, které se mají přesunout do C:\Textfiles mají stejný název, Move-Item zobrazí chybu a bude pokračovat, ale přesune se do C:\Textfilesjenom jeden soubor s každým názvem . Ostatní soubory zůstanou v původních adresářích.
Pokud adresář Textfiles (nebo jakýkoli jiný prvek cílové cesty) neexistuje, příkaz selže. Chybějící adresář se pro vás nevytvořil, i když použijete parametr Force.
Move-Item přesune první položku do souboru s názvem Textfiles a zobrazí chybu s vysvětlením, že soubor již existuje.
Ve výchozím nastavení Get-ChildItem také nepřesouvají skryté soubory. Pokud chcete přesunout skryté soubory, použijte parametr Force s Get-ChildItem.
Poznámka:
Při použití parametru Recurse rutiny Get-ChildItem v prostředí Windows PowerShell 2.0 musí být hodnota parametru Path kontejnerem. Pomocí parametru Include zadejte filtr přípony názvu souboru *.txt (Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles).
Příklad 5: Přesunutí klíčů registru a hodnot do jiného klíče
Tento příkaz přesune klíče registru a hodnoty v klíči registru MyCompany v HKLM\Software do klíče MyNewCompany. Zástupný znak (*) označuje, že obsah klíče MyCompany by se měl přesunout, nikoli samotný klíč. V tomto příkazu nejsou vynechány volitelné názvy parametrů Cesta a Cíl.
Move-Item "HKLM:\software\mycompany\*" "HKLM:\software\mynewcompany"
Příklad 6: Přesunutí adresáře a jeho obsahu do podadresáře zadaného adresáře
Tento příkaz přesune adresář Logs[Sept`06] (a jeho obsah) do Logs[2006] adresáře.
Move-Item -LiteralPath 'Logs[Sept`06]' -Destination 'Logs[2006]'
Parametr LiteralPath se používá místo cestacesta , protože původní název adresáře obsahuje znaky závorek a pravých závorek ([ a ]). Cesta je také uzavřena do jednoduchých uvozovek ('), takže symbol zpětného zadku (`) není chybně interpretován.
Parametr Destination musí být také uzavřený v jednoduchých uvozovkách, protože obsahuje hranaté závorky, které lze chybně interpretovat.
Parametry
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Credential
Poznámka:
Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými v PowerShellu. Pokud chcete zosobnit jiného uživatele nebo zvýšit oprávnění při spuštění této rutiny, použijte Invoke-Command.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | Current user |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Destination
Určuje cestu k umístění, kam se položky přesouvají. Výchozí hodnota je aktuální adresář. Zástupné cardy nejsou povolené.
Chcete-li přejmenovat přesunutou položku, zadejte nový název v hodnotě parametru Destination.
Vlastnosti parametru
| Typ: | String |
| Default value: | Current directory |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Exclude
Určuje, jako pole řetězců, položku nebo položky, které tento příkaz vylučuje z operace. Hodnota tohoto parametru kvalifikuje parametr Path. Zadejte prvek cesty nebo vzor, například *.txt. Jsou povoleny zástupné znaky. Parametr Exclude je efektivní pouze v případě, že příkaz obsahuje obsah položky, například C:\Windows\*, kde zástupný znak určuje obsah adresáře C:\Windows.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Filter
Určuje filtr pro kvalifikaci parametru Path. Zprostředkovatel FileSystem je jediným nainstalovaným poskytovatelem PowerShellu, který podporuje použití filtrů. Syntaxi jazyka filtru FileSystem najdete v about_Wildcards. Filtry jsou efektivnější než jiné parametry, protože je poskytovatel použije, když rutina získá objekty místo toho, aby objekty po jejich načtení vyfiltroval PowerShell.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele. Implementace se liší od zprostředkovatele po zprostředkovatele. Pro více informací viz about_Providers.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Include
Určuje, jako pole řetězců, jednu nebo více položek, které tento cmdlet zahrnuje v operaci. Hodnota tohoto parametru kvalifikuje parametr Path. Zadejte prvek cesty nebo vzor, například *.txt. Jsou povoleny zástupné znaky. Parametr Include je efektivní pouze v případě, že příkaz obsahuje obsah položky, například C:\Windows\*, kde zástupný znak určuje obsah adresáře C:\Windows.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-LiteralPath
Určuje cestu k jednomu nebo více místům. Hodnota LiteralPath se používá přesně tak, jak je zadána. Žádný znak není interpretován jako zástupný znak. Pokud cesta obsahuje escape znaky, uzavřete ji do jednoduchých uvozovek ('). Jednoduché uvozovky říkají PowerShellu, aby žádné znaky neinterpretoval jako únikové sekvence.
Další informace najdete v about_Quoting_Rules.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath, PO |
Sady parametrů
LiteralPath
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Vrátí objekt představující přesunutou položku. Ve výchozím nastavení tato rutina negeneruje žádný výstup.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Path
Určuje cestu k aktuálnímu umístění položek. Výchozí hodnota je aktuální adresář. Jsou povoleny zástupné znaky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | Current directory |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
Path
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
Řetězec, který obsahuje cestu, můžete předat tomuto cmdletu.
Výstupy
None
Ve výchozím nastavení tato rutina nevrací žádný výstup.
PSObject
Pokud použijete parametr PassThru, vrátí tato rutina objekt představující přesunutou položku.
Poznámky
PowerShell obsahuje následující aliasy pro Move-Item:
Všechny platformy:
mimove
Windows:
mv
Tato rutina přesune soubory mezi jednotkami podporovanými stejným poskytovatelem, ale přesune adresáře pouze na stejnou jednotku.
Vzhledem k tomu, že příkaz
Move-Itempřesune vlastnosti, obsah a podřízené položky položky, jsou všechny přesuny ve výchozím nastavení rekurzivní.Tato rutina je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem. Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište
Get-PSProvider. Pro více informací viz about_Providers.
