Delen via

Clear-Variable

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee verwijdert u de waarde van een variabele.

Syntaxis

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

Description

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.

Voorbeelden

Voorbeeld 1: De waarde van globale variabelen verwijderen die beginnen met een zoekreeks

Clear-Variable my* -Scope Global

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

Voorbeeld 2: Een variabele in een onderliggend bereik wissen, maar niet het bovenliggende bereik

$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 Clear-Variable opdracht 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 wordt $aopgehaald, wordt aangegeven dat de waarde 3 niet wordt beïnvloed.

Voorbeeld 3: de waarde van de opgegeven variabele verwijderen

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.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Exclude

Hiermee geeft u een matrix van items op die deze cmdlet weglaat in de bewerking. De waarde van deze parameter komt in aanmerking voor de parameter Name . Voer een naamelement of patroon in, zoals 's*'. Jokertekens zijn toegestaan.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Force

Hiermee kan de cmdlet een variabele wissen, zelfs als deze alleen-lezen is. Zelfs als u de parameter Force gebruikt, kan de cmdlet geen constanten wissen.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Include

Hiermee geeft u een matrix van items op die deze cmdlet in de bewerking bevat. De waarde van deze parameter komt in aanmerking voor de parameter Name . Voer een naamelement of patroon in, zoals 's*'. Jokertekens zijn toegestaan.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Name

Hiermee geeft u de naam van de variabele die moet worden gewist. Jokertekens zijn toegestaan. Deze parameter is vereist, maar de naam van de parameter is optioneel.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-PassThru

Retourneert een object dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Scope

Hiermee geeft u het bereik op waarin deze alias geldig is.

De aanvaardbare waarden voor deze parameter zijn:

  • Global
  • Local
  • Script

U kunt ook een getal gebruiken ten opzichte van het huidige bereik (0 tot het aantal bereiken, waarbij 0 het huidige bereik is en 1 het bovenliggende bereik is). Lokaal is de standaardinstelling. Zie about_Scopes voor meer informatie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

PSVariable

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

Notities

PowerShell bevat de volgende aliassen voor Clear-Variable:

  • Alle platformen:

    • clv

  • Als u een variabele wilt verwijderen, samen met de waarde ervan, gebruikt 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.