Udostępnij za pośrednictwem

Clear-Item

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

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]
     [-UseTransaction]
     [<CommonParameters>]
Clear-Item
     -LiteralPath <String[]>
     [-Force]
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-UseTransaction]
     [<CommonParameters>]

Opis

Polecenie Clear-Item cmdlet czyści zawartość elementu, ale nie powoduje usunięcia elementu. Na przykład Clear-Item polecenie cmdlet 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-Contentpolecenia , 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 i jest prawidłowa, ale jej wartość jest ustawiona na $nullwartość . 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 on 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 elementu 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

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.

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ść C:\Windows katalogu.

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ż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ą 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ść C:\Windows katalogu.

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ść 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 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
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 ścieżka nazwy parametru jest opcjonalna.

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 po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

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 Windows PowerShell zawiera następujące aliasy dla programu Clear-Item:

  • cli

  • Polecenie Clear-Item cmdlet jest obsługiwane tylko przez kilku dostawców programu PowerShell, w tym alias, środowisko, funkcję, rejestr i dostawców zmiennych . W związku z Clear-Item tym można usunąć zawartość elementów w przestrzeniach nazw dostawcy. Aby wyświetlić listę dostawców dostępnych w sesji, wpisz Get-PsProvider. Aby uzyskać więcej informacji, zobacz about_Providers.

  • Nie można użyć Clear-Item polecenia , aby usunąć zawartość pliku, ponieważ dostawca systemu plików programu PowerShell nie obsługuje tego polecenia cmdlet. Aby wyczyścić pliki, użyj polecenia Clear-Content.