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 e pode filtrar as variáveis retornadas pelo 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

Este 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 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. Curingas 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. Curingas 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. Curingas são permitidos. Você também pode canalizar 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 este parâmetro são:

  • A nível mundial
  • Locais
  • Script
  • Um número relativo ao escopo atual (0 através do número de escopos, onde 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 canalizar uma cadeia de caracteres que contenha 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[]]arquivo . 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 coleta é colocar o Get-Variable comando entre parênteses.

Notas

O PowerShell inclui os seguintes aliases para Get-Variable:

  • Todas as plataformas:

    • gv

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