Recurso Environment de DSC
Aplica-se a: Windows PowerShell 4.0, Windows PowerShell 5.x
O recurso Environment na Configuração de Estado Desejado (DSC) do Windows PowerShell fornece um mecanismo para gerenciar as variáveis de ambiente do sistema.
Observação
Esta documentação desse recurso de DSC abrange a versão incluída no PowerShell antes da versão 7.2. O módulo PSDscResources contém recursos de DSC novos e atualizados que têm suporte oficial da Microsoft. O módulo PSDscResources está disponível na Galeria do PowerShell.
Para obter mais informações e a documentação atualizada, consulte a documentação de referência do PSDscResources.
Sintaxe
Environment [string] #ResourceName
{
Name = [string]
[ Path = [bool] ]
[ Value = [string] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Absent | Present } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Propriedades
Propriedade | Descrição |
---|---|
Nome | Indica o nome da variável de ambiente para a qual você deseja garantir um estado específico. |
Caminho | Define a variável de ambiente que está sendo configurada. Defina essa propriedade como $true se a variável for Path. Caso contrário, defina-a como $false . O padrão é $false . Se a variável que estiver sendo configurada for a variável Path, o valor fornecido por meio da propriedade Value será acrescentado ao valor existente. |
Valor | O valor que será atribuído à variável de ambiente. |
Propriedades comuns
Propriedade | Descrição |
---|---|
DependsOn | Indica que a configuração de outro recurso deve ser executada antes de ele ser configurado. Por exemplo, se a ID do bloco de script de configuração do recurso que você deseja executar primeiro for ResourceName e seu tipo for ResourceType, a sintaxe para usar essa propriedade será DependsOn = "[ResourceType]ResourceName" . |
Ensure | Indica se existe uma variável. Defina essa propriedade como Present para criar a variável de ambiente caso ela não exista ou para garantir que seu valor corresponda ao que é fornecido por meio da propriedade Value se a variável já existir. Defina-a como Absent para excluir a variável se ela existir. |
PsDscRunAsCredential | Define a credencial para executar todo o recurso. |
Observação
A propriedade comum PsDscRunAsCredential foi adicionada ao WMF 5.0 para permitir a execução de qualquer recurso de DSC no contexto de outras credenciais. Para saber mais, confira Usar credenciais com recursos de DSC.
Exemplo
O exemplo a seguir assegura que TestEnvironmentVariable esteja presente e tenha o valor TestValue. Se não estiver presente, será criado.
Environment EnvironmentExample
{
Ensure = "Present" # You can also set Ensure to "Absent"
Name = "TestEnvironmentVariable"
Value = "TestValue"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de