New-CMTaskSequenceMedia

Creates task sequence media in Configuration Manager.

Syntax

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

Description

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

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

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

PS XYZ:\> 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 XYZ:\> $Group = @{"6"="8";}
PS XYZ:\> 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 XYZ:\> 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 XYZ:\> 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.

Parameters

-AllowUacPrompt

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

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

-Application

Specifies applications included in the task sequence.

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

-ApplicationName

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

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

-BootableMedia

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

-BootImage

Specifies a boot image object.

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

-BootImageDistributionPoint

Specifies a boot image distribution point.

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

-BootImageDistributionPointServerName

Specifies a boot image distribution point server name.

Type:String
Aliases:DistributionPointServerName
Position:Named
Default value:None
Required:True
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
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BootImageManagementPoint

Specifies a boot image management point.

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

-BootImageManagementPointServerName

Specifies a boot image management point server name.

Type:String[]
Aliases:ManagementPointServerName, BootImageManagementPointServerNames
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CaptureMedia

Type:SwitchParameter
Aliases:CaptureMediaOption
Position:Named
Default value:None
Required:True
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CommandIncludeFile

Indicates whether to include a file.

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

-CommandPackage

Specifies a command package.

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

-CommandPackageDistributionPoint

Specifies a command package distrubtion point.

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

-CommandPackageName

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

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

-Comment

Specifies a comment for a prestaged media file.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
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
Position:Named
Default value:None
Required: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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-DriveName

Specifies a drive name.

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

-DriverPackage

Specifies a driver package.

Type:IResultObject[]
Aliases:DriverPackages, PackageDriver, PackageDrivers
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DriverPackageName

Specifies the name of a driver package.

Type:String[]
Aliases:PackageDriverName
Position:Named
Default value:None
Required:False
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableUnknownSupport

Indicates whether to provision unknown systems for operating system deployment.

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

-ExpirationDate

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

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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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 Configuration Manager site.

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

-ImportCertificatePath

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

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

-IncludeApplicationDependency

Indicates that the cmdlet detects associated application dependencies and adds them to this media.

Type:Boolean
Aliases:IncludeApplicationDependencies
Position:Named
Default value:None
Required:False
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
Accepted values:Usb, CdDvd, Hd, Usb, CdDvd, Hd
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MediaMode

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

  • Dynamic
  • SiteBased
Type:MediaMode
Accepted values:Dynamic, SiteBased, Dynamic, SiteBased
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MediaPath

Specifies a path to the media.

Type:String
Position:Named
Default value:None
Required:True
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
Accepted values:None, Size650MB, Size4GB, Size8GB, SizeUnlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystemImageDistributionPoint

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

-OperatingSystemImageDistributionPointServerName

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

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

-OperatingSystemImageName

Specifies the name of an operating system image.

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

-OperatingSystemImagePackage

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

-OperatingSystemImagePackageId

Specifies the identifier of an operating system image package.

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

-Package

Specifies package objects.

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

-PackageName

Specifies an array of package names.

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

-Password

Specifies a password, as a secure string.

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

-PrestagedMedia

Type:SwitchParameter
Aliases:PrestagedMediaOption, PrestageMedia
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PrestartCommandLine

Specifies a pre-start command line.

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

-ProtectPassword

Indicates whether to protect the media with a password.

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

-StandaloneMedia

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

-StartDate

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

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

-TaskSequence

Specifies a task sequence object.

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

-TaskSequenceDistributionPoint

Specifies a task sequence distribution point.

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

-TaskSequenceDistributionPointServerName

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

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

-TaskSequenceId

Specifies an ID for a task sequence.

Type:String
Position:Named
Default value:None
Required:True
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
Accepted values:DoNotAllow, AdministratorApproval, AutoApproval
Position:Named
Default value:None
Required:False
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

Specifies the version information for the media.

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

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject