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 cmdlet Clear-Item
czyści zawartość elementu, ale nie usuwa elementu.
Na przykład polecenie cmdlet Clear-Item
może usunąć wartość zmiennej, ale nie powoduje usunięcia 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. Czyszczenie wartości 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 Variable:
wskazującym dostawcę zmiennej programu PowerShell.
Alternatywne polecenia pokazują, że aby uzyskać ten sam wynik, możesz przełączyć się na dysk Variable:
programu PowerShell, a następnie uruchomić polecenie Clear-Item
.
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 on podklucza "MyKey" ani nie wpływa na inne klucze rejestru lub wpisy. Możesz użyć parametrów Include and Exclude w celu zidentyfikowania określonych kluczy rejestru, ale nie można ich używać do identyfikowania wpisów rejestru.
- Aby usunąć określone wpisy rejestru, użyj polecenia cmdlet
Remove-ItemProperty
. - Aby usunąć wartość wpisu rejestru, użyj
Clear-ItemProperty cmdlet
.
Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm
Parametry
-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 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
Wskazuje, że polecenie cmdlet czyści elementy, których w przeciwnym razie nie można zmienić, takich jak 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.
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 |
-Path
Określa ścieżkę do wyczyszczonego elementu. Dozwolone są symbole wieloznaczne. Ten parametr jest wymagany, ale nazwa parametru Ścieżka jest opcjonalna.
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. 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
Możesz przekazać ciąg ścieżki 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 Clear-Item
:
Wszystkie platformy:
cli
Polecenie cmdlet
Clear-Item
jest obsługiwane tylko przez kilku dostawców programu PowerShell, w tym Alias, Environment, Function, Registryi dostawców zmiennych zmiennych. W związku z tym można użyćClear-Item
, aby 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 użyć
Clear-Item
do usunięcia zawartości pliku, ponieważ dostawca systemu plików programu PowerShell nie obsługuje tego polecenia cmdlet. Aby wyczyścić pliki, użyjClear-Content
.