Share via

Remove-ItemProperty

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

Usuwa właściwość i jej wartość z elementu.

Składnia

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

Opis

Polecenie Remove-ItemProperty cmdlet usuwa właściwość i jej wartość z elementu. Można go użyć do usuwania wartości rejestru i przechowywanych przez nich danych.

Przykłady

Przykład 1. Usuwanie wartości rejestru

To polecenie usuwa wartość rejestru "SmpProperty" i jego dane z podklucza "SmpApplication" klucza rejestru "HKEY_LOCAL_MACHINE\Software".

Ponieważ polecenie jest wydawane z dysku systemu plików (PS C:\>), zawiera w pełni kwalifikowaną ścieżkę podklucza "SmpApplication", w tym dysk, HKLM:i klucz "Oprogramowanie".

Używa parametru Name do identyfikowania wartości rejestru, która jest usuwana.

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

Przykład 2. Usuwanie wartości rejestru z lokalizacji HKCU

Te polecenia usuwają wartość rejestru "Opcje" i jego dane z podklucza "MyApp" "HKEY_CURRENT_USER\Software\MyCompany".

Pierwsze polecenie używa Set-Location polecenia cmdlet , aby zmienić bieżącą lokalizację na dysk HKEY_CURRENT_USER (HKCU:) i podklucz "Software\MyCompany\MyApp".

Drugie polecenie służy Remove-ItemProperty do usuwania wartości rejestru "Opcje" i jego danych z podklucza "MyApp". Ponieważ ścieżka jest wymagana, polecenie używa kropki ('.'), aby wskazać bieżącą lokalizację. Używa nazwy , aby określić, która wartość rejestru ma zostać usunięta. Używa parametru Confirm , aby zażądać monitu użytkownika przed usunięciem wartości.

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

Przykład 3. Usuwanie wartości rejestru przy użyciu potoku

To polecenie usuwa wartość rejestru "NoOfEmployees" i jego dane z klucza rejestru "HKLM\Software\MyCompany".

Polecenie używa Get-Item polecenia cmdlet do pobrania elementu reprezentującego klucz rejestru. Używa operatora potoku (|), aby wysłać obiekt do Remove-ItemProperty. Następnie używa parametru Name parametru , Remove-ItemProperty aby określić nazwę wartości rejestru.

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

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Credential

Uwaga

Ten parametr nie jest obsługiwany przez żadnych dostawców zainstalowanych w programie PowerShell. Aby personifikować innego użytkownika lub podnieść poziom poświadczeń podczas uruchamiania tego polecenia cmdlet, użyj polecenia Invoke-Command.

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

-Exclude

Określa elementy pomijane przez to polecenie cmdlet. Wartość tego parametru kwalifikuje parametr Path . Wprowadź element ścieżki lub wzorzec, taki jak "*.txt". Dozwolone są symbole wieloznaczne.

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

-Filter

Określa filtr w formacie lub języku dostawcy. Wartość tego parametru kwalifikuje parametr Path .

Składnia filtru, w tym użycie symboli wieloznacznych, zależy od dostawcy. Filtry są wydajniejsze niż inne parametry, ponieważ dostawca stosuje je, gdy polecenie cmdlet pobiera obiekty zamiast filtrować obiekty po ich pobraniu.

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

-Force

Wymusza usunięcie właściwości obiektu, do którego użytkownik nie może uzyskać dostępu. Implementacja różni się od dostawcy do dostawcy. Aby uzyskać więcej informacji, zobacz about_Providers.

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

-Include

Określa jako tablicę ciągów element lub elementy, które to polecenie cmdlet zawiera w operacji. Wartość tego parametru kwalifikuje parametr Path . Wprowadź element ścieżki lub wzorzec, taki jak "*.txt". Dozwolone są symbole wieloznaczne.

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

-LiteralPath

Określa ścieżkę do bieżącej lokalizacji właściwości. W przeciwieństwie do parametru Path wartość LiterałuPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze znaki cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

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

-Name

Określa nazwy właściwości do usunięcia. Dozwolone są symbole wieloznaczne.

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

-Path

Określa ścieżkę elementu, którego właściwości są usuwane. Dozwolone są symbole wieloznaczne.

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

-UseTransaction

Zawiera polecenie w aktywnej transakcji. Ten parametr jest prawidłowy tylko wtedy, gdy transakcja jest w toku. Aby uzyskać więcej informacji, zobacz about_Transactions.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

String

Do tego polecenia cmdlet można przekazać ciąg zawierający ścieżkę, ale nie ścieżkę literału.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

Program Windows PowerShell zawiera następujące aliasy dla programu Remove-ItemProperty:

  • rp

W dostawcy rejestru programu PowerShell wartości rejestru są uważane za właściwości klucza rejestru lub podklucza. Aby zarządzać tymi wartościami, możesz użyć poleceń cmdlet ItemProperty .

Remove-ItemProperty jest przeznaczony do pracy z danymi udostępnianymi przez dowolnego dostawcę. Aby wyświetlić listę dostawców dostępnych w sesji, wpisz Get-PSProvider. Aby uzyskać więcej informacji, zobacz about_Providers.