Share via

WindowsOptionalFeature

  • Artigo

Sinopse

Habilitar ou desabilitar um recurso opcional do Windows.

Sintaxe

WindowsOptionalFeature [String] #ResourceName
{
    Name = [string]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [LogLevel = [string]{ ErrorsAndWarning | ErrorsAndWarningAndInformation | ErrorsOnly }]
    [LogPath = [string]]
    [NoWindowsUpdateCheck = [bool]]
    [PsDscRunAsCredential = [PSCredential]]
    [RemoveFilesOnDisable = [bool]]
}

Descrição

O WindowsOptionalFeature recurso permite que você verifique se um recurso opcional do Windows está habilitado ou desabilitado em um computador cliente Windows. Para gerenciar as funções e os recursos de um 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 o nome do recurso opcional do Windows como uma cadeia de caracteres.

Esse valor para essa propriedade deve ser o mesmo que a propriedade FeatureName do 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 o recurso opcional do Windows deve ser habilitado. Defina essa propriedade para Present habilitar o recurso opcional do Windows se ele estiver desabilitado. Defina essa propriedade para Absent desabilitar o recurso opcional do Windows se estiver habilitado.

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 do recurso opcional 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 o recurso opcional 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 ao recurso opcional do Windows ao desabilitá-lo. Defina essa propriedade para $true remover todos os arquivos associados.

O valor padrão é $false.

Type: System.Boolean
Default Value: false

Propriedades somente leitura

CustomProperties

As propriedades personalizadas do recurso opcional do Windows como uma matriz de cadeias de caracteres.

Type: System.String[]

Descrição

A descrição do recurso opcional do Windows como uma cadeia de caracteres.

Type: System.String

DisplayName

O nome de exibição do recurso opcional do Windows como uma cadeia de caracteres.

Type: System.String

Exemplos