WindowsOptionalFeatureSet

  • Artigo

Sinopse

Gerenciar vários recursos opcionais do Windows com configurações comuns.

Sintaxe

WindowsOptionalFeatureSet [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    Name = [String[]]
    Ensure = [String]
    [RemoveFilesOnDisable = [Boolean]]
    [NoWindowsUpdateCheck = [Boolean]]
    [LogPath = [String]]
    [LogLevel = [String]]
}

Descrição

O WindowsOptionalFeatureSet recurso composto permite que você configure vários recursos opcionais do Windows. Para configurar um recurso opcional do Windows por vez, use o recurso WindowsOptionalFeature. Para gerenciar funções e recursos do Windows Server, use o recurso WindowsFeature.

Requisitos

  • O computador de destino deve estar executando um sistema operacional cliente Windows, Windows Server 2012 ou posterior ou Nano Server.
  • O computador de destino deve ter acesso ao módulo DISM do PowerShell.

Propriedades da chave

Nome

Especifique os nomes dos recursos opcionais do Windows como uma matriz de cadeias de caracteres.

Cada valor dessa propriedade deve ser o mesmo que a propriedade FeatureName de um recurso opcional do Windows. Para listar os recursos opcionais disponíveis para um computador, use o Get-WindowsOptionalFeature cmdlet.

Type: System.String[]

Propriedades opcionais

Ensure

Especifique se os recursos opcionais do Windows devem ser habilitados. Defina essa propriedade para Present habilitar os recursos opcionais do Windows. Defina essa propriedade para Absent desabilitar os recursos opcionais do Windows.

O valor padrão é Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

LogLevel

Especifique as informações de saída a serem mostradas no log dism como uma cadeia de caracteres. As opções válidas são:

  • ErrorsOnly - O recurso registra apenas erros.
  • ErrorsAndWarning - Os erros e avisos de logs de recursos.
  • ErrorsAndWarningAndInformation - O recurso registra erros, avisos e informações de depuração.

O valor padrão é ErrorsAndWarningAndInformation.

Type: System.String
Accepted Values:
  - ErrorsOnly
  - ErrorsAndWarning
  - ErrorsAndWarningAndInformation
Default Value: ErrorsAndWarningAndInformation

LogPath

Especifique o caminho para um arquivo para registrar em log a habilitação ou desabilitação dos recursos opcionais do Windows.

Se não estiver definido, o recurso gravará o log em %WINDIR%\Logs\Dism\dism.log.

Type: System.String
Default Value: None

NoWindowsUpdateCheck

Especifique se o DISM entra em contato com Windows Update (WU) ao pesquisar os arquivos de origem para habilitar os recursos opcionais do Windows. Defina essa propriedade para $true impedir que o DISM entre em contato com o WU.

O valor padrão é $false.

Type: System.Boolean
Default Value: false

RemoveFilesOnDisable

Especifique se o recurso deve remover todos os arquivos associados aos recursos opcionais do Windows ao desabilitá-los. Defina essa propriedade para $true remover todos os arquivos associados.

O valor padrão é $false.

Type: System.Boolean
Default Value: false

Exemplos