Deploy and track configurable settings - Microsoft Managed Desktop

After you make changes to your setting categories and stage a deployment, the Deployment status page allows you to begin deploying your settings to groups. This page shows a summary of each configurable setting. When opening a setting category, you can deploy settings to groups and track the progress of these deployments.

Deployment statuses

The following are the statuses you'll see for each deployment.

Status Explanation
Deploy Your change is waiting to be deployed to this group.
In progress The change is being applied to active devices in this group.
Complete The change completed on all active devices in this group.
Failed The change failed on 10 percent of active devices in the group. The deployment was stopped.

A support request will be automatically opened with Microsoft Managed Desktop operations to troubleshoot the deployment.
Reverted The change was reverted to the last change that was successfully deployed to all deployment groups.

Deploy changes

As an example, we'll use a desktop background picture in these instructions. After you've staged a deployment, you deploy changes from the Deployment status page.

To deploy changes:

  1. Sign in to Microsoft Endpoint Manager and navigate to the Devices menu.
  2. In the Microsoft Managed Desktop section, select Settings.
  3. In the Deployment status workspace, select the setting you want to deploy. Then, select the staged deployment to deploy.
  4. Select Deploy to deploy the change to one of the deployment groups.

Note

The orange caution icon indicates there is a previous group available for deployment as it's recommended to roll out in order.

We recommend deploying to deployment groups in this order: Test, First, Fast, and then Broad.

When changes complete in each group, the status changes to Complete.

Revert deployment

After you've deployed a change, you can revert from Deployment status. When you revert a change that is In progress or Complete, the current deployment stops. The setting will revert to the last version that was deployed to all groups.

As an example, we'll revert the desktop background picture.

To revert a change:

  1. Sign in to Microsoft Endpoint Manager and navigate to the Devices menu.
  2. In the Microsoft Managed Desktop section, select Settings.
  3. In the Deployment status workspace, select the setting you want to revert. Then, select the staged deployment to revert.
  4. Under Need to revert this change?, select Revert deployment.

Additional resources