CSP EnterpriseDesktopAppManagement

Artigo
01/18/2024

O provedor de serviços de configuração EnterpriseDesktopAppManagement é usado para lidar com tarefas de gerenciamento de aplicativos da área de trabalho empresarial, como consultar aplicativos empresariais instalados, instalar aplicativos ou remover aplicativos.

As instalações do aplicativo podem levar algum tempo para serem concluídas, portanto, são feitas de forma assíncrona. Quando o comando Exec é concluído, o cliente pode enviar um alerta genérico para o servidor de gerenciamento com um status, seja uma falha ou um sucesso. Para obter um exemplo de SyncML, consulte Exemplo de alerta.

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

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement
- MSI
  - {ProductID}
    - DownloadInstall
    - InstallDate
    - InstallPath
    - Lasterror
    - LastErrorDesc
    - Nome
    - Editor
    - Status
    - Versão
  - Upgradecode
    - {Guid}
./User/Vendor/MSFT/EnterpriseDesktopAppManagement
- MSI
  - {ProductID}
    - DownloadInstall
    - InstallDate
    - InstallPath
    - Lasterror
    - LastErrorDesc
    - Nome
    - Editor
    - Status
    - Versão
  - Upgradecode
    - {Guid}

Dispositivo/MSI

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 10, versão 1511 [10.0.10586] e posterior

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI

O tipo de produto é MSI.

Propriedades da estrutura de descrição:

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

Dispositivo/MSI/{ProductID}

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 10, versão 1511 [10.0.10586] e posterior

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}

O código do produto MSI para o aplicativo.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Adicionar, Excluir, Obter
Atomic Required	True
Nomenclatura de nó dinâmico	UniqueName: o código de produto MSI para o aplicativo.

Dispositivo/MSI/{ProductID}/DownloadInstall

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 10, versão 1511 [10.0.10586] e posterior

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/DownloadInstall

Executa o download e a instalação do aplicativo. Em Windows 10, versão 1703 do serviço, uma nova marca <DownloadFromAad> foi adicionada à <Enforcement> seção do XML. O valor padrão é 0 (não envie token). Essa marca é opcional e precisa ser definida como 1 caso o servidor queira que a URL de download obtenha o AADUserToken.

Veja um exemplo:

<Enforcement>
  <CommandLine>/quiet</CommandLine>
  <TimeOut>5</TimeOut>
  <RetryCount>3</RetryCount>
  <RetryInterval>5</RetryInterval>
  <DownloadFromAad>1</DownloadFromAad>
</Enforcement>

Para obter mais informações, consulte DownloadInstall XSD Schema.

Propriedades da estrutura de descrição:

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

Dispositivo/MSI/{ProductID}/InstallDate

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 10, versão 1511 [10.0.10586] e posterior

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallDate

Data de instalação do aplicativo.

Propriedades da estrutura de descrição:

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

Dispositivo/MSI/{ProductID}/InstallPath

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 10, versão 1511 [10.0.10586] e posterior

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallPath

Caminho de instalação do aplicativo.

Propriedades da estrutura de descrição:

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

Dispositivo/MSI/{ProductID}/LastError

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 10, versão 1511 [10.0.10586] e posterior

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastError

O último código de erro durante o processo de instalação do aplicativo. Normalmente, isso é armazenado como um formato HRESULT. Dependendo do que estava ocorrendo quando o erro aconteceu, isso pode ser o resultado da execução de MSIExec.exe ou do erro resultante de uma API que falhou.

Propriedades da estrutura de descrição:

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

Dispositivo/MSI/{ProductID}/LastErrorDesc

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 10, versão 1511 [10.0.10586] e posterior

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastErrorDesc

Contém a última descrição do código de erro. O valor LastErrorDesc é procurado pelo valor lasterror correspondente. Às vezes, não há nenhum LastErrorDesc retornado.

Propriedades da estrutura de descrição:

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

Dispositivo/MSI/{ProductID}/Name

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 10, versão 1511 [10.0.10586] e posterior

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Name

Nome do aplicativo.

Propriedades da estrutura de descrição:

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

Dispositivo/MSI/{ProductID}/Publisher

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 10, versão 1511 [10.0.10586] e posterior

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Publisher

Publicador do aplicativo.

Propriedades da estrutura de descrição:

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

Dispositivo/MSI/{ProductID}/Status

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 10, versão 1511 [10.0.10586] e posterior

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Status

Status do aplicativo. Valores válidos: 10-Inicializado, 20-Download em andamento, 25-Pending Download Retry, 30-Download Failed, 40-Download Concluído, 48-Pending User Session, 50-Enforcement In Progress, 55-Pending Enforcement Retry, 60-Enforcement Failed, 70-Enforcement Concluído.

Propriedades da estrutura de descrição:

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

Dispositivo/MSI/{ProductID}/Versão

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 10, versão 1511 [10.0.10586] e posterior

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Version

Versão do produto MSI.

Propriedades da estrutura de descrição:

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

Dispositivo/MSI/UpgradeCode

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 10, versão 1607 [10.0.14393] e posterior

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter
Confidencial de Caso	True

Dispositivo/MSI/UpgradeCode/{Guid}

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 10, versão 1607 [10.0.14393] e posterior

./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode/{Guid}

Um gateway (ou servidor de gerenciamento de dispositivos) usa esse método para detectar o produto MSI de atualização correspondente quando um Administração deseja atualizar um aplicativo MSI existente. Se o mesmo produto de atualização estiver instalado, a atualização será permitida.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia de caracteres)
Tipo de acesso	Obter
Nomenclatura de nó dinâmico	ClientInventory

Usuário/MSI

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 10, versão 1511 [10.0.10586] e posterior

./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI

O tipo de produto é MSI.

Propriedades da estrutura de descrição:

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

Usuário/MSI/{ProductID}

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 10, versão 1511 [10.0.10586] e posterior

./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}

O código do produto MSI para o aplicativo.

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Adicionar, Excluir, Obter
Atomic Required	True
Nomenclatura de nó dinâmico	UniqueName: o código de produto MSI para o aplicativo.

Usuário/MSI/{ProductID}/DownloadInstall

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 10, versão 1511 [10.0.10586] e posterior

./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/DownloadInstall

Veja um exemplo:

<Enforcement>
  <CommandLine>/quiet</CommandLine>
  <TimeOut>5</TimeOut>
  <RetryCount>3</RetryCount>
  <RetryInterval>5</RetryInterval>
  <DownloadFromAad>1</DownloadFromAad>
</Enforcement>

Para obter mais informações, consulte DownloadInstall XSD Schema.

Propriedades da estrutura de descrição:

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

Usuário/MSI/{ProductID}/InstallDate

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 10, versão 1511 [10.0.10586] e posterior

./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallDate

Data de instalação do aplicativo.

Propriedades da estrutura de descrição:

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

Usuário/MSI/{ProductID}/InstallPath

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 10, versão 1511 [10.0.10586] e posterior

./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallPath

Caminho de instalação do aplicativo.

Propriedades da estrutura de descrição:

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

Usuário/MSI/{ProductID}/LastError

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 10, versão 1511 [10.0.10586] e posterior

./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastError

Propriedades da estrutura de descrição:

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

Usuário/MSI/{ProductID}/LastErrorDesc

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 10, versão 1511 [10.0.10586] e posterior

./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastErrorDesc

Contém a última descrição do código de erro. O valor LastErrorDesc é procurado pelo valor lasterror correspondente. Às vezes, não há nenhum LastErrorDesc retornado.

Propriedades da estrutura de descrição:

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

Usuário/MSI/{ProductID}/Name

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 10, versão 1511 [10.0.10586] e posterior

./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Name

Nome do aplicativo.

Propriedades da estrutura de descrição:

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

Usuário/MSI/{ProductID}/Publisher

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 10, versão 1511 [10.0.10586] e posterior

./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Publisher

Publicador do aplicativo.

Propriedades da estrutura de descrição:

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

Usuário/MSI/{ProductID}/Status

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 10, versão 1511 [10.0.10586] e posterior

./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Status

Propriedades da estrutura de descrição:

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

Usuário/MSI/{ProductID}/Versão

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 10, versão 1511 [10.0.10586] e posterior

./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Version

Versão do produto MSI.

Propriedades da estrutura de descrição:

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

Usuário/MSI/UpgradeCode

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 10, versão 1607 [10.0.14393] e posterior

./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`node`
Tipo de acesso	Obter
Confidencial de Caso	True

Usuário/MSI/UpgradeCode/{Guid}

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 10, versão 1607 [10.0.14393] e posterior

./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode/{Guid}

Propriedades da estrutura de descrição:

Nome da propriedade	Valor de propriedade
Formato	`chr` (cadeia de caracteres)
Tipo de acesso	Obter
Nomenclatura de nó dinâmico	ClientInventory

DownloadInstall XSD Schema

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="Data">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="MsiInstallJob">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="Product">
                <xs:complexType>
                  <xs:sequence>
                    <xs:element name="Download">
                      <xs:complexType>
                        <xs:sequence>
                          <xs:element name="ContentURLList">
                            <xs:complexType>
                              <xs:sequence>
                                <xs:element maxOccurs="unbounded" name="ContentURL" type="xs:string" />
                              </xs:sequence>
                            </xs:complexType>
                          </xs:element>
                        </xs:sequence>
                      </xs:complexType>
                    </xs:element>
                    <xs:element name="Validation">
                      <xs:complexType>
                        <xs:sequence>
                          <xs:element name="FileHash" type="xs:string" />
                        </xs:sequence>
                      </xs:complexType>
                    </xs:element>
                    <xs:element name="Enforcement">
                      <xs:complexType>
                        <xs:sequence>
                          <xs:element name="CommandLine" type="xs:string" />
                          <xs:element name="TimeOut" type="xs:unsignedByte" />
                          <xs:element name="RetryCount" type="xs:unsignedByte" />
                          <xs:element name="RetryInterval" type="xs:unsignedByte" />
                          <xs:element name="DownloadFromAad" type="xs:unsignedByte" />
                        </xs:sequence>
                      </xs:complexType>
                    </xs:element>
                  </xs:sequence>
                  <xs:attribute name="Version" type="xs:string" use="required" />
                </xs:complexType>
              </xs:element>
            </xs:sequence>
            <xs:attribute name="id" type="xs:string" use="required" />
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Exemplos

SyncML para solicitar informações de versão do CSP:

<SyncML xmlns="SYNCML:SYNCML1.1">
  <SyncBody>
    <Get>
      <CmdID>12345</CmdID>
      <Item>
        <Target>
          <LocURI>./Device/Vendor/MSFT/EnterpriseDesktopAppManagement?prop=Type</LocURI>
        </Target>
      </Item>
    </Get>
    <Final/>
  </SyncBody>
</SyncML>

A tabela a seguir descreve os campos no exemplo anterior:

Nome	Descrição
Obter	Operação que está sendo executada. A operação Get é uma solicitação para retornar informações.
CmdID	Valor de entrada usado para fazer referência à solicitação. As respostas incluirão esse valor que pode ser usado para corresponder à solicitação e à resposta.
LocURI	Caminho para o processador de comando Do Win32 CSP.

SyncML para executar operações msi para desinstalação do aplicativo:

<SyncML xmlns="SYNCML:SYNCML1.1">
  <SyncBody>
    <Delete>
      <CmdID>12345</CmdID>
      <Item>
        <Target>
          <LocURI>./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C38-4D2B-9B9A-0CB37243539C%7D</LocURI>
        </Target>
      </Item>
    </Delete>
    <Final/>
  </SyncBody>
</SyncML>

A tabela a seguir descreve os campos no exemplo anterior:

Nome	Descrição
Excluir	Operação que está sendo executada. A operação Delete é uma solicitação para excluir o nó CSP que representa o aplicativo instalado msi especificado e para executar e desinstalar o aplicativo como parte do processo.
CmdID	Valor de entrada usado para fazer referência à solicitação. As respostas incluirão esse valor que pode ser usado para corresponder à solicitação e à resposta.
LocURI	Caminho para o processador de comando Win32 CSP, incluindo a propriedade ID do Produto (neste exemplo, 1803A630-3C38-4D2B-9B9A-0CB37243539C) escapou para formatação XML.

SyncML para executar operações msi para relatórios de status de aplicativo:

<SyncML xmlns="SYNCML:SYNCML1.1">
  <SyncBody>
    <Get>
      <CmdID>12345</CmdID>
      <Item>
        <Target>
          <LocURI>./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C38-4D2B-9B9A-0CB37243539C%7D</LocURI>
        </Target>
      </Item>
    </Get>
    <Final/>
  </SyncBody>
</SyncML>

A tabela a seguir descreve os campos no exemplo anterior:

Nome	Descrição
Obter	Operação que está sendo executada. A operação Get é uma solicitação para relatar o status do aplicativo instalado msi especificado.
CmdID	Valor de entrada usado para fazer referência à solicitação. As respostas incluirão esse valor que pode ser usado para corresponder à solicitação e à resposta.
LocURI	Caminho para o processador de comando Win32 CSP, incluindo a propriedade ID do Produto (neste exemplo, 1803A630-3C38-4D2B-9B9A-0CB37243539C) escapou para formatação XML.

SyncML para executar operações de instalação do MSI para um aplicativo direcionado a um usuário específico no dispositivo. O comando Adicionar é necessário para preceder o comando Exec.

<SyncML xmlns="SYNCML:SYNCML1.1">
  <SyncBody>
    <Add>
      <CmdID>1</CmdID>
      <Item>
        <Target>
        <LocURI>./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C384D2B-9B9A-0CB37243539C%7D/DownloadInstall</LocURI>
        </Target>
      </Item>
    </Add>
    <Exec>
      <CmdID>6</CmdID>
      <Item>
        <Target>
          <LocURI>./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B1803A630-3C38-4D2B-9B9A-0CB37243539C%7D/DownloadInstall</LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">xml</Format>
          <Type xmlns="syncml:metinf">text/plain</Type>
        </Meta>
        <Data>
          <MsiInstallJob id="{9BD4F7CD-880A-40B5-B74C-1BEECB51E596}">
            <Product Version="1.0.0">
              <Download>
                <ContentURLList>
                  <ContentURL>
                    http://bcl-w2k12r2-vm/testapps/msi/reboot/reboot.msi
                  </ContentURL>
                  <ContentURL>https://dp2.com/packages/myApp.msi</ContentURL>
                </ContentURLList>
              </Download>
              <Validation>
              <FileHash>134D8F1F7C3C036DC3DCDA9F97515C8C7951DB154B73365C9C22962BD23E3EB3</FileHash>
              </Validation>
              <Enforcement>
                <CommandLine>/quiet</CommandLine>
                <TimeOut>5</TimeOut>
                <RetryCount>3</RetryCount>
                <RetryInterval>5</RetryInterval>
              </Enforcement>
            </Product>
          </MsiInstallJob>
        </Data>
      </Item>
    </Exec>
    <Final/>
  </SyncBody>
</SyncML>

A tabela a seguir descreve os campos no exemplo anterior:

Nome

Descrição

Adicionar

Esse campo é necessário para preceder o comando Exec.

CmdID – valor de entrada usado para fazer referência à solicitação. As respostas incluem esse valor, que pode ser usado para corresponder à solicitação e à resposta.

LocURI – Caminho para o processador de comando CSP Win32, incluindo a propriedade ID do Produto (neste exemplo, 1803A630-3C38-4D2B-9B9A-0CB37243539C) escapou para formatação XML.

Exec

O nó Exec inclui os parâmetros e as propriedades necessárias para localizar, baixar, validar e executar a instalação do produto.

CmdID – valor de entrada usado para fazer referência à solicitação. As respostas incluirão esse valor que pode ser usado para corresponder à solicitação e à resposta.

LocURI – Caminho para o processador de comando CSP Win32, incluindo a propriedade ID do Produto (neste exemplo, 1803A630-3C38-4D2B-9B9A-0CB37243539C) escapou para formatação XML.

Dados - O nó Data contém um XML inserido, do tipo "MsiInstallJob"

MsiInstallJob - Contém todas as informações necessárias para o download, validação e execução bem-sucedidos do processo de instalação do MSI (consulte seção no final deste documento para obter detalhes sobre esse objeto de dados inserido).

Observação

Informações status sobre o trabalho MSI serão relatadas usando o mecanismo de notificação OMA-DM padrão. O status relatado é representado usando códigos de retorno MSIEXEC padrão como HRESULT conforme definido no tópico MSIEXEC no Microsoft TechNet em Msiexec (opções de linha de comando).

SyncML para executar operações de instalação do MSI para um aplicativo direcionado a todos os usuários no dispositivo (instalação por dispositivo):

<SyncML xmlns="SYNCML:SYNCML1.1">
  <SyncBody>
    <Add>
      <CmdID>1</CmdID>
      <Item>
        <Target>
          <LocURI>./Device /Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B6F7CB29F-1319-4816-B345-0856916EB801%7D/DownloadInstall
          </LocURI>
      </Target>
    </Item>
  </Add>
    <Exec>
      <CmdID>67890</CmdID>
      <Item>
        <Target>
          <LocURI>./Device /Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/%7B6F7CB29F-1319-4816-B345-0856916EB801%7D/DownloadInstall</LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">xml</Format>
          <Type xmlns="syncml:metinf">text/plain</Type>
        </Meta>
        <Data>
          <MsiInstallJob id="{9BD4F7CD-880A-40B5-B74C-1BEECB51E596}">
            <Product Version="1.0.0">
              <Download>
                <ContentURLList>
                  <ContentURL>http://bcl-w2k12r2-vm/testapps/msi/Orca/Orca.msi</ContentURL>
                  <ContentURL>https://dp2.com/packages/myApp.msi</ContentURL>
                </ContentURLList>
              </Download>
              <Validation>
                <FileHash>4525065777EF18B9444ABF71DD4B48E5F64F4F0E1E029995FB8DA441CDE4296E</FileHash>
              </Validation>
              <Enforcement>
                <CommandLine>/quiet</CommandLine>
                <TimeOut>5</TimeOut>
                <RetryCount>3</RetryCount>
                <RetryInterval>5</RetryInterval>
              </Enforcement>
            </Product>
          </MsiInstallJob>
        </Data>
      </Item>
    </Exec>
    <Final/>
  </SyncBody>
</SyncML>

A tabela a seguir MsiInstallJob descreve os elementos de esquema.

Elemento	Descrição
MsiInstallJob	elemento raiz Atributo: "id" – o identificador de aplicativo do aplicativo que está sendo instalado
Produto	elemento filho de MsiInstallJob Atributo: "Versão" – representação de cadeia de caracteres da versão do aplicativo
Baixar	elemento filho do Product. Contêiner para baixar informações de configuração.
ContentURLList	elemento filho de Download. Contém uma lista de um ou mais localizadores de URL de download de conteúdo na forma de elementos ContentURL.
ContentURL	O conteúdo do local deve ser baixado. Deve ser uma URL formatada por propriedade que aponta para o arquivo .MSI.
Validação	Contém informações usadas para validar a autenticidade de contend. • FileHash – sha256 valor de hash do conteúdo do arquivo
FileHash	Sha256 valor de hash do conteúdo do arquivo
Imposição	propriedades de instalação a serem usadas ao instalar este MSI
Commandline	Opções de linha de comando a serem usadas ao chamar MSIEXEC.exe
Timeout	Em minutos, o processo de instalação pode ser executado antes que o instalador considere que a instalação pode ter falhado e não monitorar mais a operação de instalação.
RetryCount	O número de vezes que a operação de download e instalação será repetida antes que a instalação seja marcada como falha.
RetryInterval	Tempo, em minutos entre operações de repetição.

Aqui está um exemplo de uma resposta comum a uma solicitação

<?xml version="1.0" encoding="utf-16"?>
<SyncML>
  <SyncHdr />
  <SyncBody>
    <Status>
      <CmdID>12345</CmdID>
      <MsgRef>1</MsgRef>
      <CmdRef>0</CmdRef>
      <Cmd>SyncHdr</Cmd>
      <Data>200</Data>
    </Status>
    <Status>
      <CmdID>67890</CmdID>
      <MsgRef>1</MsgRef>
      <CmdRef>1</CmdRef>
      <Cmd>Add</Cmd>
      <Data>200</Data>
    </Status>
    <Final />
  </SyncBody>
</SyncML>

Como determinar qual contexto de instalação usar para um pacote MSI

As tabelas a seguir mostram como o destino do aplicativo e o tipo de pacote MSI (por usuário, por computador ou modo duplo) são instalados no cliente.

Para Intune ambiente autônomo, o pacote MSI determinará o contexto de execução do MSI.

Target	MSI por usuário	MSI por computador	MSI de modo duplo
Usuário	Instalar o MSI por usuário O LocURI contém um prefixo de usuário, como ./User	Instalar o MSI por dispositivo O LocURI contém um prefixo de dispositivo, como ./Device	Instalar o MSI por usuário O LocURI contém um prefixo de usuário, como ./User
System	Instalar o MSI por usuário O LocURI contém um prefixo de usuário, como ./User	Instalar o MSI por dispositivo O LocURI contém um prefixo de dispositivo, como ./Device	Instalar o MSI por usuário O LocURI contém um prefixo de usuário, como ./User

A tabela a seguir se aplica a Configuration Manager ambiente híbrido:

Target	MSI por usuário	MSI por computador	MSI de modo duplo
Usuário	Instalar o MSI por usuário O LocURI contém um prefixo de usuário, como ./User	Instalar o MSI por dispositivo O LocURI contém um prefixo de dispositivo, como ./Device	Instalar o MSI por usuário O LocURI contém um prefixo de usuário, como ./User
System	Instalar o MSI por usuário O LocURI contém um prefixo de usuário, como ./User	Instalar o MSI por dispositivo O LocURI contém um prefixo de dispositivo, como ./Device	Instalar o contexto de MSI por sistema O LocURI contém um prefixo de dispositivo, como ./Device

Como determinar o tipo de pacote do pacote MSI

ALLUSERS="" - tipo de pacote por usuário
ALLUSERS=1 – tipo de pacote por computador
ALLUSERS=2, MSIINSTALLPERUSER=1 – tipo de pacote de modo duplo

As propriedades podem ser especificadas no pacote, passadas pela linha de comando, modificadas por uma transformação ou (mais comumente) selecionadas por meio de uma caixa de diálogo de interface do usuário.

Aqui está uma lista de referências:

Exemplo de alerta

<Alert>
   <CmdID>4</CmdID>
   <Data>1224</Data>
   <Item>
      <Source>
         <LocURI>./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{AF9257BA-6BBD-4624-AA9B-0182D50292C3}/DownloadInstall</LocURI>
      </Source>
      <Meta>
         <Type xmlns="syncml:metinf">Reversed-Domain-Name:com.microsoft.mdm.win32csp_install</Type>
         <Format xmlns="syncml:metinf">int</Format>
         <Mark xmlns="syncml:metinf">informational</Mark>
      </Meta>
      <Data>0</Data>
   </Item>
</Alert>

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

CSP EnterpriseDesktopAppManagement

Dispositivo/MSI

Dispositivo/MSI/{ProductID}

Dispositivo/MSI/{ProductID}/DownloadInstall

Dispositivo/MSI/{ProductID}/InstallDate

Dispositivo/MSI/{ProductID}/InstallPath

Dispositivo/MSI/{ProductID}/LastError

Dispositivo/MSI/{ProductID}/LastErrorDesc

Dispositivo/MSI/{ProductID}/Name

Dispositivo/MSI/{ProductID}/Publisher

Dispositivo/MSI/{ProductID}/Status

Dispositivo/MSI/{ProductID}/Versão

Dispositivo/MSI/UpgradeCode

Dispositivo/MSI/UpgradeCode/{Guid}

Usuário/MSI

Usuário/MSI/{ProductID}

Usuário/MSI/{ProductID}/DownloadInstall

Usuário/MSI/{ProductID}/InstallDate

Usuário/MSI/{ProductID}/InstallPath

Usuário/MSI/{ProductID}/LastError

Usuário/MSI/{ProductID}/LastErrorDesc

Usuário/MSI/{ProductID}/Name

Usuário/MSI/{ProductID}/Publisher

Usuário/MSI/{ProductID}/Status

Usuário/MSI/{ProductID}/Versão

Usuário/MSI/UpgradeCode

Usuário/MSI/UpgradeCode/{Guid}

DownloadInstall XSD Schema

Exemplos

Como determinar qual contexto de instalação usar para um pacote MSI

Como determinar o tipo de pacote do pacote MSI

Exemplo de alerta

Comentários

Comentários

Recursos adicionais

CSP EnterpriseDesktopAppManagement

Dispositivo/MSI

Dispositivo/MSI/{ProductID}

Dispositivo/MSI/{ProductID}/DownloadInstall

Dispositivo/MSI/{ProductID}/InstallDate

Dispositivo/MSI/{ProductID}/InstallPath

Dispositivo/MSI/{ProductID}/LastError

Dispositivo/MSI/{ProductID}/LastErrorDesc

Dispositivo/MSI/{ProductID}/Name

Dispositivo/MSI/{ProductID}/Publisher

Dispositivo/MSI/{ProductID}/Status

Dispositivo/MSI/{ProductID}/Versão

Dispositivo/MSI/UpgradeCode

Dispositivo/MSI/UpgradeCode/{Guid}

Usuário/MSI

Usuário/MSI/{ProductID}

Usuário/MSI/{ProductID}/DownloadInstall

Usuário/MSI/{ProductID}/InstallDate

Usuário/MSI/{ProductID}/InstallPath

Usuário/MSI/{ProductID}/LastError

Usuário/MSI/{ProductID}/LastErrorDesc

Usuário/MSI/{ProductID}/Name

Usuário/MSI/{ProductID}/Publisher

Usuário/MSI/{ProductID}/Status

Usuário/MSI/{ProductID}/Versão

Usuário/MSI/UpgradeCode

Usuário/MSI/UpgradeCode/{Guid}

DownloadInstall XSD Schema

Exemplos

Como determinar qual contexto de instalação usar para um pacote MSI

Como determinar o tipo de pacote do pacote MSI

Exemplo de alerta

Artigos relacionados

Comentários

Comentários

Recursos adicionais