Share via

Get-Variable

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Lekéri a változókat az aktuális konzolon.

Syntax

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

Description

A Get-Variable parancsmag lekéri a PowerShell-változókat az aktuális konzolon. A ValueOnly paraméter megadásával lekérheti a változók értékeit , és a név alapján visszaadott változókat szűrheti.

Példák

1. példa: Változók lekérése betű szerint

Ez a parancs lekéri az m betűvel kezdődő neveket tartalmazó változókat. A parancs a változók értékét is lekéri.

Get-Variable m*

2. példa: Változóértékek beolvasása betű szerint

Ez a parancs csak az m kezdetű névvel rendelkező változók értékeit kapja meg.

Get-Variable m* -ValueOnly

3. példa: Változók lekérése két betűvel

Ez a parancs az M vagy a P betűvel kezdődő változókra vonatkozó információkat kap.

Get-Variable -Include M*,P*

4. példa: Változók lekérése hatókör szerint

Az első parancs csak a helyi hatókörben definiált változókat kapja meg. Egyenértékű a következővel, Get-Variable -Scope Local és rövidítve is lehet: gv -s 0.

A második parancs a Compare-Object parancsmaggal keresi meg a szülőhatókörben definiált változókat (1. hatókör), de csak a helyi hatókörben (0. hatókör).

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

Paraméterek

-Exclude

Olyan elemtömböt ad meg, amelyet ez a parancsmag kizár a műveletből. Helyettesítő karakterek használata engedélyezett.

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

-Include

Olyan elemek tömbje, amelyeken a parancsmag működni fog, kivéve az összes többit. Helyettesítő karakterek használata engedélyezett.

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

-Name

Megadja a változó nevét. Helyettesítő karakterek használata engedélyezett. A változó nevét is becsúszthatja.Get-Variable

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

-Scope

Megadja a hatókör változóit. A paraméter elfogadható értékei a következők:

  • Globális
  • Helyi
  • Szkript
  • Az aktuális hatókörhöz viszonyított szám (0 a hatókörök számán keresztül, ahol a 0 az aktuális hatókör, az 1 pedig a szülője)

Az alapértelmezett érték a helyi . További információ: about_Scopes.

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

-ValueOnly

Azt jelzi, hogy ez a parancsmag csak a változó értékét kapja meg.

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

Bevitelek

String

A változó nevét tartalmazó sztringet erre a parancsmagra csövezheti.

Kimenetek

PSVariable

Ez a parancsmag alapértelmezés szerint egy AutomationPSVariable objektumot ad vissza minden egyes lekért változóhoz. Az objektum típusa a változótól függ.

Object[]

Amikor megadja a ValueOnly paramétert , és a megadott változó értéke gyűjtemény, ez a parancsmag egy [System.Object[]]. Ez a viselkedés megakadályozza, hogy a normál folyamatművelet egyenként dolgozza fel a változó értékeit. A gyűjtemények számbavételének kényszerítéséhez kerülő megoldásként zárójelekbe kell tenni a Get-Variable parancsot.

Jegyzetek

A PowerShell a következő aliasokat Get-Variabletartalmazza:

  • Összes platform:

    • gv

  • Ez a parancsmag nem kezeli a környezeti változókat. A környezeti változók kezeléséhez használhatja a környezeti változó szolgáltatót.