Partilhar via


Get-CMWinPEOptionalComponentInfo

SYNOPSIS

Obtenha um componente opcional Windows PE.

SYNTAX

SearchByName (Padrão)

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

SearchById

Get-CMWinPEOptionalComponentInfo -UniqueId <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

DESCRIPTION

Utilize este cmdlet para obter um componente opcional pe (WinPE) Windows. Utilize este objeto para o adicionar ou remova de uma imagem de arranque com o cmdlet Set-CMBootImage. Para obter mais informações, consulte Gerir as imagens de arranque - Componentes opcionais.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Obtenha componentes opcionais e adicione 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

PARAMETERS

-Arquitetura

Especifique a arquitetura de um componente opcional WinPE.

Type: String
Parameter Sets: SearchByName
Aliases:
Accepted values: X64, X86

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

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-LanguageId

Especifique o ID do idioma para o componente opcional.

Este ID é o equivalente decimal do ID da linguagem Windows . Por exemplo, 1033 é 0x0409 para inglês (Estados Unidos), e 2070 é para português 0x0816 (Portugal). Para obter mais informações, consulte [MS-LCID]: Windows referência do identificador de código linguístico (LCID).

O Gestor de Configuração suporta 22 idiomas. Para mais informações, consulte as línguas do Cliente.

Type: UInt32
Parameter Sets: SearchByName
Aliases:

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

-Name

Especifique o nome do componente opcional WinPE para obter.

Type: String
Parameter Sets: SearchByName
Aliases:

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

-UniqueId

Especifique o ID único do componente opcional WinPE para obter.

Type: String
Parameter Sets: SearchById
Aliases:

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Nenhuma

OUTPUTS

IResultObject[]#SMS_WinPEOptionalComponentInfo

IResultObject#SMS_WinPEOptionalComponentInfo

NOTAS

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

Set-CMBootImage

Gerir imagens de arranque - Componentes opcionais