Remove-ItemProperty

  • Reference
Modul:
Microsoft.PowerShell.Management

Odstraní vlastnost a její hodnotu z položky.

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

Rutina Remove-ItemProperty odstraní vlastnost a její hodnotu z položky. Můžete ho použít k odstranění hodnot registru a dat, která ukládají.

Příklady

Příklad 1: Odstranění hodnoty registru

Tento příkaz odstraní hodnotu registru SmpProperty a jeho data z podklíče "SmpApplication" klíče registru "HKEY_LOCAL_MACHINE\Software".

Vzhledem k tomu, že příkaz je vydán z jednotky systému souborů (PS C:\>), zahrnuje plně kvalifikovanou cestu podklíče "SmpApplication", včetně jednotky, HKLM:a klíče "Software".

Pomocí parametru Name identifikuje odstraněnou hodnotu registru.

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

Příklad 2: Odstranění hodnoty registru z umístění HKCU

Tyto příkazy odstraní hodnotu registru Options a její data z podklíče MyApp HKEY_CURRENT_USER\Software\MyCompany.

První příkaz pomocí rutiny změní aktuální umístění na jednotku Set-Location HKEY_CURRENT_USER (HKCU:) a podklíč Software\MyCompany\MyApp.

Druhý příkaz použije Remove-ItemProperty k odebrání hodnoty registru Options a jeho dat z podklíče MyApp. Vzhledem k tomu , že je požadována cesta , příkaz použije tečku (.) k označení aktuálního umístění. Pomocí názvu určí, která hodnota registru se má odstranit. Před odstraněním hodnoty použije parametr Confirm k vyžádání výzvy uživatele.

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

Příklad 3: Odebrání hodnoty registru pomocí kanálu

Tento příkaz odstraní hodnotu registru NoOfEmployees a jeho data z klíče registru HKLM\Software\MyCompany.

Příkaz pomocí rutiny Get-Item získá položku, která představuje klíč registru. Používá operátor kanálu (|) k odeslání objektu do Remove-ItemProperty. Potom pomocí parametru Remove-ItemProperty Name určuje název hodnoty registru.

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

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Credential

Poznámka:

Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými v PowerShellu. Pokud chcete zosobnit jiného uživatele nebo zvýšit úroveň přihlašovacích údajů při spuštění této rutiny, použijte Invoke-Command.

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

-Exclude

Určuje položky, které tato rutina vynechá. Hodnota tohoto parametru kvalifikuje parametr Path . Zadejte prvek cesty nebo vzor, například "*.txt". Jsou povoleny zástupné znaky.

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

-Filter

Určuje filtr ve formátu nebo jazyce poskytovatele. Hodnota tohoto parametru kvalifikuje parametr Path .

Syntaxe filtru, včetně použití zástupných znaků, závisí na poskytovateli. Filtry jsou efektivnější než jiné parametry, protože je poskytovatel použije, když rutina získá objekty místo toho, aby objekty po jejich načtení vyfiltroval PowerShell.

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

-Force

Vynutí, aby rutina odebrala vlastnost objektu, ke kterému jinak uživatel nemá přístup. Implementace se liší od zprostředkovatele po zprostředkovatele. Další informace najdete v tématu about_Providers.

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

-Include

Určuje, jako pole řetězců, položku nebo položky, které tato rutina zahrnuje v operaci. Hodnota tohoto parametru kvalifikuje parametr Path . Zadejte prvek cesty nebo vzor, například "*.txt". Jsou povoleny zástupné znaky.

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

-LiteralPath

Určuje cestu k aktuálnímu umístění vlastnosti. Na rozdíl od parametru Path se hodnota LiteralPath používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby nepřekládaly žádné znaky jako řídicí sekvence.

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

-Name

Určuje názvy vlastností, které se mají odebrat. Jsou povoleny zástupné znaky.

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

-Path

Určuje cestu položky, jejíž vlastnosti jsou odebrány. Jsou povoleny zástupné znaky.

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

-UseTransaction

Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace najdete v tématu about_Transactions.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

String

Řetězec, který obsahuje cestu, ale ne literálovou cestu, můžete do této rutiny převést.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

Windows PowerShell obsahuje následující aliasy pro Remove-ItemProperty:

  • rp

Ve zprostředkovateli registru PowerShellu se hodnoty registru považují za vlastnosti klíče registru nebo podklíče. Tyto hodnoty můžete spravovat pomocí rutin ItemProperty .

Remove-ItemProperty je navržený tak, aby fungoval s daty vystavenými jakýmkoli poskytovatelem. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PSProvider. Další informace najdete v tématu about_Providers.