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. Mit diesem Cmdlet können Sie Variablen löschen, die als Konstanten festgelegt sind, oder solche, die dem System gehören.

Beispiele

Beispiel 1: Entfernen einer Variablen

PS C:\> Remove-Variable Smp

Dieser Befehl löscht die $Smp-Variable.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Exclude

Gibt ein Array von Elementen an, das dieses Cmdlet aus dem Vorgang auslässt. Der Wert dieses Parameters qualifiziert den Parameter Name . Geben Sie ein Namenselement oder -muster wie %%amp;quot;s*%%amp;quot; ein. Platzhalter sind zulässig.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Gibt an, dass das Cmdlet eine Variable entfernt, auch wenn sie schreibgeschützt ist. Selbst mit dem Force-Parameter kann das Cmdlet keine Konstante entfernen.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Name-Element oder -Muster ein, z. B. s*. Platzhalter sind zulässig.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Scope

Ruft nur die Variablen im angegebenen Bereich ab. Zulässige Werte für diesen Parameter:

  • Global
  • Lokal
  • Skript
  • Eine Zahl relativ zum aktuellen Bereich (0 durch die Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 sein übergeordneter Bereich ist)

Local ist die Standardeinstellung. Weitere Informationen finden Sie unter „about_Scopes“.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

PSVariable

Sie können ein Variablenobjekt an Remove-Variable übergeben.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

  • Ä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 Windows PowerShell-Profil den Befehl Remove-Variable hinzu.

    Sie können auch auf Remove-Variable verweisen, indem Sie den integrierten Alias rv verwenden. Weitere Informationen finden Sie unter %%amp;quot;about_Aliases%%amp;quot;.