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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Name
Określa nazwę zmiennej do usunięcia. Nazwa parametru (Nazwa) jest opcjonalna. Dozwolone są symbole wieloznaczne
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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
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.
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla