Compartilhar via


Get-Variable

Obtém as variáveis no atual console.

Sintaxe

Get-Variable [[-Name] <string[]>] [-Exclude <string[]>] [-Include <string[]>] [-Scope <string>] [-ValueOnly] [<CommonParameters>]

Descrição

O cmdlet Get-Variable obtém as variáveis do Windows PowerShell no console atual. Você pode recuperar apenas os valores das variáveis ao especificar o parâmetro ValueOnly, bem como pode filtrar as variáveis retornadas pelo nome.

Parâmetros

-Exclude <string[]>

Omite os itens especificados. Os caracteres curinga são permitidos.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Include <string[]>

Especifica somente os itens em que o cmdlet agirá, excluindo todos os outros. Os caracteres curinga são permitidos.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Name <string[]>

Especifica o nome da variável.

Necessário?

false

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

-Scope <string>

Obtém apenas as variáveis no escopo especificado. Os valores válidos são "Global", "Local" ou "Script" ou um número relativo ao atual escopo (0 ao 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.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-ValueOnly

Obtém apenas o valor da variável.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.String

Você pode canalizar uma cadeia de caracteres que contenha o nome de variável para Get-Variable.

Saídas

Objeto de variável

Get-Variable retorna um objeto de variável System.Management.Automation para cada variável que ele obtém. O tipo do objeto depende da variável.

Observações

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.

Exemplo 1

C:\PS>get-variable m*

Descrição
-----------
Esse comando exibe variáveis com nomes que iniciam com a letra "m". O valor das variáveis também é exibido.





Exemplo 2

C:\PS>get-variable m* -valueonly

Descrição
-----------
Esse comando exibe apenas os valores das variáveis com nomes que iniciam com a letra "m".





Exemplo 3

C:\PS>get-variable -include M*,P* | sort-object name

Descrição
-----------
Esse comando obtém informações sobre as variáveis que iniciam com as letras "M" ou "P". Os resultados são canalizados para o cmdlet Sort-Object, classificados por nome e exibidos.





Exemplo 4

C:\PS>get-variable -scope 0

C:\PS> compare-object (get-variable -scope 0) (get-variable -scope 1)

Descrição
-----------
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 definidas no escopo pai (Scope 1), mas visíveis somente no escopo local (Scope 0).





Consulte também

Conceitos

Set-Variable
New-Variable
Clear-Variable
Remove-Variable