DeclaredConfiguration CSP
Важно.
Этот CSP содержит некоторые параметры, находящиеся в стадии разработки и применимые только для сборок Windows Insider Preview. Эти параметры могут изменяться и зависеть от других функций или служб в предварительной версии.
Основная модель MDM — это модель, в которой сервер MDM несет полную ответственность за оркестрацию и непрерывное обслуживание состояния устройства для сценариев конфигурации. Это приводит к интенсивному сетевому трафику и высокой задержке сети из-за синхронной модели конфигурации, основанной на стандарте OMA-DM Syncml. Он также подвержен ошибкам, учитывая, что сервер нуждается в глубоких знаниях о клиенте.
Модель управления устройствами объявленной конфигурации требует, чтобы сервер доставлял на устройство все значения параметров для конфигурации сценария. Сервер отправляет их асинхронно пакетами через объявленную клиентом конфигурацию CSP.
Во время сеанса OMA-DM, инициированного клиентом, объявленный сервер конфигурации отправляет клиенту документ конфигурации или объявленный документ конфигурации с помощью URI CSP объявленной конфигурации. Если устройство проверяет правильность синтаксиса документа, клиентский стек отправляет запрос в оркестратор для асинхронной обработки запроса. Затем клиентский стек завершает работу и возвращает управление обратно в объявленную службу конфигурации. Это поведение позволяет устройству асинхронно обрабатывать запрос.
Если какие-либо запросы находятся в процессе или завершены, клиент отправляет на сервер универсальное оповещение . Это оповещение суммирует состояние, состояние и ход выполнения каждого документа. Каждый https-запрос клиента к объявленному серверу конфигурации OMA-DM включает эту сводку.
Объявленный сервер конфигурации использует универсальное оповещение, чтобы определить, какие запросы успешно завершены или с ошибками. Затем сервер может синхронно получить результаты процесса объявленного документа конфигурации с помощью URI CSP объявленной конфигурации.
В следующем списке показаны узлы поставщика службы конфигурации DeclaredConfiguration:
- ./Device/Vendor/MSFT/DeclaredConfiguration
Host
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host
Внутренний узел узла указывает, что целевым объектом запроса конфигурации или запроса на инвентаризацию является ОС узла. Этот узел предназначен для область на случай, если анклавы когда-либо предназначены для настройки.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Добавление, удаление, получение |
Host/Complete
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete
Этот внутренний узел указывает, что конфигурация имеет дискретные значения параметров и является автономной с полными парами параметров и значений, которые не содержат заполнителей, которые необходимо устранить позже с дополнительными данными. Запрос готов к обработке как есть.
Поток от сервера к клиенту запроса Complete совпадает с запросом инвентаризации .
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Добавление, удаление, получение |
Host/Complete/Documents
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents
Узел Документы указывает, что конфигурация имеет форму документа, который представляет собой коллекцию параметров, используемых для настройки сценария стеком объявленной конфигурации.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Добавление, удаление, получение |
Host/Complete/Documents/{DocID}
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/{DocID}
Уникально идентифицирует документ конфигурации. Ни один другой документ не может иметь этот идентификатор. Идентификатор должен быть идентификатором GUID.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Добавление, удаление, получение |
Динамическое именование узлов | ServerGeneratedUniqueIdentifier |
Допустимые значения | Регулярное выражение: [0-9A-Fa-f]{8}\-[0-9A-Fa-f]{4}\-[0-9A-Fa-f]{4}\-[0-9A-Fa-f]{4}\-[0-9A-Fa-f]{12} |
Host/Complete/Documents/{DocID}/Document
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/{DocID}/Document
Значение узла Document — это xml-документ, содержащий коллекцию параметров и значений для настройки указанного сценария. Стек объявленной конфигурации проверяет синтаксис документа. Стек помечает документ для асинхронной обработки клиентом. Затем стек возвращает управление обратно в службу OMA-DM. Стек, в свою очередь, асинхронно обрабатывает запрос. Ниже приведен пример указанной требуемой конфигурации состояния с помощью URI объявленной конфигурации ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/27FEA311-68. B9-4320-9. FC4-296. F6FDFAFE2/Document.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Добавить, удалить, получить, заменить |
Host/Complete/Documents/{DocID}/Properties
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/{DocID}/Properties
Узел Свойства инкапсулирует список свойств, которые применяются к указанному документу, на который ссылается [DocID].
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Добавление, удаление, получение |
Host/Complete/Documents/{DocID}/Properties/Abandoned
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/{DocID}/Properties/Abandoned
Заброшенный узел позволяет серверу OMA-DM указать, что документ больше не управляется.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | int |
Тип доступа | Добавить, удалить, получить, заменить |
Значение по умолчанию | 0 |
Допустимые значения:
Значение | Описание |
---|---|
0 (по умолчанию) | Документ больше не управляется. |
1 | Документ управляется. |
Узел,Завершение/Результаты
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Results
Узел Результаты указывает, что это часть пути URI, который возвращает XML-документ, содержащий результаты запроса конфигурации.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Получите |
Host/Complete/Results/{DocID}
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Results/{DocID}
Уникально определяет документ конфигурации, в котором будут возвращены результаты запроса конфигурации.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Получите |
Динамическое именование узлов | ClientInventory |
Host/Complete/Results/{DocID}/Document
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Results/{DocID}/Document
Значение узла Document — это xml-документ, содержащий коллекцию результатов настройки из запроса конфигурации, указанного [DocId].
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
Узел или инвентаризация
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory
Внутренний узел Инвентаризация указывает, что это запрос на инвентаризацию. Извлекаемые значения параметров указываются в XML-документе через конечный узел документа.
Поток запроса инвентаризации между сервером и клиентом совпадает с запросом Complete .
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Добавление, удаление, получение |
Узел,Инвентаризация/Документы
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents
Узел Документы указывает, что запрос на инвентаризацию имеет форму документа, который представляет собой коллекцию параметров, используемых для получения их значений.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Добавление, удаление, получение |
Host/Inventory/Documents/{DocID}
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents/{DocID}
Уникально идентифицирует документ инвентаризации. Ни один другой документ не может иметь этот идентификатор. Идентификатор должен быть идентификатором GUID.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Добавление, удаление, получение |
Динамическое именование узлов | ServerGeneratedUniqueIdentifier |
Допустимые значения | Регулярное выражение: [0-9A-Fa-f]{8}\-[0-9A-Fa-f]{4}\-[0-9A-Fa-f]{4}\-[0-9A-Fa-f]{4}\-[0-9A-Fa-f]{12} |
Host/Inventory/Documents/{DocID}/Document
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents/{DocID}/Document
Значение узла документа — это xml-документ, содержащий коллекцию параметров, которые будут использоваться для получения их значений. Стек объявленной конфигурации проверяет синтаксис документа. Стек помечает документ для асинхронной обработки клиентом. Затем стек возвращает управление обратно в службу OMA-DM. Стек, в свою очередь, асинхронно обрабатывает запрос. Ниже приведен пример указанной требуемой конфигурации состояния с помощью URI объявленной конфигурации ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents/27FEA311-68. B9-4320-9. FC4-296. F6FDFAFE2/Document.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Добавить, удалить, получить, заменить |
Узел,Инвентаризация/Результаты
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Results
Узел Результаты указывает, что это часть пути URI, который возвращает XML-документ, содержащий результаты запроса инвентаризации.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Получите |
Host/Inventory/Results/{DocID}
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Results/{DocID}
Уникально идентифицирует документ инвентаризации. Ни один другой документ не может иметь этот идентификатор. Идентификатор должен быть идентификатором GUID.
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат | node |
Тип доступа | Получите |
Динамическое именование узлов | ClientInventory |
Host/Inventory/Results/{DocID}/Document
Область применения | Выпуски | Применимая ОС |
---|---|---|
Устройство ✅ Пользователь ❌ |
✅ Pro ✅ Enterprise ✅ для образования ✅ Windows SE ✅ IIoT Enterprise или IoT Enterprise LTSC |
✅Windows Insider Preview |
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Results/{DocID}/Document
Значение узла документа — это xml-документ, содержащий коллекцию результатов настройки из запроса инвентаризации, указанного [DocId].
Описание свойств инфраструктуры:
Имя свойства | Значение свойства |
---|---|
Формат |
chr (строка) |
Тип доступа | Получите |
URI OMA объявленной конфигурации
Объявленный запрос конфигурации отправляется с помощью OMA-URI, аналогичного ./Device/Vendor/MSFT/DeclaredConfiguration/Host/[Complete|Inventory]/Documents/{DocID}/Document
.
- Универсальный код ресурса (URI) имеет префикс целевой область. Целевой объект параметров сценария может быть только на уровне устройства для расширяемости. Область должен иметь значение
Device
. -
{DocID}
— это уникальный идентификатор для требуемого состояния сценария конфигурации. Каждый документ должен иметь идентификатор, который должен быть ИДЕНТИФИКАТОРом GUID. - Запрос может быть конфигурацией, инвентаризацией или полным запросом.
Следующий универсальный код ресурса (URI) является примером запроса Complete : ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/27FEA311-68B9-4320-9FC4-296F6FDFAFE2/Document
XML-файл документа DeclaredConfiguration
Значение конечного узла Document
— это XML-документ, описывающий запрос. Фактическая обработка запроса разворачивается вокруг тега osdefinedscenario
:
-
MSFTExtensibilityMIProviderConfig
: используется для настройки параметров поставщика mi. -
MSFTExtensibilityMIProviderInventory
: используется для получения значений параметров поставщика MI.
Поставщик CSP DeclaredConfiguration синхронно проверяет пакет параметров, описанный элементом <DeclaredConfiguration>
, который представляет объявленный документ конфигурации. Он проверяет правильность синтаксиса на основе объявленной XML-схемы конфигурации. При возникновении синтаксической ошибки поставщик служб CSP немедленно возвращает ошибку обратно на сервер в рамках текущего сеанса OMA-DM. Если синтаксис проверка пройден, запрос передается в службу Windows. Служба Windows асинхронно пытается настроить требуемое состояние для указанного сценария. Этот процесс освобождает сервер для выполнения другой работы, поэтому низкая задержка этого объявленного протокола конфигурации. Клиентская служба Windows, оркестратор, отвечает за управление конфигурацией устройства на основе заданного сервером состояния желания. Служба также поддерживает это состояние на протяжении всего времени существования, пока сервер не удалит или не изменит его.
В следующем примере используется встроенный собственный поставщик MSFT_FileDirectoryConfiguration
MI со сценарием MSFTExtensibilityMIProviderConfig
, определенным ОС :
<DeclaredConfiguration schema="1.0" context="Device" id="27FEA311-68B9-4320-9FC4-296F6FDFAFE2" checksum="99925209110918B67FE962460137AA3440AFF4DB6ABBE15C8F499682457B9999" osdefinedscenario="MSFTExtensibilityMIProviderConfig">
<DSC namespace="root/Microsoft/Windows/DesiredStateConfiguration" className="MSFT_FileDirectoryConfiguration">
<Key name="DestinationPath">c:\data\test\bin\ut_extensibility.tmp</Key>
<Value name="Contents">TestFileContentBlah</Value>
</DSC>
</DeclaredConfiguration>
Стандартный синтаксис SyncML OMA-DM используется для указания операций CSP DeclaredConfiguration, таких как Replace, Set и Delete. Полезные данные элемента SyncML <Data>
должны быть в кодировке XML. Для этой кодирования XML существуют различные сетевые кодировщики, которые можно использовать. Чтобы избежать кодирования полезных данных, можно использовать раздел CDATA , как показано в следующем примере:
<?xml version="1.0" encoding="utf-8"?>
<SyncML xmlns="SYNCML:SYNCML1.1">
<SyncBody>
<Replace>
<CmdID>14</CmdID>
<Item>
<Target>
<LocURI> ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/99988660-9080-3433-96e8-f32e85011999/Document</LocURI>
</Target>
<Data>
<![CDATA[<DeclaredConfiguration schema="1.0" context="Device" id="27FEA311-68B9-4320-9FC4-296F6FDFAFE2" checksum="99925209110918B67FE962460137AA3440AFF4DB6ABBE15C8F499682457B9999" osdefinedscenario="MSFTExtensibilityMIProviderConfig">
<DSC namespace="root/Microsoft/Windows/DesiredStateConfiguration" className="MSFT_FileDirectoryConfiguration">
<Key name="DestinationPath">c:\data\test\bin\ut_extensibility.tmp</Key>
<Value name="Contents">TestFileContentBlah</Value>
</DSC>
</DeclaredConfiguration>]]>
</Data>
</Item>
</Replace>
<Final/>
</SyncBody>
</SyncML>
Теги xml-документа DeclaredConfiguration
MSFTExtensibilityMIProviderInventory
И MSFTExtensibilityMIProviderConfig
являются сценариями, определяемыми ОС, для которых требуются одни и те же теги и атрибуты.
<DeclaredConfiguration>
XML-тег указывает сведения о объявленных документах конфигурации для обработки. Документ может быть частью запроса конфигурации или запроса на инвентаризацию. Поставщик CSP DeclaredConfiguration имеет два URI, позволяющих определить конфигурацию или запрос на инвентаризацию.Этот тег имеет следующие атрибуты:
Атрибут Описание schema
Версия схемы xml. В настоящее время . 1.0
context
Указывает, что этот документ предназначен для устройства. Значение должно быть Device
.id
Уникальный идентификатор документа, заданного сервером. Это значение должно быть GUID. checksum
Это значение является версией документа, предоставленной сервером. osdefinedscenario
Именованный сценарий, который клиент должен настроить с заданными данными конфигурации. Для расширяемости используется сценарий или MSFTExtensibilityMIProviderConfig
MSFTExtensibilityMIProviderInventory
.<DSC>
Xml-тег описывает целевой поставщик WMI, выраженный пространством имен и именем класса, а также значения, которые должны применяться к устройству или запрашиваться поставщиком MI.Этот тег имеет следующие атрибуты:
Атрибут Описание namespace
Указывает целевое пространство имен поставщика MI. classname
Целевой поставщик MI. XML-тег
<Key>
описывает имя и значение требуемого параметра. Ему требуется только значение для конфигурации. Имя — это атрибут, а значение — содержимое<Key>
.Этот тег имеет следующие атрибуты:
Атрибут Описание name
Указывает имя параметра поставщика MI. Xml-тег
<Value>
описывает необязательное имя и значение параметра. Ему требуется только значение для конфигурации. Имя — это атрибут, а значение — содержимое<Value>
.Этот тег имеет следующие атрибуты:
Атрибут Описание name
Указывает имя параметра поставщика MI.
Объявленное универсальное оповещение конфигурации
При каждом ответе клиента на запрос сервера клиент создает объявленное оповещение конфигурации. Это оповещение содержит сводку по состоянию каждого из документов, обработанных службой Windows. Примером оповещения является следующий XML-код:
<Alert>
<CmdID>1</CmdID>
<Data>1224</Data>
<Item>
<Meta>
<Type xmlns="syncml:metinf">com.microsoft.mdm.declaredconfigurationdocuments</Type>
</Meta>
<Data>
<DeclaredConfigurations schema="1.0">
<DeclaredConfiguration context="Device"
id="27FEA311-68B9-4320-9FC4-296F6FDFAFE2"
checksum="99925209110918B67FE962460137AA3440AFF4DB6ABBE15C8F499682457B9999"
result_checksum="EE4F1636201B0D39F71654427E420E625B9459EED17ACCEEE1AC9B358F4283FD"
state="60" />
</DeclaredConfigurations>
</Data>
</Item>
</Alert>
В этом примере в сводке оповещений указан один документ объявленной конфигурации. В сводке оповещений перечислены все документы, обрабатываемые клиентским стеком, — запрос на конфигурацию или инвентаризацию. В нем описывается контекст документа, указывающий область применения документа.
Контекстное значение должно иметь значение Device
.
Атрибут состояния имеет значение 60
, указывающее, что документ был успешно обработан. Следующий класс определяет другие значения состояния:
enum class DCCSPURIState :unsigned long
{
NotDefined = 0, // transient
ConfigRequest = 1, // transient
ConfigInprogress = 2, // transient
ConfigInProgressAsyncPending = 3, // transient: Async operation is performed but pending results
DeleteRequest = 10, // transient
DeleteInprogress = 11, // transient
GetRequest = 20, // transient
GetInprogress = 21, // transient
ConstructURIStorageSuccess = 40, // transient
ConfigCompletedSuccess = 60, // permanent
ConfigCompletedError = 61, // permanent
ConfigInfraError = 62, // permanent
ConfigCompletedSuccessNoRefresh = 63, // permanent
DeleteCompletedSuccess = 70, // permanent
DeleteCompletedError = 71, // permanent
DeleteInfraError = 72, // permanent
GetCompletedSuccess = 80, // permanent
GetCompletedError = 81, // permanent
GetInfraError = 82 // permanent
};
Примеры SyncML
Получите результаты запроса конфигурации или инвентаризации:
<SyncML xmlns="SYNCML:SYNCML1.1"> <SyncBody> <Get> <CmdID>2</CmdID> <Item> <Meta> <Format>chr</Format> <Type>text/plain</Type> </Meta> <Target> <LocURI>./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Results/27FEA311-68B9-4320-9FC4-296F6FDFAFE2/Document</LocURI> </Target> </Item> </Get> <Final /> </SyncBody> </SyncML>
<Status> <CmdID>2</CmdID> <MsgRef>1</MsgRef> <CmdRef>2</CmdRef> <Cmd>Get</Cmd> <Data>200</Data> </Status> <Results> <CmdID>3</CmdID> <MsgRef>1</MsgRef> <CmdRef>2</CmdRef> <Item> <Source> <LocURI>./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Results/27FEA311-68B9-4320-9FC4-296F6FDFAFE2/Document</LocURI> </Source> <Data> <DeclaredConfigurationResult context="Device" schema="1.0" id="99988660-9080-3433-96e8-f32e85011999" osdefinedscenario="MSFTPolicies" checksum="99925209110918B67FE962460137AA3440AFF4DB6ABBE15C8F499682457B9999" result_checksum="EE4F1636201B0D39F71654427E420E625B9459EED17ACCEEE1AC9B358F4283FD" operation="Set" state="60"> <DSC namespace="root/Microsoft/Windows/DesiredStateConfiguration" className="MSFT_FileDirectoryConfiguration" status="200" state="60"> <Key name="DestinationPath" /> <Value name="Contents" /> </DSC> </DeclaredConfigurationResult> </Data> </Item> </Results>
Замена запроса на настройку или инвентаризацию
<SyncML xmlns="SYNCML:SYNCML1.1"> <SyncBody> <Replace> <CmdID>14</CmdID> <Item> <Target> <LocURI>./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents/27FEA311-68B9-4320-9FC4-296F6FDFAFE2/Document</LocURI> </Target> <Data> <![CDATA[<DeclaredConfiguration schema="1.0" context="Device" id="27FEA311-68B9-4320-9FC4-296F6FDFAFE2" checksum="99995209110918B67FE962460137AA3440AFF4DB6ABBE15C8F49968245799999" osdefinedscenario="MSFTExtensibilityMIProviderInventory"> <DSC namespace="root/Microsoft/Windows/DesiredStateConfiguration" className="MSFT_FileDirectoryConfiguration"> <Key name="DestinationPath">c:/temp/foobar.tmp</Key> <Value name="Contents"></Value> </DSC> </DeclaredConfiguration>]]> </Data> </Item> </Replace> <Final /> </SyncBody> </SyncML>
<Status> <CmdID>2</CmdID> <MsgRef>1</MsgRef> <CmdRef>2</CmdRef> <Cmd>Get</Cmd> <Data>200</Data> </Status><Results> <CmdID>3</CmdID> <MsgRef>1</MsgRef> <CmdRef>2</CmdRef> <Item> <Source> <LocURI>./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Results/99998660-9080-3433-96e8-f32e85019999/Document</LocURI> </Source> <Data> <DeclaredConfigurationResult context="Device" schema="1.0" id="27FEA311-68B9-4320-9FC4-296F6FDFAFE2" osdefinedscenario="MSFTExtensibilityMIProviderInventory" checksum="99995209110918B67FE962460137AA3440AFF4DB6ABBE15C8F49968245799999" result_checksum="A27B0D234CBC2FAC1292F1E8FBDF6A90690F3988DEDC9D716829856C9ACE0E20" operation="Get" state="80"> <DSC namespace="root/Microsoft/Windows/DesiredStateConfiguration" className="MSFT_FileDirectoryConfiguration" status="200" state="80"> <Key name="DestinationPath">c:/temp/foobar.tmp</Key> <Value name="Contents">TestFileContent</Value> </DSC> </DeclaredConfigurationResult> </Data> </Item> </Results>
Отказаться от запроса на настройку или инвентаризацию. Этот процесс приводит к тому, что клиент отслеживает документ, но не будет его повторно применить. Для оповещения задано
Abandoned
1
свойство , указывающее, что документ больше не управляется объявленным сервером конфигурации.<SyncML xmlns="SYNCML:SYNCML1.1"> <SyncBody> <Replace> <CmdID>2</CmdID> <Item> <Meta> <Format>int</Format> <Type>text/plain</Type> </Meta> <Target> <LocURI>./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/27FEA311-68B9-4320-9FC4-296F6FDFAFE2/Properties/Abandoned</LocURI> </Target> <Data>1</Data> </Item> </Replace> <Final/> </SyncBody> </SyncML>
Удаление запроса конфигурации или инвентаризации. При удалении документа SyncML документ удаляется только, но все параметры расширяемости сохраняются на устройстве (татуировка).
<?xml version="1.0" encoding="utf-8"?> <SyncML xmlns="SYNCML:SYNCML1.1"> <SyncBody> <Delete> <CmdID>2</CmdID> <Item> <Target> <LocURI>./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/27FEA311-68B9-4320-9FC4-296F6FDFAFE2/Document</LocURI> </Target> </Item> </Delete> <Final/> </SyncBody> </SyncML>