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 por 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á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 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 somente 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 a qual 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 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 esse parâmetro são:

  • Global
  • Local
  • Script
  • Um número relativo ao escopo atual (0 até o 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 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[]]arquivo . 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 da coleção é colocar o Get-Variable comando entre parênteses.

Observações

O Windows PowerShell inclui os seguintes aliases para Get-Variable:

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