Remove-Variable
Löscht eine Variable und ihren Wert.
Syntax
Remove-Variable [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Scope <string>] [-Confirm] [-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 |
-Confirm
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 |
Keiner 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
Konzepte
Set-Variable
Get-Variable
Clear-Variable
New-Variable
about_Profiles