Delen via

Get-Variable

Module:
Microsoft.PowerShell.Utility Module

Haalt de variabelen op in de huidige console.

Syntaxis

Default (Standaard) 

Get-Variable
    [[-Name] <String[]>]
    [-ValueOnly]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Scope <String>]
    [<CommonParameters>]

Description

De Get-Variable cmdlet haalt de PowerShell-variabelen op in de huidige console. U kunt alleen de waarden van de variabelen ophalen door de parameter ValueOnly op te geven en u kunt de variabelen filteren die op naam worden geretourneerd.

Voorbeelden

Voorbeeld 1: Variabelen ophalen op letter

Met deze opdracht worden variabelen met namen ophaalt die beginnen met de letter m. Met de opdracht wordt ook de waarde van de variabelen opgehaald.

Get-Variable m*

Voorbeeld 2: Variabele waarden ophalen op letter

Met deze opdracht worden alleen de waarden opgehaald van de variabelen met namen die beginnen met m.

Get-Variable m* -ValueOnly

Voorbeeld 3: Variabelen ophalen met twee letters

Met deze opdracht wordt informatie opgehaald over de variabelen die beginnen met de letter M of de letter P.

Get-Variable -Include M*,P*

Voorbeeld 4: Variabelen ophalen op bereik

De eerste opdracht haalt alleen de variabelen op die zijn gedefinieerd in het lokale bereik. Het is gelijk aan Get-Variable -Scope Local en kan worden afgekort als gv -s 0.

De tweede opdracht gebruikt de cmdlet Compare-Object om de variabelen te vinden die zijn gedefinieerd in het bovenliggende bereik (Bereik 1), maar zijn alleen zichtbaar in het lokale bereik (Bereik 0).

Get-Variable -Scope 0
Compare-Object (Get-Variable -Scope 0) (Get-Variable -Scope 1)

Parameters

-Exclude

Hiermee geeft u een matrix van items op die door deze cmdlet worden uitgesloten van de bewerking. 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

-Include

Hiermee geeft u een matrix van items waarop de cmdlet zal handelen, met uitzondering van alle andere. 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. Wildcards zijn toegestaan. U kunt ook de naam van een variabele doorsluisen naar Get-Variable.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

(All)
Position:0
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Scope

Hiermee geeft u de variabelen in het bereik. 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)

lokale 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

-ValueOnly

Geeft aan dat deze cmdlet alleen de waarde van de variabele ophaalt.

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

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

String

U kunt een tekenreeks met de naam van de variabele doorsluisen naar deze cmdlet.

Uitvoerwaarden

PSVariable

Deze cmdlet retourneert standaard een AutomationPSVariable-object voor elke variabele die wordt opgehaald. Het objecttype is afhankelijk van de variabele.

Object

Wanneer u de parameter ValueOnly opgeeft en de waarde van de opgegeven variabele een verzameling is, retourneert deze cmdlet een [System.Object[]]. Dit gedrag voorkomt dat normale pijplijnbewerkingen de waarden van de variabele één voor één verwerken. Een tijdelijke oplossing om verzamelingsinventarisatie af te dwingen, is door de opdracht Get-Variable tussen haakjes te plaatsen.

Notities

PowerShell bevat de volgende aliassen voor Get-Variable:

  • Alle platforms:

    • gv

  • Met deze cmdlet worden omgevingsvariabelen niet beheerd. Als u omgevingsvariabelen wilt beheren, kunt u de omgevingsprovider gebruiken.