Freigeben über

Remove-Variable

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Löscht eine Variable und ihren Wert.

Syntax

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

Beschreibung

Das Cmdlet Remove-Variable löscht eine Variable und ihren Wert aus dem Bereich, in dem sie definiert ist, z. B. die aktuelle Sitzung. Sie können dieses Cmdlet nicht verwenden, um Variablen zu löschen, die als Konstanten oder im Besitz des Systems festgelegt sind.

Beispiele

Beispiel 1: Entfernen einer Variablen

Remove-Variable Smp

Mit diesem Befehl wird die $Smp Variable gelöscht.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Exclude

Gibt ein Array von Elementen an, die von diesem Cmdlet aus dem Vorgang weggelassen werden. Der Wert dieses Parameters qualifiziert den parameter Name. Geben Sie ein Namenselement oder ein Muster ein, z. B. "s*". Wildcards sind zulässig.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Force

Gibt an, dass das Cmdlet eine Variable entfernt, auch wenn es schreibgeschützt ist. Selbst bei Verwendung des parameters Force kann das Cmdlet keine Konstante entfernen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Include

Gibt ein Array von Elementen an, die dieses Cmdlet im Vorgang löscht. Der Wert dieses Parameters qualifiziert den parameter Name. Geben Sie ein Namenselement oder ein Muster ein, z. B. s*. Wildcards sind zulässig.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Name

Gibt den Namen der zu entfernenden Variablen an. Der Parametername (Name) ist optional. Zulässige Wildcards

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-Scope

Ruft nur die Variablen im angegebenen Bereich ab. Die zulässigen Werte für diesen Parameter sind:

  • Global
  • Lokal
  • Skript
  • Eine Zahl relativ zum aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich ist und 1 das übergeordnete Element ist)

Lokal ist die Standardeinstellung. Weitere Informationen finden Sie unter about_Scopes.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSVariable

Sie können ein Variable-Objekt an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Remove-Variable:

  • rv

  • Änderungen wirken sich nur auf den aktuellen Bereich aus, z. B. eine Sitzung. Um eine Variable aus allen Sitzungen zu löschen, fügen Sie Ihrem PowerShell-Profil einen Remove-Variable Befehl hinzu.