DeclaredConfiguration CSP

Статья
01/18/2024

Логотип программы предварительной оценки Windows.

Важно.

Этот 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
  - Выполнено
    - Документы
      - {DocID}
        
        Документ
        
        Свойства
        
        Прерванная
    - Результаты
      - {DocID}
        
        Документ
  - Активы
    - Документы
      - {DocID}
        
        Документ
    - Результаты
      - {DocID}
        
        Документ

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}

Описание свойств инфраструктуры:

Имя свойства	Значение свойства
Формат	`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`	Именованный сценарий, который клиент должен настроить с заданными данными конфигурации. Для расширяемости используется сценарий или `MSFTExtensibilityMIProviderConfigMSFTExtensibilityMIProviderInventory`.

<DSC> Xml-тег описывает целевой поставщик WMI, выраженный пространством имен и именем класса, а также значения, которые должны применяться к устройству или запрашиваться поставщиком MI.

Этот тег имеет следующие атрибуты:

Атрибут Описание

namespace Указывает целевое пространство имен поставщика MI.

classname Целевой поставщик MI.
XML-тег <Key> описывает имя и значение требуемого параметра. Ему требуется только значение для конфигурации. Имя — это атрибут, а значение — содержимое <Key> .

Этот тег имеет следующие атрибуты:

Атрибут Описание

name Указывает имя параметра поставщика MI.
Xml-тег <Value> описывает необязательное имя и значение параметра. Ему требуется только значение для конфигурации. Имя — это атрибут, а значение — содержимое <Value> .

Этот тег имеет следующие атрибуты:

Атрибут Описание

name Указывает имя параметра поставщика MI.

Атрибут	Описание
`namespace`	Указывает целевое пространство имен поставщика MI.
`classname`	Целевой поставщик MI.

Атрибут	Описание
`name`	Указывает имя параметра поставщика MI.

Атрибут	Описание
`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>

Отказаться от запроса на настройку или инвентаризацию. Этот процесс приводит к тому, что клиент отслеживает документ, но не будет его повторно применить. Для оповещения задано Abandoned1свойство , указывающее, что документ больше не управляется объявленным сервером конфигурации.
```
<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>

Справочник по поставщикам служб конфигурации

Поделиться через

DeclaredConfiguration CSP

Host

Host/Complete

Host/Complete/Documents

Host/Complete/Documents/{DocID}

Host/Complete/Documents/{DocID}/Document

Host/Complete/Documents/{DocID}/Properties

Host/Complete/Documents/{DocID}/Properties/Abandoned

Узел,Завершение/Результаты

Host/Complete/Results/{DocID}

Host/Complete/Results/{DocID}/Document

Узел или инвентаризация

Узел,Инвентаризация/Документы

Host/Inventory/Documents/{DocID}

Host/Inventory/Documents/{DocID}/Document

Узел,Инвентаризация/Результаты

Host/Inventory/Results/{DocID}

Host/Inventory/Results/{DocID}/Document

URI OMA объявленной конфигурации

XML-файл документа DeclaredConfiguration

Теги xml-документа DeclaredConfiguration

Объявленное универсальное оповещение конфигурации

Примеры SyncML

Обратная связь

Обратная связь

Дополнительные ресурсы

Поделиться через

DeclaredConfiguration CSP

Host

Host/Complete

Host/Complete/Documents

Host/Complete/Documents/{DocID}

Host/Complete/Documents/{DocID}/Document

Host/Complete/Documents/{DocID}/Properties

Host/Complete/Documents/{DocID}/Properties/Abandoned

Узел,Завершение/Результаты

Host/Complete/Results/{DocID}

Host/Complete/Results/{DocID}/Document

Узел или инвентаризация

Узел,Инвентаризация/Документы

Host/Inventory/Documents/{DocID}

Host/Inventory/Documents/{DocID}/Document

Узел,Инвентаризация/Результаты

Host/Inventory/Results/{DocID}

Host/Inventory/Results/{DocID}/Document

URI OMA объявленной конфигурации

XML-файл документа DeclaredConfiguration

Теги xml-документа DeclaredConfiguration

Объявленное универсальное оповещение конфигурации

Примеры SyncML

Связанные статьи

Обратная связь

Обратная связь

Дополнительные ресурсы