Udostępnij za pośrednictwem

Remove-Variable

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

Usuwa zmienną i jej wartość.

Składnia

Remove-Variable
      [-Name] <String[]>
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Force]
      [-Scope <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie Remove-Variable cmdlet usuwa zmienną i jej wartość z zakresu, w którym jest zdefiniowana, na przykład w bieżącej sesji. Nie można użyć tego polecenia cmdlet, aby usunąć zmienne ustawione jako stałe lub te, które są własnością systemu.

Przykłady

Przykład 1. Usuwanie zmiennej

Remove-Variable Smp

To polecenie usuwa zmienną $Smp .

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

-Exclude

Określa tablicę elementów pomijanych przez to polecenie cmdlet z operacji. Wartość tego parametru kwalifikuje parametr Name . Wprowadź element nazwy lub wzorzec, taki jak "s*". Dozwolone są symbole wieloznaczne.

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 usuwa zmienną, nawet jeśli jest tylko do odczytu. Nawet przy użyciu parametru Force polecenie cmdlet nie może usunąć stałej.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Include

Określa tablicę elementów usuwanych przez to polecenie cmdlet w operacji. Wartość tego parametru kwalifikuje parametr Name . Wprowadź element nazwy lub wzorzec, taki jak s*. Dozwolone są symbole wieloznaczne.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-Name

Określa nazwę zmiennej do usunięcia. Nazwa parametru (Nazwa) jest opcjonalna. Dozwolone są symbole wieloznaczne

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-Scope

Pobiera tylko zmienne w określonym zakresie. Dopuszczalne wartości tego parametru to:

  • Globalnie
  • Lokalny
  • Skrypt
  • Liczba względem bieżącego zakresu (od 0 do liczby zakresów, gdzie 0 jest bieżącym zakresem, a 1 jest jego elementem nadrzędnym)

Wartość lokalna to wartość domyślna. Aby uzyskać więcej informacji, zobacz about_Scopes.

Typ:String
Position:Named
Domyślna wartość:None
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

PSVariable

Do tego polecenia cmdlet można przekazać obiekt zmiennej.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

Program PowerShell zawiera następujące aliasy dla programu Remove-Variable:

  • Wszystkie platformy:

    • rv

  • Zmiany mają wpływ tylko na bieżący zakres, taki jak sesja. Aby usunąć zmienną ze wszystkich sesji, dodaj Remove-Variable polecenie do profilu programu PowerShell.