Recurso do WindowsOptionalFeatureSet DSCDSC WindowsOptionalFeatureSet Resource

Aplica-se a: Windows PowerShell 5.0Applies To: Windows PowerShell 5.0

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.The WindowsOptionalFeatureSet resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to ensure that optional features are enabled on a target node. Esse recurso é um recurso composto que chama o recurso WindowsOptionalFeature para cada recurso especificado na propriedade Name.This resource is a composite resource that calls the WindowsOptionalFeature resource for each feature specified in the Name property.

Use esse recurso quando desejar configurar vários recursos opcionais do Windows para o mesmo estado.Use this resource when you want to configure a number of Windows optional features to the same state.

SintaxeSyntax

WindowsOptionalFeature [string] #ResourceName
{
    Name = [string[]]
    [ Ensure = [string] { Enable | Disable }  ]
    [ Source = [string] ] 
    [ RemoveFilesOnDisable = [bool] ]  
    [ LogPath = [string] ]
    [ NoWindowsUpdateCheck = [bool] ]
    [ LogLevel = [string] { ErrorsOnly | ErrorsAndWarning | ErrorsAndWarningAndInformation }  ]
    [ DependsOn = [string[]] ]

}

PropriedadesProperties

PropriedadeProperty DescriçãoDescription
NomeName Indica o nome dos recursos que você deseja garantir que estejam habilitados ou desabilitados.Indicates the name of the features that you want to ensure are enabled or disabled.
EnsureEnsure Especifica se os recursos estão habilitados.Specifies whether the features are enabled. Para garantir que os recursos estejam habilitados, defina essa propriedade para "Habilitado" Para garantir que os recursos estejam desabilitados, defina a propriedade como "Desabilitado".To ensure that the features are enabled, set this property to "Enable" To ensure that the features are disabled, set the property to "Disable".
OrigemSource Não foi implementado.Not implemented.
NoWindowsUpdateCheckNoWindowsUpdateCheck Especifica se o DISM contata o WU (Windows Update) ao procurar os arquivos de origem para habilitar recursos.Specifies whether DISM contacts Windows Update (WU) when searching for the source files to enable features. Se $true, DISM não contatará WU.If $true, DISM does not contact WU.
RemoveFilesOnDisableRemoveFilesOnDisable Definido como $true para remover todos os arquivos associados ao recurso quando eles são desabilitados (ou seja, quando Garantir está definido como "Ausente").Set to $true to remove all files associated with the features when they are disabled (that is, when Ensure is set to "Absent").
LogLevelLogLevel O nível máximo de saída mostrado nos logs.The maximum output level shown in the logs. Os valores aceitos são: "ErrorsOnly" (somente erros são registrados), "ErrorsAndWarning" (erros e avisos são registrados) e "ErrorsAndWarningAndInformation" (erros, avisos e informações de depuração são registrados).The accepted values are: "ErrorsOnly" (only errors are logged), "ErrorsAndWarning" (errors and warnings are logged), and "ErrorsAndWarningAndInformation" (errors, warnings, and debug information are logged).
LogPathLogPath O caminho até um arquivo de log em que você deseja que o provedor de recursos registre a operação.The path to a log file where you want the resource provider to log the operation.
DependsOnDependsOn Especifica que a configuração de outro recurso deve ser executada antes de ele ser configurado.Specifies that the configuration of another resource must run before this resource is configured. 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".For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".