Obtém as variáveis no console atual.
Sintaxe
Descrição
O cmdlet Get-Variable 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
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.
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.
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 .
Exemplo 4: Obter variáveis por escopo
O primeiro comando obtém apenas as variáveis que são 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 encontrar as variáveis que são definidas no escopo pai (Escopo 1), mas são visíveis apenas no escopo local (Escopo 0).
Parâmetros
Especifica uma matriz de itens que este cmdlet exclui da operação. Cartões de luz são permitidos.
| Tipo: | String |
| Posição: | Nomeada |
| Valor padrão: | Nenhum |
| Aceitar entrada de pipeline: | False |
| Aceitar caracteres curinga: | Verdadeiro |
Especifica uma matriz y de itens sobre os quais o cmdlet atuará, excluindo todos os outros. Cartões selvagens são permitidos.
| Tipo: | String |
| Posição: | Nomeada |
| Valor padrão: | Nenhum |
| Aceitar entrada de pipeline: | False |
| Aceitar caracteres curinga: | Verdadeiro |
Especifica o nome da variável. Cartões selvagens são permitidos .Você também pode enviar um nome de variável para Get-Variable.
| Tipo: | String |
| Posição: | 0 |
| Valor padrão: | Nenhum |
| Aceitar entrada de pipeline: | Verdadeiro |
| Aceitar caracteres curinga: | Verdadeiro |
Especifica as variáveis no escopo . Os valores aceitáveis para este 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.
| Tipo: | String |
| Posição: | Nomeada |
| Valor padrão : | Nenhum |
| Aceitar entrada do pipeline: | Falso |
| Aceitar caracteres curinga: | False |
Indica que este cmdlet obtém apenas o valor da variável.
| Tipo: | SwitchParameter |
| Posição: | Nomeada |
| Valor padrão: | Nenhum |
| Aceitar entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
String
Você pode canalizar uma string que contenha o nome da variável para Get-Variable.
Saídas
PSVariable
Este cmdlet retorna um objeto System.Management.AutomationPSVariable para cada variável que ele almeja. O tipo de objeto depende da variável.
Objeto
Quando você especifica o parâmetro ValueOnly, se o valor da variável especificada for uma coleção, Get-Variable retorna um ]. Esse comportamento evita 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 da coleção é enclausurar o comando Get-Variable entre parênteses.
Notas
- 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.
- Clear-Variable
- New-Variable
- Remove-Variable
- Set-Variable
