Get-Variable
Obtém as variáveis no console atual.
Sintaxe
Default (Predefinição)
Get-Variable
[[-Name] <String[]>]
[-ValueOnly]
[-Include <String[]>]
[-Exclude <String[]>]
[-Scope <String>]
[<CommonParameters>]
Description
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 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 cmdlet Compare-Object 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.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Include
Especifica uma matriz de itens sobre os quais o cmdlet agirá, excluindo todos os outros. Curingas são permitidos.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Especifica o nome da variável.
Curingas são permitidos.
Você também pode canalizar um nome de variável para Get-Variable.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Scope
Especifica as variáveis no escopo. Os valores aceitáveis para este parâmetro são:
- A nível mundial
- Local
- 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ValueOnly
Indica que esse cmdlet obtém apenas o valor da variável.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
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[]]. 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 comando Get-Variable 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 ambiente.
