Clear-Variable
Hiermee verwijdert u de waarde van een variabele.
Syntax
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 van het object dat is opgeslagen in de variabele.
Voorbeelden
Voorbeeld 1: de waarde verwijderen van globale variabelen 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.
De derde opdracht, waarmee de waarde van $a
wordt opgehaald, laat zien dat de waarde 3 niet wordt beïnvloed.
Voorbeeld 3: De waarde van de opgegeven variabele verwijderen
Clear-Variable -Name "Processes"
Met deze opdracht verwijdert u de waarde van de variabele met de naam Processen. Nadat de cmdlet de bewerking heeft voltooid, bestaat de variabele met de naam Processen nog steeds, maar is de waarde null.
Parameters
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Exclude
Hiermee geeft u een matrix van items 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Hiermee kan de cmdlet een variabele wissen, zelfs als deze het kenmerk Alleen-lezen heeft. Zelfs als u de parameter Force gebruikt, kan de cmdlet geen constanten wissen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Hiermee geeft u een matrix met items op die deze cmdlet in de bewerking opneemt. 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Name
Hiermee geeft u de naam van de variabele die moet worden gewist. Jokertekens zijn toegestaan. Deze parameter is vereist, maar de parameternaam Naam is optioneel.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-PassThru
Retourneert een object dat het item vertegenwoordigt waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Hiermee geeft u het bereik 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 en met het aantal bereiken, waarbij 0 het huidige bereik is en 1 het bovenliggende bereik). Lokaal is de standaardinstelling. Zie about_Scopes voor meer informatie.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
None
U kunt geen objecten doorsnijden naar deze cmdlet.
Uitvoerwaarden
None or System.Management.Automation.PSVariable
Wanneer u de parameter PassThru gebruikt, genereert deze cmdlet een System.Management.Automation.PSVariable-object dat de gewiste variabele vertegenwoordigt. Anders genereert deze cmdlet geen uitvoer.
Notities
Als u een variabele samen met de bijbehorende waarde wilt verwijderen, gebruikt
Remove-Variable
u ofRemove-Item
.Deze cmdlet verwijdert niet de waarden van variabelen die zijn ingesteld als constanten of eigendom zijn van het systeem, 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.
U kunt ook verwijzen naar door de
Clear-Variable
ingebouwde alias,clv
. Zie about_Aliases voor meer informatie.