New-CMTaskSequenceMedia

New-CMTaskSequenceMedia

Creates task sequence media in System Center 2012 Configuration Manager.

Syntax

Parameter Set: NewBootableMedia
New-CMTaskSequenceMedia -BootableMediaOption -BootImageId <String> -DistributionPointServerName <String> -ManagementPointServerName <String[]> -MediaInputType <MediaInputType> {CDDVD | USB} -MediaMode <MediaMode> {Dynamic | SiteBased} -ProtectPassword <Boolean> [-AllowUnattendedDeployment <Boolean> ] [-CommandDistributionPointServerName <String> ] [-CommandIncludeFile <Boolean> ] [-Commandline <String> ] [-CommandPackageName <String> ] [-CreateMediaSelfCertificate <Boolean> ] [-DriveName <String> ] [-EnablePrestartCommand <Boolean> ] [-EnableUnknownSupport <Boolean> ] [-ExpirationDate <DateTime> ] [-ImportCertificatePassword <SecureString> ] [-ImportCertificatePath <String> ] [-MediaPath <String> ] [-MediaSize <MediaSize> {None | Size4GB | Size650MB | Size8GB | SizeUnlimited} ] [-Password <SecureString> ] [-StartDate <DateTime> ] [-UserDeviceAffinity <UserDeviceAffinityType> {AdministratorApproval | AutoApproval | DoNotAllow} ] [-Variable <Hashtable> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: NewCaptureMedia
New-CMTaskSequenceMedia -BootImageId <String> -CaptureMediaOption -DistributionPointServerName <String> -MediaInputType <MediaInputType> {CDDVD | USB} [-DriveName <String> ] [-MediaPath <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: NewPrestagedMedia
New-CMTaskSequenceMedia -BootImageId <String> -DistributionPointServerName <String> -ManagementPointServerName <String[]> -MediaMode <MediaMode> {Dynamic | SiteBased} -OperatingSystemImageDistributionPointServerName <String> -PrestagedMediaOption -ProtectPassword <Boolean> -TaskSequenceDistributionPointServerName <String[]> -TaskSequenceId <String> [-AllowUnattendedDeployment <Boolean> ] [-ApplicationName <String[]> ] [-Comment <String> ] [-CreatedBy <String> ] [-MediaPath <String> ] [-OperatingSystemImageName <String> ] [-OperatingSystemImagePackageId <String> ] [-PackageDriverName <String[]> ] [-PackageName <String[]> ] [-Variable <Hashtable> ] [-Version <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: NewStandAloneMedia
New-CMTaskSequenceMedia -MediaInputType <MediaInputType> {CDDVD | USB} -ProtectPassword <Boolean> -StandAloneMediaOption -TaskSequenceDistributionPointServerName <String[]> -TaskSequenceId <String> [-AllowUnattendedDeployment <Boolean> ] [-CommandDistributionPointServerName <String> ] [-CommandIncludeFile <Boolean> ] [-Commandline <String> ] [-CommandPackageName <String> ] [-DriveName <String> ] [-EnablePrestartCommand <Boolean> ] [-IncludeApplicationDependencies <Boolean> ] [-MediaPath <String> ] [-MediaSize <MediaSize> {None | Size4GB | Size650MB | Size8GB | SizeUnlimited} ] [-Password <SecureString> ] [-Variable <Hashtable> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

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

Parameters

-AllowUnattendedDeployment<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ApplicationName<String[]>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-BootableMediaOption

Indicates that bootable media is an option. Bootable media lets you deploy an operating system when the destination computer starts.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-BootImageId<String>

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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CaptureMediaOption

Indicates that the task sequences are written to capture media. Capture media contains an operating system image from a reference computer, including a boot image that starts a reference computer, and the task sequence that captures the operating system.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CommandDistributionPointServerName<String>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CommandIncludeFile<Boolean>

Indicates whether to include a file.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Commandline<String>

Specifies a command line for a task sequence.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CommandPackageName<String>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Comment<String>

Specifies a comment for a prestaged media file.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CreatedBy<String>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CreateMediaSelfCertificate<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DistributionPointServerName<String>

Specifies a name for a distribution point server.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DriveName<String>

Specifies a drive name.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnablePrestartCommand<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableUnknownSupport<Boolean>

Indicates whether to provision unknown systems for operating system deployment.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ExpirationDate<DateTime>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ImportCertificatePassword<SecureString>

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 2012 Configuration Manager site.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ImportCertificatePath<String>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-IncludeApplicationDependencies<Boolean>

Indicates whether the cmdlet includes all application dependencies.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ManagementPointServerName<String[]>

Specifies an array of names for management point servers.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MediaInputType<MediaInputType>

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

-- CDDVD
-- USB

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MediaMode<MediaMode>

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

-- Dynamic
-- SiteBased

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MediaPath<String>

Specifies a path to the media.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MediaSize<MediaSize>

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

-- None
-- Size4GB
-- Size650MB
-- Size8GB
-- SizeUnlimited

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-OperatingSystemImageDistributionPointServerName<String>

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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-OperatingSystemImageName<String>

Specifies the name of an operating system image.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-OperatingSystemImagePackageId<String>

Specifies the identifier of an operating system image package.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PackageDriverName<String[]>

Specifies an array of package driver names.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PackageName<String[]>

Specifies an array of package names.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Password<SecureString>

Specifies a password, as a secure string.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PrestagedMediaOption

Indicates that the bootable media image and operating system is written to a hard disk. Prestaged media contains a boot image and the operating system to apply to a destination computer.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ProtectPassword<Boolean>

Indicates whether to protect the media with a password.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-StandAloneMediaOption

Indicates that the task sequences are written to standalone media, such as DVD or CD.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-StartDate<DateTime>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-TaskSequenceDistributionPointServerName<String[]>

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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-TaskSequenceId<String>

Specifies an ID for a task sequence.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UserDeviceAffinity<UserDeviceAffinityType>

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

-- AdministratorApproval
-- AutoApproval
-- DoNotAllow

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Variable<Hashtable>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Version<String>

Specifies the version information for the media.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

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

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.

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

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

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.

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"

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

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

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"

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

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

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"

Get-CMTaskSequence