Remove-Variable

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee verwijdert u een variabele en de bijbehorende waarde.

Syntax

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

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 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
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Scope

Hiermee haalt u alleen de variabelen in het opgegeven bereik op. De aanvaardbare 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
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

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 platformen:

    • 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.