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: | None |
| 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: | None |
| 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
Do této rutiny můžete zamísit řetězec, který obsahuje název proměnné.
Výstupy
PSVariable
Ve výchozím nastavení vrátí tato rutina objekt AutomationPSVariable pro každou proměnnou, kterou získá. Typ objektu závisí na proměnné.
Object
Když zadáte parametr ValueOnly a hodnota zadané proměnné je kolekce, vrátí tato rutina [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
Windows PowerShell obsahuje následující aliasy pro Get-Variable:
gvTato rutina nespravuje proměnné prostředí. Ke správě proměnných prostředí můžete použít zprostředkovatele prostředí.
