Sdílet prostřednictvím

Get-Variable

  • Reference
Modul:
Microsoft.PowerShell.Utility

Získá proměnné v aktuální konzole.

Syntaxe

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 může být zkrácena jako gv -s 0.

Druhý příkaz pomocí rutiny Compare-Object vyhledá proměnné definované v nadřazené oblasti (Scope 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é cardy.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-Include

Určuje pole položek, na kterých bude rutina fungovat, s výjimkou všech ostatních. Jsou povoleny zástupné cardy.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-Name

Určuje název proměnné. Jsou povoleny zástupné cardy. Můžete také převést název proměnné na Get-Variable.

Typ:String[]
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-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ý)

Místní je výchozí hodnota. Další informace najdete v tématu about_Scopes.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ValueOnly

Označuje, že tato rutina získá pouze hodnotu proměnné.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

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, tato rutina vrátí hodnotu [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í Get-Variable příkazu do závorek.

Poznámky

PowerShell obsahuje následující aliasy pro Get-Variable:

  • Všechny platformy:

    • gv

  • 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í.