Share via

Get-CMBootImage

  • Referência
Módulo:
ConfigurationManager

Obtenha uma imagem de inicialização do sistema operacional.

Syntax

Get-CMBootImage
   [-Name <String>]
   [-Reload]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMBootImage
   -Id <String>
   [-Reload]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use esse cmdlet para obter uma imagem de inicialização do sistema operacional PE (Ambiente de Pré-Instalação do Windows) que Configuration Manager usa para implantar um sistema operacional. Por padrão, Configuration Manager inclui imagens de inicialização x86 e x64. Para obter mais informações, consulte Gerenciar imagens de inicialização com Configuration Manager.

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 uma imagem de inicialização usando sua ID

Esse comando obtém uma imagem de inicialização usando sua ID.

Get-CMBootImage -Id "XYZ00002"

Exemplo 2: Listar todas as imagens de inicialização

Esse comando obtém todas as imagens de inicialização no site e lista várias propriedades em um formato de tabela.

Get-CMBootImage | Select-Object PackageId, Name, ImageOSVersion, ProductionClientVersion, InputLocale | Format-Table

Parâmetros

-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

-Id

Especifique uma ID de imagem de inicialização para obter. Esse valor é uma ID de pacote padrão, por exemplo, XYZ00002.

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

-Name

Especifique o nome de uma imagem de inicialização a ser obtido.

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

-Reload

Aplica-se à versão 2006 e posterior. Se a versão dos componentes do Windows ADK na imagem de inicialização estiver desatualizada, use esse parâmetro para recarregar essa imagem de inicialização com a versão atual do Windows PE do Windows ADK. Para obter mais informações, confira Atualizar pontos de distribuição com a imagem de inicialização.

Type:SwitchParameter
Aliases:ReloadImage
Position:Named
Default value:None
Required:False
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_BootImagePackage classe WMI do servidor.