Remove-Variable
Löscht eine Variable und ihren Wert.
Syntax
Remove-Variable
[-Name] <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Remove-Variable
Cmdlet löscht eine Variable und ihren Wert aus dem Bereich, in dem sie definiert ist, z. B. der aktuellen 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
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: | True |
-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: | True |
-Name
Gibt den Namen der zu entfernenden Variablen an. Der Parametername (Name) ist optional. Wildcards sind zulässig
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-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
Sie können ein Variablenobjekt an dieses Cmdlet weiterleiten.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Hinweise
PowerShell enthält die folgenden Aliase für Remove-Variable
:
Alle Plattformen:
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 Befehl hinzu
Remove-Variable
.