WindowsOptionalFeatureSet

  • Article

Synopsis

Gérez plusieurs fonctionnalités facultatives Windows avec des paramètres courants.

Syntaxe

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

Description

La WindowsOptionalFeatureSet ressource composite vous permet de configurer plusieurs fonctionnalités facultatives windows. Pour configurer une fonctionnalité facultative Windows à la fois, utilisez la ressource WindowsOptionalFeature. Pour gérer les rôles et fonctionnalités d’un serveur Windows, utilisez la ressource WindowsFeature.

Configuration requise

  • La machine cible doit exécuter un système d’exploitation client Windows, Windows Server 2012 ou ultérieur, ou Nano Server.
  • La machine cible doit avoir accès au module PowerShell DISM .

Propriétés de la clé

Nom

Spécifiez les noms des fonctionnalités facultatives windows sous la forme d’un tableau de chaînes.

Chaque valeur de cette propriété doit être identique à la propriété FeatureName d’une fonctionnalité facultative Windows. Pour répertorier les fonctionnalités facultatives disponibles pour un ordinateur, utilisez l’applet de Get-WindowsOptionalFeature commande.

Type: System.String[]

Propriétés facultatives

Ensure

Spécifiez si les fonctionnalités facultatives de Windows doivent être activées. Définissez cette propriété pour Present activer les fonctionnalités facultatives de Windows. Définissez cette propriété pour Absent désactiver les fonctionnalités facultatives de Windows.

La valeur par défaut est Present.

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

LogLevel

Spécifiez les informations de sortie à afficher dans le journal DISM sous forme de chaîne. Les options valides sont notamment les suivantes :

  • ErrorsOnly - La ressource enregistre uniquement les erreurs.
  • ErrorsAndWarning - Les ressources consignent les erreurs et les avertissements.
  • ErrorsAndWarningAndInformation - Les ressources consignent les erreurs, les avertissements et les informations de débogage.

La valeur par défaut est ErrorsAndWarningAndInformation.

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

LogPath

Spécifiez le chemin d’accès à un fichier pour enregistrer l’activation ou la désactivation des fonctionnalités facultatives de Windows.

Si elle n’est pas définie, la ressource écrit le journal %WINDIR%\Logs\Dism\dism.logdans .

Type: System.String
Default Value: None

NoWindowsUpdateCheck

Spécifiez si les contacts DISM Windows Update (WU) lors de la recherche des fichiers sources pour activer les fonctionnalités facultatives de Windows. Définissez cette propriété pour $true empêcher DISM de contacter WU.

La valeur par défaut est $false.

Type: System.Boolean
Default Value: false

RemoveFilesOnDisable

Spécifiez si la ressource doit supprimer tous les fichiers associés aux fonctionnalités facultatives windows lors de leur désactivation. Définissez cette propriété pour $true supprimer tous les fichiers associés.

La valeur par défaut est $false.

Type: System.Boolean
Default Value: false

Exemples