DeclaredConfiguration CSP

[アーティクル]
01/18/2024

Windows Insider のロゴ。

重要

この CSP には、開発中であり、Windows Insider Preview ビルドにのみ適用される一部の設定が含まれています。これらの設定は変更する可能性があり、プレビューで他の機能やサービスに依存する場合があります。

プライマリ MDM モデルは、MDM サーバーが構成シナリオに対するデバイスの状態のオーケストレーションと継続的なメンテナンスのみを担当するモデルです。この動作により、OMA-DM Syncml 標準に基づく同期構成モデルにより、ネットワークトラフィックが集中的に発生し、ネットワーク待機時間が長くなります。また、サーバーにクライアントに関する深い知識が必要であることを考えると、エラーが発生しやすくなります。

宣言された構成デバイス管理モデルでは、シナリオ構成のすべての設定値をデバイスに配信する必要があります。サーバーは、クライアントで宣言された構成 CSP を介して非同期的にバッチで送信します。

クライアントによって開始される OMA-DM セッション中に、宣言された構成サーバーは、宣言された構成 CSP URI を介して構成またはインベントリで宣言された構成ドキュメントをクライアントに送信します。デバイスがドキュメントの構文が正しいことを確認した場合、クライアントスタックは要求をオーケストレーターにプッシュして要求を非同期的に処理します。次に、クライアントスタックが終了し、宣言された構成サービスにコントロールを返します。この動作により、デバイスは要求を非同期的に処理できます。
クライアントでは、処理中または完了中の要求がある場合は、汎用アラートがサーバーに送信されます。このアラートは、各ドキュメントの状態、状態、進行状況をまとめたものです。宣言された構成 OMA-DM サーバーに対するすべてのクライアント HTTPS 要求には、この概要が含まれます。
宣言された構成サーバーは、汎用アラートを使用して、正常に完了した要求またはエラーが発生した要求を判断します。その後、サーバーは、宣言された構成 CSP URI を使用して、宣言された構成ドキュメントプロセスの結果を同期的に取得できます。

次の一覧は、DeclaredConfiguration 構成サービスプロバイダーノードを示しています。

./Device/Vendor/MSFT/DeclaredConfiguration
- Host
  - Complete
    - ドキュメント
      - {DocID}
        
        Document
        
        Properties
        
        中止
    - 結果
      - {DocID}
        
        Document
  - インベントリ
    - ドキュメント
      - {DocID}
        
        Document
    - 結果
      - {DocID}
        
        Document

Host

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host

ホスト内部ノードは、構成要求またはインベントリ要求のターゲットがホスト OS であることを示します。このノードは、エンクレーブが構成の対象になる場合のスコープ用です。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`node`
アクセスの種類	追加、削除、取得

Host/Complete

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

この内部ノードは、構成に個別の設定値があり、後で追加のデータで解決する必要があるプレースホルダーを含まない完全な設定と値のペアを持つ自己完結型であることを示します。要求をそのまま処理する準備が整いました。

Complete 要求のサーバーからクライアントへのフローは、インベントリ要求と同じです。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`node`
アクセスの種類	追加、削除、取得

ホスト/完了/ドキュメント

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

[ドキュメント] ノードは、構成がドキュメントの形式であることを示します。これは、宣言された構成スタックによってシナリオを構成するために使用される設定のコレクションです。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`node`
アクセスの種類	追加、削除、取得

Host/Complete/Documents/{DocID}

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise 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

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

[ドキュメント] ノードの値は、指定したシナリオを構成するための設定と値のコレクションを含む XML ベースのドキュメントです。 Declared Configuration スタックはドキュメントの構文を検証します。スタックは、クライアントによって非同期的に処理されるドキュメントをマークします。その後、スタックは制御を OMA-DM サービスに戻します。さらに、スタックは要求を非同期的に処理します。次に、宣言された構成 URI ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/27FEA311-68 を使用した、指定した目的の状態構成の例を示します。 B9-4320-9。 FC4-296。 F6FDFAFE2/ドキュメント。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`chr` (string)
アクセスの種類	追加、削除、取得、置換

Host/Complete/Documents/{DocID}/Properties

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

[プロパティ] ノードは、[DocID] によって参照される指定されたドキュメントに適用されるプロパティの一覧をカプセル化します。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`node`
アクセスの種類	追加、削除、取得

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

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

破棄されたノードを使用すると、OMA-DM サーバーはドキュメントが管理されなくなったことを示すことができます。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`int`
アクセスの種類	追加、削除、取得、置換
既定値	0

指定可能な値

値	説明
0 (既定値)	ドキュメントは管理されなくなりました。
1	ドキュメントは管理されます。

Host/Complete/Results

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

[結果] ノードは、これが構成要求の結果を含む XML ドキュメントを返す URI パスの一部であることを示します。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`node`
アクセスの種類	[ゲームをゲット] を選びます

Host/Complete/Results/{DocID}

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

構成要求の結果が返される構成ドキュメントを一意に識別します。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`node`
アクセスの種類	[ゲームをゲット] を選びます
動的ノードの名前付け	ClientInventory

Host/Complete/Results/{DocID}/Document

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

Document ノードの値は、[DocId] で指定された構成要求からの設定結果のコレクションを含む XML ベースのドキュメントです。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`chr` (string)
アクセスの種類	[ゲームをゲット] を選びます

ホスト/インベントリ

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

Inventory 内部ノードは、これがインベントリ要求であることを示します。取得する設定値は、ドキュメントリーフノードを介して XML ドキュメントで指定されます。

インベントリ要求のサーバーからクライアントへのフローは、Complete 要求と同じです。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`node`
アクセスの種類	追加、削除、取得

ホスト/インベントリ/ドキュメント

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

[ドキュメント] ノードは、インベントリ要求がドキュメントの形式であることを示します。これは、その値を取得するために使用される設定のコレクションです。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`node`
アクセスの種類	追加、削除、取得

Host/Inventory/Documents/{DocID}

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise 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

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

[ドキュメント] ノードの値は、値の取得に使用される設定のコレクションを含む XML ベースのドキュメントです。 Declared Configuration スタックはドキュメントの構文を検証します。スタックは、クライアントによって非同期的に処理されるドキュメントをマークします。その後、スタックは制御を OMA-DM サービスに戻します。さらに、スタックは要求を非同期的に処理します。次に、宣言された構成 URI ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents/27FEA311-68 を使用した、指定した目的の状態構成の例を示します。 B9-4320-9。 FC4-296。 F6FDFAFE2/ドキュメント。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`chr` (string)
アクセスの種類	追加、削除、取得、置換

ホスト/インベントリ/結果

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

[結果] ノードは、これが、インベントリ要求の結果を含む XML ドキュメントを返す URI パスの一部であることを示します。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`node`
アクセスの種類	[ゲームをゲット] を選びます

Host/Inventory/Results/{DocID}

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

インベントリドキュメントを一意に識別します。この ID を持つドキュメントは他にありません。ID は GUID にする必要があります。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`node`
アクセスの種類	[ゲームをゲット] を選びます
動的ノードの名前付け	ClientInventory

Host/Inventory/Results/{DocID}/Document

適用範囲	エディション	対象となる OS
✅ デバイス ❌ ユーザー	✅ Pro ✅ Enterprise ✅ Education ✅ Windows SE ✅ IoT Enterprise / IoT Enterprise LTSC	✅Windows Insider Preview

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

Document ノードの値は、[DocId] で指定されたインベントリ要求からの設定結果のコレクションを含む XML ベースのドキュメントです。

説明フレームワークのプロパティ:

プロパティ名	プロパティ値
形式	`chr` (string)
アクセスの種類	[ゲームをゲット] を選びます

宣言された構成 OMA URI

宣言された構成要求は、と同様 ./Device/Vendor/MSFT/DeclaredConfiguration/Host/[Complete|Inventory]/Documents/{DocID}/Documentの OMA-URI を使用して送信されます。

URI には、対象のスコープがプレフィックスとして付けられます。シナリオ設定のターゲットは、拡張のためにデバイス全体に限定できます。スコープはである Device必要があります。
{DocID} は、構成シナリオの目的の状態の一意識別子です。すべてのドキュメントには ID が必要です。ID は GUID である必要があります。
要求には、構成、 インベントリ、または完了要求を指定できます。

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 クライアントサービスであるオーケストレーターは、サーバーが提供する要求状態に基づいてデバイスの構成を実行する役割を担います。また、サービスは、サーバーが削除または変更するまで、有効期間を通じてこの状態を維持します。

次の例では、OS で定義されたシナリオMSFTExtensibilityMIProviderConfigで組み込みのネイティブ MI プロバイダーMSFT_FileDirectoryConfigurationを使用します。

<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 定義のシナリオです。

XML タグは <DeclaredConfiguration> 、処理する宣言された構成ドキュメントの詳細を指定します。ドキュメントは、構成要求またはインベントリ要求の一部である可能性があります。 DeclaredConfiguration CSP には、構成またはインベントリ要求の指定を許可する 2 つの URI があります。

このタグには、次の属性があります。

属性	説明
`schema`	xml のスキーマバージョン。現在 `1.0`は。
`context`	このドキュメントがデバイスを対象としていることを示します。値はである `Device`必要があります。
`id`	サーバーによって設定されたドキュメントの一意識別子。この値は GUID にする必要があります。
`checksum`	この値は、サーバー提供のドキュメントのバージョンです。
`osdefinedscenario`	指定された構成データを使用してクライアントが構成する必要がある名前付きシナリオ。拡張性の場合、シナリオはまたは `MSFTExtensibilityMIProviderInventory`です`MSFTExtensibilityMIProviderConfig`。

XML タグは <DSC> 、名前空間とクラス名で表されるターゲット WMI プロバイダーと、デバイスに適用される値、または MI プロバイダーによって照会される値を表します。

このタグには、次の属性があります。

属性説明

namespace 対象となる MI プロバイダー名前空間を指定します。

classname 対象となる MI プロバイダー。
XML タグには <Key> 、必要なパラメーターの名前と値が記述されています。構成に必要な値のみです。名前は属性で、値は content です <Key> 。

このタグには、次の属性があります。

属性説明

name MI プロバイダーパラメーターの名前を指定します。
XML タグには <Value> 、省略可能なパラメーター名と値が記述されています。構成に必要な値のみです。名前は属性で、値は content です <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>

この例では、アラートの概要に宣言された構成ドキュメントが 1 つ一覧表示されています。アラートの概要には、クライアントスタックが処理しているすべてのドキュメント (構成要求またはインベントリ要求) が一覧表示されます。ドキュメントの適用方法のスコープを指定するドキュメントのコンテキストについて説明します。 コンテキスト値はであるDevice必要があります。

state 属性の値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>

構成サービスプロバイダーのリファレンス

次の方法で共有

DeclaredConfiguration CSP

Host

Host/Complete

ホスト/完了/ドキュメント

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/{DocID}

Host/Inventory/Documents/{DocID}/Document

ホスト/インベントリ/結果

Host/Inventory/Results/{DocID}

Host/Inventory/Results/{DocID}/Document

宣言された構成 OMA URI

DeclaredConfiguration ドキュメント XML

DeclaredConfiguration XML ドキュメントタグ

宣言された構成の汎用アラート

SyncML の例

フィードバック

フィードバック

その他のリソース

次の方法で共有

DeclaredConfiguration CSP

Host

Host/Complete

ホスト/完了/ドキュメント

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/{DocID}

Host/Inventory/Documents/{DocID}/Document

ホスト/インベントリ/結果

Host/Inventory/Results/{DocID}

Host/Inventory/Results/{DocID}/Document

宣言された構成 OMA URI

DeclaredConfiguration ドキュメント XML

DeclaredConfiguration XML ドキュメント タグ

宣言された構成の汎用アラート

SyncML の例

関連記事

フィードバック

フィードバック

その他のリソース

DeclaredConfiguration XML ドキュメントタグ