Compartilhar via

Get-CMBootImage

  • Referência
Módulo:
ConfigurationManager

Obter uma imagem de arranque do SO.

Sintaxe

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

Description

Utilize este cmdlet para obter uma imagem de arranque do SO do Ambiente de Pré-instalação do Windows (PE) que o Configuration Manager utiliza para implementar um SO. Por predefinição, o Configuration Manager inclui imagens de arranque x86 e x64. Para obter mais informações, veja Gerir imagens de arranque com o Configuration Manager.

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 uma imagem de arranque com o respetivo ID

Este comando obtém uma imagem de arranque com o respetivo ID.

Get-CMBootImage -Id "XYZ00002"

Exemplo 2: listar todas as imagens de arranque

Este comando obtém todas as imagens de arranque no site e lista várias propriedades num formato de tabela.

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

Parâmetros

-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

-Id

Especifique um ID de imagem de arranque a obter. Este valor é um ID de pacote padrão, por exemplo, XYZ00002.

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

-Name

Especifique o nome de uma imagem de arranque a obter.

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

-Reload

Aplica-se à versão 2006 e posterior. Se a versão dos componentes do Windows ADK na imagem de arranque estiver desatualizada, utilize este parâmetro para recarregar esta imagem de arranque com a versão atual do Windows PE a partir do Windows ADK. Para obter mais informações, consulte Atualizar pontos de distribuição com a imagem de arranque.

Tipo:SwitchParameter
Aliases:ReloadImage
Cargo:Named
Valor padrão:None
Obrigatório:False
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_BootImagePackage classe WMI de servidor.