New-CMBootableMedia

Creates bootable media.

Syntax

New-CMBootableMedia
   [-AllowUacPrompt]
   [-AllowUnattended]
   [-AllowUnknownMachine]
   -BootImage <IResultObject>
   [-CertificateExpireTime <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-CertificateStartTime <DateTime>]
   [-Confirm]
   [-DisableWildcardHandling]
   -DistributionPoint <IResultObject[]>
   [-Force]
   [-ForceWildcardHandling]
   [-FormatMedia]
   -ManagementPoint <IResultObject[]>
   -MediaMode <MediaMode>
   [-MediaPassword <SecureString>]
   -MediaType <MediaInputType>
   -Path <String>
   [-PrestartCommand <String>]
   [-PrestartPackage <IResultObject>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-Variable <Hashtable>]
   [-WhatIf]
   [<CommonParameters>]

Description

The New-CMBootableMedia cmdlet creates media used to deploy operating systems using the Configuration Manager infrastructure. Bootable media deploys an operating system when the destination computer starts.

NOTE: This cmdlet requires elevated permissions to run.

Examples

Example 1: Create bootable media

PS C:\> $BootImage = Get-CMBootImage -Name "Boot image (x64)"
PS C:\> $DistributionPoint = Get-CMDistributionpoint -SiteCode CM1
PS C:\> $ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "SiteSystemServer02.Contoso.com"
PS C:\> New-CMBootableMedia -MediaMode Dynamic -MediaType CdDvd -Path "\\Server\share\test.iso" -AllowUnknownMachine -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint

The first command gets the boot image object named Boot image (x64) and stores the object in the $BootImage variable.

The second command gets the distribution point object for the system site server named SiteServer01.Contoso.com and stores the object in the $DistributionPoint variable.

The third command gets the management point object for the site system server named SiteServer02.Contoso.com and stores the object in the $ManagementPoint variable.

The last command creates bootable media in dynamic mode using the BootImage stored in $BootImage, the distribution point stored in $DistributionPoint, and the management point stored in $ManagementPoint.

Required Parameters

-BootImage

Specifies a boot image object. To obtain a boot image object, use the Get-CMBootImage cmdlet.

Type:IResultObject
Aliases:BootImagePackage
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DistributionPoint

Specifies an array of distribution point objects. To obtain a distribution point object, use the Get-CMDistributionPoint cmdlet.

Type:IResultObject[]
Aliases:DistributionPoints
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ManagementPoint

Specifies an array of management point objects. To obtain a management point object, use the Get-CMManagementPoint cmdlet.

Type:IResultObject[]
Aliases:ManagementPoints
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MediaMode

Specifies the media mode. Valid values are: - Dynamic

  • SiteBased
Type:MediaMode
Parameter Sets:Dynamic, SiteBased
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MediaType

Specifies the media type. Valid values are: - CdDvd

  • Usb
  • Hd
Type:MediaInputType
Parameter Sets:Usb, CdDvd
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Path

Specifies the name and path where the output files are written.

Type:String
Aliases:MediaPath, OutputPath, DriveName
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-AllowUacPrompt

Indicates that User Account Control (UAC) prompts are allowed.

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

Indicates that unattended operating system deployments are allowed. An unattended operating system deployment does not prompt for network configuration or optional task sequences.

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

Indicates that Configuration Manager is allowed to provision unknown computers.

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

Specifies an expiration date and time for a self-signed media certificate.

Type:DateTime
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CertificatePassword

Specifies, as a secure string, the password for a PKI certificate. You need to import a PKI certificate for HTTPS communication.

Type:SecureString
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CertificatePath

Specifies a path from which to import a PKI certificate.

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

Specifies a start date and time for a self-signed media certificate.

Type:DateTime
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
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

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

Indicates that the cmdlet formats the removable USB drive (FAT32), and makes it bootable.

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

Specifies, as a secure string, a password to protect task sequence media.

Type:SecureString
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrestartCommand

Specifies a prestart command that will run before the task sequence runs. A prestart command is a script or an executable that can interact with the user in Windows PE before the task sequence runs to install the operating system.

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

Specifies a package object that contains files for the prestart command. To obtain a package object, use the Get-CMPackage cmdlet.

Type:IResultObject
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserDeviceAffinity

Specifies how users are associated with their devices. Valid values are: - DoNotAllow

  • AdministratorApproval
  • AutoApproval
Type:UserDeviceAffinityType
Parameter Sets:DoNotAllow, AdministratorApproval, AutoApproval
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Variable

Specifies a task sequence variable. A task sequence variable is a name/value pair that is used during the task sequence deployment.

Type:Hashtable
Aliases:TaskSequenceVariables, Variables
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