Partager via

Get-CMWinPEOptionalComponentInfo

  • Référence
Module:
ConfigurationManager

Obtenez un composant facultatif Windows PE.

Syntaxe

Get-CMWinPEOptionalComponentInfo
   -Architecture <String>
   [-LanguageId <UInt32>]
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMWinPEOptionalComponentInfo
   -UniqueId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour obtenir un composant facultatif Windows PE (WinPE). Utilisez cet objet pour l’ajouter ou le supprimer d’une image de démarrage avec l’applet de commande Set-CMBootImage . Pour plus d’informations, consultez Gérer les images de démarrage - Composants facultatifs.

Remarque

Exécutez Configuration Manager applets de commande à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Obtenir des composants facultatifs et les ajouter à une image de démarrage

Cet exemple obtient les composants facultatifs .NET et PowerShell, puis les ajoute à une image de démarrage.

$netfxOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-NetFX' -LanguageId 1033
$pwshOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-PowerShell' -LanguageId 1033
$OCs = @($netfxOC, $pwshOC)

Set-CMBootImage -Id 'XYZ00556' -AddOptionalComponent $OCs

Paramètres

-Architecture

Spécifiez l’architecture d’un composant facultatif WinPE.

Type:String
Valeurs acceptées:X64, X86
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LanguageId

Spécifiez l’ID de langue du composant facultatif.

Cet ID est l’équivalent décimal de l’ID de langue Windows. Par exemple, 1033 est 0x0409 destiné à l’anglais (États-Unis) et 2070 au 0x0816portugais (Portugal). Pour plus d’informations, consultez [MS-LCID] : Référence LCID (Windows Language Code Identifier).

Configuration Manager prend en charge 22 langues. Pour plus d’informations, consultez Langues clientes.

Type:UInt32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifiez le nom du composant facultatif WinPE à obtenir.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-UniqueId

Spécifiez l’ID unique du composant facultatif WinPE à obtenir.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

IResultObject[]

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_WinPEOptionalComponentInfo classe WMI du serveur.