Поставщик служб конфигурации EnterpriseDesktopAppManagement
Поставщик службы конфигурации EnterpriseDesktopAppManagement используется для обработки задач управления корпоративными классическими приложениями, таких как запрос установленных корпоративных приложений, установка приложений или удаление приложений.
Установка приложений может занять некоторое время, поэтому они выполняются асинхронно. После завершения команды Exec клиент может отправить на сервер управления универсальное оповещение с состоянием, независимо от того, сбой или успех. Пример SyncML см. в разделе Пример оповещения.
В следующем списке показаны узлы поставщика службы конфигурации EnterpriseDesktopAppManagement:
- ./Device/Vendor/MSFT/EnterpriseDesktopAppManagement
- ./User/Vendor/MSFT/EnterpriseDesktopAppManagement
Устройство или MSI
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI
Тип продукта — MSI.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Получите |
Device/MSI/{ProductID}
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}
Код продукта MSI для приложения.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Добавление, удаление, получение |
Атомарный обязательный | True |
Динамическое именование узлов | UniqueName: код продукта MSI для приложения. |
Device/MSI/{ProductID}/DownloadInstall
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/DownloadInstall
Выполняет скачивание и установку приложения. В Windows 10 версии 1703 в раздел XML был добавлен <Enforcement>
новый тег<DownloadFromAad>
. Значение по умолчанию — 0 (не отправлять маркер). Этот тег является необязательным и должен быть установлен в значение 1, если сервер хочет, чтобы URL-адрес для скачивания получить AADUserToken.
Вот пример.
<Enforcement>
<CommandLine>/quiet</CommandLine>
<TimeOut>5</TimeOut>
<RetryCount>3</RetryCount>
<RetryInterval>5</RetryInterval>
<DownloadFromAad>1</DownloadFromAad>
</Enforcement>
Дополнительные сведения см. в разделе DownloadInstall XSD Schema.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | xml |
Тип доступа | Add, Delete, Exec, Get, Replace |
Device/MSI/{ProductID}/InstallDate
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallDate
Дата установки приложения.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
Device/MSI/{ProductID}/InstallPath
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallPath
Путь установки приложения.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
Device/MSI/{ProductID}/LastError
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastError
Код последней ошибки во время установки приложения. Обычно он хранится в формате HRESULT. В зависимости от того, что происходило при возникновении ошибки, это может быть результатом выполнения MSIExec.exe или ошибкой api, который завершился сбоем.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | int |
Тип доступа | Получите |
Device/MSI/{ProductID}/LastErrorDesc
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastErrorDesc
Содержит описание последнего кода ошибки. Значение LastErrorDesc ищется для соответствующего значения LastError. Иногда не возвращается LastErrorDesc.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
Device/MSI/{ProductID}/Name
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Name
Имя приложения.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
Device/MSI/{ProductID}/Publisher
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Publisher
Издатель приложения.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
Device/MSI/{ProductID}/Status
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Status
Состояние приложения. Допустимые значения: 10-initialized, 20-Download In Progress, 25-Pending Download Retry, 30-DownloadEd, 40-Download Completed, 48-Pending User Session, 50-Enforcement In Progress, 55-Pending Enforcement Retry, 60-Enforcement Failed, 70-Принудительное выполнение завершено.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | int |
Тип доступа | Получите |
Device/MSI/{ProductID}/Version
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Version
Версия продукта MSI.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
Device/MSI/UpgradeCode
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1607 [10.0.14393] и более поздние |
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Получите |
С учетом регистра | True |
Device/MSI/UpgradeCode/{Guid}
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1607 [10.0.14393] и более поздние |
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode/{Guid}
Шлюз (или сервер управления устройствами) использует этот метод для обнаружения соответствующего обновления продукта MSI, когда Администратор хочет обновить существующее приложение MSI. Если установлен тот же продукт обновления, обновление разрешено.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
Динамическое именование узлов | ClientInventory |
Пользователь или MSI
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI
Тип продукта — MSI.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Получите |
User/MSI/{ProductID}
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}
Код продукта MSI для приложения.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Добавление, удаление, получение |
Атомарный обязательный | True |
Динамическое именование узлов | UniqueName: код продукта MSI для приложения. |
User/MSI/{ProductID}/DownloadInstall
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/DownloadInstall
Выполняет скачивание и установку приложения. В Windows 10 версии 1703 в раздел XML был добавлен <Enforcement>
новый тег<DownloadFromAad>
. Значение по умолчанию — 0 (не отправлять маркер). Этот тег является необязательным и должен быть установлен в значение 1, если сервер хочет, чтобы URL-адрес для скачивания получить AADUserToken.
Вот пример.
<Enforcement>
<CommandLine>/quiet</CommandLine>
<TimeOut>5</TimeOut>
<RetryCount>3</RetryCount>
<RetryInterval>5</RetryInterval>
<DownloadFromAad>1</DownloadFromAad>
</Enforcement>
Дополнительные сведения см. в разделе DownloadInstall XSD Schema.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | xml |
Тип доступа | Add, Delete, Exec, Get, Replace |
User/MSI/{ProductID}/InstallDate
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallDate
Дата установки приложения.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
User/MSI/{ProductID}/InstallPath
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallPath
Путь установки приложения.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
User/MSI/{ProductID}/LastError
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastError
Код последней ошибки во время установки приложения. Обычно он хранится в формате HRESULT. В зависимости от того, что происходило при возникновении ошибки, это может быть результатом выполнения MSIExec.exe или ошибкой api, который завершился сбоем.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | int |
Тип доступа | Получите |
User/MSI/{ProductID}/LastErrorDesc
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastErrorDesc
Содержит описание последнего кода ошибки. Значение LastErrorDesc ищется для соответствующего значения LastError. Иногда не возвращается LastErrorDesc.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
User/MSI/{ProductID}/Name
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Name
Имя приложения.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
User/MSI/{ProductID}/Publisher
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Publisher
Издатель приложения.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
User/MSI/{ProductID}/Status
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Status
Состояние приложения. Допустимые значения: 10-initialized, 20-Download In Progress, 25-Pending Download Retry, 30-DownloadEd, 40-Download Completed, 48-Pending User Session, 50-Enforcement In Progress, 55-Pending Enforcement Retry, 60-Enforcement Failed, 70-Принудительное выполнение завершено.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | int |
Тип доступа | Получите |
User/MSI/{ProductID}/Version
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1511 [10.0.10586] и более поздние версии |
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Version
Версия продукта MSI.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
User/MSI/UpgradeCode
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1607 [10.0.14393] и более поздние |
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Получите |
С учетом регистра | True |
User/MSI/UpgradeCode/{Guid}
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ✅ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows 10, версия 1607 [10.0.14393] и более поздние |
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode/{Guid}
Шлюз (или сервер управления устройствами) использует этот метод для обнаружения соответствующего обновления продукта MSI, когда Администратор хочет обновить существующее приложение MSI. Если установлен тот же продукт обновления, обновление разрешено.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
Динамическое именование узлов | ClientInventory |
DownloadInstall XSD Schema
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="Data">
<xs:complexType>
<xs:sequence>
<xs:element name="MsiInstallJob">
<xs:complexType>
<xs:sequence>
<xs:element name="Product">
<xs:complexType>
<xs:sequence>
<xs:element name="Download">
<xs:complexType>
<xs:sequence>
<xs:element name="ContentURLList">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ContentURL" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Validation">
<xs:complexType>
<xs:sequence>
<xs:element name="FileHash" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Enforcement">
<xs:complexType>
<xs:sequence>
<xs:element name="CommandLine" type="xs:string" />
<xs:element name="TimeOut" type="xs:unsignedByte" />
<xs:element name="RetryCount" type="xs:unsignedByte" />
<xs:element name="RetryInterval" type="xs:unsignedByte" />
<xs:element name="DownloadFromAad" type="xs:unsignedByte" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="Version" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Примеры:
SyncML для запроса сведений о версии CSP:
<SyncML xmlns="SYNCML:SYNCML1.1"> <SyncBody> <Get> <CmdID>12345</CmdID> <Item> <Target> <LocURI>./Device/Vendor/MSFT/EnterpriseDesktopAppManagement?prop=Type</LocURI> </Target> </Item> </Get> <Final/> </SyncBody> </SyncML>
В следующей таблице описаны поля в предыдущем примере.
Имя Описание Получите Выполняемая операция. Операция Get — это запрос на возврат сведений. CmdID Входное значение, используемое для ссылки на запрос. Ответы будут включать это значение, которое можно использовать для сопоставления запроса и ответа. LocURI Путь к обработчику команд CSP Win32. SyncML для выполнения операций MSI для удаления приложений:
<SyncML xmlns="SYNCML:SYNCML1.1"> <SyncBody> <Delete> <CmdID>12345</CmdID> <Item> <Target> <LocURI>./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C38-4D2B-9B9A-0CB37243539C%7D</LocURI> </Target> </Item> </Delete> <Final/> </SyncBody> </SyncML>
В следующей таблице описаны поля в предыдущем примере.
Имя Описание Delete Выполняемая операция. Операция Удаления — это запрос на удаление узла CSP, представляющего указанное установленное приложение MSI, а также на выполнение и удаление приложения в рамках процесса. CmdID Входное значение, используемое для ссылки на запрос. Ответы будут включать это значение, которое можно использовать для сопоставления запроса и ответа. LocURI Путь к обработчику команд Win32 CSP, включая свойство Product ID (в этом примере 1803A630-3C38-4D2B-9B9A-0CB37243539C), экранированное для форматирования XML. SyncML для выполнения операций MSI для отчетов о состоянии приложения:
<SyncML xmlns="SYNCML:SYNCML1.1"> <SyncBody> <Get> <CmdID>12345</CmdID> <Item> <Target> <LocURI>./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C38-4D2B-9B9A-0CB37243539C%7D</LocURI> </Target> </Item> </Get> <Final/> </SyncBody> </SyncML>
В следующей таблице описаны поля в предыдущем примере.
Имя Описание Получите Выполняемая операция. Операция Get — это запрос на сообщение о состоянии указанного установленного приложения MSI. CmdID Входное значение, используемое для ссылки на запрос. Ответы будут включать это значение, которое можно использовать для сопоставления запроса и ответа. LocURI Путь к обработчику команд Win32 CSP, включая свойство Product ID (в этом примере 1803A630-3C38-4D2B-9B9A-0CB37243539C), экранированное для форматирования XML. SyncML для выполнения операций установки MSI для приложения, предназначенного для определенного пользователя на устройстве. Команда Add должна предшествовать команде Exec.
<SyncML xmlns="SYNCML:SYNCML1.1"> <SyncBody> <Add> <CmdID>1</CmdID> <Item> <Target> <LocURI>./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C384D2B-9B9A-0CB37243539C%7D/DownloadInstall</LocURI> </Target> </Item> </Add> <Exec> <CmdID>6</CmdID> <Item> <Target> <LocURI>./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C38-4D2B-9B9A-0CB37243539C%7D/DownloadInstall</LocURI> </Target> <Meta> <Format xmlns="syncml:metinf">xml</Format> <Type xmlns="syncml:metinf">text/plain</Type> </Meta> <Data> <MsiInstallJob id="{9BD4F7CD-880A-40B5-B74C-1BEECB51E596}"> <Product Version="1.0.0"> <Download> <ContentURLList> <ContentURL> http://bcl-w2k12r2-vm/testapps/msi/reboot/reboot.msi </ContentURL> <ContentURL>https://dp2.com/packages/myApp.msi</ContentURL> </ContentURLList> </Download> <Validation> <FileHash>134D8F1F7C3C036DC3DCDA9F97515C8C7951DB154B73365C9C22962BD23E3EB3</FileHash> </Validation> <Enforcement> <CommandLine>/quiet</CommandLine> <TimeOut>5</TimeOut> <RetryCount>3</RetryCount> <RetryInterval>5</RetryInterval> </Enforcement> </Product> </MsiInstallJob> </Data> </Item> </Exec> <Final/> </SyncBody> </SyncML>
В следующей таблице описаны поля в предыдущем примере.
Имя Описание Add Это поле должно предшествовать команде Exec. - CmdID — входное значение, используемое для ссылки на запрос. Ответы включают это значение, которое можно использовать для сопоставления запроса и ответа.
- LocURI — путь к обработчику команд Win32 CSP, включая свойство Product ID (в этом примере 1803A630-3C38-4D2B-9B9A-0CB37243539C), экранированное для форматирования XML.
Exec Узел Exec содержит параметры и свойства, необходимые для поиска, скачивания, проверки и установки продукта. - CmdID — входное значение, используемое для ссылки на запрос. Ответы будут включать это значение, которое можно использовать для сопоставления запроса и ответа.
- LocURI — путь к обработчику команд Win32 CSP, включая свойство Product ID (в этом примере 1803A630-3C38-4D2B-9B9A-0CB37243539C), экранированное для форматирования XML.
- Данные— узел данных содержит внедренный XML-код типа MsiInstallJob.
- MsiInstallJob — содержит все сведения, необходимые для успешного скачивания, проверки и выполнения процесса установки MSI (дополнительные сведения об этом внедренном объекте данных см. в разделе в конце этого документа).
Примечание.
Сведения о состоянии задания MSI будут сообщаться с помощью стандартного механизма уведомлений OMA-DM. Сообщаемое состояние представлено с помощью стандартных кодов возврата MSIEXEC в виде HRESULT, как определено в разделе MSIEXEC в Microsoft TechNet в Msiexec (параметры командной строки).
SyncML для выполнения операций установки MSI для приложения, предназначенного для всех пользователей на устройстве (установка на каждом устройстве):
<SyncML xmlns="SYNCML:SYNCML1.1"> <SyncBody> <Add> <CmdID>1</CmdID> <Item> <Target> <LocURI>./Device /Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B6F7CB29F-1319-4816-B345-0856916EB801%7D/DownloadInstall </LocURI> </Target> </Item> </Add> <Exec> <CmdID>67890</CmdID> <Item> <Target> <LocURI>./Device /Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B6F7CB29F-1319-4816-B345-0856916EB801%7D/DownloadInstall</LocURI> </Target> <Meta> <Format xmlns="syncml:metinf">xml</Format> <Type xmlns="syncml:metinf">text/plain</Type> </Meta> <Data> <MsiInstallJob id="{9BD4F7CD-880A-40B5-B74C-1BEECB51E596}"> <Product Version="1.0.0"> <Download> <ContentURLList> <ContentURL>http://bcl-w2k12r2-vm/testapps/msi/Orca/Orca.msi</ContentURL> <ContentURL>https://dp2.com/packages/myApp.msi</ContentURL> </ContentURLList> </Download> <Validation> <FileHash>4525065777EF18B9444ABF71DD4B48E5F64F4F0E1E029995FB8DA441CDE4296E</FileHash> </Validation> <Enforcement> <CommandLine>/quiet</CommandLine> <TimeOut>5</TimeOut> <RetryCount>3</RetryCount> <RetryInterval>5</RetryInterval> </Enforcement> </Product> </MsiInstallJob> </Data> </Item> </Exec> <Final/> </SyncBody> </SyncML>
В следующей таблице MsiInstallJob описаны элементы схемы.
Элемент Описание MsiInstallJob корневой элемент
Атрибут: id — идентификатор устанавливаемого приложения.Продукт дочерний элемент MsiInstallJob
Атрибут: "Version" — строковое представление версии приложенияСкачать дочерний элемент Product. Контейнер для скачивания сведений о конфигурации. ContentURLList дочерний элемент элемента Download. Содержит список одного или нескольких указателей URL-адресов для скачивания содержимого в виде элементов ContentURL. ContentURL Содержимое расположения должно быть скачано по адресу. Должен быть URL-адресом в формате свойства, указывающим на файл .MSI. Проверки Содержит сведения, используемые для проверки подлинности утверждения. • FileHash — хэш-значение SHA256 содержимого файла FileHash Хэш-значение SHA256 для содержимого файла Принудительное применение свойства установки, используемые при установке этого MSI CommandLine Параметры командной строки, используемые при вызове MSIEXEC.exe Времени ожидания Количество времени (в минутах), в течение которых может быть запущен процесс установки, прежде чем установщик посчитает, что установка может завершиться сбоем и больше не будет отслеживать операцию установки. RetryCount Количество повторных попыток загрузки и установки, прежде чем установка будет помечена как сбой. RetryInterval Количество времени в минутах между операциями повтора. Ниже приведен пример общего ответа на запрос.
<?xml version="1.0" encoding="utf-16"?> <SyncML> <SyncHdr /> <SyncBody> <Status> <CmdID>12345</CmdID> <MsgRef>1</MsgRef> <CmdRef>0</CmdRef> <Cmd>SyncHdr</Cmd> <Data>200</Data> </Status> <Status> <CmdID>67890</CmdID> <MsgRef>1</MsgRef> <CmdRef>1</CmdRef> <Cmd>Add</Cmd> <Data>200</Data> </Status> <Final /> </SyncBody> </SyncML>
Определение контекста установки для пакета MSI
В следующих таблицах показано, как в клиенте устанавливаются целевые приложения и тип пакета MSI (на пользователя, на компьютер или в двойном режиме).
Для Intune автономной среды пакет MSI будет определять контекст выполнения MSI.
Target | MSI для каждого пользователя | MSI для каждого компьютера | MSI с двумя режимами |
---|---|---|---|
Пользователь | Установка MSI для каждого пользователя LocURI содержит префикс пользователя, например ./User |
Установка MSI для каждого устройства LocURI содержит префикс устройства, например ./Device |
Установка MSI для каждого пользователя LocURI содержит префикс пользователя, например ./User |
System | Установка MSI для каждого пользователя LocURI содержит префикс пользователя, например ./User |
Установка MSI для каждого устройства LocURI содержит префикс устройства, например ./Device |
Установка MSI для каждого пользователя LocURI содержит префикс пользователя, например ./User |
Следующая таблица относится к гибридной среде Configuration Manager:
Target | MSI для каждого пользователя | MSI для каждого компьютера | MSI с двумя режимами |
---|---|---|---|
Пользователь | Установка MSI для каждого пользователя LocURI содержит префикс пользователя, например ./User |
Установка MSI для каждого устройства LocURI содержит префикс устройства, например ./Device |
Установка MSI для каждого пользователя LocURI содержит префикс пользователя, например ./User |
System | Установка MSI для каждого пользователя LocURI содержит префикс пользователя, например ./User |
Установка MSI для каждого устройства LocURI содержит префикс устройства, например ./Device |
Установка контекста MSI для каждой системы LocURI содержит префикс устройства, например ./Device |
Определение типа пакета из пакета MSI
- ALLUSERS="" — тип пакета для каждого пользователя
- ALLUSERS=1 — тип пакета для каждого компьютера
- ALLUSERS=2, MSIINSTALLPERUSER=1 — тип пакета с двойным режимом
Свойства можно указать в пакете, передать через командную строку, изменить с помощью преобразования или (чаще всего) выбрать в диалоговом окне пользовательского интерфейса.
Ниже приведен список ссылок:
- Использование установщика Windows
- Создание одного пакета для контекста установки Per-User или Per-Machine в Windows 7
Пример оповещения
<Alert>
<CmdID>4</CmdID>
<Data>1224</Data>
<Item>
<Source>
<LocURI>./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{AF9257BA-6BBD-4624-AA9B-0182D50292C3}/DownloadInstall</LocURI>
</Source>
<Meta>
<Type xmlns="syncml:metinf">Reversed-Domain-Name:com.microsoft.mdm.win32csp_install</Type>
<Format xmlns="syncml:metinf">int</Format>
<Mark xmlns="syncml:metinf">informational</Mark>
</Meta>
<Data>0</Data>
</Item>
</Alert>