New-CMBootImage

Adds a new operating system boot image.

Syntax

New-CMBootImage
   [-Confirm]
   [-Description <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -Index <Int32>
   -Name <String>
   -Path <String>
   [-Version <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

The New-CMBootImage cmdlet adds a new Windows Preinstallation Environment (Windows PE) operating system boot image to Microsoft System Center Configuration Manager. Operating system images are .wim format files. These files contain a compressed set of reference files and folders that are required to successfully install and configure a boot image on a computer. By default, System Center Configuration Manager includes both x86 and x64 operating system images.

You must run New-CMBootImage 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 package source 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: Create a new boot image object

PS C:\> New-CMBootImage -Path "\\Server99.Contoso.com\SMS_CCC\osd\boot\i386\boot.wim" -Index 1 -Name "WinPE Boot Image" -Version 11 -Description "WinPE Boot Image x86 Approved 9/1/2012"

This command creates a new boot image object and provides it with a source path for its WIM file, an index value, a name, an operating system version, and a description.

Required Parameters

-Index

Specifies an index. An index is the number of an image in a .wim file.

Type:Int32
Aliases:ImageIndex
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies the name of a new boot image.

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

Specifies the location of the original WIM file for the boot image.

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

Optional Parameters

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

Specifies a description of the 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
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

Type:SwitchParameter
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