Get-Variable
Lekéri a változókat az aktuális konzolon.
Syntax
Default (Alapértelmezett)
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 név alapján szűrheti a visszaadott változókat.
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.
Ez egyenértékű a Get-Variable -Scope Local, és rövidítve 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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Megadja a változó nevét.
Helyettesítő karakterek használata engedélyezett.
A változó nevét a Get-Variableis beszűkítheti.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-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-tól a hatókörök számáig terjedően, ahol a 0 az aktuális hatókört, az 1 pedig a szülőt jelenti)
helyi az alapértelmezett. További információ található a about_Scopesrészben.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ValueOnly
Azt jelzi, hogy ez a parancsmag csak a változó értékét kapja meg.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
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[]]ad vissza. 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ére kerülő megoldás a Get-Variable parancs zárójelbe helyezése.
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Get-Variable:
Minden 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 szolgáltatót.