Enable-WindowsOptionalFeature
Enable-WindowsOptionalFeature
Enables a feature in a Windows image.
Syntaxe
Parameter Set: Offline
Enable-WindowsOptionalFeature -FeatureName <String[]> -Path <String> [-All] [-LimitAccess] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-NoRestart] [-PackageName <String> ] [-ScratchDirectory <String> ] [-Source <String[]> ] [-SystemDrive <String> ] [-WindowsDirectory <String> ] [ <CommonParameters>]
Parameter Set: Online
Enable-WindowsOptionalFeature -FeatureName <String[]> -Online [-All] [-LimitAccess] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-NoRestart] [-PackageName <String> ] [-ScratchDirectory <String> ] [-Source <String[]> ] [-SystemDrive <String> ] [-WindowsDirectory <String> ] [ <CommonParameters>]
Description détaillée
The Enable-WindowsOptionalFeature cmdlet enables or restores an optional feature in a Windows image.
Utilisez le paramètre Online pour spécifier le système d’exploitation en cours d’exécution sur votre ordinateur local, ou utilisez le paramètre Path pour spécifier l’emplacement d’une image Windows montée.
The PackageName parameter specifies the package that the feature is a component of. This parameter is optional when the package is the Windows Foundation package.
The FeatureName parameter specifies the feature to add. You can specify more than one feature in the same package. Separate feature names with a comma.
The Source parameter specifies the location of files that are needed to restore a removed feature.
The LimitAccess parameter prevents access to Windows Update (WU) as a Source for restoring features to online images. The All parameter enables all parent features of the specified feature before enabling the specified feature. The parent feature will be enabled with default values.
Paramètres
-All
Enables all parent features of the specified feature. If a parent feature is required for the specified feature to be enabled in the image, All will enable the parent and all of its default dependencies.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-FeatureName<String[]>
Specifies the name of the feature to be enabled. Feature names are case sensitive if you are servicing a Windows image running a version of Windows earlier than Windows® 8. You can use Get-WindowsOptionalFeature to find the name of the feature in the image.
Alias |
none |
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-LimitAccess
Prevents DISM from contacting Windows Update (WU) when searching for the source files to restore a feature on an online image.
LimitAccess can only be used when servicing images with Windows 8, Windows Server® 2012, environnement de préinstallation Windows® (Windows PE) 4.0 or a later version.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-LogLevel<LogLevel>
Spécifie le niveau de sortie maximal enregistré dans les journaux. Le niveau de journalisation par défaut est 3. Les valeurs acceptées sont les suivantes :1 = erreurs uniquement2 = erreurs et avertissements3 = erreurs, avertissements et informations4 = toutes les informations répertoriées plus haut, plus la sortie du débogage
Alias |
LL |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-LogPath<String>
Spécifie le chemin et le nom de fichier complets où consigner la journalisation. S’il n’est pas défini, la valeur par défaut est %WINDIR%\Logs\Dism\dism.log.Dans Windows PE, le répertoire par défaut est l’espace de travail RAMDISK; dont la taille peut être de seulement 32 Mo. Le fichier journal est archivé automatiquement. Le fichier journal archivé est enregistré avec l’extension .bak ajoutée au nom de fichier et un nouveau fichier journal est généré. Chaque fois que le fichier journal est archivé, le fichier .bak est remplacé. Quand vous utilisez un partage réseau qui n’est pas joint à un domaine, utilisez la commande net use avec des informations d’identification de domaine pour définir les autorisations d’accès avant de définir le chemin du journal DISM.
Alias |
LP |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-NoRestart
Supprime le redémarrage. Si un redémarrage n’est pas nécessaire, cette commande ne fait rien. Cette option empêche l’application d’inviter l’utilisateur à redémarrer ou l’empêche de redémarrer automatiquement.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Online
Spécifie que l’action doit être effectuée sur le système d’exploitation en cours d’exécution sur l’ordinateur local.
Alias |
none |
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-PackageName<String>
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Path<String>
Spécifie le chemin complet du répertoire racine de l’image Windows hors connexion dont vous allez effectuer la maintenance. Si le répertoire nommé Windows n’est pas un sous-répertoire du répertoire racine, vous devez spécifier -WindowsDirectory.
Alias |
none |
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-ScratchDirectory<String>
Spécifie un répertoire temporaire qui sera utilisé lors de l’extraction de fichiers à utiliser pendant la maintenance. Le répertoire doit exister localement. S’il n’est pas spécifié, le répertoire \Windows\%Temp% sera utilisé, avec comme nom de sous-répertoire une valeur hexadécimale générée de manière aléatoire pour chaque exécution de DISM. Les éléments du répertoire de travail sont supprimés après chaque opération. Vous ne devez pas utiliser un emplacement de partage réseau comme répertoire de travail pour développer un package (fichier .cab ou .msu) en vue d’une installation. Le répertoire utilisé pour l’extraction des fichiers à usage temporaire pendant la maintenance doit être un répertoire local.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Source<String[]>
Specifies the location of the files that are required to restore a feature that has been removed from the image. You can specify the Windows directory of a mounted image or a running Windows installation that is shared on the network.
If you specify multiple Source arguments, the files are gathered from the first location where they are found and the rest of the locations are ignored. Separate feature names with a comma.
If you do not specify a Source for a feature that has been removed, the default location set by Group Policy is used. Windows Update (WU) is also used for online images.
Source can only be used when servicing an image with Windows 8 or Windows Server 2012 or a later version.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-SystemDrive<String>
Spécifie le chemin d’accès de l’emplacement des fichiers BootMgr. Ceci est nécessaire seulement quand les fichiers BootMgr sont trouvent sur une partition autre que celle à partir de laquelle vous exécutez la commande. Utilisez -SystemDrive pour traiter une image Windows installée à partir d’un environnement Windows PE.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-WindowsDirectory<String>
Spécifie le chemin d’accès du répertoire Windows relativement au chemin de l’image. Il peut pas s’agir du chemin complet du répertoire Windows ; ce doit être un chemin d’accès relatif. S’il n’est pas spécifié, la valeur par défaut est le répertoire Windows dans la racine du répertoire de l’image hors connexion.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.
- System.String[]
- Microsoft.Dism.Commands.ImageObject
- Microsoft.Dism.Commands.BasicFeatureObject
- Microsoft.Dism.Commands.AdvancedFeatureObject
Sorties
Le type de sortie est le type des objets émis par l’applet de commande.
- Microsoft.Dism.Commands.ImageObject
Exemples
Example 1
This command enables the optional feature, Hearts, the parent feature for Hearts, and the dependencies for the parent feature in the running Windows operating system.
PS C:\> Enable-WindowsOptionalFeature –Online –FeatureName Hearts -All
Example 2
This command enables the optional feature, Calc, in the specified package in the Windows image that is mounted to c:\offline.
PS C:\> Enable-WindowsOptionalFeature –Path c:\offline –FeatureName Calc –PackageName Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0
Example 3
This command restores the optional feature, MyFeature, to the Windows image that is mounted to c:\offline using source files from another Windows image that is mounted to c:\test\mount. If the files are not found in the source image, this command specifies not to check Windows Update for the source files.
PS C:\> Enable-WindowsOptionalFeature –Online –FeatureName MyFeature –Source c:\test\mount -LimitAccess