New-CMTaskSequenceMedia

Creates task sequence media in System Center Configuration Manager.

Syntax

New-CMTaskSequenceMedia
   [-AllowUacPrompt]
   [-AllowUnattendedDeployment <Boolean>]
   -BootImageDistributionPointServerName <String>
   -BootImageId <String>
   -BootImageManagementPointServerName <String[]>
   [-BootableMedia]
   [-CommandDistributionPointServerName <String>]
   [-CommandIncludeFile <Boolean>]
   [-CommandPackageName <String>]
   [-Confirm]
   [-CreateMediaSelfCertificate <Boolean>]
   [-DisableWildcardHandling]
   [-DriveName <String>]
   [-EnablePrestartCommand <Boolean>]
   [-EnableUnknownSupport <Boolean>]
   [-ExpirationDate <DateTime>]
   [-ForceWildcardHandling]
   [-ImportCertificatePassword <SecureString>]
   [-ImportCertificatePath <String>]
   -MediaInputType <MediaInputType>
   -MediaMode <MediaMode>
   -MediaPath <String>
   [-MediaSize <MediaSize>]
   [-Password <SecureString>]
   [-PrestartCommandLine <String>]
   -ProtectPassword <Boolean>
   [-StartDate <DateTime>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-Variable <Hashtable>]
   [-WhatIf]
   [<CommonParameters>]
New-CMTaskSequenceMedia [-AllowUacPrompt] [-AllowUnattendedDeployment ]
 [-CommandDistributionPointServerName ] [-CommandIncludeFile ] [-CommandPackageName ]
 [-Confirm] [-DisableWildcardHandling] [-DriveName ] [-EnablePrestartCommand ]
 [-ForceWildcardHandling] [-IncludeApplicationDependency ] -MediaInputType 
 -MediaPath  [-MediaSize ] [-Password ] [-PrestartCommandLine ]
 -ProtectPassword  [-StandaloneMedia] -TaskSequenceDistributionPointServerName 
 -TaskSequenceId  [-Variable ] [-WhatIf] []
New-CMTaskSequenceMedia [-AllowUacPrompt] [-AllowUnattendedDeployment ]
 [-CommandIncludeFile ] [-CommandPackage ]
 [-CommandPackageDistributionPoint ] [-Confirm] [-DisableWildcardHandling] [-DriveName ]
 [-EnablePrestartCommand ] [-ForceWildcardHandling] [-IncludeApplicationDependency ]
 [-MediaInputType ] -MediaPath  [-MediaSize ] [-Password ]
 [-PrestartCommandLine ] [-ProtectPassword ] [-StandaloneMedia] -TaskSequence 
 -TaskSequenceDistributionPoint  [-Variable ] [-WhatIf] []
New-CMTaskSequenceMedia [-AllowUacPrompt] [-AllowUnattendedDeployment ] -BootImage 
 -BootImageDistributionPoint  -BootImageManagementPoint  [-BootableMedia]
 [-CommandIncludeFile ] [-CommandPackage ]
 [-CommandPackageDistributionPoint ] [-Confirm] [-CreateMediaSelfCertificate ]
 [-DisableWildcardHandling] [-DriveName ] [-EnablePrestartCommand ]
 [-EnableUnknownSupport ] [-ExpirationDate ] [-ForceWildcardHandling]
 [-ImportCertificatePassword ] [-ImportCertificatePath ]
 [-MediaInputType ] [-MediaMode ] -MediaPath  [-MediaSize ]
 [-Password ] [-PrestartCommandLine ] [-ProtectPassword ]
 [-StartDate ] [-UserDeviceAffinity ] [-Variable ] [-WhatIf]
 []
New-CMTaskSequenceMedia [-AllowUacPrompt] [-AllowUnattendedDeployment ]
 [-Application ] -BootImage  -BootImageDistributionPoint 
 -BootImageManagementPoint  [-CommandIncludeFile ] [-CommandPackage ]
 [-CommandPackageDistributionPoint ] [-Comment ] [-Confirm] [-CreatedBy ]
 [-DisableWildcardHandling] [-DriverPackage ] [-ForceWildcardHandling] -MediaMode 
 -MediaPath  -OperatingSystemImageDistributionPoint 
 [-OperatingSystemImagePackage ] [-Package ] [-PrestagedMedia]
 [-PrestartCommandLine ] [-ProtectPassword ] -TaskSequence 
 -TaskSequenceDistributionPoint  [-Variable ] [-Version ] [-WhatIf]
 []
New-CMTaskSequenceMedia [-AllowUacPrompt] [-AllowUnattendedDeployment ]
 [-Application ] [-ApplicationName ] -BootImageDistributionPointServerName 
 -BootImageId  -BootImageManagementPointServerName 
 [-CommandDistributionPointServerName ] [-CommandIncludeFile ] [-CommandPackageName ]
 [-Comment ] [-Confirm] [-CreatedBy ] [-DisableWildcardHandling]
 [-DriverPackage ] [-DriverPackageName ] [-ForceWildcardHandling]
 -MediaMode  -MediaPath  -OperatingSystemImageDistributionPointServerName 
 [-OperatingSystemImageName ] [-OperatingSystemImagePackageId ] [-Package ]
 [-PackageName ] [-PrestagedMedia] [-PrestartCommandLine ] -ProtectPassword 
 -TaskSequenceDistributionPointServerName  -TaskSequenceId  [-Variable ]
 [-Version ] [-WhatIf] []
New-CMTaskSequenceMedia [-AllowUacPrompt] -BootImage 
 -BootImageDistributionPoint  [-CaptureMedia] [-Confirm] [-DisableWildcardHandling]
 [-DriveName ] [-ForceWildcardHandling] [-MediaInputType ] -MediaPath 
 [-WhatIf] []
New-CMTaskSequenceMedia [-AllowUacPrompt] -BootImageDistributionPointServerName  -BootImageId 
 [-CaptureMedia] [-Confirm] [-DisableWildcardHandling] [-DriveName ] [-ForceWildcardHandling]
 -MediaInputType  -MediaPath  [-WhatIf] []

Description

The New-CMTaskSequenceMedia cmdlet creates task sequence media in Microsoft System Center Configuration Manager.

Examples

Example 1: Create task sequence media with the captured media option

PS C:\> New-CMTaskSequenceMedia -CaptureMediaOption -MediaPath "\\Contoso320\Users\Administrator.Contoso319DOM\Desktop\DD\1.iso" -MediaInputType CDDVD -BootImageName "Boot" -DistributionPointServerName "Contoso320.Contoso319DOM.NET"

This command creates task sequence media by specifying the CaptureMediaOption parameter. The command also specifies a value for the MediaPath parameter, and a value for the MediaInputType parameter.

Example 2: Create task sequence media with the standalone media option

PS C:\> $Group = @{"6"="8";}
PS C:\> New-CMTaskSequenceMedia -StandAloneMediaOption -Variable $Group -MediaInputType CDDVD -MediaPath "\\Contoso320\Users\Administrator.Contoso319DOM\Desktop\DD\111 - Copy.iso" -ProtectPassword 0 -TaskSequenceId "CCC0000B" -TaskSequenceDistributionPointServerName "\\Contoso320.Contoso319DOM.NET"

The first command creates a mapping, and then stores the result in the $Group variable.

The second command creates task sequence media by specifying the StandAloneMediaOption parameter.

Example 3: Create task sequence media with the bootable media option

PS C:\> New-CMTaskSequenceMedia -BootableMediaOption -MediaInputType CDDVD -MediaPath "\\Contoso320\Users\Administrator.Contoso319DOM\Desktop\DD\111 - Copy (6).iso" -MediaMode Dynamic -ProtectPassword 0 -BootImageName "boot" -DistributionPointServerName "Contoso320.Contoso319DOM.NET" -ManagementnPointNetworkOperatingSystemPath "Contoso320.Contoso319DOM.NET"

This command creates task sequence media by specifying the BootableMediaOption parameter.

Example 4: Create task sequence media with the prestaged media option

PS C:\> New-CMTaskSequenceMedia -PrestagedMediaOption -MediaMode Dynamic -MediaPath "\\Contoso320\Users\Administrator.Contoso319DOM\Desktop\DD\2.wim"  -ProtectPassword 0 -TaskSequenceId "CCC0000B" -BootImageName "boot" -DistributionPointServerName "Contoso320.Contoso319DOM.NET" -ManagementnPointNetworkOperatingSystemPath "Contoso320.Contoso319DOM.NET" -OperatingSystemImageDistributionPointServerName "Contoso320.Contoso319DOM.NET" -TaskSequenceDistributionPointServerName "\\Contoso320.Contoso319DOM.NET"

This command uses the New-CMTaskSequenceMedia cmdlet to create task sequence media by specifying the PrestagedMediaOption parameter.

Required Parameters

-BootImage
Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-BootImageDistributionPoint
Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-BootImageDistributionPointServerName
Type:String
Aliases:DistributionPointServerName
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-BootImageId

Specifies the ID of the boot image package associated with the task sequence media.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-BootImageManagementPoint
Type:IResultObject[]
Aliases:BootImageManagementPoints
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-BootImageManagementPointServerName
Type:String[]
Aliases:ManagementPointServerName, BootImageManagementPointServerNames
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-BootableMedia
Type:SwitchParameter
Aliases:BootableMediaOption
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CaptureMedia
Type:SwitchParameter
Aliases:CaptureMediaOption
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MediaInputType

Specifies a media input type. The acceptable values for this parameter are:- CDDVD

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

Specifies a media mode. The acceptable values for this parameter are:- Dynamic

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

Specifies a path to the media.

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

Specifies the name of a distribution point server for an operating system image.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrestagedMedia
Type:SwitchParameter
Aliases:PrestagedMediaOption
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProtectPassword

Indicates whether to protect the media with a password.

Type:Boolean
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StandaloneMedia
Type:SwitchParameter
Aliases:StandAloneMediaOption
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TaskSequence
Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-TaskSequenceDistributionPoint
Type:IResultObject[]
Aliases:TaskSequenceDistributionPoints
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-TaskSequenceDistributionPointServerName

Specifies an array of available distribution point servers for a task sequence.

Type:String[]
Aliases:TaskSequenceDistributionPointServerNames
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TaskSequenceId

Specifies an ID for a task sequence.

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

Optional Parameters

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

Indicates whether you allow unattended operating system deployment, which does not prompt for network configuration or optional task sequences.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Application
Type:IResultObject[]
Aliases:Applications
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-ApplicationName

Specifies an array of names of applications included in the task sequence.

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

Specifies a name for a distribution point server from which the cmdlet acquires the package. The CommandPackageName parameter specifies the package name.

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

Indicates whether to include a file.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CommandPackage
Type:IResultObject
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CommandPackageDistributionPoint
Type:IResultObject
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CommandPackageName

Specifies a package name for the command specified by the CommandLine parameter.

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

Specifies a comment for a prestaged media file.

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

Indicates whether the media includes a self-signed certificate. Use this parameter only in mixed-mode environments.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CreatedBy

Specifies the name of an individual or organization responsible for the creation of the prestaged media.

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

Specifies a drive name.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DriverPackage
Type:IResultObject[]
Aliases:DriverPackages, PackageDriver, PackageDrivers
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-DriverPackageName
Type:String[]
Aliases:PackageDriverName
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnablePrestartCommand

Indicates whether to enable a prestart command. A prestart command is a script or executable that runs before the task sequence.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableUnknownSupport

Indicates whether to provision unknown systems for operating system deployment.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ExpirationDate

Specifies an expiration date, in D.HH:MM:SS format, for bootable media.

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

Specifies a password for an import certificate, as a secure string. An import certificate is a PKI-issued certificate added to the boot media for client authentication and communication with a System Center Configuration Manager site.

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

Specifies a path for an import certificate to add to the boot media.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IncludeApplicationDependency
Type:Boolean
Aliases:IncludeApplicationDependencies
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MediaSize

Specifies the size of the media. The acceptable values for this parameter are:- None

  • Size4GB
  • Size650MB
  • Size8GB
  • SizeUnlimited
Type:MediaSize
Parameter Sets:None, Size650MB, Size4GB, Size8GB, SizeUnlimited
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OperatingSystemImageName

Specifies the name of an operating system image.

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

Specifies the identifier of an operating system image package.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Package
Type:IResultObject[]
Aliases:Packages
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-PackageName

Specifies an array of package names.

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

Specifies a password, as a secure string.

Type:SecureString
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
-StartDate

Specifies a start date and time, in D.HH:MM:SS format.

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

Specifies user device affinity. User device affinity associates users with a destination computer. The acceptable values for this parameter are:- AdministratorApproval

  • AutoApproval
  • DoNotAllow
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. The task sequence variable consists of a name and a value.

Type:Hashtable
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Version

Specifies the version information for the media.

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