Get-CMWinPEOptionalComponentInfo

  • Referência
Módulo:
ConfigurationManager

Obter um componente opcional do Windows PE.

Sintaxe

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

Description

Utilize este cmdlet para obter um componente opcional do Windows PE (WinPE). Utilize este objeto para adicioná-lo ou removê-lo de uma imagem de arranque com o cmdlet Set-CMBootImage . Para obter mais informações, veja Gerir imagens de arranque – Componentes opcionais.

Observação

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

Exemplos

Exemplo 1: Obter componentes opcionais e adicionar a uma imagem de arranque

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

$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.

Tipo:String
Valores aceitos:X64, X86
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LanguageId

Especifique o ID de idioma para o componente opcional.

Este ID é o equivalente decimal do ID de idioma 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 Identificador de Código de Idioma do Windows (LCID).

O Configuration Manager suporta 22 idiomas. Para obter mais informações, veja Idiomas de cliente.

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique o nome do componente opcional WinPE a obter.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-UniqueId

Especifique o ID exclusivo do componente opcional WinPE a obter.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_WinPEOptionalComponentInfo classe WMI de servidor.