Clear-Item
Czyści zawartość elementu, ale nie usuwa elementu.
Składnia
Clear-Item
[-Path] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Clear-Item
-LiteralPath <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie Clear-Item
cmdlet czyści zawartość elementu, ale nie usuwa elementu.
Na przykład Clear-Item
polecenie cmdlet może usunąć wartość zmiennej, ale nie usuwa zmiennej. Wartość używana do reprezentowania wyczyszczonego elementu jest definiowana przez każdego dostawcę programu PowerShell.
To polecenie cmdlet jest podobne do Clear-Content
, ale działa na aliasach i zmiennych zamiast plików.
Przykłady
Przykład 1. Wyczyść wartość zmiennej
To polecenie czyści wartość zmiennej o nazwie TestVar1
.
Zmienna pozostaje prawidłowa, ale jej wartość jest ustawiona na $null
.
Nazwa zmiennej jest poprzedzona prefiksem , Variable:
aby wskazać dostawcę zmiennej programu PowerShell.
Alternatywne polecenia pokazują, że aby uzyskać ten sam wynik, możesz przełączyć się na dysk programu PowerShell Variable:
, a następnie uruchomić Clear-Item
polecenie.
Clear-Item Variable:TestVar1
Set-Location Variable:
PS Variable:\> Clear-Item TestVar1
Przykład 2. Wyczyść wszystkie wpisy rejestru
To polecenie czyści wszystkie wpisy rejestru w podkluczu "MyKey", ale dopiero po wyświetleniu monitu o potwierdzenie intencji. Nie usuwa podklucza "MyKey" ani nie wpływa na inne klucze rejestru lub wpisy. Możesz użyć parametrów Dołączanie i wykluczanie , aby zidentyfikować określone klucze rejestru, ale nie można ich używać do identyfikowania wpisów rejestru.
- Aby usunąć określone wpisy rejestru, użyj
Remove-ItemProperty
polecenia cmdlet . - Aby usunąć wartość wpisu rejestru, użyj polecenia
Clear-ItemProperty cmdlet
.
Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm
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
Wskazuje, że polecenie cmdlet czyści elementy, których nie można zmienić, na przykład aliasy tylko do odczytu. Polecenie cmdlet nie może wyczyścić stałych. Implementacja różni się od dostawcy do dostawcy. Aby uzyskać więcej informacji, zobacz about_Providers. Polecenie cmdlet nie może zastąpić ograniczeń zabezpieczeń, nawet jeśli jest używany parametr Force .
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 |
-Path
Określa ścieżkę do wyczyszczonego elementu. Dozwolone są symbole wieloznaczne. Ten parametr jest wymagany, ale ścieżka nazwy parametru jest opcjonalna.
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 przekazać ciąg ścieżki do tego polecenia cmdlet.
Dane wyjściowe
None
To polecenie cmdlet nie generuje żadnych danych wyjściowych.
Uwagi
- Polecenie
Clear-Item
cmdlet jest obsługiwane tylko przez kilku dostawców programu PowerShell, w tym aliasu, środowiska, funkcji, rejestru i dostawców zmiennych . W związku zClear-Item
tym można usunąć zawartość elementów w przestrzeniach nazw dostawcy. Aby wyświetlić listę dostawców dostępnych w sesji, wpiszGet-PsProvider
. Aby uzyskać więcej informacji, zobacz about_Providers. - Nie można
Clear-Item
usunąć zawartości pliku, ponieważ dostawca systemu plików programu PowerShell nie obsługuje tego polecenia cmdlet. Aby wyczyścić pliki, użyj poleceniaClear-Content
.