Set-CMBootImage

Modifies an operating system boot image.

Syntax

Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-Confirm]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisableWildcardHandling]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   [-ForceWildcardHandling]
   -Id <String>
   [-IncludeFilesForPrestart <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMBootImage [-AddOptionalComponent ] [-BackgroundBitmapPath ] [-Confirm]
 [-CopyToPackageShareOnDistributionPoint ] [-CustomPackageShareName ]
 [-DeployFromPxeDistributionPoint ] [-Description ] [-DisableWildcardHandling]
 [-DisconnectUserFromDistributionPoint ] [-DisconnectUserFromDistributionPointMins ]
 [-DisconnectUserFromDistributionPointRetryCount ] [-DistributionPointUpdateSchedule ]
 [-EnableBinaryDeltaReplication ] [-EnableCommandSupport ] [-EnablePrestartCommand ]
 [-Force] [-ForceWildcardHandling] [-IncludeFilesForPrestart ] -InputObject 
 [-NewName ] [-PassThru] [-Path ] [-PersistContentInCache ]
 [-PrestageBehavior ] [-PrestartCommandLine ]
 [-PrestartIncludeFilesDirectory ] [-Priority ] [-RemoveOptionalComponent ]
 [-ScratchSpace ] [-SendToPreferredDistributionPoint ] [-Version ] [-WhatIf]
 []
Set-CMBootImage [-AddOptionalComponent ] [-BackgroundBitmapPath ] [-Confirm]
 [-CopyToPackageShareOnDistributionPoint ] [-CustomPackageShareName ]
 [-DeployFromPxeDistributionPoint ] [-Description ] [-DisableWildcardHandling]
 [-DisconnectUserFromDistributionPoint ] [-DisconnectUserFromDistributionPointMins ]
 [-DisconnectUserFromDistributionPointRetryCount ] [-DistributionPointUpdateSchedule ]
 [-EnableBinaryDeltaReplication ] [-EnableCommandSupport ] [-EnablePrestartCommand ]
 [-Force] [-ForceWildcardHandling] [-IncludeFilesForPrestart ] -Name  [-NewName ]
 [-PassThru] [-Path ] [-PersistContentInCache ] [-PrestageBehavior ]
 [-PrestartCommandLine ] [-PrestartIncludeFilesDirectory ] [-Priority ]
 [-RemoveOptionalComponent ] [-ScratchSpace ]
 [-SendToPreferredDistributionPoint ] [-Version ] [-WhatIf] []

Description

The Set-CMBootImage cmdlet modifies an operating system boot image. Boot images are Windows Preinstallation Environment (Windows PE) images into which you boot a client computer before you install an operating system.

You can add device drivers to a boot image or change its properties. Before you can add a new device driver, you must first import the driver to the Microsoft System Center Configuration Manager driver catalog and enable it.

A modification to the boot image does not change its source package.

Examples

Example 1: Rename a boot image object that is identified by using its ID

PS C:\> Set-CMBootimage -Id "CM100004" -NewName "Windows8 (x64)"

This command retrieves a boot image by using its ID, and then renames the boot image. Depending on replication issues, this modification can take a long time to display in the Configuration Manager console.

Example 2: Rename a boot image object that is identified by using its name

PS C:\> Set-CMBootImage -Name "Boot Image (x64)" -NewName "Windows 8 x64" -Version "6.2.8400.1" -Description "Microsoft Windows 8 PE (x64)"

This command retrieves a boot image by using its name, and then renames the boot image. The command also adds a version and description to the boot image object. Depending on replication issues, this modification can take a long time to display in the Configuration Manager console.

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
-InputObject

Specifies a boot image object.

Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Name

Specifies a name of a boot image.

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

Optional Parameters

-AddOptionalComponent
Type:IResultObject[]
Aliases:AddOptionalComponents
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-BackgroundBitmapPath
Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-CopyToPackageShareOnDistributionPoint
Type:Boolean
Aliases:CopyToPackageShareOnDistributionPoints
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CustomPackageShareName
Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeployFromPxeDistributionPoint
Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

Describes the contents of a boot image.

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

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisconnectUserFromDistributionPoint
Type:Boolean
Aliases:DisconnectUsersFromDistributionPoints
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisconnectUserFromDistributionPointMins
Type:UInt32
Aliases:DisconnectUsersFromDistributionPointsMinutes
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisconnectUserFromDistributionPointRetryCount
Type:UInt32
Aliases:DisconnectUsersFromDistributionPointsRetries
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DistributionPointUpdateSchedule
Type:IResultObject
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableBinaryDeltaReplication
Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableCommandSupport
Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnablePrestartCommand
Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Force

Forces the command to run without asking for user confirmation.

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
-IncludeFilesForPrestart
Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewName

Specifies a new name for the boot image.

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

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Path
Type:String
Aliases:ImagePath
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PersistContentInCache
Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrestageBehavior
Type:PrestageBehavior
Parameter Sets:ManualCopy, DownloadDelta, OnDemand
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrestartCommandLine
Type:String
Aliases:CommandLine
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrestartIncludeFilesDirectory
Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Priority
Type:Priority
Parameter Sets:High, Medium, Low
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveOptionalComponent
Type:IResultObject[]
Aliases:RemoveOptionalComponents
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ScratchSpace
Type:UInt32
Parameter Sets:32, 64, 128, 256, 512
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SendToPreferredDistributionPoint
Type:Boolean
Aliases:SendToPreferredDistributionPoints
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Version

Specifies the version of the boot image.

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

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False