Note

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

Access to this page requires authorization. You can try .

New-CMStandaloneMedia

Creates stand-alone media.

Syntax

Default (Default)

New-CMStandaloneMedia
 [-Application <IResultObject[]>]
 [-DriverPackage <IResultObject[]>]
 [-IncludeApplicationDependency]
 [-MediaExpirationDate <DateTime>]
 [-MediaSize <MediaSize>]
 [-MediaStartDate <DateTime>]
 [-Package <IResultObject[]>]
 -TaskSequence <IResultObject>
 [-AllowUacPrompt]
 [-AllowUnattended]
 [-CertificatePath <String>]
 -DistributionPoint <IResultObject[]>
 [-Force]
 [-FormatMedia]
 [-SiteCode <String>]
 [-MediaPassword <SecureString>]
 -MediaType <MediaInputType>
 [-NoAutoRun]
 -Path <String>
 [-PrestartCommand <String>]
 [-PrestartPackage <IResultObject>]
 [-TemporaryFolder <String>]
 [-Variable <Hashtable>]
 [-DisableWildcardHandling]
 [-ForceWildcardHandling]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

Description

The New-CMStandaloneMedia cmdlet creates media used to deploy operating systems without network access.

NOTE: This cmdlet requires elevated permissions to run.

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 stand-alone media using variables

PS XYZ:\> $TaskSequence = Get-CMTaskSequence -Name "TaskSequence01"
PS XYZ:\> $DistributionPoint = Get-CMDistributionpoint -SiteCode CM1
PS XYZ:\> New-CMStandaloneMedia -MediaType CdDvd -Path \\server\share\standaloneMedia.iso -TaskSequence $TaskSequence -DistributionPoint $DistributionPoint

The first command gets the task sequence object named TaskSequence01 and stores the object in the $TaskSequence variable.

The second command gets the distribution point object for the site code named CM1 and stores the object in the $DistributionPoint variable.

The last command creates stand-alone media using the task sequence stored in $TaskSequence and the distribution point stored in $DistributionPoint.

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

-AllowUnattended

Indicates that unattended operating system deployments are allowed. An unattended operating system deployment does not prompt for network configuration or optional task sequences.

Parameter properties

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

Parameter sets

-Application

The New-CMStandaloneMedia cmdlet creates media used to deploy operating systems without network access.

NOTE: This cmdlet requires elevated permissions to run.

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
Aliases:Applications

Parameter sets

-CertificatePath

Specifies a path from which to import a PKI certificate.

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

-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

-DistributionPoint

Specifies an array of distribution point objects. To obtain a distribution point object, use the Get-CMDistributionPoint cmdlet.

Parameter properties

Type:

IResultObject[]

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

Parameter sets

-DriverPackage

The New-CMStandaloneMedia cmdlet creates media used to deploy operating systems without network access.

NOTE: This cmdlet requires elevated permissions to run.

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
Aliases:DriverPackages, PackageDriver, PackageDrivers

Parameter sets

-Force

Forces the command to run without asking for user confirmation.

Parameter properties

Type:SwitchParameter
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

-FormatMedia

Indicates that the cmdlet formats the removable USB drive (FAT32), and makes it bootable.

Parameter properties

Type:SwitchParameter
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:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:IncludeApplicationDependencies

Parameter sets

-MediaExpirationDate

The New-CMStandaloneMedia cmdlet creates media used to deploy operating systems without network access.

NOTE: This cmdlet requires elevated permissions to run.

Note

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

Parameter properties

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

Parameter sets

-MediaPassword

Specifies, as a secure string, a password to protect task sequence media.

Parameter properties

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

Parameter sets

-MediaSize

Specifies the size of the media. Valid values are:

  • None
  • Size4GB
  • Size8GB
  • Size650MB
  • SizeUnlimited

Parameter properties

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

Parameter sets

-MediaStartDate

The New-CMStandaloneMedia cmdlet creates media used to deploy operating systems without network access.

NOTE: This cmdlet requires elevated permissions to run.

Note

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

Parameter properties

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

Parameter sets

-MediaType

Specifies the media type. Valid values are:

  • CdDvd
  • Usb
  • Hd

Parameter properties

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

Parameter sets

-NoAutoRun

Use this parameter to configure the following option from the create task sequence media wizard: Include autorun.inf file on media

Parameter properties

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

Parameter sets

-Package

The New-CMStandaloneMedia cmdlet creates media used to deploy operating systems without network access.

NOTE: This cmdlet requires elevated permissions to run.

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
Aliases:Packages

Parameter sets

-Path

Specifies the name and path where the output files are written.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:MediaPath, OutputPath, DriveName

Parameter sets

-PrestartCommand

Specifies a prestart command that will run before the task sequence runs. A prestart command is a script or an executable that can interact with the user in Windows PE before the task sequence runs to install the operating system.

Parameter properties

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

Parameter sets

-PrestartPackage

Specifies a package object that contains files for the prestart command. To obtain a package object, use the Get-CMPackage cmdlet.

Parameter properties

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

Parameter sets

-SiteCode

{{ Fill SiteCode Description }}

Parameter properties

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

Parameter sets

-TaskSequence

Specifies a task sequence object. To obtain a task sequence object, use the Get-CMTaskSequence cmdlet.

Parameter properties

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

Parameter sets

-TemporaryFolder

{{ Fill TemporaryFolder Description }}

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:TemporaryDirectory, StagingArea

Parameter sets

-Variable

Specifies a task sequence variable. A task sequence variable is a name/value pair that is used during the task sequence deployment.

Parameter properties

Type:Hashtable
Default value:None
Supports wildcards:False
DontShow:False
Aliases:TaskSequenceVariables, Variables

Parameter sets

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't 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

None

Outputs

System.Object

Related Links


Feedback

Was this page helpful?