Freigeben über

DeclaredConfiguration CSP

  • Artikel

Logo von Windows Insider.

Wichtig

Dieser CSP enthält einige Einstellungen, die sich in der Entwicklung befinden und nur für Windows Insider Preview-Builds gelten. Diese Einstellungen können geändert werden und weisen möglicherweise Abhängigkeiten von anderen Vorschau-Features oder -Diensten auf.

Das primäre MDM-Modell ist eines, bei dem der MDM-Server allein für die Orchestrierung und kontinuierliche Wartung des Gerätezustands für Konfigurationsszenarien verantwortlich ist. Dieses Verhalten führt aufgrund des synchronen Konfigurationsmodells, das auf dem OMA-DM Syncml-Standard basiert, zu intensivem Netzwerkdatenverkehr und hoher Netzwerklatenz. Es ist auch fehleranfällig, da der Server tiefe Kenntnisse über den Client benötigt.

Das Windows-Geräteverwaltungsmodell für deklarierte Konfiguration (WinDC) erfordert, dass der Server alle Einstellungswerte für die Szenariokonfiguration an das Gerät übermittelt. Der Server sendet sie asynchron in Batches über den DeclaredConfiguration-CSP.

  • Während der vom Client initiierten OMA-DM-Sitzung sendet der WinDC-Server eine Konfiguration oder ein WinDC-Inventurdokument über den CSP-URI DeclaredConfiguration an den Client. Wenn das Gerät überprüft, ob die Syntax des Dokuments korrekt ist, pusht der Clientstapel die Anforderung an den Orchestrator, um die Anforderung asynchron zu verarbeiten. Der Clientstapel wird dann beendet und gibt die Steuerung an den WinDC-Dienst zurück. Dieses Verhalten ermöglicht es dem Gerät, die Anforderung asynchron zu verarbeiten.

  • Wenn auf dem Client Anforderungen ausgeführt oder abgeschlossen sind, sendet er eine generische Warnung an den Server. Diese Warnung fasst die status, den Status und den Fortschritt jedes Dokuments zusammen. Jede HTTPS-Clientanforderung an den WinDC OMA-DM-Server enthält diese Zusammenfassung.

  • Der WinDC-Server verwendet die generische Warnung, um zu bestimmen, welche Anforderungen erfolgreich oder mit Fehlern abgeschlossen wurden. Der Server kann dann synchron die WinDC-Dokumentprozessergebnisse über den CSP-URI DeclaredConfiguration abrufen.

In der folgenden Liste sind die Knoten des Konfigurationsdienstanbieters DeclaredConfiguration aufgeführt:

Host

Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host

Der interne Knoten Host gibt an, dass das Ziel der Konfigurationsanforderung oder Inventuranforderung das Hostbetriebssystem ist. Dieser Knoten ist für den Bereich vorgesehen, falls Enclaves jemals für die Konfiguration vorgesehen sind.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format node
Zugriffstyp Hinzufügen, Löschen, Abrufen

Host/Complete

Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete

Dieser interne Knoten gibt an, dass die Konfiguration über diskrete Einstellungswerte verfügt und eigenständig mit vollständigen Einstellungs- und Wertpaaren ist, die keine Platzhalter enthalten, die später mit zusätzlichen Daten aufgelöst werden müssen. Die Anforderung kann unverändert verarbeitet werden.

Der Server-zu-Client-Flow der Complete-Anforderung ist identisch mit einer Bestandsanforderung .

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format node
Zugriffstyp Hinzufügen, Löschen, Abrufen

Host/Complete/Documents

Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents

Der Knoten Dokumente gibt an, dass die Konfiguration in Form eines Dokuments erfolgt. Hierbei handelt es sich um eine Sammlung von Einstellungen, die zum Konfigurieren eines Szenarios durch den Stapel der deklarierten Konfiguration verwendet werden.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format node
Zugriffstyp Hinzufügen, Löschen, Abrufen
Host/Complete/Documents/{DocID}
Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/{DocID}

Identifiziert das Konfigurationsdokument eindeutig. Kein anderes Dokument kann diese ID aufweisen. Die ID sollte eine GUID sein.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format node
Zugriffstyp Hinzufügen, Löschen, Abrufen
Dynamische Knotenbenennung ServerGeneratedUniqueIdentifier
Zulässige Werte Regulärer Ausdruck: [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
Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/{DocID}/Document

Der Wert des Knotens Dokument ist ein XML-basiertes Dokument, das eine Sammlung von Einstellungen und Werten zum Konfigurieren des angegebenen Szenarios enthält. Der Stapel der deklarierten Konfiguration überprüft die Syntax des Dokuments, der Stapel markiert das Dokument, das vom Client asynchron verarbeitet werden soll. Der Stapel gibt dann die Steuerung an den OMA-DM-Dienst zurück. Der Stapel verarbeitet die Anforderung wiederum asynchron. Im Folgenden finden Sie ein Beispiel für eine angegebene Konfiguration des gewünschten Zustands mithilfe des deklarierten Konfigurations-URI ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/27FEA311-68. B9-4320-9. FC4-296. F6FDFAFE2/Dokument.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format chr (Zeichenfolge)
Zugriffstyp Hinzufügen, Löschen, Abrufen, Ersetzen
Host/Complete/Documents/{DocID}/Properties
Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/{DocID}/Properties

Der Knoten Eigenschaften kapselt die Liste der Eigenschaften, die für das angegebene Dokument gelten, auf das von [DocID] verwiesen wird.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format node
Zugriffstyp Hinzufügen, Löschen, Abrufen
Host/Complete/Documents/{DocID}/properties/Abandoned
Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/{DocID}/Properties/Abandoned

Der Knoten Verlassen ermöglicht es dem OMA-DM-Server, anzugeben, dass das Dokument nicht mehr verwaltet wird.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format int
Zugriffstyp Hinzufügen, Löschen, Abrufen, Ersetzen
Standardwert 0

Zulässige Werte:

Wert Beschreibung
0 (Standard) Das Dokument wird nicht mehr verwaltet.
1 Das Dokument wird verwaltet.

Host/Complete/Results

Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Results

Der Knoten Ergebnisse gibt an, dass dies Teil des URI-Pfads ist, der ein XML-Dokument mit den Ergebnissen der Konfigurationsanforderung zurückgibt.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format node
Zugriffstyp „Abrufen“
Host/Complete/Results/{DocID}
Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Results/{DocID}

Identifiziert eindeutig das Konfigurationsdokument, in dem Ergebnisse der Konfigurationsanforderung zurückgegeben werden.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format node
Zugriffstyp „Abrufen“
Dynamische Knotenbenennung ClientInventory
Host/Complete/Results/{DocID}/Document
Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Results/{DocID}/Document

Der Wert des Knotens Document ist ein XML-basiertes Dokument, das eine Sammlung von Einstellungsergebnissen aus der durch [DocId] angegebenen Konfigurationsanforderung enthält.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format chr (Zeichenfolge)
Zugriffstyp „Abrufen“

Host/Bestand

Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory

Der interne Knoten Bestand gibt an, dass es sich um eine Bestandsanforderung handelt. Die abzurufenden Einstellungswerte werden in einem XML-Dokument über den Blattknoten Dokument angegeben.

Der Server-zu-Client-Flow der Bestandsanforderung ist identisch mit der Complete-Anforderung .

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format node
Zugriffstyp Hinzufügen, Löschen, Abrufen

Host/Bestand/Dokumente

Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents

Der Knoten Dokumente gibt an, dass die Inventuranforderung in Form eines Dokuments besteht, bei dem es sich um eine Sammlung von Einstellungen handelt, die zum Abrufen ihrer Werte verwendet werden.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format node
Zugriffstyp Hinzufügen, Löschen, Abrufen
Host/Bestand/Dokumente/{DocID}
Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents/{DocID}

Identifiziert das Inventurdokument eindeutig. Kein anderes Dokument kann diese ID aufweisen. Die ID sollte eine GUID sein.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format node
Zugriffstyp Hinzufügen, Löschen, Abrufen
Dynamische Knotenbenennung ServerGeneratedUniqueIdentifier
Zulässige Werte Regulärer Ausdruck: [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/Bestand/Dokumente/{DocID}/Dokument
Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents/{DocID}/Document

Der Wert des Dokumentknotens ist ein XML-basiertes Dokument, das eine Sammlung von Einstellungen enthält, die zum Abrufen ihrer Werte verwendet werden. Der Stapel der deklarierten Konfiguration überprüft die Syntax des Dokuments, der Stapel markiert das Dokument, das vom Client asynchron verarbeitet werden soll. Der Stapel gibt dann die Steuerung an den OMA-DM-Dienst zurück. Der Stapel verarbeitet die Anforderung wiederum asynchron. Im Folgenden finden Sie ein Beispiel für eine angegebene Konfiguration des gewünschten Zustands mithilfe des deklarierten Konfigurations-URI ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents/27FEA311-68. B9-4320-9. FC4-296. F6FDFAFE2/Dokument.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format chr (Zeichenfolge)
Zugriffstyp Hinzufügen, Löschen, Abrufen, Ersetzen

Host/Bestand/Ergebnisse

Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Results

Der Knoten Ergebnisse gibt an, dass dies Teil des URI-Pfads ist, der ein XML-Dokument mit den Ergebnissen der Inventuranforderung zurückgibt.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format node
Zugriffstyp „Abrufen“
Host/Bestand/Ergebnisse/{DocID}
Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Results/{DocID}

Identifiziert das Inventurdokument eindeutig. Kein anderes Dokument kann diese ID aufweisen. Die ID sollte eine GUID sein.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format node
Zugriffstyp „Abrufen“
Dynamische Knotenbenennung ClientInventory
Host/Inventory/Results/{DocID}/Document
Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Results/{DocID}/Document

Der Wert des Knotens Document ist ein XML-basiertes Dokument, das eine Sammlung von Einstellungsergebnissen aus der durch [DocId] angegebenen Bestandsanforderung enthält.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format chr (Zeichenfolge)
Zugriffstyp „Abrufen“

ManagementServiceConfiguration

Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/ManagementServiceConfiguration

Der ManagementServiceConfiguration-Knoten, der zum Steuern eines bestimmten Windows-Konfigurationsverhaltens verwendet wird.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format node
Zugriffstyp „Abrufen“

ManagementServiceConfiguration/ConflictResolution

Bereich Editionen Geeignetes Betriebssystem
✅ Gerät
❌ Benutzer		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅Windows Insider Preview 
./Device/Vendor/MSFT/DeclaredConfiguration/ManagementServiceConfiguration/ConflictResolution

Dieser Knoten steuert, dass die Konfliktlösung aktiviert und deaktiviert wird.

Beschreibungsframeworkeigenschaften:

Eigenschaftenname Eigenschaftenwert
Format int
Zugriffstyp Hinzufügen, Löschen, Abrufen, Ersetzen

Zulässige Werte:

Wert Beschreibung
0 Die Konfliktlösung ist OFF.
1 Die Konfliktlösung ist AKTIVIERT.

DeclaredConfiguration OMA-URI

Eine WinDC-Anforderung wird mithilfe eines OMA-URI ähnlich ./Device/Vendor/MSFT/DeclaredConfiguration/Host/[Complete|Inventory]/Documents/{DocID}/Documentgesendet.

  • Dem URI wird ein Zielbereich (User oder Device) vorangestellt.
  • {DocID} ist ein eindeutiger Bezeichner für den gewünschten Zustand des Konfigurationsszenarios. Jedes Dokument muss über eine ID verfügen, die eine GUID sein muss.
  • Die Anforderung kann eine Bestandsanforderung oder eine Vollständige Anforderung sein.

Der folgende URI ist ein Beispiel für eine Complete-Anforderung : ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/27FEA311-68B9-4320-9FC4-296F6FDFAFE2/Document

WinDC-Dokument

<DeclaredConfiguration
    schema="1.0"
    context="Device"
    id="27FEA311-68B9-4320-9FC4-296F6FDFAFE2"
    checksum="99925209110918B67FE962460137AA3440AFF4DB6ABBE15C8F499682457B9999"
    osdefinedscenario="MSFTExtensibilityMIProviderConfig">
    ... {Configuration Data} ...
</DeclaredConfiguration>

Das <DeclaredConfiguration> XML-Tag gibt die Details des zu verarbeitenden WinDC-Dokuments an. Das Dokument kann Teil einer Konfigurationsanforderung oder einer Bestandsanforderung sein. Der CSP DeclaredConfiguration verfügt über zwei URIs, um die Spezifikation einer Konfiguration oder einer Inventuranforderung zu ermöglichen.

Dieses Tag weist die folgenden Attribute auf:

Attribut Beschreibung
schema Die Schemaversion des XML-Codes. Derzeit 1.0.
context Gibt an, ob das Dokument auf das Gerät oder den Benutzer ausgerichtet ist.
id Der eindeutige Bezeichner des vom Server festgelegten Dokuments. Dieser Wert sollte eine GUID sein.
checksum Dieser Wert ist die vom Server bereitgestellte Version des Dokuments.
osdefinedscenario Das benannte Szenario, das der Client mit den angegebenen Konfigurationsdaten konfigurieren soll.

Der DeclaredConfiguration-CSP überprüft synchron den Vom -Element beschriebenen <DeclaredConfiguration> Einstellungsbatch, das das WinDC-Dokument darstellt. Anhand des WinDC-XML-Schemas wird überprüft, ob die richtige Syntax korrekt ist. Wenn ein Syntaxfehler auftritt, gibt der CSP einen Fehler im Rahmen der aktuellen OMA-DM-Sitzung sofort an den Server zurück. Wenn die Syntaxprüfung erfolgreich ist, wird die Anforderung an einen Windows-Dienst übergeben. Der Windows-Dienst versucht asynchron die konfiguration des gewünschten Zustands des angegebenen Szenarios. Dieser Prozess gibt den Server frei, um andere Aufgaben auszuführen, was die geringe Latenz des WinDC-Protokolls bedeutet. Der Windows-Clientdienst, der Orchestrator, ist für die Konfiguration des Geräts basierend auf dem vom Server bereitgestellten Wunschzustand verantwortlich. Der Dienst behält diesen Zustand auch während seiner gesamten Lebensdauer bei, bis der Server ihn entfernt oder ändert.

Die tatsächliche Verarbeitung der Anforderung dreht sich um das osdefinedscenario Tag und die im Dokument angegebenen Konfigurationsdaten. Weitere Informationen finden Sie unter:

Generische WinDC-Warnung

Bei jeder Clientantwort auf die Serveranforderung erstellt der Client eine WinDC-Warnung. Diese Warnung fasst den Status der einzelnen Dokumente zusammen, die der Windows-Dienst verarbeitet hat. Der folgende XML-Code ist eine Beispielwarnung:

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

In diesem Beispiel ist ein WinDC-Dokument in der Warnungszusammenfassung aufgeführt. Die Warnungszusammenfassung listet jedes Dokument auf, das vom Clientstapel verarbeitet wird, entweder eine Konfigurations- oder Bestandsanforderung. Es beschreibt den Kontext des Dokuments, der den Bereich der Anwendung des Dokuments angibt. Der Kontextwert sollte sein Device.

Das State-Attribut weist den Wert auf, der 60angibt, dass das Dokument erfolgreich verarbeitet wurde.

WinDC-Zustände

Die folgende Klasse definiert die Zustandswerte:

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

Verwerfen eines WinDC-Dokuments

Das Verlassen einer Ressource tritt auf, wenn bestimmte Ressourcen nicht mehr für einen Benutzer oder eine Gruppe bestimmt sind. Anstatt die Ressource auf dem Gerät zu löschen, kann der Server das WinDC-Dokument verlassen. Eine aufgegebene Ressource verbleibt auf dem Gerät, beendet jedoch die Aktualisierung des WinDC-Dokuments, das die Driftsteuerung behandelt. Außerdem wird der Ressourcenbesitz an MDM übertragen, was bedeutet, dass die gleiche Ressource über den Legacy-MDM-Kanal erneut geändert werden kann.

In diesem Beispiel wird veranschaulicht, wie Sie ein WinDC-Dokument aufgeben, indem Sie die Abandoned-Eigenschaft auf 1 festlegen.

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

Unabandonieren eines WinDC-Dokuments

Wenn das Dokument nicht mehr verfügbar ist, wird das Dokument sofort angewendet, wodurch der Ressourcenbesitz wieder an die WinDC-Verwaltung übertragen wird und der Legacy-MDM-Kanal die Verwaltung der Kanäle blockiert.

In diesem Beispiel wird veranschaulicht, wie Sie die Auflösung eines WinDC-Dokuments durch Festlegen der Abandoned-Eigenschaft auf 0 ändern.

<?xml version="1.0" encoding="utf-8"?>
<SyncML xmlns="SYNCML:SYNCML1.1">
  <SyncBody>
    <Replace>
      <CmdID>10</CmdID>
      <Item>
        <Target>
          <LocURI>./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/DCA000B5-397D-40A1-AABF-40B25078A7F9/Properties/Abandoned</LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">int</Format>
        </Meta>
        <Data>0</Data>
      </Item>
    </Replace>
    <Final />
  </SyncBody>
</SyncML>

Löschen eines WinDC-Dokuments

Durch das SyncML-Löschen des Dokuments wird nur das Dokument entfernt, aber alle Einstellungen bleiben auf dem Gerät erhalten. In diesem Beispiel wird das Löschen eines Dokuments veranschaulicht.

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

Referenz zum Konfigurationsdienstanbieter