Share via

Get-CMWinPEOptionalComponentInfo

  • Referência
Módulo:
ConfigurationManager

Obtenha um componente opcional do Windows PE.

Syntax

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

Description

Use este cmdlet para obter um componente opcional do WinPE (Windows PE). Use esse objeto para adicioná-lo ou removê-lo de uma imagem de inicialização com o cmdlet Set-CMBootImage . Para obter mais informações, consulte Gerenciar imagens de inicialização – componentes opcionais.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: Obter componentes opcionais e adicionar a uma imagem de inicialização

Este exemplo obtém os componentes opcionais .NET e PowerShell e, em seguida, adiciona-os a uma imagem de inicialização.

$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

Parâmetros

-Architecture

Especifique a arquitetura de um componente opcional WinPE.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-LanguageId

Especifique a ID do idioma para o componente opcional.

Essa ID é o equivalente decimal da ID de linguagem do Windows. Por exemplo, 1033 é 0x0409 para inglês (Estados Unidos)e 2070 é 0x0816 para português (Portugal). Para obter mais informações, consulte [MS-LCID]: Referência do LCID (Identificador de Código de Linguagem do Windows).

Configuration Manager dá suporte a 22 idiomas. Para obter mais informações, consulte Idiomas do cliente.

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

-Name

Especifique o nome do componente opcional WinPE a ser obtido.

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

-UniqueId

Especifique a ID exclusiva do componente opcional WinPE a ser obtido.

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

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_WinPEOptionalComponentInfo classe WMI do servidor.