Udostępnij za pośrednictwem

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

Opis

Polecenie cmdlet Remove-ItemProperty 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.

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

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

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

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

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

Drugie polecenie używa Remove-ItemProperty do usunięcia wartości rejestru "Opcje" i jego danych z podklucza "MyApp". Ponieważ ścieżka jest wymagana, polecenie używa kropki (.), aby wskazać bieżącą lokalizację. Parametr Confirm żąda monitu użytkownika przed usunięciem wartości.

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.

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

Polecenie używa polecenia cmdlet Get-Item, aby uzyskać element reprezentujący klucz rejestru. Używa operatora potoku (|) do wysyłania obiektu do Remove-ItemProperty. Następnie używa parametru NameRemove-ItemProperty, aby określić nazwę wartości rejestru.

Parametry

-Confirm

Prosi o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Credential

Notatka

Ten parametr nie jest obsługiwany przez żadnych dostawców zainstalowanych w programie PowerShell. Aby podszyć się pod innego użytkownika lub zwiększyć swoje uprawnienia podczas wykonywania tego polecenia cmdlet, użyj Invoke-Command.

Typ:PSCredential
Position:Named
Domyślna wartość:Current user
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Exclude

Określa jako tablicę ciągów element lub elementy, które to polecenie cmdlet wyklucza w operacji. Wartość tego parametru kwalifikuje parametr Path. Wprowadź element ścieżki lub wzorzec, taki jak *.txt. Dozwolone są symbole wieloznaczne. Parametr Exclude jest skuteczny tylko wtedy, gdy polecenie zawiera zawartość elementu, na przykład C:\Windows\*, gdzie symbol wieloznaczny określa zawartość katalogu C:\Windows.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-Filter

Określa filtr, aby zakwalifikować parametr ścieżki. Dostawca systemu plików jest jedynym zainstalowanym dostawcą programu PowerShell obsługującym korzystanie z filtrów. Składnię języka filtru systemu plików można znaleźć w about_Wildcards. Filtry są wydajniejsze niż inne parametry, ponieważ dostawca stosuje je, gdy polecenie cmdlet pobiera obiekty zamiast filtrować obiekty po ich pobraniu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-Force

Polecenie cmdlet wymusza usunięcie właściwości obiektu, do której użytkownik nie ma zwykle dostępu. Implementacja różni się od dostawcy do dostawcy. Aby uzyskać więcej informacji, zobacz about_Providers.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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. Parametr Include jest skuteczny tylko wtedy, gdy polecenie zawiera zawartość elementu, na przykład C:\Windows\*, gdzie symbol wieloznaczny określa zawartość katalogu C:\Windows.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-LiteralPath

Określa ścieżkę do co najmniej jednej lokalizacji. Wartość LiteralPath 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.

Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.

Typ:String[]
Aliasy:PSPath, LP
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

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

Typ:String[]
Aliasy:PSProperty
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-Path

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

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Nie uruchomiono polecenia cmdlet.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

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

Dane wyjściowe

None

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

Uwagi

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

  • Wszystkie platformy:

    • rp

  • W dostawcy rejestru programu PowerShell wartości rejestru są uważane za właściwości klucza rejestru lub podklucza. Do zarządzania tymi wartościami można użyć polecenia cmdlet ItemProperty.

  • Remove-ItemProperty jest przeznaczona 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.