DeclaredConfiguration CSP

Artigo
01/18/2024

Logotipo do Windows Insider.

Importante

Esse CSP contém algumas configurações que estão em desenvolvimento e só se aplicam Windows Insider Preview builds. Essas configurações estão sujeitas a alterações e podem ter dependências de outros recursos ou serviços em versão prévia.

O modelo MDM primário é aquele em que o servidor MDM é o único responsável pela orquestração e manutenção contínua do estado do dispositivo para cenários de configuração. Esse comportamento resulta em tráfego de rede intensivo e alta latência de rede devido ao modelo de configuração síncrona com base no padrão OMA-DM Syncml. Também é propenso a erros, dado que o servidor precisa de conhecimento profundo do cliente.

O modelo de gerenciamento de dispositivo de configuração declarado exige que o servidor entregue todos os valores de configuração ao dispositivo para a configuração do cenário. O servidor os envia de forma assíncrona em lotes por meio do CSP de configuração declarado pelo cliente.

Durante a sessão OMA-DM iniciada pelo cliente, o servidor de configuração declarado envia uma configuração ou um documento de configuração declarado de inventário para o cliente por meio do URI CSP de Configuração Declarada. Se o dispositivo verificar se a sintaxe do documento está correta, a pilha de clientes enviará a solicitação ao orquestrador para processar a solicitação de forma assíncrona. Em seguida, a pilha de cliente sai e retorna o controle de volta para o serviço de configuração declarado. Esse comportamento permite que o dispositivo processe assíncronamente a solicitação.
No cliente, se houver solicitações em processo ou concluídas, ele enviará um alerta genérico para o servidor. Esse alerta resume o status, o estado e o progresso de cada documento. Cada solicitação HTTPS do cliente para o servidor OMA-DM de configuração declarada inclui este resumo.
O servidor de configuração declarado usa o alerta genérico para determinar quais solicitações são concluídas com êxito ou com erros. Em seguida, o servidor pode recuperar síncronamente os resultados do processo de documento de configuração declarado por meio do URI CSP de Configuração Declarada.

A lista a seguir mostra os nós do provedor de serviços de configuração DeclaredConfiguration:

./Device/Vendor/MSFT/DeclaredConfiguration
- Host
  - Concluída
    - Documentos
      - {DocID}
        
        Documento
        
        Propriedades
        
        Abandonado
    - Resultados
      - {DocID}
        
        Documento
  - Inventário
    - Documentos
      - {DocID}
        
        Documento
    - Resultados
      - {DocID}
        
        Documento

Host

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

./Device/Vendor/MSFT/DeclaredConfiguration/Host

O nó interno host indica que o destino da solicitação de configuração ou da solicitação de inventário é o sistema operacional host. Esse nó é para escopo caso enclaves sejam sempre direcionados para configuração.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Adicionar, Excluir, Obter

Host/Complete

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

Esse nó interno indica que a configuração tem valores de configurações discretas e é independente com pares de configuração e valor completos que não contêm espaços reservados que precisam ser resolvidos posteriormente com dados adicionais. A solicitação está pronta para ser processada como está.

O fluxo de servidor para cliente da solicitação Completa é o mesmo que uma solicitação de Inventário .

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Adicionar, Excluir, Obter

Host/Complete/Documents

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

O nó Documentos indica que a configuração está na forma de um documento, que é uma coleção de configurações usadas para configurar um cenário pela pilha Configuração Declarada.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Adicionar, Excluir, Obter

Host/Complete/Documents/{DocID}

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

Identifica exclusivamente o documento de configuração. Nenhum outro documento pode ter essa ID. A ID deve ser um GUID.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Adicionar, Excluir, Obter
Nomenclatura de nó dinâmico	ServerGeneratedUniqueIdentifier
Valores Permitidos	Expressão 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

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

O valor do nó Document é um documento baseado em XML que contém uma coleção de configurações e valores para configurar o cenário especificado. A pilha Configuração Declarada verifica a sintaxe do documento, a pilha marca o documento a ser processado de forma assíncrona pelo cliente. Em seguida, a pilha retorna o controle para o serviço OMA-DM. A pilha, por sua vez, processa assíncronamente a solicitação. Veja abaixo um exemplo de uma configuração de estado desejada especificada usando o URI de Configuração Declarada ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/27FEA311-68. B9-4320-9. FC4-296. F6FDFAFE2/Documento.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia de caracteres)
Tipo de acesso	Adicionar, Excluir, Obter, Substituir

Host/Complete/Documents/{DocID}/Properties

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

O nó Propriedades encapsula a lista de propriedades que se aplicam ao documento especificado referenciado por [DocID].

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Adicionar, Excluir, Obter

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

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

O nó Abandonado permite que o servidor OMA-DM indique que o documento não é mais gerenciado.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`int`
Tipo de acesso	Adicionar, Excluir, Obter, Substituir
Valor Padrão	0

Valores Permitidos:

Valor	Descrição
0 (Padrão)	O documento não é mais gerenciado.
1	O documento é gerenciado.

Host/Complete/Results

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

O nó Resultados indica que isso faz parte do caminho do URI que retornará um documento XML contendo os resultados da solicitação de configuração.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter

Host/Complete/Results/{DocID}

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

Identifica exclusivamente o documento de configuração no qual os resultados da solicitação de configuração serão retornados.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter
Nomenclatura de nó dinâmico	ClientInventory

Host/Complete/Results/{DocID}/Document

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

O valor do nó Document é um documento baseado em XML que contém uma coleção de resultados de configuração da solicitação de configuração especificada por [DocId].

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia de caracteres)
Tipo de acesso	Obter

Host/Inventário

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

O nó interno inventário indica que essa é uma solicitação de inventário. Os valores de configuração a serem recuperados são especificados em um documento XML por meio do nó Folha de documento.

O fluxo de servidor para cliente da solicitação de inventário é o mesmo que a solicitação Complete .

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Adicionar, Excluir, Obter

Host/Inventário/Documentos

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

O nó Documentos indica que a solicitação de inventário está na forma de um documento, que é uma coleção de configurações usadas para recuperar seus valores.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Adicionar, Excluir, Obter

Host/Inventário/Documentos/{DocID}

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

Identifica exclusivamente o documento de inventário. Nenhum outro documento pode ter essa ID. A ID deve ser um GUID.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Adicionar, Excluir, Obter
Nomenclatura de nó dinâmico	ServerGeneratedUniqueIdentifier
Valores Permitidos	Expressão 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/Inventário/Documentos/{DocID}/Document

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

O valor do nó Document é um documento baseado em XML que contém uma coleção de configurações que serão usadas para recuperar seus valores. A pilha Configuração Declarada verifica a sintaxe do documento, a pilha marca o documento a ser processado de forma assíncrona pelo cliente. Em seguida, a pilha retorna o controle para o serviço OMA-DM. A pilha, por sua vez, processa assíncronamente a solicitação. Veja abaixo um exemplo de uma configuração de estado desejada especificada usando o URI de Configuração Declarada ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Inventory/Documents/27FEA311-68. B9-4320-9. FC4-296. F6FDFAFE2/Documento.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia de caracteres)
Tipo de acesso	Adicionar, Excluir, Obter, Substituir

Host/Inventário/Resultados

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

O nó Resultados indica que isso faz parte do caminho do URI que retornará um documento XML contendo os resultados da solicitação de inventário.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter

Host/Inventário/Resultados/{DocID}

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

Identifica exclusivamente o documento de inventário. Nenhum outro documento pode ter essa ID. A ID deve ser um GUID.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter
Nomenclatura de nó dinâmico	ClientInventory

Host/Inventário/Resultados/{DocID}/Documento

Escopo	Edições	Sistema operacional aplicável
Dispositivo ✅ Usuário ❌	Pro ✅ Corporativo ✅ Educação ✅ Windows SE ✅ Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅	✅Windows Insider Preview

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

O valor do nó Document é um documento baseado em XML que contém uma coleção de resultados de configuração da solicitação de inventário especificada por [DocId].

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia de caracteres)
Tipo de acesso	Obter

URI OMA de configuração declarada

Uma solicitação de configuração declarada é enviada usando um OMA-URI semelhante a ./Device/Vendor/MSFT/DeclaredConfiguration/Host/[Complete|Inventory]/Documents/{DocID}/Document.

O URI é prefixado com um escopo direcionado. O destino das configurações de cenário só pode ser de largura do dispositivo para extensibilidade. O escopo deve ser Device.
{DocID} é um identificador exclusivo para o estado desejado do cenário de configuração. Cada documento deve ter uma ID, que deve ser um GUID.
A solicitação pode ser uma configuração, inventário ou solicitaçãocompleta.

O URI a seguir é um exemplo de uma solicitação completa : ./Device/Vendor/MSFT/DeclaredConfiguration/Host/Complete/Documents/27FEA311-68B9-4320-9FC4-296F6FDFAFE2/Document

Documento DeclaredConfiguration XML

O valor do nó Document folha é um documento XML que descreve a solicitação. O processamento real da solicitação gira em torno da osdefinedscenario marca:

MSFTExtensibilityMIProviderConfig: usado para configurar as configurações do provedor de MI.
MSFTExtensibilityMIProviderInventory: usado para recuperar valores de configuração do provedor de MI.

O CSP DeclaredConfiguration valida síncronamente o lote de configurações descrito pelo <DeclaredConfiguration> elemento, que representa o documento de configuração declarado. Ele verifica a sintaxe correta com base no esquema XML de configuração declarado. Se houver um erro de sintaxe, o CSP retornará imediatamente um erro para o servidor como parte da sessão OMA-DM atual. Se a sintaxe marcar for aprovada, a solicitação será passada para um serviço Windows. O serviço Windows tenta assíncronamente a configuração de estado desejada do cenário especificado. Esse processo libera o servidor para fazer outro trabalho, portanto, a baixa latência deste protocolo de configuração declarado. O serviço cliente windows, o orquestrador, é responsável por conduzir a configuração do dispositivo com base no estado de desejo fornecido pelo servidor. O serviço também mantém esse estado durante todo o tempo de vida, até que o servidor o remova ou modifique.

O exemplo a seguir usa o provedor MSFT_FileDirectoryConfiguration de MI nativo interno com o cenário MSFTExtensibilityMIProviderConfigdefinido pelo sistema operacional:

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

A sintaxe Síncrona OMA-DM padrão é usada para especificar as operações CSP DeclaredConfiguration, como Substituir, Definir e Excluir. A carga do elemento SyncML <Data> deve ser codificada por XML. Para essa codificação XML, há vários codificadores online que você pode usar. Para evitar codificar a carga, você pode usar a Seção CDATA , conforme mostrado no exemplo a seguir:

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

Marcas de documento XML declareConfiguration

Ambos MSFTExtensibilityMIProviderConfig e MSFTExtensibilityMIProviderInventory são cenários definidos pelo sistema operacional que exigem as mesmas marcas e atributos.

A <DeclaredConfiguration> marca XML especifica os detalhes do documento de configuração declarado a ser processado. O documento pode fazer parte de uma solicitação de configuração ou de uma solicitação de inventário. O CSP DeclaredConfiguration tem duas URIs para permitir a especificação de uma configuração ou uma solicitação de inventário.

Essa marca tem os seguintes atributos:

Atributo	Descrição
`schema`	A versão do esquema do xml. Atualmente `1.0`.
`context`	Afirma que este documento está direcionando o dispositivo. O valor deve ser `Device`.
`id`	O identificador exclusivo do documento definido pelo servidor. Esse valor deve ser um GUID.
`checksum`	Esse valor é a versão fornecida pelo servidor do documento.
`osdefinedscenario`	O cenário nomeado que o cliente deve configurar com os dados de configuração fornecidos. Para extensibilidade, o cenário é `MSFTExtensibilityMIProviderConfig` ou `MSFTExtensibilityMIProviderInventory`.

A <DSC> marca XML descreve o provedor WMI de destino expresso por um namespace e um nome de classe, juntamente com os valores a serem aplicados ao dispositivo ou consultados pelo provedor MI.

Essa marca tem os seguintes atributos:

Atributo Descrição

namespace Especifica o namespace do provedor mi direcionado.

classname O provedor mi direcionado.
A <Key> marca XML descreve o nome e o valor do parâmetro necessários. Ele só precisa de um valor para configuração. O nome é um atributo e o valor é <Key> conteúdo.

Essa marca tem os seguintes atributos:

Atributo Descrição

name Especifica o nome de um parâmetro de provedor de MI.
A <Value> marca XML descreve o nome e o valor do parâmetro opcional. Ele só precisa de um valor para configuração. O nome é um atributo e o valor é <Value> conteúdo.

Essa marca tem os seguintes atributos:

Atributo Descrição

name Especifica o nome de um parâmetro de provedor de MI.

Atributo	Descrição
`namespace`	Especifica o namespace do provedor mi direcionado.
`classname`	O provedor mi direcionado.

Atributo	Descrição
`name`	Especifica o nome de um parâmetro de provedor de MI.

Atributo	Descrição
`name`	Especifica o nome de um parâmetro de provedor de MI.

Alerta genérico de configuração declarado

Em cada resposta do cliente à solicitação do servidor, o cliente constrói um alerta de configuração declarado. Esse alerta resume o estado de cada um dos documentos processados pelo serviço Windows. O XML a seguir é um alerta de exemplo:

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

Neste exemplo, há um documento de configuração declarado listado no resumo do alerta. O resumo do alerta lista cada documento que a pilha de clientes está processando, uma configuração ou uma solicitação de inventário. Ele descreve o contexto do documento que especifica o escopo de como o documento é aplicado. O valor de contexto deve ser Device.

O atributo de estado tem um valor de 60, que indica que o documento foi processado com êxito. A classe a seguir define os outros 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
};

Exemplos de SyncML

Recupere os resultados de uma configuração ou solicitação de inventário:

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

Substituir uma configuração ou solicitação de inventário

<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 uma configuração ou solicitação de inventário. Esse processo resulta no cliente que acompanha o documento, mas não o reaplica. O alerta tem a Abandoned propriedade definida como 1, o que indica que o documento não é mais gerenciado pelo servidor de configuração declarado.

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

Exclusão de configuração ou solicitação de inventário. A exclusão syncml do documento remove apenas o documento, mas todas as configurações de extensibilidade persistem no dispositivo (tatuagem).

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

Referência de provedor de serviços de configuração

Partilhar 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/Inventário

Host/Inventário/Documentos

Host/Inventário/Documentos/{DocID}

Host/Inventário/Documentos/{DocID}/Document

Host/Inventário/Resultados

Host/Inventário/Resultados/{DocID}

Host/Inventário/Resultados/{DocID}/Documento

URI OMA de configuração declarada

Documento DeclaredConfiguration XML

Marcas de documento XML declareConfiguration

Alerta genérico de configuração declarado

Exemplos de SyncML

Comentários

Recursos adicionais

Partilhar 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/Inventário

Host/Inventário/Documentos

Host/Inventário/Documentos/{DocID}

Host/Inventário/Documentos/{DocID}/Document

Host/Inventário/Resultados

Host/Inventário/Resultados/{DocID}

Host/Inventário/Resultados/{DocID}/Documento

URI OMA de configuração declarada

Documento DeclaredConfiguration XML

Marcas de documento XML declareConfiguration

Alerta genérico de configuração declarado

Exemplos de SyncML

Artigos relacionados

Comentários

Recursos adicionais