From bf9cf317e78a6d7f8269000b19cbec798f1ef9e1 Mon Sep 17 00:00:00 2001 From: Vinay Pamnani <37223378+vinaypamnani-msft@users.noreply.github.com> Date: Mon, 27 Feb 2023 15:41:45 -0500 Subject: [PATCH] EnterpriseDesktopAppManagement CSP --- .openpublishing.redirection.json | 5 + .../mdm/enterprisedesktopappmanagement-csp.md | 1633 ++++++++++++++--- ...enterprisedesktopappmanagement-ddf-file.md | 1076 +++++++---- windows/client-management/mdm/toc.yml | 4 +- 4 files changed, 2071 insertions(+), 647 deletions(-) diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 72f7b416ce..e104e625e8 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -20530,6 +20530,11 @@ "redirect_url": "/windows/client-management/mdm/vpnv2-csp#profilexml-xsd-schema", "redirect_document_id": true }, + { + "source_path": "windows/client-management/mdm/enterprisedesktopappmanagement2-xsd.md", + "redirect_url": "/windows/client-management/mdm/windows/enterprisedesktopappmanagement-csp#downloadinstall-xsd-schema", + "redirect_document_id": true + }, { "source_path": "education/windows/education-scenarios-store-for-business.md", "redirect_url": "/windows/resources", diff --git a/windows/client-management/mdm/enterprisedesktopappmanagement-csp.md b/windows/client-management/mdm/enterprisedesktopappmanagement-csp.md index 62e50eadd1..394eabf465 100644 --- a/windows/client-management/mdm/enterprisedesktopappmanagement-csp.md +++ b/windows/client-management/mdm/enterprisedesktopappmanagement-csp.md @@ -1,83 +1,163 @@ --- title: EnterpriseDesktopAppManagement CSP -description: Learn how the EnterpriseDesktopAppManagement CSP handles enterprise desktop application management tasks, such as installing or removing applications. -ms.assetid: 2BFF7491-BB01-41BA-9A22-AB209EE59FC5 -ms.reviewer: +description: Learn more about the EnterpriseDesktopAppManagement CSP. +author: vinaypamnani-msft manager: aaroncz ms.author: vinpa -ms.topic: article +ms.date: 02/27/2023 +ms.localizationpriority: medium ms.prod: windows-client ms.technology: itpro-manage -author: vinaypamnani-msft -ms.date: 07/11/2017 +ms.topic: reference --- + + + # EnterpriseDesktopAppManagement CSP -The table below shows the applicability of Windows: - -|Edition|Windows 10|Windows 11| -|--- |--- |--- | -|Home|No|No| -|Pro|Yes|Yes| -|Windows SE|No|Yes| -|Business|Yes|Yes| -|Enterprise|Yes|Yes| -|Education|Yes|Yes| - + + The EnterpriseDesktopAppManagement configuration service provider is used to handle enterprise desktop application management tasks, such as querying installed enterprise applications, installing applications, or removing applications. Application installations can take some time to complete, hence they're done asynchronously. When the Exec command is completed, the client can send a generic alert to the management server with a status, whether it's a failure or success. For a SyncML example, see [Alert example](#alert-example). + -The following example shows the EnterpriseDesktopAppManagement CSP in tree format. + +The following list shows the EnterpriseDesktopAppManagement configuration service provider nodes: +- ./Device/Vendor/MSFT/EnterpriseDesktopAppManagement + - [MSI](#devicemsi) + - [{ProductID}](#devicemsiproductid) + - [DownloadInstall](#devicemsiproductiddownloadinstall) + - [InstallDate](#devicemsiproductidinstalldate) + - [InstallPath](#devicemsiproductidinstallpath) + - [LastError](#devicemsiproductidlasterror) + - [LastErrorDesc](#devicemsiproductidlasterrordesc) + - [Name](#devicemsiproductidname) + - [Publisher](#devicemsiproductidpublisher) + - [Status](#devicemsiproductidstatus) + - [Version](#devicemsiproductidversion) + - [UpgradeCode](#devicemsiupgradecode) + - [{Guid}](#devicemsiupgradecodeguid) +- ./User/Vendor/MSFT/EnterpriseDesktopAppManagement + - [MSI](#usermsi) + - [{ProductID}](#usermsiproductid) + - [DownloadInstall](#usermsiproductiddownloadinstall) + - [InstallDate](#usermsiproductidinstalldate) + - [InstallPath](#usermsiproductidinstallpath) + - [LastError](#usermsiproductidlasterror) + - [LastErrorDesc](#usermsiproductidlasterrordesc) + - [Name](#usermsiproductidname) + - [Publisher](#usermsiproductidpublisher) + - [Status](#usermsiproductidstatus) + - [Version](#usermsiproductidversion) + - [UpgradeCode](#usermsiupgradecode) + - [{Guid}](#usermsiupgradecodeguid) + + + +## Device/MSI + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```Device +./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI ``` -./Device/Vendor/MSFT -EnterpriseDesktopAppManagement -----MSI ---------ProductID -------------Version -------------Name -------------Publisher -------------InstallPath -------------InstallDate -------------DownloadInstall -------------Status -------------LastError -------------LastErrorDesc ---------UpgradeCode -------------Guid + + + + +Product Type is MSI. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | node | +| Access Type | Get | + + + + + + + + + +### Device/MSI/{ProductID} + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```Device +./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID} ``` + -**./Device/Vendor/MSFT/EnterpriseDesktopAppManagement** -The root node for the EnterpriseDesktopAppManagement configuration service provider. - -**MSI** -Node for all settings. - -**MSI/***ProductID* + + The MSI product code for the application. + -**MSI/*ProductID*/Version** -Version number. Value type is string. Supported operation is Get. + + + -**MSI/*ProductID*/Name** -Name of the application. Value type is string. Supported operation is Get. + +**Description framework properties**: -**MSI/*ProductID*/Publisher** -Publisher of application. Value type is string. Supported operation is Get. +| Property name | Property value | +|:--|:--| +| Format | node | +| Access Type | Add, Delete, Get | +| Atomic Required | True | +| Dynamic Node Naming | UniqueName: The MSI product code for the application. | + -**MSI/*ProductID*/InstallPath** -Installation path of the application. Value type is string. Supported operation is Get. + + + -**MSI/*ProductID*/InstallDate** -Installation date of the application. Value type is string. Supported operation is Get. + -**MSI/*ProductID*/DownloadInstall** -Executes the download and installation of the application. Value type is string. Supported operations are Execute and Get. + +#### Device/MSI/{ProductID}/DownloadInstall -In Windows 10, version 1703 service release, a new tag \ was added to the \ section of the XML. The default value is 0 (don't send token). This tag is optional and needs to be set to 1 in case the server wants the download URL to get the AADUserToken. `` 0 will set the timeout to infinite. + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + +```Device +./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/DownloadInstall +``` + + + + +Executes the download and installation of the application. In Windows 10, version 1703 service release, a new tag `` was added to the `` section of the XML. The default value is 0 (do not send token). This tag is optional and needs to be set to 1 in case the server wants the download URL to get the AADUserToken. + + + + Here's an example: ```xml @@ -90,280 +170,1236 @@ Here's an example: ``` -**MSI/*ProductID*/Status** -Status of the application. Value type is string. Supported operation is Get. +For more information, see [DownloadInstall XSD Schema](#downloadinstall-xsd-schema). + -| Status | Value | -|---------------------------|-------| -| Initialized | 10 | -| Download In Progress | 20 | -| Pending Download Retry | 25 | -| Download Failed | 30 | -| Download Completed | 40 | -| Pending User Session | 48 | -| Enforcement In Progress | 50 | -| Pending Enforcement Retry | 55 | -| Enforcement Failed | 60 | -| Enforcement Completed | 70 | + +**Description framework properties**: -**MSI/*ProductID*/LastError** -The last error code during the application installation process. This error code is typically stored as an HRESULT format. Depending on what was occurring when the error happened, this error could be the result of executing MSIExec.exe or the error result from an API that failed. +| Property name | Property value | +|:--|:--| +| Format | xml | +| Access Type | Add, Delete, Exec, Get | + -Value type is string. Supported operation is Get. + + + -**MSI/*ProductID*/LastErrorDesc** -Contains the last error code description. The LastErrorDesc value is looked up for the matching LastError value. Sometimes there's no LastErrorDesc returned. + -Value type is string. Supported operation is Get. + +#### Device/MSI/{ProductID}/InstallDate -**MSI/UpgradeCode** -Added in the March service release of Windows 10, version 1607. + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + -**MSI/UpgradeCode/_Guid_** -Added in the March service release of Windows 10, version 1607. A gateway (or device management server) uses this method to detect matching upgrade MSI product when an administrator wants to update an existing MSI app. If the same upgrade product is installed, then the update is allowed. + +```Device +./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallDate +``` + -Value type is string. Supported operation is Get. + + +Installation date of the application. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | + + + + + + + + + +#### Device/MSI/{ProductID}/InstallPath + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```Device +./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallPath +``` + + + + +Installation path of the application. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | + + + + + + + + + +#### Device/MSI/{ProductID}/LastError + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```Device +./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastError +``` + + + + +The last error code during the application installation process. This is typically stored as an HRESULT format. Depending on what was occurring when the error happened, this could be the result of executing MSIExec.exe or the error result from an API that failed. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | int | +| Access Type | Get | + + + + + + + + + +#### Device/MSI/{ProductID}/LastErrorDesc + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```Device +./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastErrorDesc +``` + + + + +Contains the last error code description. The LastErrorDesc value is looked up for the matching LastError value. Sometimes there is no LastErrorDesc returned. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | + + + + + + + + + +#### Device/MSI/{ProductID}/Name + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```Device +./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Name +``` + + + + +Name of the application. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | + + + + + + + + + +#### Device/MSI/{ProductID}/Publisher + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```Device +./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Publisher +``` + + + + +Publisher of application. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | + + + + + + + + + +#### Device/MSI/{ProductID}/Status + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```Device +./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Status +``` + + + + +Status of the application. Valid values: 10-Initialized, 20-Download In Progress, 25-Pending Download Retry, 30-Download Failed, 40-Download Completed, 48-Pending User Session, 50-Enforcement In Progress, 55-Pending Enforcement Retry, 60-Enforcement Failed, 70-Enforcement Completed. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | int | +| Access Type | Get | + + + + + + + + + +#### Device/MSI/{ProductID}/Version + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```Device +./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Version +``` + + + + +MSI Product Version. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | + + + + + + + + + +### Device/MSI/UpgradeCode + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1607 [10.0.14393] and later | + + + +```Device +./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode +``` + + + + + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | node | +| Access Type | Get | +| Case Sensitive | True | + + + + + + + + + +#### Device/MSI/UpgradeCode/{Guid} + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1607 [10.0.14393] and later | + + + +```Device +./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode/{Guid} +``` + + + + +A gateway (or device management server) uses this method to detect matching upgrade MSI product when a Admin wants to update an existing MSI app. If the same upgrade product is installed, then the update is allowed. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | +| Dynamic Node Naming | ClientInventory | + + + + + + + + + +## User/MSI + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```User +./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI +``` + + + + +Product Type is MSI. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | node | +| Access Type | Get | + + + + + + + + + +### User/MSI/{ProductID} + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```User +./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID} +``` + + + + +The MSI product code for the application. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | node | +| Access Type | Add, Delete, Get | +| Atomic Required | True | +| Dynamic Node Naming | UniqueName: The MSI product code for the application. | + + + + + + + + + +#### User/MSI/{ProductID}/DownloadInstall + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```User +./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/DownloadInstall +``` + + + + +Executes the download and installation of the application. In Windows 10, version 1703 service release, a new tag `` was added to the `` section of the XML. The default value is 0 (do not send token). This tag is optional and needs to be set to 1 in case the server wants the download URL to get the AADUserToken. + + + + +Here's an example: + +```xml + + /quiet + 5 + 3 + 5 + 1 + +``` + +For more information, see [DownloadInstall XSD Schema](#downloadinstall-xsd-schema). + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | xml | +| Access Type | Add, Delete, Exec, Get | + + + + + + + + + +#### User/MSI/{ProductID}/InstallDate + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```User +./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallDate +``` + + + + +Installation date of the application. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | + + + + + + + + + +#### User/MSI/{ProductID}/InstallPath + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```User +./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallPath +``` + + + + +Installation path of the application. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | + + + + + + + + + +#### User/MSI/{ProductID}/LastError + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```User +./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastError +``` + + + + +The last error code during the application installation process. This is typically stored as an HRESULT format. Depending on what was occurring when the error happened, this could be the result of executing MSIExec.exe or the error result from an API that failed. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | int | +| Access Type | Get | + + + + + + + + + +#### User/MSI/{ProductID}/LastErrorDesc + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```User +./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastErrorDesc +``` + + + + +Contains the last error code description. The LastErrorDesc value is looked up for the matching LastError value. Sometimes there is no LastErrorDesc returned. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | + + + + + + + + + +#### User/MSI/{ProductID}/Name + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```User +./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Name +``` + + + + +Name of the application. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | + + + + + + + + + +#### User/MSI/{ProductID}/Publisher + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```User +./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Publisher +``` + + + + +Publisher of application. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | + + + + + + + + + +#### User/MSI/{ProductID}/Status + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```User +./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Status +``` + + + + +Status of the application. Valid values: 10-Initialized, 20-Download In Progress, 25-Pending Download Retry, 30-Download Failed, 40-Download Completed, 48-Pending User Session, 50-Enforcement In Progress, 55-Pending Enforcement Retry, 60-Enforcement Failed, 70-Enforcement Completed. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | int | +| Access Type | Get | + + + + + + + + + +#### User/MSI/{ProductID}/Version + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1511 [10.0.10586] and later | + + + +```User +./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Version +``` + + + + +MSI Product Version. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | + + + + + + + + + +### User/MSI/UpgradeCode + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1607 [10.0.14393] and later | + + + +```User +./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode +``` + + + + + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | node | +| Access Type | Get | +| Case Sensitive | True | + + + + + + + + + +#### User/MSI/UpgradeCode/{Guid} + + +| Scope | Editions | Applicable OS | +|:--|:--|:--| +| :heavy_check_mark: Device
:heavy_check_mark: User | :x: Home
:heavy_check_mark: Pro
:heavy_check_mark: Enterprise
:heavy_check_mark: Education
:heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1607 [10.0.14393] and later | + + + +```User +./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode/{Guid} +``` + + + + +A gateway (or device management server) uses this method to detect matching upgrade MSI product when a Admin wants to update an existing MSI app. If the same upgrade product is installed, then the update is allowed. + + + + + + + +**Description framework properties**: + +| Property name | Property value | +|:--|:--| +| Format | chr (string) | +| Access Type | Get | +| Dynamic Node Naming | ClientInventory | + + + + + + + + + + +## DownloadInstall XSD Schema + +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +``` ## Examples -**SyncML to request CSP version information** +- SyncML to request CSP version information: -```xml - - - - 12345 - - - ./Device/Vendor/MSFT/EnterpriseDesktopAppManagement?prop=Type - - - - - - -``` + ```xml + + + + 12345 + + + ./Device/Vendor/MSFT/EnterpriseDesktopAppManagement?prop=Type + + + + + + + ``` -The following table describes the fields in the previous sample: + The following table describes the fields in the previous sample: -| Name | Description | -|--------|-------------------------------------------------------------------------------------------------------------------------------| -| Get | Operation being performed. The Get operation is a request to return information. | -| CmdID | Input value used to reference the request. Responses will include this value that can be used to match request and response. | -| LocURI | Path to Win32 CSP command processor. | + | Name | Description | + |--------|------------------------------------------------------------------------------------------------------------------------------| + | Get | Operation being performed. The Get operation is a request to return information. | + | CmdID | Input value used to reference the request. Responses will include this value that can be used to match request and response. | + | LocURI | Path to Win32 CSP command processor. | -**SyncML to perform MSI operations for application uninstall:** +- SyncML to perform MSI operations for application uninstall: -```xml - - - - 12345 - - - ./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C38-4D2B-9B9A-0CB37243539C%7D - - - - - - -``` + ```xml + + + + 12345 + + + ./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C38-4D2B-9B9A-0CB37243539C%7D + + + + + + + ``` -The following table describes the fields in the previous sample: + The following table describes the fields in the previous sample: -| Name | Description | -|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Delete | Operation being performed. The Delete operation is a request to delete the CSP node that represents the specified MSI installed application and to perform and uninstall of the application as part of the process. | -| CmdID | Input value used to reference the request. Responses will include this value that can be used to match request and response. | -| LocURI | Path to Win32 CSP command processor, including the Product ID (in this example, 1803A630-3C38-4D2B-9B9A-0CB37243539C) property escaped for XML formatting. | + | Name | Description | + |--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| + | Delete | Operation being performed. The Delete operation is a request to delete the CSP node that represents the specified MSI installed application and to perform and uninstall of the application as part of the process. | + | CmdID | Input value used to reference the request. Responses will include this value that can be used to match request and response. | + | LocURI | Path to Win32 CSP command processor, including the Product ID (in this example, 1803A630-3C38-4D2B-9B9A-0CB37243539C) property escaped for XML formatting. | +- SyncML to perform MSI operations for application status reporting: + ```xml + + + + 12345 + + + ./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C38-4D2B-9B9A-0CB37243539C%7D + + + + + + + ``` -**SyncML to perform MSI operations for application status reporting** + The following table describes the fields in the previous sample: -```xml - - - - 12345 - - - ./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C38-4D2B-9B9A-0CB37243539C%7D - - - - - - -``` + | Name | Description | + |--------|------------------------------------------------------------------------------------------------------------------------------------------------------------| + | Get | Operation being performed. The Get operation is a request to report the status of the specified MSI installed application. | + | CmdID | Input value used to reference the request. Responses will include this value that can be used to match request and response. | + | LocURI | Path to Win32 CSP command processor, including the Product ID (in this example, 1803A630-3C38-4D2B-9B9A-0CB37243539C) property escaped for XML formatting. | -The following table describes the fields in the previous sample: +- SyncML to perform MSI install operations for an application targeted to a specific user on the device. The Add command is required to precede the Exec command. -| Name | Description | -|--------|-----------------------| -| Get | Operation being performed. The Get operation is a request to report the status of the specified MSI installed application.| -| CmdID | Input value used to reference the request. Responses will include this value that can be used to match request and response. | -| LocURI | Path to Win32 CSP command processor, including the Product ID (in this example, 1803A630-3C38-4D2B-9B9A-0CB37243539C) property escaped for XML formatting. | + ```xml + + + + 1 + + + ./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C384D2B-9B9A-0CB37243539C%7D/DownloadInstall + + + + + 6 + + + ./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C38-4D2B-9B9A-0CB37243539C%7D/DownloadInstall + + + xml + text/plain + + + + + + + + http://bcl-w2k12r2-vm/testapps/msi/reboot/reboot.msi + + https://dp2.com/packages/myApp.msi + + + + 134D8F1F7C3C036DC3DCDA9F97515C8C7951DB154B73365C9C22962BD23E3EB3 + + + /quiet + 5 + 3 + 5 + + + + + + + + + + ``` -**SyncML to perform MSI install operations for an application targeted to a specific user on the device. The Add command is required to precede the Exec command.** + The following table describes the fields in the previous sample: -```xml - - - - 1 - - - ./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C384D2B-9B9A-0CB37243539C%7D/DownloadInstall - - - - - 6 - - - ./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C38-4D2B-9B9A-0CB37243539C%7D/DownloadInstall - - - xml - text/plain - - - - - - - - http://bcl-w2k12r2-vm/testapps/msi/reboot/reboot.msi - - https://dp2.com/packages/myApp.msi - - - -134D8F1F7C3C036DC3DCDA9F97515C8C7951DB154B73365C9C22962BD23E3EB3 - - - /quiet - 5 - 3 - 5 - - - - - - - - - -``` + |Name|Description| + |--- |--- | + |Add|This field is required to precede the Exec command.
  • CmdID - Input value used to reference the request. Responses include this value, which can be used to match the request and response.
  • LocURI - Path to Win32 CSP command processor, including the Product ID (in this example, 1803A630-3C38-4D2B-9B9A-0CB37243539C) property escaped for XML formatting.| + |Exec|The Exec node includes the parameters and properties requires to locate, download, validate and perform product installation.
  • CmdID - Input value used to reference the request. Responses will include this value that can be used to match request and response.
  • LocURI - Path to Win32 CSP command processor, including the Product ID (in this example, 1803A630-3C38-4D2B-9B9A-0CB37243539C) property escaped for XML formatting.
  • Data - The Data node contains an embedded XML, of type “MsiInstallJob”
  • MsiInstallJob - Contains all information required for the successful download, validation and execution of the MSI installation process (see section at the end of this document for details on this embedded data object).| -The following table describes the fields in the previous sample: + > [!NOTE] + > Information status on the MSI job will be reported using standard OMA-DM notification mechanism. The status reported is represented using standard MSIEXEC return codes as HRESULT as defined in the MSIEXEC topic on Microsoft TechNet at [Msiexec (command-line options)](https://technet.microsoft.com/library/cc759262%28v=ws.10%29.aspx). -|Name|Description| -|--- |--- | -|Add|This field is required to precede the Exec command.
  • CmdID - Input value used to reference the request. Responses include this value, which can be used to match the request and response.
  • LocURI - Path to Win32 CSP command processor, including the Product ID (in this example, 1803A630-3C38-4D2B-9B9A-0CB37243539C) property escaped for XML formatting.| -|Exec|The Exec node includes the parameters and properties requires to locate, download, validate and perform product installation.
  • CmdID - Input value used to reference the request. Responses will include this value that can be used to match request and response.
  • LocURI - Path to Win32 CSP command processor, including the Product ID (in this example, 1803A630-3C38-4D2B-9B9A-0CB37243539C) property escaped for XML formatting.
  • Data - The Data node contains an embedded XML, of type “MsiInstallJob”
  • MsiInstallJob - Contains all information required for the successful download, validation and execution of the MSI installation process (see section at the end of this document for details on this embedded data object).| - +- SyncML to perform MSI install operations for an application targeted to all users on the device (per-device installation): -> [!Note] -> Information status on the MSI job will be reported using standard OMA-DM notification mechanism. The status reported is represented using standard MSIEXEC return codes as HRESULT as defined in the MSIEXEC topic on Microsoft TechNet at [Msiexec (command-line options)](https://technet.microsoft.com/library/cc759262%28v=ws.10%29.aspx). + ```xml + + + + 1 + + + ./Device /Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B6F7CB29F-1319-4816-B345-0856916EB801%7D/DownloadInstall + + + + + + 67890 + + + ./Device /Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B6F7CB29F-1319-4816-B345-0856916EB801%7D/DownloadInstall + + + xml + text/plain + + + + + + + http://bcl-w2k12r2-vm/testapps/msi/Orca/Orca.msi + https://dp2.com/packages/myApp.msi + + + + 4525065777EF18B9444ABF71DD4B48E5F64F4F0E1E029995FB8DA441CDE4296E + + + /quiet + 5 + 3 + 5 + + + + + + + + + + ``` -**SyncML to perform MSI install operations for an application targeted to all users on the device (per-device installation):** + The following table MsiInstallJob describes the schema elements. -```xml - - - - 1 - - - ./Device /Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B6F7CB29F-1319-4816-B345-0856916EB801%7D/DownloadInstall - - - - - - 67890 - - - ./Device /Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B6F7CB29F-1319-4816-B345-0856916EB801%7D/DownloadInstall - - - xml - text/plain - - - - - - - http://bcl-w2k12r2-vm/testapps/msi/Orca/Orca.msi - https://dp2.com/packages/myApp.msi - - - - 4525065777EF18B9444ABF71DD4B48E5F64F4F0E1E029995FB8DA441CDE4296E - - - /quiet - 5 - 3 - 5 - - - - - - - - - -``` + | Element | Description | + |-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| + | MsiInstallJob | root element
    Attribute: "id" - the application identifier of the application being installed | + | Product | child element of MsiInstallJob
    Attribute: "Version" - string representation of application version | + | Download | child element of Product. Container for download configuration information. | + | ContentURLList | child element of Download. Contains list of one or more content download URL locators in the form of ContentURL elements. | + | ContentURL | Location content should be downloaded from. Must be a property formatted URL that points to the .MSI file. | + | Validation | Contains information used to validate contend authenticity. • FileHash - SHA256 hash value of file content | + | FileHash | SHA256 hash value of file content | + | Enforcement | installation properties to be used when installing this MSI | + | CommandLine | Command-line options to be used when calling MSIEXEC.exe | + | TimeOut | Amount of time, in minutes that the installation process can run before the installer considers the installation may have failed and no longer monitors the installation operation. | + | RetryCount | The number of times the download and installation operation will be retried before the installation will be marked as failed. | + | RetryInterval | Amount of time, in minutes between retry operations. | -The following table MsiInstallJob describes the schema elements. + Here's an example of a common response to a request -|Element|Description| -|--- |--- | -|MsiInstallJob|root element
    Attribute: "id" - the application identifier of the application being installed| -|Product|child element of MsiInstallJob
    Attribute: “Version” – string representation of application version| -|Download|child element of Product. Container for download configuration information.| -|ContentURLList|child element of Download. Contains list of one or more content download URL locators in the form of ContentURL elements.| -|ContentURL|Location content should be downloaded from. Must be a property formatted URL that points to the .MSI file.| -|Validation|Contains information used to validate contend authenticity. • FileHash – SHA256 hash value of file content| -|FileHash|SHA256 hash value of file content| -|Enforcement|installation properties to be used when installing this MSI| -|CommandLine|Command-line options to be used when calling MSIEXEC.exe| -|TimeOut|Amount of time, in minutes that the installation process can run before the installer considers the installation may have failed and no longer monitors the installation operation.| -|RetryCount|The number of times the download and installation operation will be retried before the installation will be marked as failed.| -|RetryInterval|Amount of time, in minutes between retry operations.| - -Here's an example of a common response to a request - -```xml - - - - - - 12345 - 1 - 0 - SyncHdr - 200 - - - 67890 - 1 - 1 - Add - 200 - - - - -``` + ```xml + + + + + + 12345 + 1 + 0 + SyncHdr + 200 + + + 67890 + 1 + 1 + Add + 200 + + + + + ``` ## How to determine which installation context to use for an MSI package @@ -395,7 +1431,6 @@ Here's a list of references: - [Using Windows Installer](/previous-versions/windows/it-pro/windows-server-2003/cc782896(v=ws.10)) - [Authoring a single package for Per-User or Per-Machine Installation context in Windows 7](https://blogs.msdn.com/b/windows_installer_team/archive/2009/09/02/authoring-a-single-package-for-per-user-or-per-machine-installation-context-in-windows-7.aspx) -- SyncML Representation Protocol, Draft Version 1.3 - 27 Aug 2009 (OMA-TS-SyncML\_RepPro-V1\_3-20090827-D) ## Alert example @@ -416,6 +1451,10 @@ Here's a list of references: ``` -## Related topics + -[Configuration service provider reference](index.yml) \ No newline at end of file + + +## Related articles + +[Configuration service provider reference](configuration-service-provider-reference.md) diff --git a/windows/client-management/mdm/enterprisedesktopappmanagement-ddf-file.md b/windows/client-management/mdm/enterprisedesktopappmanagement-ddf-file.md index 0a13970546..788f6427ae 100644 --- a/windows/client-management/mdm/enterprisedesktopappmanagement-ddf-file.md +++ b/windows/client-management/mdm/enterprisedesktopappmanagement-ddf-file.md @@ -1,370 +1,752 @@ --- -title: EnterpriseDesktopAppManagement DDF -description: This topic shows the OMA DM device description framework (DDF) for the EnterpriseDesktopAppManagement configuration service provider. -ms.reviewer: +title: EnterpriseDesktopAppManagement DDF file +description: View the XML file containing the device description framework (DDF) for the EnterpriseDesktopAppManagement configuration service provider. +author: vinaypamnani-msft manager: aaroncz ms.author: vinpa -ms.topic: article +ms.date: 02/27/2023 +ms.localizationpriority: medium ms.prod: windows-client ms.technology: itpro-manage -author: vinaypamnani-msft -ms.date: 06/26/2017 +ms.topic: reference --- -# EnterpriseDesktopAppManagement DDF + -This topic shows the OMA DM device description framework (DDF) for the **EnterpriseDesktopAppManagement** configuration service provider. +# EnterpriseDesktopAppManagement DDF file -DDF files are used only with OMA DM provisioning XML. +The following XML file contains the device description framework (DDF) for the EnterpriseDesktopAppManagement configuration service provider. ```xml -]> +]> - 1.2 + 1.2 + + + + EnterpriseDesktopAppManagement + ./User/Vendor/MSFT + + + + + The root node for the EnterpriseDesktopAppManagement configuration service provider. + + + + + + + + + + + + + + 10.0.10586 + 1.0 + 0x4;0x1B;0x30;0x31;0x48;0x54;0x77;0x79;0x7A;0x7D;0x7E;0x81;0x82;0x8A;0x8B;0xA1;0xA2;0xA4;0xA5;0xAB;0xAC;0xAF;0xB4;0xBC;0xBF;0xCA;0xCB;0xCD; + + - EnterpriseDesktopAppManagement - ./Device/Vendor/MSFT + MSI + + + + + Product Type is MSI + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - com.microsoft/1.0/MDM/EnterpriseDesktopAppManagement - + + + + + + The MSI product code for the application. + + + + + + + + + + ProductID + + + + + + + + The MSI product code for the application. + + - MSI - - - - - Product Type is MSI - - - - - - - - - - - - - - - - - - - - - - - - - MSI product code for Threshold - - - - - - - - - - - - - ProductID - - - - - - Version - - - - - MSI Product Version - - - - - - - - - - - - - - text/plain - - - - - Name - - - - - - - - - - - - - - - - - - text/plain - - - - - Publisher - - - - - - - - - - - - - - - - - - text/plain - - - - - InstallPath - - - - - - - - - - - - - - - - - - text/plain - - - - - InstallDate - - - - - - - - - - - - - - - - - - text/plain - - - - - DownloadInstall - - - - - - - - Method to download and install an MSI app - - - - - - - - - - - - - - text/plain - - - - - Status - - - - - - - - - - - - - - - - - - text/plain - - - - - LastError - - - - - - - - - - - - - - - - - - text/plain - - - - - LastErrorDesc - - - - - - - - - - - - - - - - - - text/plain - - - - - - UpgradeCode - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Guid - - text/plain - - - - + Version + + + + + MSI Product Version + + + + + + + + + + + + + + + + + + Name + + + + + Name of the application. + + + + + + + + + + + + + + + + + + + Publisher + + + + + Publisher of application. + + + + + + + + + + + + + + + + + + + InstallPath + + + + + Installation path of the application. + + + + + + + + + + + + + + + + + + + InstallDate + + + + + Installation date of the application. + + + + + + + + + + + + + + + + + + + DownloadInstall + + + + + + + + was added to the section of the XML. The default value is 0 (do not send token). This tag is optional and needs to be set to 1 in case the server wants the download URL to get the AADUserToken.]]> + + + + + + + + + + + + + + + + + + + + + Status + + + + + Status of the application. Valid values: 10-Initialized, 20-Download In Progress, 25-Pending Download Retry, 30-Download Failed, 40-Download Completed, 48-Pending User Session, 50-Enforcement In Progress, 55-Pending Enforcement Retry, 60-Enforcement Failed, 70-Enforcement Completed + + + + + + + + + + + + + + + + + + + LastError + + + + + The last error code during the application installation process. This is typically stored as an HRESULT format. Depending on what was occurring when the error happened, this could be the result of executing MSIExec.exe or the error result from an API that failed. + + + + + + + + + + + + + + + + + + + LastErrorDesc + + + + + Contains the last error code description. The LastErrorDesc value is looked up for the matching LastError value. Sometimes there is no LastErrorDesc returned. + + + + + + + + + + + + + + + + + + + + UpgradeCode + + + + + + + + + + + + + + + + + + + + + 10.0.14393 + 1.0 + + + + + + + + + + A gateway (or device management server) uses this method to detect matching upgrade MSI product when a Admin wants to update an existing MSI app. If the same upgrade product is installed, then the update is allowed. + + + + + + + + + + Guid + + + + + + + + + + + + + + + EnterpriseDesktopAppManagement + ./Device/Vendor/MSFT + + + + + The root node for the EnterpriseDesktopAppManagement configuration service provider. + + + + + + + + + + + + + + 10.0.10586 + 1.0 + 0x4;0x1B;0x30;0x31;0x48;0x54;0x77;0x79;0x7A;0x7D;0x7E;0x81;0x82;0x8A;0x8B;0xA1;0xA2;0xA4;0xA5;0xAB;0xAC;0xAF;0xB4;0xBC;0xBF;0xCA;0xCB;0xCD; + + + + MSI + + + + + Product Type is MSI + + + + + + + + + + + + + + + + + + + + + + + + + + The MSI product code for the application. + + + + + + + + + + ProductID + + + + + + + + The MSI product code for the application. + + + + + Version + + + + + MSI Product Version + + + + + + + + + + + + + + + + + + + Name + + + + + Name of the application. + + + + + + + + + + + + + + + + + + + Publisher + + + + + Publisher of application. + + + + + + + + + + + + + + + + + + + InstallPath + + + + + Installation path of the application. + + + + + + + + + + + + + + + + + + + InstallDate + + + + + Installation date of the application. + + + + + + + + + + + + + + + + + + + DownloadInstall + + + + + + + + was added to the section of the XML. The default value is 0 (do not send token). This tag is optional and needs to be set to 1 in case the server wants the download URL to get the AADUserToken.]]> + + + + + + + + + + + + + + + + + + + + + Status + + + + + Status of the application. Valid values: 10-Initialized, 20-Download In Progress, 25-Pending Download Retry, 30-Download Failed, 40-Download Completed, 48-Pending User Session, 50-Enforcement In Progress, 55-Pending Enforcement Retry, 60-Enforcement Failed, 70-Enforcement Completed + + + + + + + + + + + + + + + + + + + LastError + + + + + The last error code during the application installation process. This is typically stored as an HRESULT format. Depending on what was occurring when the error happened, this could be the result of executing MSIExec.exe or the error result from an API that failed. + + + + + + + + + + + + + + + + + + + LastErrorDesc + + + + + Contains the last error code description. The LastErrorDesc value is looked up for the matching LastError value. Sometimes there is no LastErrorDesc returned. + + + + + + + + + + + + + + + + + + + + UpgradeCode + + + + + + + + + + + + + + + + + + + + + 10.0.14393 + 1.0 + + + + + + + + + + A gateway (or device management server) uses this method to detect matching upgrade MSI product when a Admin wants to update an existing MSI app. If the same upgrade product is installed, then the update is allowed. + + + + + + + + + + Guid + + + + + + + + + + + + + + - ``` -  - -  - - - - - +## Related articles +[EnterpriseDesktopAppManagement configuration service provider reference](enterprisedesktopappmanagement-csp.md) diff --git a/windows/client-management/mdm/toc.yml b/windows/client-management/mdm/toc.yml index 5f76856695..f664d78079 100644 --- a/windows/client-management/mdm/toc.yml +++ b/windows/client-management/mdm/toc.yml @@ -738,10 +738,8 @@ items: - name: EnterpriseDesktopAppManagement href: enterprisedesktopappmanagement-csp.md items: - - name: EnterpriseDesktopAppManagement DDF + - name: EnterpriseDesktopAppManagement DDF file href: enterprisedesktopappmanagement-ddf-file.md - - name: EnterpriseDesktopAppManagement XSD - href: enterprisedesktopappmanagement2-xsd.md - name: EnterpriseModernAppManagement href: enterprisemodernappmanagement-csp.md items: