Estructura de archivos de aprovisionamiento de OMA DM

Artículo
08/07/2024
Se aplica a:

✅ Windows 11, ✅ Windows 10

Los comandos OMA DM se transmiten entre el servidor y el dispositivo cliente en mensajes. Un mensaje puede contener uno o varios comandos. Para obtener una lista de los comandos admitidos, consulte la tabla en compatibilidad con el protocolo OMA DM.

Un mensaje DM es un documento XML. La estructura y el contenido del documento se definen en el protocolo de representación OMA DM (OMA-SyncML-DevInfo-DTD-V1_1_2-20030505-D.dtd) disponible en el sitio web de OMA.

Cada mensaje se compone de un encabezado, especificado por el elemento SyncHdr, y un cuerpo del mensaje, especificado por el elemento SyncBody.

En la tabla siguiente se muestran las versiones de OMA DM que se admiten.

Versión	Formato
OMA DM, versión 1.1.2	`<SyncML xmlns='SYNCML:SYNCML1.1'></SyncML>`
OMA DM, versión 1.2	`<SyncML xmlns='SYNCML:SYNCML1.2'></SyncML>`

Formato de archivo

En el ejemplo siguiente se muestra la estructura general del documento XML enviado por el servidor mediante la versión 1.2.1 de OMA DM solo con fines de demostración. Los paquetes XML iniciales intercambiados entre el cliente y el servidor podrían contener más etiquetas XML. Para obtener una descripción detallada y ejemplos de esos paquetes, consulte la especificación OMA Administración de dispositivos Protocol 1.2.1.

XML

<SyncML xmlns='SYNCML:SYNCML1.2'>
   <SyncHdr>
      <VerDTD>1.2</VerDTD>
      <VerProto>DM/1.2</VerProto>
      <SessionID>1</SessionID>
      <MsgID>1</MsgID>
      <Target>
         <LocURI>{unique device ID}</LocURI>
      </Target>
      <Source>
         <LocURI>https://www.contoso.com/mgmt-server</LocURI>
      </Source>
   </SyncHdr>
   <SyncBody>
      <!-- query a device OS system version -->
      <Get>
         <CmdID>2</CmdID>
         <Item>
            <Target>
               <LocURI>./DevDetail/SwV</LocURI>
            </Target>
         </Item>
      </Get>
      <!-- Update device policy -->

      <Final />
   </SyncBody>
</SyncML>

Elemento SyncHdr

SyncHdr incluye la siguiente información:

Definición de tipo de documento (DTD) y números de versión de protocolo
Identificadores de sesión y mensaje. Cada mensaje de la misma sesión de DM debe tener un MsgID diferente.
Identificadores uniformes de recursos (URI) de origen y destino del mensaje
Credenciales para la autenticación

El dispositivo cliente usa esta información para administrar correctamente la sesión de DM.

Ejemplo de código

En el ejemplo siguiente se muestra el componente de encabezado de un mensaje DM. En este caso, solo se usa la versión 1.2 de OMA DM como ejemplo.

Nota

El <LocURI> valor del nodo para el <Source> elemento de SyncHdr del paquete DM generado por el dispositivo debe ser el mismo que el valor de ./DevInfo/DevID. Para obtener más información sobre DevID, vea Proveedor de servicios de configuración de DevInfo.

XML

<SyncHdr>
   <VerDTD>1.2</VerDTD>
   <VerProto>DM/1.2</VerProto>
   <SessionID>1</SessionID>
   <MsgID>1</MsgID>
   <Target>
      <LocURI>{unique device ID}</LocURI>
   </Target>
   <Source>
      <LocURI>https://www.contoso.com/mgmt-server</LocURI>
   </Source>
</SyncHdr>

Elemento SyncBody

SyncBody contiene uno o varios comandos DM. SyncBody puede contener varios comandos DM; cada comando debe tener un valor CmdID diferente.

Ejemplo de código

En el ejemplo siguiente se muestra el componente de cuerpo de un mensaje DM. En este ejemplo, SyncBody contiene solo un comando, Get. Este comando se indica mediante la <Final /> etiqueta que se produce inmediatamente después de la etiqueta de terminación para el comando Get.

XML

<SyncBody>
   <!-- query device OS software version -->
   <Get>
      <CmdID>2</CmdID>
      <Item>
         <Target>
            <LocURI>./DevDetail/SwV</LocURI>
         </Target>
      </Item>
   </Get>
   <Final />
</SyncBody>

Cuando se usa SyncML para el aprovisionamiento de OMA DM, un LocURI en SyncBody puede tener un "." como un nombre de segmento válido solo en el primer segmento. Sin embargo, un "." no es un nombre de segmento válido para los demás segmentos. Por ejemplo, el siguiente locURI no es válido porque el nombre del segmento del séptimo segmento es ".".

XML

<LocURI>./Vendor/MSFT/Registry/HKLM/Security/./Test</LocURI>

Ejemplo de actualización de la configuración del dispositivo

El comando Replace se usa para actualizar una configuración de dispositivo.

En el ejemplo siguiente se muestra cómo usar el comando Reemplazar para actualizar una configuración de dispositivo.

XML

<SyncHdr>
   <VerDTD>1.2</VerDTD>
   <VerProto>DM/1.2</VerProto>
   <SessionID>1</SessionID>
   <MsgID>1</MsgID>
   <Target>
      <LocURI>{unique device ID}</LocURI>
   </Target>
   <Source>
      <LocURI>https://www.contoso.com/mgmt-server</LocURI>
   </Source>
</SyncHdr>
<SyncBody>
   <!-- update device setting -->
   <Replace>
      <CmdID>2</CmdID>
      <Item>
         <Target>
            <LocURI>./Vendor/MSFT/PolicyManager/My/DeviceLock/MinDevicePasswordLength</LocURI>
         </Target>
         <Meta>
            <Type xmlns="syncml:metinf">text/plain</Type>
            <Format xmlns="syncml:metinf">int</Format>
         </Meta>
         <Data>6</Data>
      </Item>
   </Replace>
   <Final />
</SyncBody>

Compartir a través de