Sdílet prostřednictvím

Remove-ItemProperty

  • Reference
Modul:
Microsoft.PowerShell.Management

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

Syntaxe

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

K identifikaci odstraněné hodnoty registru používá parametr Name.

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 použije rutinu Set-Location ke změně aktuálního umístění na jednotku HKEY_CURRENT_USER (HKCU:) a podklíč Software\MyCompany\MyApp.

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

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 používá rutinu Get-Item k získání položky, která představuje klíč registru. Používá operátor kanálu (|) k odeslání objektu do Remove-ItemProperty. Potom použije parametr NameRemove-ItemProperty k určení názvu hodnoty registru.

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

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 oprávnění při spuštění této rutiny, použijte Invoke-Command.

Typ:PSCredential
Position:Named
Default value:Current user
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 naleznete v tématu about_Providers.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String[]
Aliasy:PSPath
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

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

Typ:String[]
Aliasy:PSProperty
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-Path

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

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Aliasy:usetx
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 nevrací žádný výstup.

Poznámky

Ve zprostředkovateli registru PowerShellu se hodnoty registru považují za vlastnosti klíče registru nebo podklíče. Ke správě těchto hodnot můžete použít rutiny ItemProperty.

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