DeclaredConfiguration CSP

项目
01/18/2024

Windows 预览体验成员的徽标。

重要提示

此云解决方案提供商包含一些正在开发中的设置，仅适用于 Windows Insider Preview 版本。这些设置可能会发生更改，并且可能依赖于预览版中的其他功能或服务。

主 MDM 模型是一种主 MDM 模型，其中 MDM 服务器只负责协调和持续维护配置方案的设备状态。由于基于 OMA-DM Syncml 标准的同步配置模型，此行为会导致网络流量密集和高网络延迟。鉴于服务器需要深入了解客户端，这也容易出错。

声明的配置设备管理模型要求服务器将方案配置的所有设置值传递给设备。服务器通过客户端声明的配置 CSP 以异步方式批量发送它们。

在客户端发起的 OMA-DM 会话期间，声明的配置服务器通过声明的配置 CSP URI 将配置或清单声明的配置文档发送到客户端。如果设备验证文档的语法是否正确，则客户端堆栈会将请求推送到其业务流程协调程序，以异步处理请求。然后，客户端堆栈退出，并将控制权返回到声明的配置服务。此行为允许设备异步处理请求。
在客户端上，如果有任何请求正在处理或已完成，它会向服务器发送一般警报。此警报汇总了每个文档的状态、状态和进度。向声明的配置 OMA-DM 服务器发送的每个客户端 HTTPS 请求都包含此摘要。
声明的配置服务器使用通用警报来确定哪些请求成功完成或出现错误。然后，服务器可以通过声明的配置 CSP URI 同步检索声明的配置文档进程结果。

以下列表显示了 DeclaredConfiguration 配置服务提供程序节点：

./Device/Vendor/MSFT/DeclaredConfiguration
- Host
  - 完成
    - 文件
      - {DocID}
        
        文档
        
        属性
        
        放弃
    - 结果
      - {DocID}
        
        文档
  - 库存
    - 文件
      - {DocID}
        
        文档
    - 结果
      - {DocID}
        
        文档

Host

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host

主机内部节点指示配置请求或清单请求的目标是主机 OS。此节点用于范围，以防 enclave 成为配置目标。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	添加、删除、获取

Host/Complete

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete

此内部节点指示配置具有离散设置值，并且是自包含的完整设置和值对，这些值对不包含需要稍后使用其他数据解析的占位符。请求已准备好按原样进行处理。

完成请求的服务器到客户端流与清单请求相同。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	添加、删除、获取

Host/Complete/Documents

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents

“文档”节点指示配置采用文档的形式，文档是用于通过“声明的配置”堆栈配置方案的设置集合。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	添加、删除、获取

Host/Complete/Documents/{DocID}

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/{DocID}

唯一标识配置文档。其他文档不能有此 ID。ID 应为 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

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/{DocID}/Document

“文档”节点的值是基于 XML 的文档，其中包含用于配置指定方案的设置和值的集合。 “声明的配置”堆栈验证文档的语法，该堆栈标记客户端要异步处理的文档。然后，堆栈将控制返回到 OMA-DM 服务。堆栈反过来会异步处理请求。下面是使用声明的配置 URI ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/27FEA311-68 的指定所需状态配置的示例。 B9-4320-9。 FC4-296。 F6FDFAFE2/文档。

描述框架属性:

属性名	属性值
格式	`chr` (字符串)
访问类型	添加、删除、获取、替换

Host/Complete/Documents/{DocID}/Properties

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/{DocID}/Properties

“属性”节点封装应用于 [DocID] 引用的指定文档的属性列表。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	添加、删除、获取

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

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/{DocID}/Properties/Abandoned

“已放弃”节点允许 OMA-DM 服务器指示不再管理文档。

描述框架属性:

属性名	属性值
格式	`int`
访问类型	添加、删除、获取、替换
默认值	0

允许的值:

值	说明
0(默认值)	不再管理文档。
1	文档是托管的。

Host/Complete/results

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Results

“结果”节点指示这是 URI 路径的一部分，该路径将返回包含配置请求结果的 XML 文档。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	“获取”

Host/Complete/results/{DocID}

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Results/{DocID}

唯一标识将返回配置请求结果的配置文档。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	“获取”
动态节点命名	ClientInventory

Host/Complete/results/{DocID}/Document

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Results/{DocID}/Document

Document 节点的值是基于 XML 的文档，其中包含 [DocId] 指定的配置请求的设置结果的集合。

描述框架属性:

属性名	属性值
格式	`chr` (字符串)
访问类型	“获取”

主机/清单

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory

清单内部节点指示这是一个清单请求。要检索的设置值通过文档叶节点在 XML 文档中指定。

清单请求的服务器到客户端流与 Complete 请求相同。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	添加、删除、获取

Host/Inventory/Documents

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents

“文档”节点指示清单请求采用文档的形式，文档是用于检索其值的设置的集合。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	添加、删除、获取

Host/Inventory/Documents/{DocID}

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents/{DocID}

唯一标识清单文档。其他文档不能有此 ID。ID 应为 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

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 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/文档。

描述框架属性:

属性名	属性值
格式	`chr` (字符串)
访问类型	添加、删除、获取、替换

Host/Inventory/Results

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Results

“结果”节点指示这是 URI 路径的一部分，该路径将返回包含清单请求结果的 XML 文档。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	“获取”

Host/Inventory/Results/{DocID}

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Results/{DocID}

唯一标识清单文档。其他文档不能有此 ID。ID 应为 GUID。

描述框架属性:

属性名	属性值
格式	`node`
访问类型	“获取”
动态节点命名	ClientInventory

Host/Inventory/Results/{DocID}/Document

范围	版本	适用的操作系统
✅ 设备 ❌ 用户	✅ 专业版 ✅ 企业版 ✅ 教育版 ✅ Windows SE ✅ IoT 企业版/IoT 企业版 LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Results/{DocID}/Document

文档节点的值是基于 XML 的文档，其中包含 [DocId] 指定的清单请求的设置结果的集合。

描述框架属性:

属性名	属性值
格式	`chr` (字符串)
访问类型	“获取”

声明的配置 OMA URI

使用类似于 ./Device/Vendor/MSFT/DeclaredConfiguration/Host/[Complete|Inventory]/Documents/{DocID}/Document的 OMA-URI 发送声明的配置请求。

URI 以目标范围为前缀。方案设置的目标只能是设备范围的扩展性。范围应为 Device。
{DocID} 是配置方案所需状态的唯一标识符。每个文档都必须有一个 ID，该 ID 必须是 GUID。
该请求可以是 Configuration、 Inventory 或 Complete 请求。

以下 URI 是 Complete 请求的示例： ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/27FEA311-68B9-4320-9FC4-296F6FDFAFE2/Document

DeclaredConfiguration 文档 XML

叶节点 Document 的值是描述请求的 XML 文档。请求的实际处理围绕 osdefinedscenario 标记进行透视：

MSFTExtensibilityMIProviderConfig：用于配置 MI 提供程序设置。
MSFTExtensibilityMIProviderInventory：用于检索 MI 提供程序设置值。

DeclaredConfiguration CSP 同步验证元素描述 <DeclaredConfiguration> 的设置批，该批设置表示声明的配置文档。它根据声明的配置 XML 架构检查语法是否正确。如果出现语法错误，CSP 会将错误作为当前 OMA-DM 会话的一部分立即返回给服务器。如果语法检查传递，则请求将传递到 Windows 服务。 Windows 服务异步尝试指定方案的所需状态配置。此过程释放服务器来执行其他工作，从而降低此声明配置协议的延迟。 Windows 客户端服务（业务流程协调程序）负责根据服务器提供的需求状态来驱动设备的配置。服务在其整个生存期内也会保持此状态，直到服务器删除或修改它。

以下示例将内置本机 MI 提供程序 MSFT_FileDirectoryConfiguration 与 OS 定义的方案 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>

标准 OMA-DM SyncML 语法用于指定 DeclaredConfiguration CSP 操作，例如替换、设置和删除。 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>

DeclaredConfiguration XML 文档标记

和 MSFTExtensibilityMIProviderInventory 都是 MSFTExtensibilityMIProviderConfig OS 定义的方案，需要相同的标记和属性。

<DeclaredConfiguration> XML 标记指定要处理的声明配置文档的详细信息。文档可以是配置请求或清单请求的一部分。 DeclaredConfiguration CSP 有两个 URI，用于对配置或清单请求进行规范。

此标记具有以下属性：

属性	描述
`schema`	xml 的架构版本。当前 `1.0`。
`context`	指出此文档面向设备。该值应为 `Device`。
`id`	服务器设置的文档的唯一标识符。此值应为 GUID。
`checksum`	此值是服务器提供的文档版本。
`osdefinedscenario`	客户端应使用给定的配置数据配置的命名方案。对于扩展性，方案为 `MSFTExtensibilityMIProviderConfig` 或 `MSFTExtensibilityMIProviderInventory`。

<DSC> XML 标记描述由命名空间和类名表示的目标 WMI 提供程序，以及要应用于设备或由 MI 提供程序查询的值。

此标记具有以下属性：

属性描述

namespace 指定目标 MI 提供程序命名空间。

classname 目标 MI 提供程序。
<Key> XML 标记描述所需的参数名称和值。它只需要一个值进行配置。名称是属性，值为 <Key> content。

此标记具有以下属性：

属性描述

name 指定 MI 提供程序参数的名称。
<Value> XML 标记描述可选的参数名称和值。它只需要一个值进行配置。名称是属性，值为 <Value> content。

此标记具有以下属性：

属性描述

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>

放弃配置或清单请求。此过程会导致客户端跟踪文档，但不会重新应用文档。警报的 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>

删除配置或清单请求。同步ML 删除文档只会删除文档，但设备上的任何扩展性设置 (纹身) 保留。

<?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>

配置服务提供程序参考

Share via

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

Host/Complete/results/{DocID}

Host/Complete/results/{DocID}/Document

主机/清单

Host/Inventory/Documents

Host/Inventory/Documents/{DocID}

Host/Inventory/Documents/{DocID}/Document

Host/Inventory/Results

Host/Inventory/Results/{DocID}

Host/Inventory/Results/{DocID}/Document

声明的配置 OMA URI

DeclaredConfiguration 文档 XML

DeclaredConfiguration XML 文档标记

声明的配置通用警报

SyncML 示例

反馈

反馈

其他资源

Share via

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

Host/Complete/results/{DocID}

Host/Complete/results/{DocID}/Document

主机/清单

Host/Inventory/Documents

Host/Inventory/Documents/{DocID}

Host/Inventory/Documents/{DocID}/Document

Host/Inventory/Results

Host/Inventory/Results/{DocID}

Host/Inventory/Results/{DocID}/Document

声明的配置 OMA URI

DeclaredConfiguration 文档 XML

DeclaredConfiguration XML 文档标记

声明的配置通用警报

SyncML 示例

相关文章

反馈

反馈

其他资源