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>]
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-ItemProperty
      -LiteralPath <String[]>
      [-Name] <String[]>
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<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 beállításkulcs "SmpApplication" alkulcsából HKEY_LOCAL_MACHINE\Software .

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

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.

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_U Standard kiadás R\Software\MyCompany" "MyApp" alkulcsából.

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

Az első parancs a Set-Location parancsmaggal módosítja az aktuális helyet az HKEY_CURRENT_U Standard kiadás R meghajtóra (HKCU:) és az 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 pont (.) használatával jelzi az aktuális helyet. A Megerősítés paraméter az érték törlése előtt egy felhasználói kérést kér.

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ásjegyzék-értéket és annak adatait a HKLM\Software\MyCompany beállításkulcsból.

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

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.

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

-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 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. A Kizárás paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza, például C:\Windows\*ha a helyettesítő karakter a könyvtár tartalmát C:\Windows adja meg.

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

-Filter

Egy szűrőt ad meg, amely megfelel az Elérési út paraméternek. 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ének szintaxisa about_Wildcards található. 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Az Include paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza, például C:\Windows\*amikor a helyettesítő karakter a könyvtár tartalmát C:\Windows adja meg.

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

-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

-Name

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

Type:String[]
Aliases:PSProperty
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:0
Default value:None
Required:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters: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 PowerShell a következő aliasokat Remove-ItemPropertytartalmazza:

  • Összes platform:

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