Clear-Variable

Clear-Variable
    [-Name] <String[]>
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Force]
    [-PassThru]
    [-Scope <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

De Clear-Variable cmdlet verwijdert de gegevens die zijn opgeslagen in een variabele, maar de variabele wordt niet verwijderd. Als gevolg hiervan is de waarde van de variabele NULL (leeg). Als de variabele een opgegeven gegevens- of objecttype heeft, behoudt deze cmdlet het type object dat is opgeslagen in de variabele.

Clear-Variable my* -Scope Global

Met deze opdracht verwijdert u de waarde van globale variabelen met namen die beginnen met mijn.

$a = 3
&{ Clear-Variable a }
$a

3

Deze opdrachten laten zien dat het wissen van een variabele in een onderliggend bereik de waarde in het bovenliggende bereik niet wist. Met de eerste opdracht wordt de waarde van de variabele $a ingesteld op 3. De tweede opdracht maakt gebruik van de aanroepoperator (&) om de opdracht Clear-Variable uit te voeren in een nieuw bereik. De variabele wordt gewist in het onderliggende bereik (hoewel deze niet bestond), maar wordt niet gewist in het lokale bereik. Met de derde opdracht, waarmee de waarde van $awordt opgehaald, wordt aangegeven dat de waarde 3 niet wordt beïnvloed.

Clear-Variable -Name "Processes"

Met deze opdracht wordt de waarde van de variabele Processen verwijderd. Nadat de cmdlet de bewerking heeft voltooid, bestaat de variabele met de naam Processen nog steeds, maar de waarde is null.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt geen objecten doorsluisen naar deze cmdlet.

Deze cmdlet retourneert standaard geen uitvoer.

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een PSVariable-object dat de gewiste variabele vertegenwoordigt.

PowerShell bevat de volgende aliassen voor Clear-Variable:

• Alle platforms:

  • clv

• Als u een variabele samen met de waarde wilt verwijderen, gebruikt u Remove-Variable of Remove-Item.

  Met deze cmdlet worden de waarden van variabelen die zijn ingesteld als constanten of eigendom van het systeem niet verwijderd, zelfs niet als u de parameter Force gebruikt.

  Als de variabele die u wist niet bestaat, heeft de cmdlet geen effect. Er wordt geen variabele met een null-waarde gemaakt.