共用方式為


Get-CMWinPEOptionalComponentInfo

取得 Windows PE 選擇性元件。

語法

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

Description

使用此 Cmdlet 取得 Windows PE (WinPE) 選用元件。 使用此物件,以 Set-CMBootImage Cmdlet 將它新增至開機映像或從開機映射中移除它。 如需詳細資訊,請 參閱管理開機映射 - 選擇性元件

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>。 如需詳細資訊,請 參閱開始使用

範例

範例 1:取得選擇性元件並新增至開機映像

此範例會取得 .NET 和 PowerShell 選擇性元件,然後將它們新增至開機映射。

$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

參數

-Architecture

指定 WinPE 選擇性元件的架構。

類型:String
接受的值:X64, X86
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceWildcardHandling

此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LanguageId

指定選擇性元件的 語言標識 碼。

此標識子是 Windows 語言識別子的小數對等專案。 例如, 10330x0409 適用於 英文 (美國) ,而 20700x0816 適用於 葡萄牙 (葡萄牙) 。 如需詳細資訊,請參閱 [MS-LCID]: Windows 語言代碼識別碼 (LCID) 參考。

Configuration Manager 支援 22 種語言。 如需詳細資訊,請參閱 客戶端語言

類型:UInt32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

指定要取得之 WinPE 選擇性元件的名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:True

-UniqueId

指定要取得之 WinPE 選擇性元件的唯一識別碼。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

輸入

None

輸出

IResultObject[]

IResultObject

備註

如需這個傳回物件及其屬性的詳細資訊,請 參閱SMS_WinPEOptionalComponentInfo伺服器 WMI 類別