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 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é 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. Název proměnné můžete také převést 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:

  • Global
  • 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 tématu about_Scopes.

Typ:String
Position:Named
Default value:Local
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:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

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