Edit

Share via

Start-CMApplicationDeploymentSimulation

  • Reference
Module:
ConfigurationManager

(Deprecated) Starts an application deployment simulation in Configuration Manager.

Syntax

Start-CMApplicationDeploymentSimulation
     -CollectionName <String>
     [-DeploymentAction <DeployActionType>]
     -InputObject <IResultObject>
     [-PreDeploy <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMApplicationDeploymentSimulation
     -CollectionName <String>
     [-DeploymentAction <DeployActionType>]
     -Id <Int32>
     [-PreDeploy <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMApplicationDeploymentSimulation
     -CollectionName <String>
     [-DeploymentAction <DeployActionType>]
     -Name <String>
     [-PreDeploy <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

The Start-CMApplicationDeploymentSimulation cmdlet starts an application deployment. Use simulated deployment to test an application deployment without installing an application.

Important

Starting in version 2107, this cmdlet is deprecated and may be removed in a future release. Instead use the New-CMApplicationDeployment cmdlet with the Simulation parameter.

Examples

Example 1: Start an application deployment simulation

PS XYZ:\> Start-CMApplicationDeploymentSimulation -CollectionName "All Mobile Devices" -Name "WIN8_UPDATE2" -DeployAction Install

This command starts a deployment simulation of the installation of the application named WIN8_UPDATE2 for the target collection named All Mobile Devices.

Parameters

-CollectionName

Specifies a name for the target collection.

Type:String
Position:Named
Default value:None
Required:True
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

-DeploymentAction

Type:DeployActionType
Aliases:DeployAction
Accepted values:Install, Uninstall
Position:Named
Default value:None
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

-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

-Id

Specifies an array of IDs.

Type:Int32
Aliases:CIId, CI_ID
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies an application deployment object.

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifies an array of names.

Type:String
Aliases:LocalizedDisplayName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PreDeploy

Indicates whether to copy software to a device before installation.

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

System.Object