Remove-Variable - PowerShell Befehl Hilfe und Beispiele

Löscht eine Variable und ihren Wert. (Remove-Variable)

... Beispiele      
 NAME
 
    Remove-Variable 

 ÜBERSICHT
 
    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 [<SwitchParameter>] 
        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 [<SwitchParameter>] 
        Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf. 

        Erforderlich?                false 
        Position?                    named 
        Standardwert 
        Pipelineeingaben akzeptieren?false 
        Platzhalterzeichen akzeptieren?false 

    -WhatIf [<SwitchParameter>] 
        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 folgende allgemeine Parameter: "Verbose", "Debug", 
        "ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable", 
        "OutBuffer" und "OutVariable". Weitere Informationen 
        erhalten Sie mit dem Befehl "get-help about_commonparameters". 

 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". 

 Beispiele
    
BEISPIEL 1
 

    C:\PS>remove-variable Smp 

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

VERWANDTE LINKS 
    Online version: http://go.microsoft.com/fwlink/?LinkID=113380 (möglicherweise auf Englisch) 
    Set-Variable 
    Get-Variable 
    Clear-Variable 
    New-Variable 
    about_Profiles 

C:\Windows>powershell get-help Clear-Variable -full 

Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.

ColorConsole [Version 3.7.1000] PowerShell 2.0-Export

Windows 11, 10, 8.1, 8, 7 / Server 2022, 2019, 2016