Delen via

Remove-Variable

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee verwijdert u een variabele en de bijbehorende waarde.

Syntaxis

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

Description

De cmdlet Remove-Variable 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

PS C:\> Remove-Variable Smp

Met deze opdracht wordt de $Smp variabele verwijderd.

Parameters

-Confirm

U wordt 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 uit 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: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.

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 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*. Jokertekens zijn toegestaan.

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

-Name

Hiermee geeft u de naam van de variabele die moet worden verwijderd. De parameternaam (Name) is optioneel.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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 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

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

PSVariable

U kunt een variabele object doorsluisen naar Remove-Variable.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

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

    U kunt ook verwijzen naar Remove-Variable door de ingebouwde alias, rv. Zie about_Aliases voor meer informatie.