WindowsOptionalFeature

  • Artículo

Sinopsis

Habilite o deshabilite una característica opcional de Windows.

Sintaxis

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

Descripción

El WindowsOptionalFeature recurso permite asegurarse de que una característica opcional de Windows está habilitada o deshabilitada en un equipo cliente de Windows. Para administrar los roles y características de windows Server, use el recurso WindowsFeature.

Requisitos

  • La máquina de destino debe ejecutar un sistema operativo cliente Windows, Windows Server 2012 o posterior, o Nano Server.
  • La máquina de destino debe tener acceso al módulo de PowerShell de DISM .

Propiedades clave

Nombre

Especifique el nombre de la característica opcional de Windows como una cadena.

Este valor para esta propiedad debe ser el mismo que la propiedad FeatureName de la característica opcional de Windows. Para enumerar las características opcionales disponibles para un equipo, use el Get-WindowsOptionalFeature cmdlet .

Type: System.String

Propiedades opcionales

Ensure

Especifique si se debe habilitar la característica opcional de Windows. Establezca esta propiedad Present en para habilitar la característica opcional de Windows si está deshabilitada. Establezca esta propiedad Absent en para deshabilitar la característica opcional de Windows si está habilitada.

El valor predeterminado es Present.

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

LogLevel

Especifique la información de salida que se va a mostrar en el registro DISM como una cadena. Hay varias opciones válidas:

  • ErrorsOnly : el recurso solo registra errores.
  • ErrorsAndWarning - El recurso registra errores y advertencias.
  • ErrorsAndWarningAndInformation - El recurso registra errores, advertencias e información de depuración.

El valor predeterminado es ErrorsAndWarningAndInformation.

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

LogPath

Especifique la ruta de acceso a un archivo para registrar la habilitación o deshabilitación de la característica opcional de Windows.

Si no se establece, el recurso escribe el registro en %WINDIR%\Logs\Dism\dism.log.

Type: System.String
Default Value: None

NoWindowsUpdateCheck

Especifique si los contactos dism Windows Update (WU) al buscar los archivos de origen para habilitar la característica opcional de Windows. Establezca esta propiedad $true en para evitar que DISM se comunique con WU.

El valor predeterminado es $false.

Type: System.Boolean
Default Value: false

RemoveFilesOnDisable

Especifique si el recurso debe quitar todos los archivos asociados a la característica opcional de Windows al deshabilitarlo. Establezca esta propiedad en $true para quitar todos los archivos asociados.

El valor predeterminado es $false.

Type: System.Boolean
Default Value: false

Propiedades de solo lectura

CustomProperties

Las propiedades personalizadas de la característica opcional de Windows como una matriz de cadenas.

Type: System.String[]

Descripción

La descripción de la característica opcional de Windows como una cadena.

Type: System.String

DisplayName

El nombre para mostrar de la característica opcional de Windows como una cadena.

Type: System.String

Ejemplos