Condividi tramite

Get-CMBootImage

  • Riferimento
Modulo:
ConfigurationManager

Ottenere un'immagine di avvio del sistema operativo.

Sintassi

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

Descrizione

Usare questo cmdlet per ottenere un'immagine di avvio del sistema operativo PE (Windows Preinstallation Environment) usata da Configuration Manager per distribuire un sistema operativo. Per impostazione predefinita, Configuration Manager include immagini di avvio x86 e x64. Per altre informazioni, vedere Gestire le immagini di avvio con Configuration Manager.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Ottenere un'immagine di avvio usando il relativo ID

Questo comando ottiene un'immagine di avvio usando il relativo ID.

Get-CMBootImage -Id "XYZ00002"

Esempio 2: Elencare tutte le immagini di avvio

Questo comando ottiene tutte le immagini di avvio nel sito ed elenca diverse proprietà in formato tabella.

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

Parametri

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specificare un ID immagine di avvio da ottenere. Questo valore è un ID pacchetto standard, ad esempio XYZ00002.

Tipo:String
Alias:PackageId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare il nome di un'immagine di avvio da ottenere.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Reload

Si applica alla versione 2006 e successive. Se la versione dei componenti di Windows ADK nell'immagine di avvio non è aggiornata, usare questo parametro per ricaricare l'immagine di avvio con la versione corrente di Windows PE da Windows ADK. Per altre informazioni, vedere Aggiornare i punti di distribuzione con l'immagine di avvio.

Tipo:SwitchParameter
Alias:ReloadImage
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject[]

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_BootImagePackage classe WMI del server.