Get-CMBootImage

Gets an operating system boot image.

Syntax

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

Description

The Get-CMBootImage cmdlet gets a Windows Preinstallation Environment (PE) operating system boot image that Microsoft System Center Configuration Manager can use to deploy an operating system.

Operating system boot images are .wim format files. These files contain a compressed set of reference files and folders that are required to successfully install and configure an operating system image. By default, System Center Configuration Manager includes both x86 and x64 boot images.

You must run the Get-CMBootImage cmdlet on the computer that is running the Systems Management Server (SMS) provider. The computer account of the computer that is running the SMS provider must have Read and Write access to the source package of the boot image. For more information about the SMS provider, see Planning for the SMS Provider in Configuration Manager on TechNet.

Examples

Example 1: Get a boot image by using its ID

PS C:\> Get-CMBootImage -Id "c0eb2912-0de8-4a2a-9c77-603b35bcf7e4"

This command gets a boot image by using its ID.

Example 2: Get a boot image by using its name

PS C:\> Get-CMBootImage -Name "SMS_BootImagePackage"

This command gets a boot image by using its name.

Required Parameters

-Id

Specifies an array of boot image identifiers.

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

Optional Parameters

-DisableWildcardHandling

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies a name of a boot image.

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