Delen via

Remove-Variable

Module:
Microsoft.PowerShell.Utility Module

Hiermee verwijdert u een variabele en de bijbehorende waarde.

Syntaxis

Default (Standaard) 

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

Description

De Remove-Variable cmdlet verwijdert een variabele en de bijbehorende waarde uit het bereik waarin deze is gedefinieerd, zoals de huidige sessie. U kunt deze cmdlet niet gebruiken om variabelen te verwijderen die zijn ingesteld als constanten of variabelen die eigendom zijn van het systeem.

Voorbeelden

Voorbeeld 1: Een variabele verwijderen

Remove-Variable Smp

Met deze opdracht wordt de $Smp variabele verwijderd.

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 uit 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

Geeft aan dat de cmdlet een variabele verwijdert, zelfs als deze alleen-lezen is. Zelfs als u de parameter Force gebruikt, kan de cmdlet geen constante verwijderen.

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 specificeert u een array van items die door deze cmdlet in de bewerking worden verwijderd. 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 verwijderd. De parameternaam (Name) is optioneel. Jokertekens zijn toegestaan

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

-Scope

Hiermee haalt u alleen de variabelen in het opgegeven bereik op. De acceptabele waarden voor deze parameter zijn:

  • Globaal
  • Lokaal
  • Script
  • Een getal ten opzichte van het huidige bereik (0 tot het totale aantal bereiken, waarbij 0 het huidige bereik is en 1 het bovenliggende bereik aangeeft)

Lokaal is de standaardinstelling. Zie about_Scopesvoor 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

PSVariable

U kunt een variabele object doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

PowerShell bevat de volgende aliassen voor Remove-Variable:

  • Alle platforms:

    • rv

  • Wijzigingen zijn alleen van invloed op het huidige bereik, zoals een sessie. Als u een variabele uit alle sessies wilt verwijderen, voegt u een Remove-Variable opdracht toe aan uw PowerShell-profiel.