Freigeben über

Get-CMBootImage

  • Referenz
Modul:
ConfigurationManager

Rufen Sie ein Betriebssystemstartimage ab.

Syntax

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

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Windows Preinstallation Environment (PE)-Betriebssystemstartimage abzurufen, das Configuration Manager zum Bereitstellen eines Betriebssystems verwendet. Standardmäßig enthält Configuration Manager sowohl x86- als auch x64-Startimages. Weitere Informationen finden Sie unter Verwalten von Startimages mit Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen eines Startimages mithilfe seiner ID

Dieser Befehl ruft ein Startimage mithilfe seiner ID ab.

Get-CMBootImage -Id "XYZ00002"

Beispiel 2: Auflisten aller Startimages

Dieser Befehl ruft alle Startimages am Standort ab und listet mehrere Eigenschaften in einem Tabellenformat auf.

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

Parameter

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Geben Sie eine Startimage-ID an, die abgerufen werden soll. Dieser Wert ist eine Standardpaket-ID, XYZ00002z. B. .

Typ:String
Aliase:PackageId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen eines abzurufenden Startimages an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Reload

Gilt für Version 2006 und höher. Wenn die Version der Windows ADK-Komponenten im Startimage veraltet ist, verwenden Sie diesen Parameter, um dieses Startimage mit der aktuellen Windows PE-Version aus dem Windows ADK neu zu laden. Weitere Informationen finden Sie unter Aktualisieren von Verteilungspunkten mit dem Startimage.

Typ:SwitchParameter
Aliase:ReloadImage
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject[]

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_BootImagePackage WMI-Serverklasse.