Sdílet prostřednictvím

Get-Variable

  • Reference
Modul:
Microsoft.PowerShell.Utility

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

Syntax

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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-ValueOnly

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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í.