Rename-Item

Referencia

Modul:: Microsoft.PowerShell.Management

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

Syntax

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

Rename-Item
      -LiteralPath <String>
      [-NewName] <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 Rename-Item helyezhet át elemeket, például egy elérési utat az új névvel együtt. 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 a következőre 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 Rename-Item az elemek átnevezését és áthelyezését. Pontosabban nem adhat meg elérési utat a NewName paraméter értékéhez, kivéve, ha az elérési út megegyezik az 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 project.txt aktuális könyvtárban old-project.txt lévő fájlt a D:\Archive könyvtárba. Az eredmény a kimenetben megjelenő hiba.

Használja inkább a Move-Item parancsmagot.

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

Ez a példa átnevez egy beállításkulcsot reklámról marketingre. 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 *.txt aktuális könyvtárban lévő összes fájlt a következőre *.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, amely rendelkezik fájlkiterjesztéssel .txt , majd a következőre Rename-Itemcsövezi őket. A NewName értéke egy szkriptblokk, amely az érték NewName paraméterbe való elküldése előtt fut.

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

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Feljegyzés

Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják. Ha megszemélyesíteni szeretne egy másik felhasználót, vagy a parancsmag futtatásakor emeli a hitelesítő adatait, használja az Invoke-Command parancsot.

Type:	PSCredential
Position:	Named
Default value:	Current user
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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ó: about_Providers.

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LiteralPath

Egy vagy több hely elérési útját adja meg. A LiteralPath értékét pontosan a beírt módon használja a rendszer. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz escape karaktereket, csatolja egy idézőjelek közé. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket feloldósorozatként.

További információ: about_Quoting_Rules.

Type:	String
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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 az Elérési út paraméterben megadott elérési úttól, Rename-Item hibát generál. Egy elem átnevezéséhez és áthelyezéséhez használja a következőt Move-Item: .

A NewName paraméter értékében nem használhat helyettesítő karaktereket. Ha több fájl nevét szeretné megadni, használja a Csere operátort egy reguláris kifejezésben. További információ a Csere operátorról: about_Comparison_Operators.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PassThru

Egy objektumot ad vissza, amely az elemet jelöli a folyamatnak. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

Megadja az átnevezni kívánt elem elérési útját.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Bevitelek

String

A parancsmag elérési útját tartalmazó sztringet csövezheti.

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 Rename-Itemtartalmazza:

Minden platform:
- ren
- rni

Rename-Item ú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 következőt Get-PsProvider: További információ: about_Providers.

Rename-Item

Syntax

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

-Credential

-Force

-LiteralPath

-NewName

-PassThru

-Path

-WhatIf

Bevitelek

Kimenetek

Jegyzetek

Visszajelzés

További források

Rename-Item

Syntax

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

-Credential

-Force

-LiteralPath

-NewName

-PassThru

-Path

-WhatIf

Bevitelek

Kimenetek

Jegyzetek

Kapcsolódó hivatkozások

Visszajelzés

További források