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

类型: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

指定可选组件 的语言 ID 。

此 ID 是 Windows 语言 ID 的等效小数。 例如， 1033 表示0x0409英语 (美国) ， (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 可选组件的唯一 ID。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

输入

None

输出

IResultObject[]

IResultObject

备注

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