Delen via

Get-Variable

  • Referentie
Module:
Microsoft.PowerShell.Utility

Haalt de variabelen op in de huidige console.

Syntax

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 geretourneerde variabelen filteren op naam.

Voorbeelden

Voorbeeld 1: Variabelen per letter ophalen

Met deze opdracht haalt u variabelen op met namen die beginnen met de letter m. Met de opdracht wordt ook de waarde van de variabelen opgehaald.

Get-Variable m*

Voorbeeld 2: Variabelewaarden per letter ophalen

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 per 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 Compare-Object cmdlet om de variabelen te vinden die zijn gedefinieerd in het bovenliggende bereik (bereik 1), maar die alleen zichtbaar zijn 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 die deze cmdlet uitsluit van de bewerking. Jokertekens zijn toegestaan.

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

-Include

Hiermee geeft u een matrix met items op waarop de cmdlet zal reageren, met uitzondering van alle andere. 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. Jokertekens zijn toegestaan. U kunt ook een variabelenaam doorsnijden naar Get-Variable.

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

-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 en met het aantal bereiken, waarbij 0 het huidige bereik is en 1 het bovenliggende bereik)

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

-ValueOnly

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

U kunt een tekenreeks met de naam van de variabele doorsnijden naar Get-Variable.

Uitvoerwaarden

PSVariable

Deze cmdlet retourneert een System.Management.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, Get-Variable retourneert een [System.Object[]]. Dit gedrag voorkomt dat normale pijplijnbewerkingen de waarden van de variabele een voor een verwerken. Een tijdelijke oplossing voor het afdwingen van verzamelingsinventarisatie is door de Get-Variable opdracht tussen haakjes te plaatsen.

Notities

  • Deze cmdlet beheert geen omgevingsvariabelen. Voor het beheren van omgevingsvariabelen kunt u de omgevingsvariabelenprovider gebruiken.