Share via

Get-Variable

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

Obtém as variáveis no console atual.

Syntax

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, além de filtrar por nome as variáveis retornadas.

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 que estão definidas no escopo local. Ele é equivalente a Get-Variable -Scope Local e 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 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.

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

-Include

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

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

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Scope

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

  • Global
  • Local
  • Script
  • Um número relativo ao escopo atual (0 pelo 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.

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

-ValueOnly

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

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

Entradas

String

Você pode redirecionar 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ê especificar 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 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

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