New-CMStandaloneMedia
Creates stand-alone media.
Syntax
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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowUnattended
Indicates that unattended operating system deployments are allowed. An unattended operating system deployment does not prompt for network configuration or optional task sequences.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Application
Type: | IResultObject[] |
Aliases: | Applications |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificatePath
Specifies a path from which to import a PKI certificate.
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 |
-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 |
-DistributionPoint
Specifies an array of distribution point objects. To obtain a distribution point object, use the Get-CMDistributionPoint cmdlet.
Type: | IResultObject[] |
Aliases: | DistributionPoints |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriverPackage
Type: | IResultObject[] |
Aliases: | DriverPackages, PackageDriver, PackageDrivers |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Forces the command to run without asking for user confirmation.
Type: | SwitchParameter |
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 |
-FormatMedia
Indicates that the cmdlet formats the removable USB drive (FAT32), and makes it bootable.
Type: | SwitchParameter |
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: | SwitchParameter |
Aliases: | IncludeApplicationDependencies |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MediaExpirationDate
Type: | DateTime |
Aliases: | Expiration |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MediaPassword
Specifies, as a secure string, a password to protect task sequence media.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MediaSize
Specifies the size of the media. Valid values are:
- None
- Size4GB
- Size8GB
- Size650MB
- 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 |
-MediaStartDate
Type: | DateTime |
Aliases: | Start |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MediaType
Specifies the media type. Valid values are:
- CdDvd
- Usb
- Hd
Type: | MediaInputType |
Accepted values: | Usb, CdDvd |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoAutoRun
Use this parameter to configure the following option from the create task sequence media wizard: Include autorun.inf file on media
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Package
Type: | IResultObject[] |
Aliases: | Packages |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Specifies the name and path where the output files are written.
Type: | String |
Aliases: | MediaPath, OutputPath, DriveName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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.
Type: | String |
Aliases: | PreExecCommandLine |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrestartPackage
Specifies a package object that contains files for the prestart command. To obtain a package object, use the Get-CMPackage cmdlet.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SiteCode
{{ Fill SiteCode Description }}
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSequence
Specifies a task sequence object. To obtain a task sequence object, use the Get-CMTaskSequence cmdlet.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemporaryFolder
{{ Fill TemporaryFolder Description }}
Type: | String |
Aliases: | TemporaryDirectory, StagingArea |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Variable
Specifies a task sequence variable. A task sequence variable is a name/value pair that is used during the task sequence deployment.
Type: | Hashtable |
Aliases: | TaskSequenceVariables, Variables |
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 doesn't run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
None
Outputs
System.Object