WindowsOptionalFeature

  • Article

Synopsis

Activez ou désactivez une fonctionnalité facultative Windows.

Syntaxe

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

Description

La WindowsOptionalFeature ressource vous permet de vérifier si une fonctionnalité facultative Windows est activée ou désactivée sur un ordinateur client Windows. 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.
  • L’ordinateur cible doit avoir accès au module PowerShell DISM

Propriétés de clé

Nom

Spécifiez le nom de la fonctionnalité facultative Windows en tant que chaîne.

Cette valeur de cette propriété doit être identique à la propriété FeatureName de la 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 la fonctionnalité facultative Windows doit être activée. Définissez cette propriété pour Present activer la fonctionnalité facultative Windows si elle est désactivée. Définissez cette propriété pour Absent désactiver la fonctionnalité facultative Windows si elle est activée.

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 de la fonctionnalité facultative 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 la fonctionnalité facultative 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 à la fonctionnalité facultative Windows lors de sa 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

Propriétés en lecture seule

CustomProperties

Propriétés personnalisées de la fonctionnalité Facultative Windows sous la forme d’un tableau de chaînes.

Type: System.String[]

Description

Description facultative de la fonctionnalité Windows sous forme de chaîne.

Type: System.String

DisplayName

Nom complet de la fonctionnalité facultative Windows sous forme de chaîne.

Type: System.String

Exemples