Feedback

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

Hiermee geeft u een matrix van items op die door deze cmdlet worden weggelaten 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
Accept pipeline input:False
Accept wildcard characters:True
-Force

Geeft aan dat met de cmdlet een variabele wordt verwijderd, 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
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
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
Accept pipeline input:True
Accept wildcard characters:True
-Scope

Hiermee worden alleen de variabelen in het opgegeven bereik opgeslagen. De aanvaardbare waarden voor deze parameter zijn:

  • Globaal
  • Lokaal
  • Script
  • Een getal ten opzichte van het huidige bereik (0 tot en met 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
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
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSVariable

U kunt een variabeleobject 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 Remove-Variable opdracht toe aan uw PowerShell-profiel.

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