Get-WindowsOptionalFeature
Get-WindowsOptionalFeature
Gets information about optional features in a Windows image.
Syntaxe
Parameter Set: Offline
Get-WindowsOptionalFeature -Path <String> [-FeatureName <String> ] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-PackageName <String> ] [-PackagePath <String> ] [-ScratchDirectory <String> ] [-SystemDrive <String> ] [-WindowsDirectory <String> ] [ <CommonParameters>]
Parameter Set: Online
Get-WindowsOptionalFeature -Online [-FeatureName <String> ] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-PackageName <String> ] [-PackagePath <String> ] [-ScratchDirectory <String> ] [-SystemDrive <String> ] [-WindowsDirectory <String> ] [ <CommonParameters>]
Description détaillée
The Get-WindowsOptionalFeature cmdlet gets information about all features (operating system features that include optional Windows foundation features) in the Windows Foundation Package or a specified package in the Windows image.
Use the PackageName or PackagePath parameter to get information about all features in a specific package in the Windows image.
The FeatureName parameter gets more detailed information about a specific feature in the Windows image. If the feature is not a part of the Windows Foundation package, either a PackageName or PackagePath parameter must be used to specify the parent package of the feature.
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.
Paramètres
-FeatureName<String>
Specifies the name of a feature to get detailed information about. Feature names are case sensitive if you are servicing a Windows image other than Windows 8.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
true (ByValue, ByPropertyName) |
Accepter les caractères génériques ? |
true |
-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 |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
true (ByValue, 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 |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
true (ByValue, 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 (ByValue, ByPropertyName) |
Accepter les caractères génériques ? |
false |
-PackageName<String>
Specifies the name of a package as it is listed in the Windows image. Use the PackageName parameter to get all of the features in the package. Use the FeatureName and PackageName parameters to get more detailed information about a specific feature in the package.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
true (ByValue, ByPropertyName) |
Accepter les caractères génériques ? |
true |
-PackagePath<String>
Specifies the location of a .cab file in the Windows image. Use the PackagePath parameter to get all of the features in the package. Use the FeatureName and PackagePath parameters to get more detailed information about a specific feature in the package.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
true (ByValue, 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 (ByValue, 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 (ByValue, 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 (ByValue, 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 (ByValue, 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
Sorties
Le type de sortie est le type des objets émis par l’applet de commande.
- Microsoft.Dism.Commands.BasicFeatureObject
- Microsoft.Dism.Commands.AdvancedFeatureObject
Exemples
Example 1
This command lists all of the optional features in the running Windows operating system.
PS C:\> Get-WindowsOptionalFeature –Online
Example 2
This command displays lists all of the optional features in the specified package in the Windows image mounted to c:\offline.
PS C:\> Get-WindowsOptionalFeature –Path c:\offline –PackageName Microsoft-Windows-Backup-Package~31bf3856ad364e35~x86~~6.1.7601.16525
Example 3
This command displays detailed information about the feature, Hearts, in the Windows Foundation Package in the Windows image mounted to c:\offline.
PS C:\> Get-WindowsOptionalFeature –Path c:\offline –FeatureName Hearts
Example 4
This command displays detailed information about the feature, MyFeature, in the package at c:\package\package.cab in the Windows image mounted to c:\offline.
PS C:\> Get-WindowsOptionalFeature –Path c:\offline –FeatureName MyFeature –PackagePath c:\packages\package.cab