Recurso Registry de DSC
Aplica-se a: Windows PowerShell 4.0, Windows PowerShell 5.x
O recurso Registry na Configuração de Estado Desejado (DSC) do Windows PowerShell fornece um mecanismo para gerenciar chaves e valores do registro em um nó de destino.
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
Registry [string] #ResourceName
{
Key = [string]
ValueName = [string]
[ Force = [bool] ]
[ Hex = [bool] ]
[ ValueData = [string[]] ]
[ ValueType = [string] { Binary | Dword | ExpandString | MultiString | Qword | String } ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Present | Absent } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Propriedades
Propriedade | Descrição |
---|---|
Chave | Indica o caminho da chave do Registro para o qual você deseja garantir um estado específico. Esse caminho deve incluir o hive. |
ValueName | Indica o nome do valor de registro. Para adicionar ou remover uma chave do Registro, especifique essa propriedade como uma cadeia de caracteres vazia sem especificar ValueType ou ValueData. Para modificar ou remover o valor padrão de uma chave do Registro, especifique essa propriedade como uma cadeia de caracteres vazia e também especifique ValueType ou ValueData. |
Force | Se a chave do Registro especificada estiver presente, Force a substituirá pelo novo valor. Para excluir uma chave do Registro com subchaves, isso deve ser $true . |
Hex | Indica se os dados serão expressos em formato hexadecimal. Se especificado, os dados do valor DWORD/QWORD são apresentados em formato hexadecimal. Não é válido para outros tipos. O valor padrão é $false . |
ValueData | Os dados para o valor de registro. |
ValueType | Indica o tipo de valor. Os tipos com suporte são: Cadeia de caracteres (REG_SZ), Binário (REG_BINARY), Dword (REG_DWORD de 32 bits), Qword (REG_QWORD de 64 bits), MultiString (REG_MULTI_SZ), ExpandString (REG_EXPAND_SZ). |
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 a chave e o valor existem. Para garantir que existam, defina essa propriedade como Present. Para garantir que não existam, defina a propriedade como Absent. O valor padrão é Present. |
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.
Exemplos
Exemplo 1: Verifique o Valor e os Dados especificados na chave do Registro especificada
Este exemplo verifica se o valor do Registro "TestValue" em uma chave chamada "ExampleKey1" está presente no hive HKEY\_LOCAL\_MACHINE
e tem os dados "TestData".
Configuration RegistryTest
{
Import-DscResource -ModuleName 'PSDesiredStateConfiguration'
Registry RegistryExample
{
Ensure = "Present" # You can also set Ensure to "Absent"
Key = "HKEY_LOCAL_MACHINE\SOFTWARE\ExampleKey1"
ValueName = "TestValue"
ValueData = "TestData"
}
}
Exemplo 2: Verifique se a chave do Registro especificada existe
Este exemplo garante que uma chave chamada "ExampleKey2" esteja presente no hive HKEY_LOCAL_MACHINE .
Configuration RegistryTest
{
Import-DscResource -ModuleName 'PSDesiredStateConfiguration'
Registry RegistryExample
{
Ensure = "Present" # You can also set Ensure to "Absent"
Key = "HKEY_LOCAL_MACHINE\SOFTWARE\ExampleKey2"
ValueName = ""
}
}
Observação
Alterar uma configuração do registro no hive HKEY_CURRENT_USER
requer que a configuração seja executada com credenciais de usuário, em vez de como o sistema. Você pode usar a propriedade PsDscRunAsCredential para especificar credenciais de usuário para a configuração. Por exemplo, veja Executar DSC com as credenciais do usuário.
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