Freigeben über

Get-CMWinPEOptionalComponentInfo

  • Referenz
Modul:
ConfigurationManager

Rufen Sie eine optionale Windows PE-Komponente ab.

Syntax

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

Beschreibung

Verwenden Sie dieses Cmdlet, um eine optionale Komponente für Windows PE (WinPE) abzurufen. Verwenden Sie dieses Objekt, um es mit dem Cmdlet Set-CMBootImage einem Startimage hinzuzufügen oder daraus zu entfernen. Weitere Informationen finden Sie unter Verwalten von Startimages – Optionale Komponenten.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen optionaler Komponenten und Hinzufügen zu einem Startimage

In diesem Beispiel werden die optionalen .NET- und PowerShell-Komponenten abgerufen und dann einem Startimage hinzugefügt.

$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

Parameter

-Architecture

Geben Sie die Architektur einer optionalen WinPE-Komponente an.

Typ:String
Zulässige Werte:X64, X86
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LanguageId

Geben Sie die Sprach-ID für die optionale Komponente an.

Diese ID ist die dezimale Entsprechung der Windows-Sprach-ID. Beispielsweise 1033 ist 0x0409 für Englisch (USA) und 20700x0816 für Portugiesisch (Portugal). Weitere Informationen finden Sie unter [MS-LCID]: Referenz zu Windows Language Code Identifier (LCID).

Configuration Manager unterstützt 22 Sprachen. Weitere Informationen finden Sie unter Clientsprachen.

Typ:UInt32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen der abzurufenden optionalen WinPE-Komponente an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-UniqueId

Geben Sie die eindeutige ID der abzurufenden optionalen WinPE-Komponente an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject[]

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_WinPEOptionalComponentInfo WMI-Serverklasse.