about_Environment_Provider
Nome do fornecedor
Environment
Unidades
Env:
Capacidades
DeveProcessar
Breve descrição
Fornece acesso às variáveis de ambiente do Windows.
Descrição detalhada
O provedor de Ambiente do PowerShell permite obter, adicionar, alterar, limpar e excluir variáveis e valores de ambiente no PowerShell.
As variáveis de ambiente são variáveis nomeadas dinamicamente que descrevem o ambiente no qual seus programas são executados. O Windows e o PowerShell usam variáveis de ambiente para armazenar informações persistentes que afetam a execução do sistema e do processo. Ao contrário das variáveis do PowerShell, as variáveis de ambiente não estão sujeitas a restrições de escopo.
A unidade de ambiente é um namespace simples que contém as variáveis de ambiente específicas para a sessão do usuário atual. As variáveis de ambiente não têm itens filho.
O provedor de ambiente oferece suporte aos cmdlets a seguir, que são abordados neste artigo.
Tipos expostos por este provedor
Cada variável de ambiente é uma instância da classe System.Collections.DictionaryEntry . O nome da variável é a chave do dicionário. O valor da variável de ambiente é o valor do dicionário.
Navegando na unidade Ambiente
O provedor de ambiente expõe seu armazenamento de dados na Env: unidade. Para trabalhar com variáveis de ambiente, altere seu local para a Env: unidade (Set-Location Env:) ou trabalhe em outra unidade do PowerShell. Para fazer referência a uma variável de ambiente de outro local, use o nome da Env: unidade no caminho.
Set-Location Env:
Para retornar a uma unidade do sistema de arquivos, digite o nome da unidade. Por exemplo, escreva:
Set-Location C:
Você também pode trabalhar com o provedor de ambiente de qualquer outra unidade do PowerShell. Para fazer referência a uma variável de ambiente de outro local, use o nome Env: da unidade no caminho.
O provedor de ambiente também expõe variáveis de ambiente usando um prefixo de variável de $env:. O comando a seguir exibe o conteúdo da variável de ambiente ProgramFiles . O $env: prefixo da variável pode ser usado de qualquer unidade do PowerShell.
PS C:\> $env:ProgramFiles
C:\Program Files
Você também pode alterar o valor de uma variável de ambiente usando o prefixo da $env: variável. Quaisquer alterações feitas referem-se apenas à sessão atual do PowerShell enquanto ela estiver ativa.
Nota
O PowerShell usa aliases para permitir uma maneira familiar de trabalhar com caminhos de provedor. Comandos como dir e ls agora são aliases para Get-ChildItem, cd é um alias para Set-Location. e pwd é um alias para Get-Location.
Obter variáveis de ambiente
Este comando lista todas as variáveis de ambiente na sessão atual.
Get-Item -Path Env:
Você pode usar esse comando de qualquer unidade do PowerShell.
O provedor de ambiente não tem contêineres, portanto, o comando acima tem o mesmo efeito quando usado com Get-ChildItem.
Get-ChildItem -Path Env:
Obter uma variável de ambiente selecionada
Este comando obtém a WINDIR variável de ambiente.
Get-ChildItem -Path Env:windir
Você também pode usar o formato de prefixo variável.
$env:windir
Criar uma variável de ambiente
Este comando cria a USERMODE variável de ambiente com um valor de "Non-Admin". O -Path valor do parâmetro cria o novo item na Env: unidade. A nova variável de ambiente só pode ser usada na sessão atual do PowerShell enquanto estiver ativa.
PS C:\> New-Item -Path Env: -Name USERMODE -Value Non-Admin
Alterar uma variável de ambiente
Renomear uma variável de ambiente
Este comando usa o Rename-Item cmdlet para alterar o nome da variável de USERMODE ambiente que você criou para USERROLE. Não altere o nome de uma variável de ambiente que o sistema usa. Embora essas alterações afetem apenas a sessão atual, elas podem fazer com que o sistema ou um programa funcione incorretamente.
Rename-Item -Path Env:USERMODE -NewName USERROLE
Alterar uma variável de ambiente
Este comando usa o Set-Item cmdlet para alterar o USERROLE valor da variável de ambiente para "Administrador".
Set-Item -Path Env:USERROLE -Value Administrator
Copiar uma variável de ambiente
Este comando copia o USERROLE valor da variável de ambiente para a USERROLE2 variável de ambiente.
Copy-Item -Path Env:USERROLE -Destination Env:USERROLE2
Remover uma variável de ambiente
Este comando exclui a USERROLE2 variável de ambiente da sessão atual.
Remove-Item -Path Env:USERROLE2
Remover uma variável de ambiente com Clear-Item
Este comando exclui a USERROLE variável de ambiente limpando seu valor.
Clear-Item -Path Env:USERROLE
Usando o pipeline
Os cmdlets do provedor aceitam entrada de pipeline. Você pode usar o pipeline para simplificar a tarefa enviando dados do provedor de um cmdlet para outro cmdlet do provedor. Para ler mais sobre como usar o pipeline com cmdlets de provedor, consulte as referências de cmdlet fornecidas ao longo deste artigo.
Obter ajuda
A partir do Windows PowerShell 3.0, você pode obter tópicos de ajuda personalizados para cmdlets de provedor que explicam como esses cmdlets se comportam em uma unidade do sistema de arquivos.
Para obter os tópicos de ajuda personalizados para a unidade do sistema de arquivos, execute um comando Get-Help em uma unidade do sistema de arquivos ou use o -Path parâmetro Get-Help para especificar uma unidade do sistema de arquivos.
Get-Help Get-ChildItem
Get-Help Get-ChildItem -Path env:
