WindowsFeature

  • Artículo

Sinopsis

Instale o desinstale un rol o característica de Windows.

Sintaxis

WindowsFeature [String] #ResourceName
{
    Name = [string]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [IncludeAllSubFeature = [bool]]
    [LogPath = [string]]
    [PsDscRunAsCredential = [PSCredential]]
}

Descripción

El WindowsFeature recurso le permite asegurarse de que un rol o característica de Windows está instalado en un servidor windows. Para administrar un equipo cliente, use el recurso WindowsOptionalFeature.

Requisitos

  • La máquina de destino debe ejecutar Windows Server 2008 o posterior.
  • La máquina de destino debe tener acceso al módulo de PowerShell de DISM .
  • La máquina de destino debe tener acceso al módulo de PowerShell ServerManager .

Propiedades

Propiedades de la clave

Nombre

Especifique el nombre del rol o la característica como una cadena.

Este valor para esta propiedad debe ser el mismo que la propiedad Name del rol o la característica, no la propiedad DisplayName . Para enumerar los roles y características disponibles para un equipo, use el Get-WindowsFeature cmdlet .

Type: System.String

Propiedades opcionales

Credential:

Especifique la credencial de una cuenta para agregar o quitar el rol o la característica como.

Type: System.Management.Automation.PSCredential
Default Value: None

Ensure

Especifique si se debe instalar el rol o la característica. Establezca esta propiedad Present en para instalar el rol o la característica si no está instalado. Establezca esta propiedad Absent en para desinstalar el rol o la característica si está instalado.

El valor predeterminado es Present.

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

IncludeAllSubFeature

Especifique si se van a instalar todas las subfeaturas de la característica o el rol. Establezca esta propiedad $true en para instalar las subfeatures que faltan. Establezca esta propiedad $false en para omitir subfeatures. Independientemente de la configuración de esta propiedad, el recurso quita todas las subfeatures si Ensure está establecido en Absent.

El valor predeterminado es $false.

Type: System.Boolean
Behavior: Write
Default Value: false

LogPath

Especifique la ruta de acceso a un archivo para registrar la instalación o desinstalación de la característica o el rol.

Type: System.String
Default Value: None

Propiedades de solo lectura

DisplayName

Nombre para mostrar del rol o la característica recuperados.

Type: System.String

Ejemplos