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"