Get-CMWinPEOptionalComponentInfo

Получите необязательный компонент Windows PE.

Синтаксис

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

Описание

Используйте этот командлет, чтобы получить дополнительный компонент Windows PE (WinPE). Используйте этот объект, чтобы добавить его в образ загрузки или удалить его из образа загрузки с помощью командлета Set-CMBootImage . Дополнительные сведения см. в разделе Управление образами загрузки — необязательные компоненты.

Примечание.

Выполните командлеты Configuration Manager с диска сайта Configuration Manager, например 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

Укажите идентификатор языка для необязательного компонента.

Этот идентификатор является десятичным эквивалентом идентификатора языка Windows. Например, 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, который требуется получить.

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

Входные данные

None

Выходные данные

IResultObject[]

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_WinPEOptionalComponentInfo класс WMI сервера.