Manage and monitor phased deployments
This article describes how to manage and monitor phased deployments. Management tasks include manually beginning the next phase, and suspend or resume a phase.
First, you need to create a phased deployment:
Move to the next phase
When you select the setting, Manually begin the second phase of deployment, the site doesn't automatically start the next phase based on success criteria. You need to move the phased deployment to the next phase.
How to start this action varies based on the type of deployed software:
Application: Go to the Software Library workspace, expand Application Management, and select Applications.
Software update: Go to the Software Library workspace, and then select one of the following nodes:
- Software Updates
- All Software Updates
- Software Update Groups
- Windows Servicing, All Windows Updates
- Office 365 Client Management, Office 365 Updates
- Software Updates
Task sequence: Go to the Software Library workspace, expand Operating Systems, and select Task Sequences.
Select the software with the phased deployment.
In the details pane, switch to the Phased Deployments tab.
Select the phased deployment, and click Move to next phase in the ribbon.
Optionally, use the following Windows PowerShell cmdlet for this task: Move-CMPhasedDeploymentToNext.
Suspend and resume phases
You can manually suspend or resume a phased deployment. For example, you create a phased deployment for a task sequence. While monitoring the phase to your pilot group, you notice a large number of failures. You suspend the phased deployment to stop further devices from running the task sequence. After resolving the issue, you resume the phased deployment to continue the rollout.
How to start this action varies based on the type of deployed software:
Application: Go to the Software Library workspace, expand Application Management, and select Applications.
Software update: Go to the Software Library workspace, and then select one of the following nodes:
- Software Updates
- All Software Updates
- Software Update Groups
- Windows Servicing, All Windows Updates
- Office 365 Client Management, Office 365 Updates
- Software Updates
Task sequence: Go to the Software Library workspace, expand Operating Systems, and select Task Sequences. Select an existing task sequence, and then click Create Phased Deployment in the ribbon.
Select the software with the phased deployment.
In the details pane, switch to the Phased Deployments tab.
Select the phased deployment, and click Suspend or Resume in the ribbon.
Note
Starting on April 21, 2020, Office 365 ProPlus is being renamed to Microsoft 365 Apps for enterprise. For more information, see Name change for Office 365 ProPlus. You may still see the old name in the Configuration Manager product and documentation while the console is being updated.
Optionally, use the following Windows PowerShell cmdlets for this task:
Monitor
Phased deployments have their own dedicated monitoring node, making it easier to identify phased deployments you have created and navigate to the phased deployment monitoring view. From the Monitoring workspace, select Phased Deployments, then double-click one of the phased deployments to see the status.
This dashboard shows the following information for each phase in the deployment:
Total devices or Total resources: How many devices are targeted by this phase.
Status: The current status of this phase. Each phase can be in one of the following states:
Deployment created: The phased deployment created a deployment of the software to the collection for this phase. Clients are actively targeted with this software.
Waiting: The previous phase hasn't yet reached the success criteria for the deployment to continue to this phase.
Suspended: An administrator suspended the deployment.
Progress: The color-coded deployment states from clients. For example: Success, In Progress, Error, Requirements Not Met, and Unknown.
Success criteria tile
Use the Select Phase drop-down list to change the display of the Success Criteria tile. This tile compares the Phase Goal against the current compliance of the deployment. With the default settings, the phase goal is 95%. This value means that the deployment needs a 95% compliance to move to the next phase.
In the example, the phase goal is 65%, and the current compliance is 66.7%. The phased deployment automatically moved to the second phase, because the first phase met the success criteria.
The phase goal is the same as the Deployment success percentage on the Phase Settings for the next phase. For the phased deployment to start the next phase, that second phase defines the criteria for success of the first phase. To view this setting:
Go to the phased deployment object on the software, and open the Phased Deployment Properties.
Switch to the Phases tab. Select Phase 2 and click View.
In the phase Properties window, switch to the Phase Settings tab.
View the value for Deployment success percentage in the Criteria for success of the previous phase group.
For example, the following properties are for the same phase as the success criteria tile shown above where the criteria is 65%:
PowerShell
Use the following Windows PowerShell cmdlets to manage phased deployments:
Automatically create phased deployments
- New-CMApplicationAutoPhasedDeployment
- New-CMSoftwareUpdateAutoPhasedDeployment
- New-CMTaskSequenceAutoPhasedDeployment
Manually create phased deployments
- New-CMSoftwareUpdatePhase
- New-CMSoftwareUpdateManualPhasedDeployment
- New-CMTaskSequencePhase
- New-CMTaskSequenceManualPhasedDeployment
Get existing phased deployment objects
- Get-CMApplicationPhasedDeployment
- Get-CMSoftwareUpdatePhasedDeployment
- Get-CMTaskSequencePhasedDeployment
- Get-CMPhase