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 Get-Variable cmdlet 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 por nome.

Exemplos

Exemplo 1: Obter variáveis por letra

Este 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áveis por letra

Este 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 que estão definidas no escopo local. É equivalente e Get-Variable -Scope Local pode ser abreviado como gv -s 0.

O segundo comando usa o Compare-Object cmdlet para localizar as variáveis definidas no escopo pai (Escopo 1), mas 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. Caracteres curinga 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 sobre a qual o cmdlet atuará, excluindo todos os outros. Caracteres curinga 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. Caracteres curinga 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
  • Script
  • Um número relativo ao escopo atual (0 até o 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:None
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:None
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 esse cmdlet.

Saídas

PSVariable

Por padrão, esse cmdlet retorna um objeto AutomationPSVariable para cada variável obtida. O tipo de objeto depende da variável.

Object[]

Quando você especifica o parâmetro ValueOnly e o valor da variável especificada é uma coleção, esse cmdlet retorna um [System.Object[]]. Esse comportamento impede que a operação normal do pipeline 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 Get-Variable comando entre parênteses.

Observações

O PowerShell inclui os seguintes aliases para Get-Variable:

  • Todas as plataformas:

    • gv

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