Share via

Get-CMWinPEOptionalComponentInfo

  • 参考
模块:
ConfigurationManager

获取 Windows PE 可选组件。

语法

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

说明

使用此 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 可选组件的体系结构。

Type:String
Accepted values:X64, X86
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LanguageId

指定可选组件 的语言 ID 。

此 ID 是 Windows 语言 ID 的等效小数。 例如， 1033 表示0x0409英语 (美国) ，为 20700x0816葡萄牙语 (葡萄牙) 。 有关详细信息，请参阅 [MS-LCID]：Windows 语言代码标识符 (LCID) 参考。

Configuration Manager支持 22 种语言。 有关详细信息，请参阅 客户端语言。

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定要获取的 WinPE 可选组件的名称。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-UniqueId

指定要获取的 WinPE 可选组件的唯一 ID。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

输入

None

输出

IResultObject[]

IResultObject

备注

有关此返回对象及其属性的详细信息，请参阅 SMS_WinPEOptionalComponentInfo服务器 WMI 类。