Move-Item

Modul:

Microsoft.PowerShell.Management Module

Elem áthelyezése egyik helyről a másikra.

Syntax

Path (Alapértelmezett)

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

LiteralPath

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

Description

A Move-Item parancsmag áthelyez egy elemet, beleértve annak tulajdonságait, tartalmát és gyermekelemeit egyik helyről a másik helyre. A helyeket ugyanannak a szolgáltatónak kell támogatnia. Áthelyezhet például egy fájlt vagy alkönyvtárat egyik könyvtárból a másikba, vagy áthelyezhet egy beállításjegyzék-alkulcsot egyik kulcsról a másikra. Amikor áthelyez egy elemet, az új helyre kerül, és törlődik az eredeti helyről.

Példák

1. példa: Fájl áthelyezése egy másik könyvtárba és átnevezése

Ez a parancs áthelyezi a "Test.txt" fájlt a C: meghajtóról az "E:\Temp" könyvtárba, és átnevezi a "test.txt" fájlról a "tst.txt" névre.

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

2. példa: Könyvtár és tartalma áthelyezése másik könyvtárba

Ez a parancs áthelyezi a "C:\Temp" könyvtárat és annak tartalmát a "C:\Logs" könyvtárba. A "Temp" könyvtár, valamint annak összes alkönyvtára és fájlja megjelenik a "Naplók" könyvtárban.

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

3. példa: Egy adott bővítmény összes fájljának áthelyezése az aktuális könyvtárból egy másik könyvtárba

Ez a parancs áthelyezi az összes szövegfájlt ("*.txt") az aktuális könyvtárban (amelyet pont ('.')) jelöl) a "C:\Logs" könyvtárba.

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

4. példa: Egy adott bővítmény összes fájljának rekurzív áthelyezése az aktuális könyvtárból egy másik könyvtárba

Ez a parancs áthelyezi az összes szövegfájlt az aktuális könyvtárból és az összes alkönyvtárból rekurzív módon a "C:\TextFiles" könyvtárba.

A parancs a Get-ChildItem parancsmaggal lekéri az aktuális könyvtár összes gyermekelemét (a pont [.]) és annak alkönyvtárait, amelyek ".txt" fájlnévkiterjesztéssel rendelkeznek. A Recurse paraméter használatával teszi rekurzívvá a lekérést, az Include paraméter pedig a ".txt" fájlokra korlátozza a lekérést.

A folyamat operátora (|) elküldi a parancs eredményeit Move-Item, amely a szövegfájlokat a "TextFiles" könyvtárba helyezi át.

Ha a "C:\Textfiles" fájlba áthelyezendő fájlok neve megegyezik, Move-Item hibaüzenet jelenik meg, és folytatódik, de csak egy, minden névvel rendelkező fájlt helyez át a "C:\Textfiles" fájlba. A többi fájl az eredeti könyvtárakban marad.

Ha a "Textfiles" könyvtár (vagy a célút bármely más eleme) nem létezik, a parancs meghiúsul. A hiányzó könyvtár akkor sem jön létre, ha a Force paramétert használja. Move-Item áthelyezi az első elemet egy "Textfiles" nevű fájlba, majd hibaüzenetet jelenít meg, amely azt jelzi, hogy a fájl már létezik.

Emellett alapértelmezés szerint Get-ChildItem nem helyezi át a rejtett fájlokat. Rejtett fájlok áthelyezéséhez használja a Force paramétert Get-ChildItem.

Megjegyzés: A Windows PowerShell 2.0-ban a parancsmag Get-ChildItem paraméterének használatakor a Elérési út paraméter értékének tárolónak kell lennie. A Include paraméter használatával adja meg a .txt fájlnévkiterjesztés szűrőt (Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles).

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

5. példa: Beállításkulcsok és értékek áthelyezése egy másik kulcsra

Ez a parancs a "HKLM\Software" "MyCompany" beállításkulcsában lévő beállításkulcsokat és értékeket a "MyNewCompany" kulcsra helyezi át. A helyettesítő karakter (*) azt jelzi, hogy a "MyCompany" kulcs tartalmát át kell helyezni, nem magát a kulcsot. Ebben a parancsban a választható Elérési út és Cél paraméternevek nem lesznek megadva.

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

6. példa: Könyvtár és tartalma áthelyezése a megadott könyvtár alkönyvtárába

Ez a parancs áthelyezi a "Logs[Sept'06]" könyvtárat (és annak tartalmát) a "Logs[2006]" könyvtárba.

A LiteralPath paramétert használja a rendszer az elérési úthelyett, mivel az eredeti könyvtárnév bal oldali zárójelet és jobb oldali szögletes zárójelet ("[" és "]") tartalmaz. Az elérési út egy idézőjelben (' ') is szerepel, hogy a háttérjel (') ne legyen félreértve.

A Cél paraméter nem igényel literális elérési utat, mivel a Cél változót is egy idézőjelek közé kell foglalni, mivel olyan zárójeleket tartalmaz, amelyek félreérthetők.

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

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Cf

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Credential

Megjegyzés:

Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják. Ha egy másik felhasználó szerepében szeretne fellépni, vagy emelni szeretné hitelesítő adatait a parancsmag futtatásakor, használja a Invoke-Command.

Paramétertulajdonságok

Típus:	PSCredential
Alapértelmezett érték:	Current user
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Destination

Megadja az elemek áthelyezési helyének elérési útját. Az alapértelmezett az aktuális könyvtár. A helyettesítő karakterek használata engedélyezett, de az eredménynek egyetlen helyet kell megadnia.

Az áthelyezett elem átnevezéséhez adjon meg egy új nevet a Cél paraméter értékében.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	Current directory
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

(All)

Position:	1
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Exclude

Sztringtömbként olyan elemet vagy elemeket határoz meg, amelyeket ez a parancsmag kizár a műveletből. Ennek a paraméternek az értéke a Elérési út paramétert minősíti. Adjon meg egy elérési út elemet vagy mintát, például "*.txt". A helyettesítő karakterek használata engedélyezett.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Filter

A szűrőt a szolgáltató formátumában vagy nyelvén adja meg. Ennek a paraméternek az értéke a Elérési út paramétert minősíti.

A szűrő szintaxisa, beleértve a helyettesítő karakterek használatát is, a szolgáltatótól függ. A szűrők hatékonyabbak, mint a többi paraméter, mivel a szolgáltató akkor alkalmazza őket, amikor a parancsmag lekéri az objektumokat, és nem azt, hogy a PowerShell szűrje az objektumokat a lekérés után.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne. A megvalósítás szolgáltatónként eltérő. További információért lásd a about_Providerscímű részt.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Include

Sztringtömbként megadja a parancsmag által a műveletben áthelyezett elemet vagy elemeket. Ennek a paraméternek az értéke a Elérési út paramétert minősíti. Adjon meg egy elérési út elemet vagy mintát, például "*.txt". A helyettesítő karakterek használata engedélyezett.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-LiteralPath

Megadja az elemek aktuális helyének elérési útját. A Path paramétertől eltérően a LiteralPath értéke pontosan a beíráskor lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	PSPath

Paraméterkészletek

LiteralPath

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-PassThru

Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Path

Megadja az elemek aktuális helyének elérési útját. Az alapértelmezett az aktuális könyvtár. A helyettesítő karakterek használata engedélyezett.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	Current directory
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

Path

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-UseTransaction

Tartalmazza a parancsot az aktív tranzakcióban. Ez a paraméter csak akkor érvényes, ha egy tranzakció folyamatban van. További információ: about_Transactions.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	usetx

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Wi

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

Egy elérési utat tartalmazó karakterláncot küldhet tovább ehhez a cmdlethez.

Kimenetek

None or an object representing the moved item.

A PassThru paraméter használatakor ez a parancsmag létrehoz egy objektumot, amely az áthelyezett elemet jelöli. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.

Jegyzetek

Ez a parancsmag áthelyezi a fájlokat az ugyanazon szolgáltató által támogatott meghajtók között, de a könyvtárakat csak ugyanazon a meghajtón belül helyezi át.

Mivel egy Move-Item parancs áthelyezi egy elem tulajdonságait, tartalmát és gyermekelemeit, az összes áthelyezés alapértelmezés szerint rekurzív.

Ez a parancsmag úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön együtt. A munkamenetben elérhető szolgáltatók listájához írja be a Get-PSProvider. További információért lásd a about_Providerscímű részt.

Kapcsolódó hivatkozások

• Elem törlése
• Másolás-Elem
• Get-Item (Elem lekérése)
• Invoke-Item
• Új-Elem
• Elem eltávolítása
• Átnevezés-Elem
• Set-Item
• A szolgáltatókról