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 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.
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