Compartilhar via

Get-Variable

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Obtém as variáveis no console atual.

Sintaxe

Get-Variable
   [[-Name] <String[]>]
   [-ValueOnly]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]

Description

O cmdlet Get-Variable obtém as variáveis do PowerShell no console atual. Você pode recuperar apenas os valores das variáveis especificando o parâmetro ValueOnly e filtrar as variáveis retornadas pelo nome.

Exemplos

Exemplo 1: Obter variáveis por letra

Esse comando obtém variáveis com nomes que começam com a letra m. O comando também obtém o valor das variáveis.

Get-Variable m*

Exemplo 2: Obter valores de variável por letra

Esse comando obtém apenas os valores das variáveis que têm nomes que começam com m.

Get-Variable m* -ValueOnly

Exemplo 3: Obter variáveis por duas letras

Esse comando obtém informações sobre as variáveis que começam com a letra M ou a letra P.

Get-Variable -Include M*,P*

Exemplo 4: Obter variáveis por escopo

O primeiro comando obtém apenas as variáveis definidas no escopo local. É equivalente a Get-Variable -Scope Local e pode ser abreviado como gv -s 0.

O segundo comando usa o cmdlet Compare-Object para localizar as variáveis que são definidas no escopo pai (Escopo 1), mas são visíveis apenas no escopo local (Escopo 0).

Get-Variable -Scope 0
Compare-Object (Get-Variable -Scope 0) (Get-Variable -Scope 1)

Parâmetros

-Exclude

Especifica uma matriz de itens que esse cmdlet exclui da operação. Curingas são permitidos.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-Include

Especifica uma matriz de itens nos quais o cmdlet atuará, excluindo todos os outros. Curingas são permitidos.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-Name

Especifica o nome da variável. Curingas são permitidos. Você também pode canalizar um nome de variável para Get-Variable.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-Scope

Especifica as variáveis no escopo. Os valores aceitáveis para este parâmetro são:

  • Global
  • Local
  • de Script
  • Um número relativo ao escopo atual (0 por meio do número de escopos, em que 0 é o escopo atual e 1 é seu pai)

local é o padrão. Para obter mais informações, consulte about_Scopes.

Tipo:String
Cargo:Named
Valor padrão:Local
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ValueOnly

Indica que esse cmdlet obtém apenas o valor da variável.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Você pode canalizar uma cadeia de caracteres que contém o nome da variável para Get-Variable.

Saídas

PSVariable

Esse cmdlet retorna um objeto System.Management.AutomationPSVariable para cada variável que ele obtém. O tipo de objeto depende da variável.

Object[]

Quando você especifica o parâmetro ValueOnly, se o valor da variável especificada for uma coleção, Get-Variable retornará um [System.Object[]]. Esse comportamento impede que a operação de pipeline normal processe os valores da variável um de cada vez. Uma solução alternativa para forçar a enumeração de coleção é colocar o comando Get-Variable entre parênteses.

Observações

  • Esse cmdlet não gerencia variáveis de ambiente. Para gerenciar variáveis de ambiente, você pode usar o provedor de variável de ambiente.