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

Remove-ItemProperty

  • Referencia
Modul:
Microsoft.PowerShell.Management

Törli a tulajdonságot és annak értékét egy elemből.

Syntax

Remove-ItemProperty
      [-Path] <String[]>
      [-Name] <String[]>
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<CommonParameters>]
Remove-ItemProperty
      -LiteralPath <String[]>
      [-Name] <String[]>
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<CommonParameters>]

Description

A Remove-ItemProperty parancsmag töröl egy tulajdonságot és annak értékét egy elemből. Ezzel törölheti a beállításjegyzék értékeit és az általuk tárolt adatokat.

Példák

1. példa: Beállításjegyzék-érték törlése

Ez a parancs törli a "SmpProperty" beállításjegyzék-értéket és annak adatait a "HKEY_LOCAL_MACHINE\Software" beállításkulcs "SmpApplication" alkulcsából.

Mivel a parancs egy fájlrendszer-meghajtóról (PS C:\>) van kiadva, tartalmazza a "SmpApplication" alkulcs teljes elérési útját, beleértve a meghajtót HKLM:és a "Szoftver" kulcsot.

A Név paraméter használatával azonosítja a törölni kívánt beállításjegyzék-értéket.

Remove-ItemProperty -Path "HKLM:\Software\SmpApplication" -Name "SmpProperty"

2. példa: Beállításjegyzék-érték törlése a HKCU helyről

Ezek a parancsok törlik a beállításjegyzék "Beállítások" értékét és adatait a "HKEY_CURRENT_USER\Software\MyCompany" "MyApp" alkulcsából.

Az első parancs a Set-Location parancsmaggal módosítja az aktuális helyet a HKEY_CURRENT_USER meghajtóra (HKCU:) és a "Software\MyCompany\MyApp" alkulcsra.

A második parancs eltávolítja Remove-ItemProperty a "Beállítások" beállításjegyzék-értéket és annak adatait a "MyApp" alkulcsból. Mivel az elérési út megadása kötelező, a parancs egy pont ('.') használatával jelzi az aktuális helyet. Név használatával adja meg, hogy melyik beállításjegyzék-értéket szeretné törölni. Az Érték törlése előtt a Megerősítés paraméterrel kér egy felhasználói kérést.

PS C:\> Set-Location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> Remove-ItemProperty -Path . -Name "Options" -Confirm

3. példa: Beállításjegyzék-érték eltávolítása a folyamat használatával

Ez a parancs törli a "NoOfEmployees" beállításértéket és annak adatait a "HKLM\Software\MyCompany" beállításkulcsból.

A parancs a Get-Item parancsmaggal lekér egy olyan elemet, amely a beállításkulcsot jelöli. Folyamatkezelőt (|) használ az objektum Remove-ItemPropertyelküldéséhez. Ezután a Név paraméter Remove-ItemProperty használatával adja meg a beállításjegyzék-érték nevét.

Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployees

Paraméterek

-Confirm

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

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Típus:PSCredential
Position:Named
Alapértelmezett érték:Current user
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Exclude

Megadja azokat az elemeket, amelyeket ez a parancsmag kihagy. Ennek a paraméternek az értéke az 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.

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:True

-Filter

A szűrőt a szolgáltató formátumában vagy nyelvén adja meg. Ennek a paraméternek az értéke az 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.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:True

-Force

Kényszeríti a parancsmagot egy olyan objektum tulajdonságának eltávolítására, amely egyébként nem érhető el a felhasználó számára. A megvalósítás szolgáltatónként eltérő. További információ: about_Providers.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Include

Sztringtömbként egy elemet vagy elemet határoz meg, amelyet ez a parancsmag tartalmaz a műveletben. Ennek a paraméternek az értéke az 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.

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:True

-LiteralPath

Megadja a tulajdonság aktuális helyének elérési útját. Az Elérési út paramétertől eltérően a LiteralPath értéke pontosan a beírt módon lesz használva. 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.

Típus:String[]
Aliasok:PSPath
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Name

Megadja az eltávolítandó tulajdonságok nevét. A helyettesítő karakterek használata engedélyezett.

Típus:String[]
Aliasok:PSProperty
Position:1
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:True

-Path

Annak az elemnek az elérési útját adja meg, amelynek a tulajdonságai el lettek távolítva. A helyettesítő karakterek használata engedélyezett.

Típus:String[]
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:True

-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.

Típus:SwitchParameter
Aliasok:usetx
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WhatIf

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

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

String

Ehhez a parancsmaghoz egy elérési utat tartalmazó, de nem literális elérési utat tartalmazó sztringet csövezhet.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

A Windows PowerShell a következő aliasokat Remove-ItemPropertytartalmazza:

  • rp

A PowerShell-beállításjegyzék-szolgáltatóban a beállításjegyzék-értékek egy beállításkulcs vagy alkulcs tulajdonságainak minősülnek. Ezeket az értékeket az ItemProperty parancsmagokkal kezelheti.

Remove-ItemProperty ú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.