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.

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

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.