Compartilhar via

Get-Variable

Módulo:
Microsoft.PowerShell.Utility Module

Obtém as variáveis no console atual.

Sintaxe

Default (Padrão) 

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: Obtenha valores de variáveis 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. Caracteres curinga são permitidos.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Include

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-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 (variando de 0 até o número total de escopos, onde 0 é o escopo atual e 1 é o escopo pai)

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ValueOnly

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

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

Saídas

PSVariable

Por padrão, esse cmdlet retorna um objeto 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 e o valor da variável especificada é uma coleção, esse cmdlet retorna 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

O PowerShell inclui os seguintes aliases para Get-Variable:

  • Todas as plataformas:

    • gv

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