diff --git a/windows/client-management/mdm/images/provisioning-csp-update.png b/windows/client-management/mdm/images/provisioning-csp-update.png index d98b7fcea1..e88466a113 100644 Binary files a/windows/client-management/mdm/images/provisioning-csp-update.png and b/windows/client-management/mdm/images/provisioning-csp-update.png differ diff --git a/windows/client-management/mdm/new-in-windows-mdm-enrollment-management.md b/windows/client-management/mdm/new-in-windows-mdm-enrollment-management.md index 17ab0d9a6c..a55bdccdcb 100644 --- a/windows/client-management/mdm/new-in-windows-mdm-enrollment-management.md +++ b/windows/client-management/mdm/new-in-windows-mdm-enrollment-management.md @@ -1590,6 +1590,16 @@ The DM agent for [push-button reset](https://msdn.microsoft.com/windows/hardware [UEFI CSP](uefi-csp.md)

Added a new CSP in Windows 10, version 1803.

+ +[Update CSP](update-csp.md) +

Added the following nodes in Windows 10, version 1803:

+ + diff --git a/windows/client-management/mdm/update-csp.md b/windows/client-management/mdm/update-csp.md index 5e471e50ba..67de432346 100644 --- a/windows/client-management/mdm/update-csp.md +++ b/windows/client-management/mdm/update-csp.md @@ -7,7 +7,7 @@ ms.topic: article ms.prod: w10 ms.technology: windows author: nickbrower -ms.date: 06/26/2017 +ms.date: 02/23/2018 --- # Update CSP @@ -76,7 +76,7 @@ The following diagram shows the Update configuration service provider in tree fo

Supported operation is Get. **FailedUpdates/*Failed Update Guid*/RevisionNumber** -

Added in the Windows 10, version 1803. The revision number for the update that must be passed in server to server sync to get the metadata for the update. +

Added in Windows 10, version 1703. The revision number for the update that must be passed in server to server sync to get the metadata for the update.

Supported operation is Get. @@ -91,7 +91,7 @@ The following diagram shows the Update configuration service provider in tree fo

Supported operation is Get. **InstalledUpdates/*Installed Update Guid*/RevisionNumber** -

Added in Windows 10, version 1803. The revision number for the update that must be passed in server to server sync to get the metadata for the update. +

Added in Windows 10, version 1703. The revision number for the update that must be passed in server to server sync to get the metadata for the update.

Supported operation is Get. @@ -135,7 +135,7 @@ The following diagram shows the Update configuration service provider in tree fo

Supported operation is Get. **PendingRebootUpdates/*Pending Reboot Update Guid*/RevisionNumber** -

Added in Windows 10, version 1803. The revision number for the update that must be passed in server to server sync to get the metadata for the update. +

Added in Windows 10, version 1703. The revision number for the update that must be passed in server to server sync to get the metadata for the update.

Supported operation is Get. @@ -149,6 +149,38 @@ The following diagram shows the Update configuration service provider in tree fo

Supported operation is Get. +**Rollback** +Added in Windows 10, version 1803. Node for the rollback operations. + +**Rollback/QualityUpdate** +Added in Windows 10, version 1803. Roll back latest Quality Update, if the machine meets the following conditions: + +- Condition 1: Device must be Windows Update for Business Connected +- Condition 2: Device must be in a Paused State +- Condition 3: Device must have the Latest Quality Update installed on the device (Current State) + +If the conditions are not true, the device will not Roll Back the Latest Quality Update. + +**Rollback/FeatureUpdate** +Added in Windows 10, version 1803. Roll Back Latest Feature Update, if the machine meets the following conditions: + +- Condition 1: Device must be Windows Update for Business Connnected +- Condition 2: Device must be in Paused State +- Condition 3: Device must have the Latest Feature Update Installed on the device (Current State) +- Condition 4: Machine should be within the uninstall period + +> [!Note] +> This only works for Semi Annual Channel Targeted devices. + +If the conditions are not true, the device will not Roll Back the Latest Feature Update. + + +**Rollback/QualityUpdateStatus** +Added in Windows 10, version 1803. Returns the result of last RollBack QualityUpdate operation. + +**Rollback/FeatureUpdateStatus** +Added in Windows 10, version 1803. Returns the result of last RollBack FeatureUpdate operation. + ## Related topics [Configuration service provider reference](configuration-service-provider-reference.md) diff --git a/windows/client-management/mdm/update-ddf-file.md b/windows/client-management/mdm/update-ddf-file.md index 00056f6fc8..b628189e10 100644 --- a/windows/client-management/mdm/update-ddf-file.md +++ b/windows/client-management/mdm/update-ddf-file.md @@ -7,7 +7,7 @@ ms.topic: article ms.prod: w10 ms.technology: windows author: nickbrower -ms.date: 12/05/2017 +ms.date: 02/23/2018 --- # Update DDF file @@ -16,522 +16,643 @@ This topic shows the OMA DM device description framework (DDF) for the **Update* Looking for the DDF XML files? See [CSP DDF files download](configuration-service-provider-reference.md#csp-ddf-files-download). -The XML below is the current version for this CSP. +The XML below is for Windows 10, version 1803. ``` syntax ]> + "http://www.openmobilealliance.org/tech/DTD/DM_DDF-V1_2.dtd" + []> - 1.2 + 1.2 + + Update + ./Vendor/MSFT + + + + + + + + + + + + + + + com.microsoft/1.1/MDM/Update + + - Update - ./Vendor/MSFT + ApprovedUpdates + + + + + + + Approve of specific updates to be installed on a device and accept the EULA associated with the update on behalf of the end-user + + + + + + + + + + Approved Updates + + + + + + - - - - - - - - - - - - - - - + + + + UpdateID field of the UpdateIdentity is used to display relevant update metadata to IT and approved updates to be installed on the device + + + + + + + + + + Approved Update Guid + + + - ApprovedUpdates - - - - - - - Approve of specific updates to be installed on a device and accept the EULA associated with the update on behalf of the end-user - - - - - - - - - - Approved Updates - - - - - - - - - - - UpdateID field of the UpdateIdentity is used to display relevant update metadata to IT and approved updates to be installed on the device - - - - - - - - - - Approved Update Guid - - - - - - ApprovedTime - - - - - 0 - The time updates get approved - - - - - - - - - The time update get approved - - text/plain - - - - - - - FailedUpdates - - - - - Approved updates that failed to install on a device - - - - - - - - - - Failed Updates - - - - - - - - - - - UpdateID field of the UpdateIdentity GUID that represent an update that failed to install - - - - - - - - - - - - - Failed Update Guid - - - - - - HResult - - - - - 0 - Update failure error code - - - - - - - - - - HResult - - text/plain - - - - - Status - - - - - Update failure status - - - - - - - - - - - - - Failed update status - - text/plain - - - - - RevisionNumber - - - - - The revision number of the update - - - - - - - - - - Update's revision number - - text/plain - - - - - - - InstalledUpdates - - - - - Updates that are installed on the device - - - - - - - - - - Installed Updates - - - - - - - - - - - UpdateIDs that represent the updates installed on a device - - - - - - - - - - Installed Update Guid - - - - - - RevisionNumber - - - - - The revision number of the update - - - - - - - - - - Update's revision number - - text/plain - - - - - - - InstallableUpdates - - - - - Updates that are applicable and not yet installed on the device - - - - - - - - - - Installable Updates - - - - - - - - - - - UpdateIDs that represent the updates applicable and not installed on a device - - - - - - - - - - Installable Update Guid - - - - - - Type - - - - - - The UpdateClassification value of the update - Values: - 0 = None - 1 = Security - 2 = Critical - - - - - - - - - - - Type of update - - text/plain - - - - - RevisionNumber - - - - - The revision number of the update - - - - - - - - - - Update's revision number - - text/plain - - - - - - - PendingRebootUpdates - - - - - - - - - - - - - - - - - - - - - - - - Devices in the pending reboot state - - - - - - - - - - - - - Pending Reboot Update Guid - - - - - - InstalledTime - - - - - The time the update installed. - - - - - - - - - InstalledTime - - text/plain - - - - - RevisionNumber - - - - - The revision number of the update - - - - - - - - - - Update's revision number - - text/plain - - - - - - - LastSuccessfulScanTime - - - - - 0 - Last success scan time. - - - - - - - - - - - - LastSuccessfulScanTime - - text/plain - - - - - DeferUpgrade - - - - - 0 - Defer upgrades till the next upgrade period (at least a few months). - - - - - - - - - - - - - - text/plain - - + ApprovedTime + + + + + 0 + The time updates get approved + + + + + + + + + The time update get approved + + text/plain + + + + + FailedUpdates + + + + + Approved updates that failed to install on a device + + + + + + + + + + Failed Updates + + + + + + + + + + + UpdateID field of the UpdateIdentity GUID that represent an update that failed to install + + + + + + + + + + + + + Failed Update Guid + + + + + + HResult + + + + + 0 + Update failure error code + + + + + + + + + + HResult + + text/plain + + + + + Status + + + + + Update failure status + + + + + + + + + + + + + Failed update status + + text/plain + + + + + RevisionNumber + + + + + The revision number of the update + + + + + + + + + + Update's revision number + + text/plain + + + + + + + InstalledUpdates + + + + + Updates that are installed on the device + + + + + + + + + + Installed Updates + + + + + + + + + + + UpdateIDs that represent the updates installed on a device + + + + + + + + + + Installed Update Guid + + + + + + RevisionNumber + + + + + The revision number of the update + + + + + + + + + + Update's revision number + + text/plain + + + + + + + InstallableUpdates + + + + + Updates that are applicable and not yet installed on the device + + + + + + + + + + Installable Updates + + + + + + + + + + + UpdateIDs that represent the updates applicable and not installed on a device + + + + + + + + + + Installable Update Guid + + + + + + Type + + + + + + The UpdateClassification value of the update + Values: + 0 = None + 1 = Security + 2 = Critical + + + + + + + + + + + Type of update + + text/plain + + + + + RevisionNumber + + + + + The revision number of the update + + + + + + + + + + Update's revision number + + text/plain + + + + + + + PendingRebootUpdates + + + + + + + + + + + + + + + + + + + + + + + + Devices in the pending reboot state + + + + + + + + + + + + + Pending Reboot Update Guid + + + + + + InstalledTime + + + + + The time the update installed. + + + + + + + + + InstalledTime + + text/plain + + + + + RevisionNumber + + + + + The revision number of the update + + + + + + + + + + Update's revision number + + text/plain + + + + + + + LastSuccessfulScanTime + + + + + 0 + Last success scan time. + + + + + + + + + + + + LastSuccessfulScanTime + + text/plain + + + + + DeferUpgrade + + + + + 0 + Defer upgrades till the next upgrade period (at least a few months). + + + + + + + + + + + + + + text/plain + + + + + Rollback + + + + + + + + + + + + + + + + + + + QualityUpdate + + + + + + Roll back Latest Quality Update, if the machine meets the following conditions: + Condition 1: Device must be WUfB Connected + Condition 2: Device must be in a Paused State + Condition 3: Device must have the Latest Quality Update installed on the device (Current State) + If the conditions are not true, the device will not Roll Back the Latest Quality Update. + + + + + + + + + + + QualityUpdate + + text/plain + + + + + FeatureUpdate + + + + + + Roll Back Latest Feature Update, if the machine meets the following conditions: + Condition 1: Device must be WUfB Connnected + Condition 2: Device must be in Paused State + Condition 3: Device must have the Latest Feature Update Installed on the device (Current State) + Condition 4: Machine should be within the uninstall period + If the conditions are not true, the device will not Roll Back the Latest Feature Update. + + + + + + + + + + + FeatureUpdate + + text/plain + + + + + QualityUpdateStatus + + + + + Returns the result of last RollBack QualityUpdate opearation. + + + + + + + + + + QualityUpdateStatus + + text/plain + + + + + FeatureUpdateStatus + + + + + Returns the result of last RollBack FeatureUpdate opearation. + + + + + + + + + + FeatureUpdateStatus + + text/plain + + + + + ```