Remove-Variable
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
Do tego polecenia cmdlet można przekazać obiekt zmiennej.
Dane wyjściowe
None
To polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Uwagi
Program Windows PowerShell zawiera następujące aliasy dla programu Remove-Variable
:
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.