Get-Variable
Získá proměnné v aktuální konzole.
Syntax
Default (Výchozí)
Get-Variable
[[-Name] <String[]>]
[-ValueOnly]
[-Include <String[]>]
[-Exclude <String[]>]
[-Scope <String>]
[<CommonParameters>]
Description
Rutina Get-Variable získá proměnné PowerShellu v aktuální konzole.
Hodnoty proměnných můžete načíst zadáním parametru ValueOnly a můžete filtrovat proměnné vrácené názvem.
Příklady
Příklad 1: Získání proměnných podle písmen
Tento příkaz získá proměnné s názvy, které začínají písmenem m. Příkaz také získá hodnotu proměnných.
Get-Variable m*
Příklad 2: Získání hodnot proměnných podle písmene
Tento příkaz získá pouze hodnoty proměnných, které mají názvy začínající m.
Get-Variable m* -ValueOnly
Příklad 3: Získání proměnných dvěma písmeny
Tento příkaz získá informace o proměnných, které začínají písmenem M nebo písmenem P.
Get-Variable -Include M*,P*
Příklad 4: Získání proměnných podle oboru
První příkaz získá pouze proměnné definované v místním oboru.
Je ekvivalentní Get-Variable -Scope Local a lze jej zkrátit jako gv -s 0.
Druhý příkaz používá rutinu Compare-Object k vyhledání proměnných definovaných v nadřazeného oboru (Obor 1), ale jsou viditelné pouze v místním oboru (Obor 0).
Get-Variable -Scope 0
Compare-Object (Get-Variable -Scope 0) (Get-Variable -Scope 1)
Parametry
-Exclude
Určuje pole položek, které tato rutina z operace vylučuje. Jsou povoleny zástupné symboly.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Include
Určuje pole položek, na kterých bude rutina fungovat, s výjimkou všech ostatních. Jsou povoleny zástupné symboly.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje název proměnné.
Jsou povoleny zástupné symboly.
Název proměnné můžete také převést na Get-Variable.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Scope
Určuje proměnné v oboru. Přijatelné hodnoty pro tento parametr jsou:
- Globální
- Místní
- Skript
- Číslo relativní k aktuálnímu oboru (0 až počet oborů, kde 0 je aktuální obor a 1 je jeho nadřazený)
je výchozí místní. Další informace najdete v části about_Scopes.
Vlastnosti parametru
| Typ: | String |
| Default value: | Local |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ValueOnly
Označuje, že tato rutina získá pouze hodnotu proměnné.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
Řetězec, který obsahuje název proměnné, můžete převést na Get-Variable.
Výstupy
PSVariable
Tato rutina vrátí objekt System.Management.AutomationPSVariable pro každou proměnnou, kterou získá. Typ objektu závisí na proměnné.
Object
Když zadáte parametr ValueOnly, pokud je hodnota zadané proměnné kolekce, Get-Variable vrátí [System.Object[]]. Toto chování zabraňuje normální operaci kanálu ve zpracování hodnot proměnné po jednom. Alternativním řešením pro vynucení výčtu kolekce je uzavření příkazu Get-Variable do závorek.
Poznámky
- Tato rutina nespravuje proměnné prostředí. Ke správě proměnných prostředí můžete použít zprostředkovatele proměnných prostředí.