Rename-ItemProperty

Átnevez egy elem tulajdonságát.

Syntax

Rename-ItemProperty
      [-Path] <String>
      [-Name] <String>
      [-NewName] <String>
      [-PassThru]
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Rename-ItemProperty
      -LiteralPath <String>
      [-Name] <String>
      [-NewName] <String>
      [-PassThru]
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

A Rename-ItemProperty parancsmag megváltoztatja egy adott elemtulajdonság nevét. A tulajdonság értéke nem változik. A használatával Rename-ItemProperty például módosíthatja egy beállításjegyzék-bejegyzés nevét.

Példák

1. példa: Beállításjegyzék-bejegyzés átnevezése

Ez a parancs átnevezi a kulcsban HKEY_LOCAL_MACHINE\Software\SmpApplication található konfigurációs beállításjegyzék-bejegyzést "oldconfig" névre.

Rename-ItemProperty -Path HKLM:\Software\SmpApplication -Name config -NewName oldconfig

Paraméterek

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters: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ót szeretne megszemélyesíteni, vagy a parancsmag futtatásakor megemelni a hitelesítő adatait, használja az Invoke-Command parancsot.

Type:PSCredential
Position:Named
Default value:Current user
Accept pipeline input:True
Accept wildcard characters:False

-Exclude

Sztringtömbként olyan elemet vagy elemeket határoz meg, amelyeket a parancsmag kizár a műveletből. Ennek a paraméternek az értéke a Path paramétert minősíti. Adjon meg egy elérésiút-elemet vagy mintát, például *.txt: . Helyettesítő karakterek használata engedélyezett. Az Exclude paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza( például C:\Windows\*), ahol a helyettesítő karakter a könyvtár tartalmát C:\Windows határozza meg.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Filter

Egy szűrőt ad meg a Path paraméter minősítéséhez. A Fájlrendszer-szolgáltató az egyetlen telepített PowerShell-szolgáltató, amely támogatja a szűrők használatát. A Fájlrendszer szűrőnyelv szintaxisát a about_Wildcards találja. 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 ahelyett, hogy a PowerShell a lekérésük után szűri az objektumokat.

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

-Force

Kényszeríti a parancsmagot egy olyan objektum tulajdonságának átnevezésére, amelyet egyébként nem érhet el a felhasználó. Az implementáció szolgáltatónként eltérő. További információ: about_Providers.

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

-Include

Sztringtömbként megad egy elemet vagy elemet, amelyet ez a parancsmag tartalmaz a műveletben. Ennek a paraméternek az értéke a Path paramétert minősíti. Adjon meg egy elérésiút-elemet vagy mintát, például "*.txt": . Helyettesítő karakterek használata engedélyezett. Az Include paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza( például C:\Windows\*), ahol a helyettesítő karakter a könyvtár tartalmát C:\Windows határozza meg.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

Megadja az elem elérési útját. 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 út tartalmaz feloldókaraktereket, tegye idézőjelek közé. Az egyszeres idézőjelek azt jelzik, hogy a PowerShell nem értelmez feloldósorozatként egyetlen karaktert sem.

További információ: about_Quoting_Rules.

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Az átnevezni kívánt tulajdonság aktuális nevét adja meg.

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

-NewName

Megadja a tulajdonság új nevét.

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

-PassThru

Egy objektumot ad vissza, amely az elem tulajdonságát jelöli. Alapértelmezés szerint ez a parancsmag nem ad kimenetet.

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

-Path

Megadja az elem elérési útját. Helyettesítő karakterek használata engedélyezett.

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

-WhatIf

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

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

Bevitelek

String

Erre a parancsmagra egy elérési utat tartalmazó, de nem literális elérési utat tartalmazó sztringet helyezhet el.

Kimenetek

None, System.Management.Automation.PSCustomObject

Ez a parancsmag létrehoz egy PSCustomObject objektumot, amely az átnevezett elemtulajdonságot jelöli, ha megadja a PassThru paramétert. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.

Jegyzetek

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

  • Összes platform:
    • rnp

Remove-ItemProperty úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön. A munkamenetben elérhető szolgáltatók listázásához írja be a következőt Get-PSProvider: . További információ: about_Providers.