Remove-ItemProperty
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 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".
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, aby zidentyfikować wartość 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 polecenia cmdlet Set-Location, aby zmienić bieżącą lokalizację na dysk HKEY_CURRENT_USER (HKCU:) i 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ę.
Używa Nazwa, 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" -ConfirmPrzykł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 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.
Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployeesParametry
-Confirm
Monituje 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
Nuta
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 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 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.
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| 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.
| 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 bieżącej lokalizacji właściwości. W przeciwieństwie do parametru Path 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.
| Typ: | String[] |
| Aliasy: | PSPath |
| 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 |
-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.
| Typ: | SwitchParameter |
| Aliasy: | usetx |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
| 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
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 Remove-ItemProperty:
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.
