Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

New-CMTaskSequenceMedia

Creates task sequence media in Configuration Manager.

Syntax

NewBootableMedia (Default)

New-CMTaskSequenceMedia
 -BootImageDistributionPointServerName <String>
 -BootImageId <String>
 -BootImageManagementPointServerName <String[]>
 -MediaInputType <MediaInputType>
 -MediaMode <MediaMode>
 -MediaPath <String>
 -ProtectPassword <Boolean>
 [-AllowUacPrompt]
 [-AllowUnattendedDeployment <Boolean>]
 [-BootableMedia]
 [-CommandDistributionPointServerName <String>]
 [-CommandIncludeFile <Boolean>]
 [-CommandPackageName <String>]
 [-CreateMediaSelfCertificate <Boolean>]
 [-DriveName <String>]
 [-EnablePrestartCommand <Boolean>]
 [-EnableUnknownSupport <Boolean>]
 [-ExpirationDate <DateTime>]
 [-ImportCertificatePassword <SecureString>]
 [-ImportCertificatePath <String>]
 [-MediaSize <MediaSize>]
 [-Password <SecureString>]
 [-PrestartCommandLine <String>]
 [-StartDate <DateTime>]
 [-UserDeviceAffinity <UserDeviceAffinityType>]
 [-Variable <Hashtable>]
 [-DisableWildcardHandling]
 [-ForceWildcardHandling]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

NewStandAloneMedia

New-CMTaskSequenceMedia
 -MediaInputType <MediaInputType>
 -MediaPath <String>
 -ProtectPassword <Boolean>
 -TaskSequenceDistributionPointServerName <String[]>
 -TaskSequenceId <String>
 [-AllowUacPrompt]
 [-AllowUnattendedDeployment <Boolean>]
 [-CommandDistributionPointServerName <String>]
 [-CommandIncludeFile <Boolean>]
 [-CommandPackageName <String>]
 [-DriveName <String>]
 [-EnablePrestartCommand <Boolean>]
 [-IncludeApplicationDependency <Boolean>]
 [-MediaSize <MediaSize>]
 [-Password <SecureString>]
 [-PrestartCommandLine <String>]
 [-StandaloneMedia]
 [-Variable <Hashtable>]
 [-DisableWildcardHandling]
 [-ForceWildcardHandling]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

NewStandAloneMediaByValue

New-CMTaskSequenceMedia
 -MediaPath <String>
 -TaskSequence <IResultObject>
 -TaskSequenceDistributionPoint <IResultObject[]>
 [-AllowUacPrompt]
 [-AllowUnattendedDeployment <Boolean>]
 [-CommandIncludeFile <Boolean>]
 [-CommandPackage <IResultObject>]
 [-CommandPackageDistributionPoint <IResultObject>]
 [-DriveName <String>]
 [-EnablePrestartCommand <Boolean>]
 [-IncludeApplicationDependency <Boolean>]
 [-MediaInputType <MediaInputType>]
 [-MediaSize <MediaSize>]
 [-Password <SecureString>]
 [-PrestartCommandLine <String>]
 [-ProtectPassword <Boolean>]
 [-StandaloneMedia]
 [-Variable <Hashtable>]
 [-DisableWildcardHandling]
 [-ForceWildcardHandling]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

NewBootableMediaByValue

New-CMTaskSequenceMedia
 -BootImage <IResultObject>
 -BootImageDistributionPoint <IResultObject>
 -BootImageManagementPoint <IResultObject[]>
 -MediaPath <String>
 [-AllowUacPrompt]
 [-AllowUnattendedDeployment <Boolean>]
 [-BootableMedia]
 [-CommandIncludeFile <Boolean>]
 [-CommandPackage <IResultObject>]
 [-CommandPackageDistributionPoint <IResultObject>]
 [-CreateMediaSelfCertificate <Boolean>]
 [-DriveName <String>]
 [-EnablePrestartCommand <Boolean>]
 [-EnableUnknownSupport <Boolean>]
 [-ExpirationDate <DateTime>]
 [-ImportCertificatePassword <SecureString>]
 [-ImportCertificatePath <String>]
 [-MediaInputType <MediaInputType>]
 [-MediaMode <MediaMode>]
 [-MediaSize <MediaSize>]
 [-Password <SecureString>]
 [-PrestartCommandLine <String>]
 [-ProtectPassword <Boolean>]
 [-StartDate <DateTime>]
 [-UserDeviceAffinity <UserDeviceAffinityType>]
 [-Variable <Hashtable>]
 [-DisableWildcardHandling]
 [-ForceWildcardHandling]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

NewPrestagedMedia

New-CMTaskSequenceMedia
 -BootImageDistributionPointServerName <String>
 -BootImageId <String>
 -BootImageManagementPointServerName <String[]>
 -MediaMode <MediaMode>
 -MediaPath <String>
 -OperatingSystemImageDistributionPointServerName <String>
 -ProtectPassword <Boolean>
 -TaskSequenceDistributionPointServerName <String[]>
 -TaskSequenceId <String>
 [-AllowUacPrompt]
 [-AllowUnattendedDeployment <Boolean>]
 [-Application <IResultObject[]>]
 [-ApplicationName <String[]>]
 [-CommandDistributionPointServerName <String>]
 [-CommandIncludeFile <Boolean>]
 [-CommandPackageName <String>]
 [-Comment <String>]
 [-CreatedBy <String>]
 [-DriverPackage <IResultObject[]>]
 [-DriverPackageName <String[]>]
 [-OperatingSystemImageName <String>]
 [-OperatingSystemImagePackageId <String>]
 [-Package <IResultObject[]>]
 [-PackageName <String[]>]
 [-PrestagedMedia]
 [-PrestartCommandLine <String>]
 [-Variable <Hashtable>]
 [-Version <String>]
 [-DisableWildcardHandling]
 [-ForceWildcardHandling]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

NewPrestagedMediaByValue

New-CMTaskSequenceMedia
 -BootImage <IResultObject>
 -BootImageDistributionPoint <IResultObject>
 -BootImageManagementPoint <IResultObject[]>
 -MediaMode <MediaMode>
 -MediaPath <String>
 -OperatingSystemImageDistributionPoint <IResultObject>
 -TaskSequence <IResultObject>
 -TaskSequenceDistributionPoint <IResultObject[]>
 [-AllowUacPrompt]
 [-AllowUnattendedDeployment <Boolean>]
 [-Application <IResultObject[]>]
 [-CommandIncludeFile <Boolean>]
 [-CommandPackage <IResultObject>]
 [-CommandPackageDistributionPoint <IResultObject>]
 [-Comment <String>]
 [-CreatedBy <String>]
 [-DriverPackage <IResultObject[]>]
 [-OperatingSystemImagePackage <IResultObject>]
 [-Package <IResultObject[]>]
 [-PrestagedMedia]
 [-PrestartCommandLine <String>]
 [-ProtectPassword <Boolean>]
 [-Variable <Hashtable>]
 [-Version <String>]
 [-DisableWildcardHandling]
 [-ForceWildcardHandling]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

NewCaptureMediaByValue

New-CMTaskSequenceMedia
 -BootImage <IResultObject>
 -BootImageDistributionPoint <IResultObject>
 -MediaPath <String>
 [-AllowUacPrompt]
 [-CaptureMedia]
 [-DriveName <String>]
 [-MediaInputType <MediaInputType>]
 [-DisableWildcardHandling]
 [-ForceWildcardHandling]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

NewCaptureMedia

New-CMTaskSequenceMedia
 -BootImageDistributionPointServerName <String>
 -BootImageId <String>
 -MediaInputType <MediaInputType>
 -MediaPath <String>
 [-AllowUacPrompt]
 [-CaptureMedia]
 [-DriveName <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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-AllowUnattendedDeployment

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Application

Specifies applications included in the task sequence.

Parameter properties

Type:

IResultObject[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:Applications

Parameter sets

-ApplicationName

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

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-BootableMedia

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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:BootableMediaOption

Parameter sets

-BootImage

Specifies a boot image object.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-BootImageDistributionPoint

Specifies a boot image distribution point.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-BootImageDistributionPointServerName

Specifies a boot image distribution point server name.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:DistributionPointServerName

Parameter sets

-BootImageId

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-BootImageManagementPoint

Specifies a boot image management point.

Parameter properties

Type:

IResultObject[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:BootImageManagementPoints

Parameter sets

-BootImageManagementPointServerName

Specifies a boot image management point server name.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:ManagementPointServerName, BootImageManagementPointServerNames

Parameter sets

-CaptureMedia

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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:CaptureMediaOption

Parameter sets

-CommandDistributionPointServerName

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-CommandIncludeFile

Indicates whether to include a file.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-CommandPackage

Specifies a command package.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-CommandPackageDistributionPoint

Specifies a command package distrubtion point.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-CommandPackageName

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Comment

Specifies a comment for a prestaged media file.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

-CreatedBy

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-CreateMediaSelfCertificate

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-DisableWildcardHandling

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-DriveName

Specifies a drive name.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-DriverPackage

Specifies a driver package.

Parameter properties

Type:

IResultObject[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:DriverPackages, PackageDriver, PackageDrivers

Parameter sets

-DriverPackageName

Specifies the name of a driver package.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:PackageDriverName

Parameter sets

-EnablePrestartCommand

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-EnableUnknownSupport

Indicates whether to provision unknown systems for operating system deployment.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-ExpirationDate

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

Parameter properties

Type:DateTime
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-ForceWildcardHandling

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

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

Parameter properties

Type:SecureString
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-ImportCertificatePath

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-IncludeApplicationDependency

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False
Aliases:IncludeApplicationDependencies

Parameter sets

-MediaInputType

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

  • CDDVD
  • USB

Parameter properties

Type:MediaInputType
Default value:None
Accepted values:Usb, CdDvd, Hd
Supports wildcards:False
DontShow:False

Parameter sets

-MediaMode

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

  • Dynamic
  • SiteBased

Parameter properties

Type:MediaMode
Default value:None
Accepted values:Dynamic, SiteBased
Supports wildcards:False
DontShow:False

Parameter sets

-MediaPath

Specifies a path to the media.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-MediaSize

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

  • None
  • Size4GB
  • Size650MB
  • Size8GB
  • SizeUnlimited

Parameter properties

Type:MediaSize
Default value:None
Accepted values:None, Size650MB, Size4GB, Size8GB, SizeUnlimited
Supports wildcards:False
DontShow:False

Parameter sets

-OperatingSystemImageDistributionPoint

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.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-OperatingSystemImageDistributionPointServerName

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-OperatingSystemImageName

Specifies the name of an operating system image.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-OperatingSystemImagePackage

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.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-OperatingSystemImagePackageId

Specifies the identifier of an operating system image package.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Package

Specifies package objects.

Parameter properties

Type:

IResultObject[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:Packages

Parameter sets

-PackageName

Specifies an array of package names.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Password

Specifies a password, as a secure string.

Parameter properties

Type:SecureString
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-PrestagedMedia

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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:PrestagedMediaOption, PrestageMedia

Parameter sets

-PrestartCommandLine

Specifies a pre-start command line.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:CommandLine

Parameter sets

-ProtectPassword

Indicates whether to protect the media with a password.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-StandaloneMedia

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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:StandAloneMediaOption

Parameter sets

-StartDate

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

Parameter properties

Type:DateTime
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-TaskSequence

Specifies a task sequence object.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-TaskSequenceDistributionPoint

Specifies a task sequence distribution point.

Parameter properties

Type:

IResultObject[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:TaskSequenceDistributionPoints

Parameter sets

-TaskSequenceDistributionPointServerName

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

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:TaskSequenceDistributionPointServerNames

Parameter sets

-TaskSequenceId

Specifies an ID for a task sequence.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-UserDeviceAffinity

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

  • AdministratorApproval
  • AutoApproval
  • DoNotAllow

Parameter properties

Type:UserDeviceAffinityType
Default value:None
Accepted values:DoNotAllow, AdministratorApproval, AutoApproval
Supports wildcards:False
DontShow:False

Parameter sets

-Variable

Specifies a task sequence variable. The task sequence variable consists of a name and a value.

Parameter properties

Type:Hashtable
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Version

Specifies the version information for the media.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-WhatIf

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

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Related Links


Feedback

Was this page helpful?