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>]
[-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 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 nie danych.
Przykłady
Przykład 1. Usuwanie wartości rejestru
To polecenie usuwa wartość rejestru "SmpProperty" i jego dane z podklucza HKEY_LOCAL_MACHINE\Software
"SmpApplication" klucza rejestru.
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 Set-Location
polecenia cmdlet, aby zmienić bieżącą lokalizację na dysk HKEY_CURRENT_USER (HKCU:
) i podklucz Software\MyCompany\MyApp
.
Drugie polecenie używa Remove-ItemProperty
polecenia do usunięcia wartości rejestru "Options" i jego danych z podklucza "MyApp". Ponieważ ścieżka jest wymagana, polecenie używa kropki (.
), aby wskazać bieżącą lokalizację. Parametr Potwierdzanie żą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 HKLM\Software\MyCompany
klucza rejestru.
Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployees
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
obiektu .
Następnie używa parametru Name , Remove-ItemProperty
aby określić nazwę wartości rejestru.
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 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ść C:\Windows
katalogu.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Określa filtr w celu zakwalifikowania parametru Ścieżka . Dostawca systemu plików jest jedynym zainstalowanym dostawcą programu PowerShell, który obsługuje korzystanie z filtrów. Składnię języka filtru Systemu plików można znaleźć w about_Wildcards. Filtry są bardziej wydajne niż inne parametry, ponieważ dostawca stosuje je, gdy polecenie cmdlet pobiera obiekty, zamiast filtrować obiekty programu PowerShell 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 nie może uzyskać dostępu użytkownik. 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. Parametr Include jest skuteczny tylko wtedy, gdy polecenie zawiera zawartość elementu, na przykład C:\Windows\*
, gdzie symbol wieloznaczny określa zawartość C:\Windows
katalogu.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Określa ścieżkę do co najmniej jednej lokalizacji. 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 je ująć w pojedynczy cudzysłów. Znaki pojedynczego cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.
Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.
Type: | String[] |
Aliases: | PSPath, LP |
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 |
-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
Możesz potokować ciąg zawierający ścieżkę, ale nie ścieżkę literału, do tego polecenia cmdlet.
Dane wyjściowe
None
To polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Uwagi
Program PowerShell zawiera następujące aliasy dla Remove-ItemProperty
programu :
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ć 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, wpiszGet-PSProvider
. Aby uzyskać więcej informacji, zobacz about_Providers.