Löscht eine Variable und ihren Wert.

Syntax

Remove-Variable [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Scope <string>] [-Bestätigung] [-WhatIf] [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "Remove-Variable" werden eine Variable und ihr Wert aus dem Bereich gelöscht, in der die Variable definiert ist, z. B. aus der aktuellen Sitzung. Mit diesem Cmdlet können Sie keine Variablen löschen, die als Konstanten festgelegt sind oder deren Besitzer das System ist.

Parameter

-Exclude <string[]>

Lässt die angegebenen Elemente aus. Der Name-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Namenselement oder -muster wie "s*" ein. Platzhalter sind zulässig.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Force

Ermöglicht es dem Cmdlet, eine Variable selbst dann zu löschen, wenn sie schreibgeschützt ist. Auch bei Verwendung des Force-Parameters kann das Cmdlet keine Konstanten entfernen.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Include <string[]>

Löscht nur die angegebenen Elemente. Der Name-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Namenselement oder -muster wie "s*" ein. Platzhalter sind zulässig.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Name <string[]>

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

Erforderlich?

true

Position?

1

Standardwert

Pipelineeingaben akzeptieren?

true (ByPropertyName)

Platzhalterzeichen akzeptieren?

false

-Scope <string>

Gibt den Gültigkeitsbereich dieses Alias an. Gültige Werte sind "global", "local", "script", oder eine Zahl in Bezug auf den aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 der übergeordnete Bereich ist). Der Standardwert ist "local". Weitere Informationen finden Sie unter "about_Scopes".

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Bestätigung

Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-WhatIf

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

System.Management.Automation.PSVariable

Sie können auch ein Variablenobjekt über die Pipeline 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 dem Windows PowerShell-Profil den Befehl "Remove-Variable" hinzu.

Sie können auch über den integrierten Alias "rv" auf "RemoveVariable" verweisen. Weitere Informationen finden Sie unter "about_Aliases".

Beispiel 1

C:\PS>remove-variable Smp

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






Siehe auch




Inhaltsverzeichnis