Rename-Item

Modul:: Microsoft.PowerShell.Management Module

Átnevez egy elemet egy PowerShell-szolgáltató névterében.

Syntax

ByPath (Alapértelmezett)

Rename-Item
    [-Path] <String>
    [-NewName] <String>
    [-Force]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByLiteralPath

Rename-Item
    [-NewName] <String>
    -LiteralPath <String>
    [-Force]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

A Rename-Item parancsmag megváltoztatja egy adott elem nevét. Ez a parancsmag nem befolyásolja az átnevezett elem tartalmát.

Nem használhatja a Rename-Item-t egy elem áthelyezésére, például egy elérési útvonal és az új név megadásával. Egy elem áthelyezéséhez és átnevezéséhez használja a Move-Item parancsmagot.

Példák

1. példa: Fájl átnevezése

Ez a parancs átnevezi a fájlt daily_file.txtmonday_file.txt.

Rename-Item -Path "C:\logfiles\daily_file.txt" -NewName "monday_file.txt"

2. példa: Elem átnevezése és áthelyezése

Nem használhatja a Rename-Item-t egyszerre egy elem átnevezésére és áthelyezésére. Pontosabban nem adhat meg elérési utat a NewName paraméter értékéhez, kivéve, ha az elérési út megegyezik a Elérési út paraméterben megadott elérési útval. Ellenkező esetben csak új név engedélyezett.

Rename-Item -Path "project.txt" -NewName "D:\archive\old-project.txt"

Rename-Item : can't rename because the target specified represents a path or device name.
At line:1 char:12
+ Rename-Item <<<<  -Path project.txt -NewName D:\archive\old-project.txt
+ CategoryInfo          : InvalidArgument: (:) [Rename-Item], PS>  Move-Item -Path "project.txt" -De
stination "D:\archive\old-project.txt"

Ez a példa megpróbálja átnevezni az aktuális könyvtárban lévő project.txt fájlt old-project.txt a D:\Archive könyvtárban. Az eredmény a kimenetben megjelenő hiba.

Ehelyett használja a Move-Item parancsmagot.

3. példa: Beállításkulcs átnevezése

Ez a példa egy beállításkulcsot nevez át Hirdetési-ről Marketing-ra. Ha a parancs befejeződött, a kulcs átnevezve lesz, de a kulcs beállításjegyzék-bejegyzései nem változnak.

Rename-Item -Path "HKLM:\Software\MyCompany\Advertising" -NewName "Marketing"

4. példa: Több fájl átnevezése

Ez a példa átnevezi az aktuális könyvtárban lévő összes *.txt fájlt *.log.

Get-ChildItem *.txt

    Directory: C:\temp\files

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        10/3/2019   7:47 AM           2918 Friday.TXT
-a----        10/3/2019   7:46 AM           2918 Monday.Txt
-a----        10/3/2019   7:47 AM           2918 Wednesday.txt

Get-ChildItem *.txt | Rename-Item -NewName { $_.Name -replace '.txt','.log' }
Get-ChildItem *.log

    Directory: C:\temp\files

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        10/3/2019   7:47 AM           2918 Friday.log
-a----        10/3/2019   7:46 AM           2918 Monday.log
-a----        10/3/2019   7:47 AM           2918 Wednesday.log

A Get-ChildItem parancsmag lekéri az aktuális mappában lévő összes fájlt, amelyek .txt fájlkiterjesztéssel rendelkeznek, majd ezeket továbbítja a Rename-Itemszámára. A NewName értéke egy szkriptblokk, amely az érték NewName paraméterbe való elküldése előtt fut.

A szkriptblokkban a $_ automatikus változó az egyes fájlobjektumokat jelöli a parancs folyamaton keresztüli végrehajtásakor. A szkriptblokk a -replace operátorral cseréli le az egyes fájlok fájlkiterjesztését .log. Figyelje meg, hogy a -replace operátorral való egyeztetés nem érzékeny a kis- és nagybetűkre.

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

-Force

Kényszeríti a parancsmagot, hogy átnevezze az egyébként nem módosítható elemeket, például rejtett vagy írásvédett fájlokat, írásvédett aliasokat vagy változókat. A parancsmag nem módosíthatja az állandó aliasokat vagy változókat. A megvalósítás szolgáltatónként eltérő. További információért lásd a about_Providerscímű részt.

A parancsmag még a Force paraméter használatával sem tudja felülbírálni a biztonsági korlátozásokat.

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

-LiteralPath

Egy vagy több hely elérési útját adja meg. A LiteralPath értéke pontosan a beíráskor használatos. 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.

További információk az about_Quoting_Rules oldalon találhatók: .

Paramétertulajdonságok

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

Paraméterkészletek

ByLiteralPath

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

-NewName

Megadja az elem új nevét. Csak nevet adjon meg, elérési utat és nevet nem. Ha olyan elérési utat ad meg, amely eltér a Elérési út paraméterben megadott elérési úttól, Rename-Item hibát okoz. Egy elem átnevezéséhez és áthelyezéséhez használja a Move-Item.

Nem használhat helyettesítő karaktereket a NewName paraméter értékében. Ha több fájl nevét szeretné megadni, használja a -replace operátort egy reguláris kifejezésben. A -replace operátorral kapcsolatos további információkért nézze meg a about_Comparison_Operatorsrészt.

Paramétertulajdonságok

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

Paraméterkészletek

(All)

Position:	1
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

Egy objektumot ad vissza, amely az elemet jelöli a folyamatba. 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 átnevezni kívánt elem elérési útját.

Paramétertulajdonságok

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

Paraméterkészletek

ByPath

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

-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

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

PSObject

A PassThru paraméter használatakor ez a parancsmag az átnevezett elemet képviselő objektumot adja vissza.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza Rename-Item:

Minden platform:
- ren
- rni

Rename-Item úgy tervezték, 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.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Megosztás a következőn keresztül:

Rename-Item

Syntax

ByPath (Alapértelmezett)

ByLiteralPath

Description

Példák

1. példa: Fájl átnevezése

2. példa: Elem átnevezése és áthelyezése

3. példa: Beállításkulcs átnevezése

4. példa: Több fájl átnevezése

Paraméterek

-Confirm

Paramétertulajdonságok

Paraméterkészletek

-Credential

Paramétertulajdonságok

Paraméterkészletek

-Force

Paramétertulajdonságok

Paraméterkészletek

-LiteralPath

Paramétertulajdonságok

Paraméterkészletek

-NewName

Paramétertulajdonságok

Paraméterkészletek

-PassThru

Paramétertulajdonságok

Paraméterkészletek

-Path

Paramétertulajdonságok

Paraméterkészletek

-WhatIf

Paramétertulajdonságok

Paraméterkészletek

CommonParameters

Bevitelek

String

Kimenetek

None

PSObject

Jegyzetek

Kapcsolódó hivatkozások

Visszajelzés