Clear-Variable
Hiermee verwijdert u de waarde van een variabele.
Syntax
Default (Standaard)
Clear-Variable
[-Name] <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-PassThru]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De cmdlet Clear-Variable 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
PS C:\> 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
PS C:\> $a=3
PS C:\> &{ Clear-Variable a }
PS C:\> $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. De derde opdracht, waarmee de waarde van $A wordt opgehaald, geeft aan dat de waarde 3 niet wordt beïnvloed.
Voorbeeld 3: de waarde van de opgegeven variabele verwijderen
PS C:\> 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
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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*'. Wildcards zijn toegestaan.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-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.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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*'. Wildcards zijn toegestaan.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Name
Hiermee geeft u de naam van de variabele die moet worden gewist. Wildcards zijn toegestaan. Deze parameter is vereist, maar de parameternaam ('Name') is optioneel.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-PassThru
Retourneert een object dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Scope
Hiermee geeft u het bereik op waarin deze alias geldig is.
De acceptabele waarden voor deze parameter zijn:
- Globaal
- Lokaal
- 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.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
None
U kunt geen objecten doorsluisen 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 waarde wilt verwijderen, gebruikt u Remove-Variable of Item verwijderen.
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.
U kunt ook verwijzen naar Clear-Variable door de ingebouwde alias clv. Zie about_Aliases voor meer informatie.