Recurso do WindowsOptionalFeatureSet DSC
Aplica-se a: Windows PowerShell 5.x
O recurso WindowsOptionalFeatureSet na DSC (Configuração de Estado Desejado) do Windows PowerShell oferece um mecanismo para garantir que os recursos opcionais sejam habilitados em um nó de destino. Esse recurso é um recurso composto que chama o recurso WindowsOptionalFeature para cada recurso especificado na propriedade Name.
Use esse recurso quando desejar configurar vários recursos opcionais do Windows para o mesmo estado.
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
WindowsOptionalFeatureSet [string] #ResourceName
{
Name = [string[]]
[ RemoveFilesOnDisable = [bool] ]
[ LogPath = [string] ]
[ NoWindowsUpdateCheck = [bool] ]
[ LogLevel = [string] { ErrorsOnly | ErrorsAndWarning | ErrorsAndWarningAndInformation } ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Enable | Disable } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Propriedades
Propriedade | Descrição |
---|---|
Nome | Indica o nome dos recursos que você deseja garantir que estejam habilitados ou desabilitados. |
NoWindowsUpdateCheck | Especifica se o DISM contata o WU (Windows Update) ao procurar os arquivos de origem para habilitar recursos. Se $true , o DISM não contatará o WU. |
RemoveFilesOnDisable | Definido como $true para remover todos os arquivos associados aos recursos quando Ensure está definido como Absent. |
LogLevel | O nível máximo de saída mostrado nos logs. Os valores aceitos são: ErrorsOnly, ErrorsAndWarning e ErrorsAndWarningAndInformation. |
LogPath | O caminho até um arquivo de log em que você deseja que o provedor de recursos registre a operação. |
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 | Especifica se os recursos estão habilitados. Para garantir que os recursos sejam habilitados, defina essa propriedade como Enable. Para garantir que os recursos sejam desabilitados, defina essa propriedade como Disable. O valor padrão é Enable. |
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.
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