DeclaredConfiguration CSP

Artículo
01/18/2024

Logotipo de Windows Insider.

Importante

Este CSP contiene algunas configuraciones que están en desarrollo y que solo se aplican a las compilaciones de Windows Insider Preview. Esta configuración está sujeta a cambios y puede tener dependencias en otras características o servicios en versión preliminar.

El modelo mdm principal es aquel en el que el servidor MDM es el único responsable de la orquestación y el mantenimiento continuo del estado del dispositivo para escenarios de configuración. Este comportamiento da como resultado un tráfico de red intensivo y una latencia de red alta debido al modelo de configuración sincrónica basado en el estándar syncml de OMA-DM. También es propenso a errores dado que el servidor necesita un conocimiento profundo del cliente.

El modelo de administración de dispositivos de configuración declarado requiere que el servidor entregue todos los valores de configuración al dispositivo para la configuración del escenario. El servidor los envía de forma asincrónica en lotes a través del CSP de configuración declarado por el cliente.

Durante la sesión de OMA-DM iniciada por el cliente, el servidor de configuración declarado envía una configuración o un documento de configuración declarado de inventario al cliente a través del URI de CSP de configuración declarada. Si el dispositivo comprueba que la sintaxis del documento es correcta, la pila de cliente inserta la solicitud en su orquestador para procesar la solicitud de forma asincrónica. A continuación, la pila de cliente se cierra y devuelve el control al servicio de configuración declarado. Este comportamiento permite que el dispositivo procese de forma asincrónica la solicitud.
En el cliente, si hay solicitudes en proceso o completadas, envía una alerta genérica al servidor. Esta alerta resume el estado, el estado y el progreso de cada documento. Todas las solicitudes HTTPS de cliente al servidor OMA-DM de configuración declarada incluyen este resumen.
El servidor de configuración declarado usa la alerta genérica para determinar qué solicitudes se completan correctamente o con errores. A continuación, el servidor puede recuperar sincrónicamente los resultados del proceso del documento de configuración declarado mediante el URI de CSP de configuración declarada.

En la lista siguiente se muestran los nodos del proveedor de servicios de configuración DeclaredConfiguration:

./Device/Vendor/MSFT/DeclaredConfiguration
- Host
  - Completar
    - Documentos
      - {DocID}
        
        Documento
        
        Propiedades
        
        Abandonado
    - Resultados
      - {DocID}
        
        Documento
  - Inventario
    - Documentos
      - {DocID}
        
        Documento
    - Resultados
      - {DocID}
        
        Documento

Host

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host

El nodo interno host indica que el destino de la solicitud de configuración o la solicitud de inventario es el sistema operativo host. Este nodo es para el ámbito en caso de que los enclaves se dirijan alguna vez a la configuración.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Agregar, eliminar, obtener

Host/Complete

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

Este nodo interno indica que la configuración tiene valores de configuración discretos y es independiente con pares de valores y valores completos que no contienen marcadores de posición que deben resolverse más adelante con datos adicionales. La solicitud está lista para procesarse tal y como está.

El flujo de servidor a cliente de la solicitud Complete es el mismo que una solicitud de inventario .

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Agregar, eliminar, obtener

Host/Completo/Documentos

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

El nodo Documentos indica que la configuración tiene el formato de un documento, que es una colección de opciones usadas para configurar un escenario por la pila de configuración declarada.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Agregar, eliminar, obtener

Host/Complete/Documents/{DocID}

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

Identifica de forma única el documento de configuración. Ningún otro documento puede tener este identificador. El identificador debe ser un GUID.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Agregar, eliminar, obtener
Nomenclatura dinámica de nodos	ServerGeneratedUniqueIdentifier
Valores permitidos	Expresión regular: `[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

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

El valor del nodo Document es un documento basado en XML que contiene una colección de valores y valores para configurar el escenario especificado. La pila De configuración declarada comprueba la sintaxis del documento; la pila marca el documento que el cliente va a procesar de forma asincrónica. A continuación, la pila devuelve el control al servicio OMA-DM. A su vez, la pila procesa de forma asincrónica la solicitud. A continuación se muestra un ejemplo de una configuración de estado deseado especificada mediante el URI de configuración declarada ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/27FEA311-68. B9-4320-9. FC4-296. F6FDFAFE2/Documento.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`chr` (cadena)
Tipo de acceso	Agregar, Eliminar, Obtener, Reemplazar

Host/Complete/Documents/{DocID}/Properties

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

El nodo Propiedades encapsula la lista de propiedades que se aplican al documento especificado al que hace referencia [DocID].

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Agregar, eliminar, obtener

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

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

El nodo Abandonado permite que el servidor OMA-DM indique que el documento ya no se administra.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`int`
Tipo de acceso	Agregar, Eliminar, Obtener, Reemplazar
Valor predeterminado	0

Valores permitidos:

Valor	Descripción
0 (Predeterminado)	El documento ya no se administra.
1	El documento se administra.

Host/Complete/Results

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

El nodo Resultados indica que forma parte de la ruta de acceso del URI que devolverá un documento XML que contiene los resultados de la solicitud de configuración.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Obtener

Host/Complete/Results/{DocID}

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

Identifica de forma única el documento de configuración en el que se devolverán los resultados de la solicitud de configuración.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Obtener
Nomenclatura dinámica de nodos	ClientInventory

Host/Complete/Results/{DocID}/Document

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

El valor del nodo Document es un documento basado en XML que contiene una colección de resultados de configuración de la solicitud de configuración especificada por [DocId].

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`chr` (cadena)
Tipo de acceso	Obtener

Host/Inventario

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

El nodo interno Inventario indica que se trata de una solicitud de inventario. Los valores de configuración que se van a recuperar se especifican en un documento XML a través del nodo hoja Documento.

El flujo de servidor a cliente de la solicitud inventario es el mismo que la solicitud Complete .

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Agregar, eliminar, obtener

Host/Inventario/Documentos

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

El nodo Documentos indica que la solicitud de inventario tiene el formato de un documento, que es una colección de valores que se usan para recuperar sus valores.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Agregar, eliminar, obtener

Host/Inventario/Documentos/{DocID}

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

Identifica de forma única el documento de inventario. Ningún otro documento puede tener este identificador. El identificador debe ser un GUID.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Agregar, eliminar, obtener
Nomenclatura dinámica de nodos	ServerGeneratedUniqueIdentifier
Valores permitidos	Expresión regular: `[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/Inventario/Documentos/{DocID}/Documento

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

El valor del nodo Document es un documento basado en XML que contiene una colección de valores que se usarán para recuperar sus valores. La pila De configuración declarada comprueba la sintaxis del documento; la pila marca el documento que el cliente va a procesar de forma asincrónica. A continuación, la pila devuelve el control al servicio OMA-DM. A su vez, la pila procesa de forma asincrónica la solicitud. A continuación se muestra un ejemplo de una configuración de estado deseado especificada mediante el URI de configuración declarada ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents/27FEA311-68. B9-4320-9. FC4-296. F6FDFAFE2/Documento.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`chr` (cadena)
Tipo de acceso	Agregar, Eliminar, Obtener, Reemplazar

Host/Inventario/Resultados

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

El nodo Resultados indica que forma parte de la ruta de acceso del URI que devolverá un documento XML que contiene los resultados de la solicitud de inventario.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Obtener

Host/Inventario/Resultados/{DocID}

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

Identifica de forma única el documento de inventario. Ningún otro documento puede tener este identificador. El identificador debe ser un GUID.

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`node`
Tipo de acceso	Obtener
Nomenclatura dinámica de nodos	ClientInventory

Host/Inventario/Resultados/{DocID}/Documento

Ámbito	Ediciones	Sistema operativo aplicable
Dispositivo ✅ ❌ Usuario	✅ Pro ✅ Empresa ✅ Educación ✅ Windows SE ✅ IoT Enterprise/IoT Enterprise LTSC	✅Windows Insider Preview

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

El valor del nodo Document es un documento basado en XML que contiene una colección de resultados de configuración de la solicitud de inventario especificada por [DocId].

Propiedades del marco de descripción:

Nombre de la propiedad	Valor de propiedad
Formato	`chr` (cadena)
Tipo de acceso	Obtener

Uri de OMA de configuración declarada

Una solicitud de configuración declarada se envía mediante un OMA-URI similar a ./Device/Vendor/MSFT/DeclaredConfiguration/Host/[Complete|Inventory]/Documents/{DocID}/Document.

El URI tiene el prefijo de un ámbito de destino. El destino de la configuración del escenario solo puede ser todo el dispositivo para la extensibilidad. El ámbito debe ser Device.
{DocID} es un identificador único para el estado deseado del escenario de configuración. Cada documento debe tener un identificador, que debe ser un GUID.
La solicitud puede ser una solicitud De configuración, Inventario o Completa .

El siguiente URI es un ejemplo de una solicitud Complete : ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/27FEA311-68B9-4320-9FC4-296F6FDFAFE2/Document

XML del documento DeclaredConfiguration

El valor del nodo Document hoja es un documento XML que describe la solicitud. El procesamiento real de la solicitud gira alrededor de la osdefinedscenario etiqueta:

MSFTExtensibilityMIProviderConfig: se usa para configurar los valores del proveedor de MI.
MSFTExtensibilityMIProviderInventory: se usa para recuperar los valores de configuración del proveedor de MI.

El CSP DeclaredConfiguration valida sincrónicamente el lote de valores descrito por el <DeclaredConfiguration> elemento , que representa el documento de configuración declarado. Comprueba si hay una sintaxis correcta basada en el esquema XML de configuración declarado. Si se produce un error de sintaxis, el CSP devuelve inmediatamente un error al servidor como parte de la sesión actual de OMA-DM. Si se supera la comprobación de sintaxis, la solicitud se pasa a un servicio de Windows. El servicio de Windows intenta de forma asincrónica la configuración de estado deseado del escenario especificado. Este proceso libera el servidor para realizar otro trabajo, por lo que la latencia baja de este protocolo de configuración declarado. El servicio cliente de Windows, el orquestador, es responsable de impulsar la configuración del dispositivo en función del estado de deseo proporcionado por el servidor. El servicio también mantiene este estado a lo largo de su duración, hasta que el servidor lo quita o modifica.

En el ejemplo siguiente se usa el proveedor MSFT_FileDirectoryConfiguration de MI nativo integrado con el escenario MSFTExtensibilityMIProviderConfigdefinido por el sistema operativo :

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

La sintaxis syncML estándar de OMA-DM se usa para especificar las operaciones de CSP DeclaredConfiguration, como Replace, Set y Delete. La carga del elemento de <Data> SyncML debe estar codificada en XML. Para esta codificación XML, hay varios codificadores en línea que puede usar. Para evitar la codificación de la carga, puede usar la sección CDATA como se muestra en el ejemplo siguiente:

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

Etiquetas de documento XML DeclaredConfiguration

Tanto como MSFTExtensibilityMIProviderConfigMSFTExtensibilityMIProviderInventory son escenarios definidos por el sistema operativo que requieren las mismas etiquetas y atributos.

La <DeclaredConfiguration> etiqueta XML especifica los detalles del documento de configuración declarado que se va a procesar. El documento podría formar parte de una solicitud de configuración o una solicitud de inventario. El CSP DeclaredConfiguration tiene dos URI para permitir la especificación de una configuración o una solicitud de inventario.

Esta etiqueta tiene los siguientes atributos:

Atributo	Descripción
`schema`	Versión del esquema del xml. Actualmente es `1.0`.
`context`	Indica que este documento tiene como destino el dispositivo. El valor debe ser `Device`.
`id`	Identificador único del documento establecido por el servidor. Este valor debe ser un GUID.
`checksum`	Este valor es la versión proporcionada por el servidor del documento.
`osdefinedscenario`	Escenario con nombre que el cliente debe configurar con los datos de configuración especificados. Para la extensibilidad, el escenario es o `MSFTExtensibilityMIProviderConfigMSFTExtensibilityMIProviderInventory`.

La <DSC> etiqueta XML describe el proveedor WMI de destino expresado por un espacio de nombres y un nombre de clase junto con los valores que se van a aplicar al dispositivo o consultados por el proveedor de MI.

Esta etiqueta tiene los siguientes atributos:

Atributo Descripción

namespace Especifica el espacio de nombres del proveedor de MI de destino.

classname Proveedor de MI de destino.
La <Key> etiqueta XML describe el nombre y el valor de parámetro necesarios. Solo necesita un valor para la configuración. El nombre es un atributo y el valor es <Key> contenido.

Esta etiqueta tiene los siguientes atributos:

Atributo Descripción

name Especifica el nombre de un parámetro de proveedor de MI.
La <Value> etiqueta XML describe el nombre y el valor del parámetro opcional. Solo necesita un valor para la configuración. El nombre es un atributo y el valor es <Value> contenido.

Esta etiqueta tiene los siguientes atributos:

Atributo Descripción

name Especifica el nombre de un parámetro de proveedor de MI.

Atributo	Descripción
`namespace`	Especifica el espacio de nombres del proveedor de MI de destino.
`classname`	Proveedor de MI de destino.

Atributo	Descripción
`name`	Especifica el nombre de un parámetro de proveedor de MI.

Atributo	Descripción
`name`	Especifica el nombre de un parámetro de proveedor de MI.

Alerta genérica de configuración declarada

En cada respuesta de cliente a la solicitud del servidor, el cliente crea una alerta de configuración declarada. Esta alerta resume el estado de cada uno de los documentos que el servicio de Windows ha procesado. El siguiente XML es una alerta de ejemplo:

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

En este ejemplo, hay un documento de configuración declarado que aparece en el resumen de alertas. En el resumen de alertas se enumeran todos los documentos que está procesando la pila de cliente, ya sea una solicitud de configuración o de inventario. Describe el contexto del documento que especifica el ámbito de aplicación del documento. El valor de contexto debe ser Device.

El atributo state tiene un valor de 60, que indica que el documento se procesó correctamente. La clase siguiente define los demás valores de estado:

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

Ejemplos de SyncML

Recupere los resultados de una solicitud de configuración o inventario:

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

Reemplazar una solicitud de configuración o inventario

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

Abandone una solicitud de configuración o inventario. Este proceso da como resultado que el cliente siga el documento, pero no lo vuelva a aplicar. La alerta tiene la Abandoned propiedad establecida en 1, lo que indica que el servidor de configuración declarado ya no administra el documento.

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

Eliminación de la solicitud de configuración o inventario. La eliminación de SyncML del documento solo quita el documento, pero cualquier configuración de extensibilidad persiste en el dispositivo (tatuaje).

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

Referencia de proveedor de servicios de configuración

Share via

DeclaredConfiguration CSP

Host

Host/Complete

Host/Completo/Documentos

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

Host/Inventario/Documentos

Host/Inventario/Documentos/{DocID}

Host/Inventario/Documentos/{DocID}/Documento

Host/Inventario/Resultados

Host/Inventario/Resultados/{DocID}

Host/Inventario/Resultados/{DocID}/Documento

Uri de OMA de configuración declarada

XML del documento DeclaredConfiguration

Etiquetas de documento XML DeclaredConfiguration

Alerta genérica de configuración declarada

Ejemplos de SyncML

Comentarios

Comentarios

Recursos adicionales

Share via

DeclaredConfiguration CSP

Host

Host/Complete

Host/Completo/Documentos

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

Host/Inventario/Documentos

Host/Inventario/Documentos/{DocID}

Host/Inventario/Documentos/{DocID}/Documento

Host/Inventario/Resultados

Host/Inventario/Resultados/{DocID}

Host/Inventario/Resultados/{DocID}/Documento

Uri de OMA de configuración declarada

XML del documento DeclaredConfiguration

Etiquetas de documento XML DeclaredConfiguration

Alerta genérica de configuración declarada

Ejemplos de SyncML

Artículos relacionados

Comentarios

Comentarios

Recursos adicionales