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