EnterpriseDesktopAppManagement CSP

EnterpriseDesktopAppManagement 構成サービス プロバイダーは、インストールされているエンタープライズ アプリケーションのクエリ、アプリケーションのインストール、アプリケーションの削除など、エンタープライズ デスクトップ アプリケーション管理タスクを処理するために使用されます。

アプリケーションのインストールが完了するまでに時間がかかる場合があるため、非同期的に実行されます。 Exec コマンドが完了すると、クライアントは、エラーか成功かに関係なく、状態を持つ汎用アラートを管理サーバーに送信できます。 SyncML の例については、「 アラートの例」を参照してください。

次の一覧は、EnterpriseDesktopAppManagement 構成サービス プロバイダー ノードを示しています。

デバイス/MSI

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI

製品の種類は MSI です。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 node
アクセスの種類 [ゲームをゲット] を選びます

Device/MSI/{ProductID}

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}

アプリケーションの MSI 製品コード。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 node
アクセスの種類 追加、削除、取得
Atomic Required True
動的ノードの名前付け UniqueName: アプリケーションの MSI 製品コード。

Device/MSI/{ProductID}/DownloadInstall

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/DownloadInstall

アプリケーションのダウンロードとインストールを実行します。 バージョン 1703 サービス リリースWindows 10、XML のセクションに<Enforcement>新しいタグ<DownloadFromAad>が追加されました。 既定値は 0 です (トークンを送信しません)。 このタグは省略可能であり、サーバーがダウンロード URL で AADUserToken を取得する場合は、1 に設定する必要があります。

以下に例を示します。

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

詳細については、「 DownloadInstall XSD スキーマ」を参照してください。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 xml
アクセスの種類 追加、削除、Exec、Get

Device/MSI/{ProductID}/InstallDate

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallDate

アプリケーションのインストール日。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます

Device/MSI/{ProductID}/InstallPath

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallPath

アプリケーションのインストール パス。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます

Device/MSI/{ProductID}/LastError

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastError

アプリケーションのインストール プロセス中の最後のエラー コード。 これは通常、HRESULT 形式として格納されます。 エラーが発生したときに発生した内容によっては、MSIExec.exe を実行した結果、または失敗した API のエラーの結果である可能性があります。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 int
アクセスの種類 [ゲームをゲット] を選びます

Device/MSI/{ProductID}/LastErrorDesc

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastErrorDesc

最後のエラー コードの説明が含まれます。 LastErrorDesc 値は、一致する LastError 値を検索します。 LastErrorDesc が返されない場合があります。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます

Device/MSI/{ProductID}/Name

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Name

アプリケーションの名前。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます

Device/MSI/{ProductID}/Publisher

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Publisher

アプリケーションの発行元。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます

Device/MSI/{ProductID}/Status

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Status

アプリケーションの状態。 有効な値: 10 初期化済み、20-Download In Progress、25-Pending Download Retry、30-Download Failed、40-Download Completed、48-Pending User Session、50-Enforcement In Progress、55-Pending Enforcement Retry、60-Enforcement Failed、70-Enforcement Completed。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 int
アクセスの種類 [ゲームをゲット] を選びます

Device/MSI/{ProductID}/Version

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Version

MSI 製品バージョン。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます

Device/MSI/UpgradeCode

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1607 [10.0.14393] 以降
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 node
アクセスの種類 [ゲームをゲット] を選びます
大文字と小文字の区別 True

Device/MSI/UpgradeCode/{Guid}

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1607 [10.0.14393] 以降
./Device/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode/{Guid}

ゲートウェイ (またはデバイス管理サーバー) では、管理が既存の MSI アプリを更新するときに、このメソッドを使用して一致するアップグレード MSI 製品を検出します。 同じアップグレード製品がインストールされている場合は、更新が許可されます。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます
動的ノードの名前付け ClientInventory

ユーザー/MSI

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI

製品の種類は MSI です。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 node
アクセスの種類 [ゲームをゲット] を選びます

User/MSI/{ProductID}

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}

アプリケーションの MSI 製品コード。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 node
アクセスの種類 追加、削除、取得
Atomic Required True
動的ノードの名前付け UniqueName: アプリケーションの MSI 製品コード。

User/MSI/{ProductID}/DownloadInstall

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/DownloadInstall

アプリケーションのダウンロードとインストールを実行します。 バージョン 1703 サービス リリースWindows 10、XML のセクションに<Enforcement>新しいタグ<DownloadFromAad>が追加されました。 既定値は 0 です (トークンを送信しません)。 このタグは省略可能であり、サーバーがダウンロード URL で AADUserToken を取得する場合は、1 に設定する必要があります。

以下に例を示します。

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

詳細については、「 DownloadInstall XSD スキーマ」を参照してください。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 xml
アクセスの種類 追加、削除、Exec、Get

User/MSI/{ProductID}/InstallDate

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallDate

アプリケーションのインストール日。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます

User/MSI/{ProductID}/InstallPath

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/InstallPath

アプリケーションのインストール パス。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます

User/MSI/{ProductID}/LastError

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastError

アプリケーションのインストール プロセス中の最後のエラー コード。 これは通常、HRESULT 形式として格納されます。 エラーが発生したときに発生した内容によっては、MSIExec.exe を実行した結果、または失敗した API のエラーの結果である可能性があります。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 int
アクセスの種類 [ゲームをゲット] を選びます

User/MSI/{ProductID}/LastErrorDesc

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/LastErrorDesc

最後のエラー コードの説明が含まれます。 LastErrorDesc 値は、一致する LastError 値を検索します。 LastErrorDesc が返されない場合があります。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます

User/MSI/{ProductID}/Name

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Name

アプリケーションの名前。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます

User/MSI/{ProductID}/Publisher

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Publisher

アプリケーションの発行元。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます

User/MSI/{ProductID}/Status

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Status

アプリケーションの状態。 有効な値: 10 初期化済み、20-Download In Progress、25-Pending Download Retry、30-Download Failed、40-Download Completed、48-Pending User Session、50-Enforcement In Progress、55-Pending Enforcement Retry、60-Enforcement Failed、70-Enforcement Completed。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 int
アクセスの種類 [ゲームをゲット] を選びます

User/MSI/{ProductID}/Version

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1511 [10.0.10586] 以降
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/{ProductID}/Version

MSI 製品バージョン。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます

User/MSI/UpgradeCode

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1607 [10.0.14393] 以降
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 node
アクセスの種類 [ゲームをゲット] を選びます
大文字と小文字の区別 True

User/MSI/UpgradeCode/{Guid}

適用範囲 エディション 対象となる OS
✅ デバイス
✅ ユーザー
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅Windows 10バージョン 1607 [10.0.14393] 以降
./User/Vendor/MSFT/EnterpriseDesktopAppManagement/MSI/UpgradeCode/{Guid}

ゲートウェイ (またはデバイス管理サーバー) では、管理が既存の MSI アプリを更新するときに、このメソッドを使用して一致するアップグレード MSI 製品を検出します。 同じアップグレード製品がインストールされている場合は、更新が許可されます。

説明フレームワークのプロパティ:

プロパティ名 プロパティ値
形式 chr (string)
アクセスの種類 [ゲームをゲット] を選びます
動的ノードの名前付け ClientInventory

DownloadInstall XSD スキーマ

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

  • SyncML を使用して 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>
    

    次の表では、前のサンプルのフィールドについて説明します。

    名前 説明
    [ゲームをゲット] を選びます 実行されている操作。 Get 操作は、情報を返す要求です。
    CmdID 要求を参照するために使用される入力値。 応答には、要求と応答の照合に使用できるこの値が含まれます。
    LocURI Win32 CSP コマンド プロセッサへのパス。
  • SyncML を使用して、アプリケーションのアンインストールに対して MSI 操作を実行します。

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

    次の表では、前のサンプルのフィールドについて説明します。

    名前 説明
    Delete 実行されている操作。 削除操作は、指定された MSI インストール済みアプリケーションを表す CSP ノードを削除し、プロセスの一部としてアプリケーションの実行とアンインストールを行う要求です。
    CmdID 要求を参照するために使用される入力値。 応答には、要求と応答の照合に使用できるこの値が含まれます。
    LocURI XML 書式設定用にエスケープされた製品 ID (この例では 1803A630-3C38-4D2B-9B9A-0CB37243539C) を含む、Win32 CSP コマンド プロセッサへのパス。
  • SyncML を使用して、アプリケーションの状態レポートに対して MSI 操作を実行します。

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

    次の表では、前のサンプルのフィールドについて説明します。

    名前 説明
    [ゲームをゲット] を選びます 実行されている操作。 Get 操作は、指定された MSI インストール済みアプリケーションの状態を報告する要求です。
    CmdID 要求を参照するために使用される入力値。 応答には、要求と応答の照合に使用できるこの値が含まれます。
    LocURI XML 書式設定用にエスケープされた製品 ID (この例では 1803A630-3C38-4D2B-9B9A-0CB37243539C) を含む、Win32 CSP コマンド プロセッサへのパス。
  • デバイス上の特定のユーザーを対象とするアプリケーションに対して MSI インストール操作を実行する SyncML。 Exec コマンドの前に Add コマンドが必要です。

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

    次の表では、前のサンプルのフィールドについて説明します。

    名前 説明
    Add Exec コマンドの前にこのフィールドが必要です。
  • CmdID - 要求の参照に使用される入力値。 応答には、この値が含まれます。これは、要求と応答の一致に使用できます。
  • LocURI - XML 書式設定用にエスケープされた製品 ID (この例では、1803A630-3C38-4D2B-9B9A-0CB37243539C) プロパティを含む、Win32 CSP コマンド プロセッサへのパス。
  • Exec Exec ノードには、製品のインストールを検索、ダウンロード、検証、実行するために必要なパラメーターとプロパティが含まれています。
  • CmdID - 要求の参照に使用される入力値。 応答には、要求と応答の照合に使用できるこの値が含まれます。
  • LocURI - XML 書式設定用にエスケープされた製品 ID (この例では、1803A630-3C38-4D2B-9B9A-0CB37243539C) プロパティを含む、Win32 CSP コマンド プロセッサへのパス。
  • データ - データ ノードには、"MsiInstallJob" 型の埋め込み XML が含まれています
  • MsiInstallJob - MSI インストール プロセスの正常なダウンロード、検証、実行に必要なすべての情報が含まれています (この埋め込みデータ オブジェクトの詳細については、このドキュメントの最後のセクションを参照してください)。
  • MSI ジョブの情報の状態は、標準の OMA-DM 通知メカニズムを使用して報告されます。 報告される状態は、Microsoft TechNet at Msiexec (コマンド ライン オプション) の MSIEXEC トピックで定義されているように、標準の MSIEXEC リターン コードを HRESULT として使用して表されます。

  • デバイス上のすべてのユーザーを対象とするアプリケーションに対して MSI インストール操作を実行する SyncML (デバイスごとのインストール):

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

    次の表 MsiInstallJob では、スキーマ要素について説明します。

    要素 説明
    MsiInstallJob root 要素
    属性: "id" - インストールされているアプリケーションのアプリケーション識別子
    製品 MsiInstallJob の child 要素
    属性: "Version" - アプリケーション バージョンの文字列表現
    ダウンロード Product の child 要素。 構成情報をダウンロードするためのコンテナー。
    ContentURLList ダウンロードの child 要素。 ContentURL 要素の形式で 1 つ以上のコンテンツ ダウンロード URL ロケーターの一覧が含まれます。
    ContentURL 場所のコンテンツはからダウンロードする必要があります。 .MSI ファイルを指すプロパティ形式の URL にする必要があります。
    検証 競合の信頼性を検証するために使用される情報が含まれます。 • FileHash - ファイル コンテンツの SHA256 ハッシュ値
    FileHash ファイル コンテンツの SHA256 ハッシュ値
    使用停止措置 この MSI をインストールするときに使用するインストール プロパティ
    コマンドライン MSIEXEC.exe を呼び出すときに使用するコマンド ライン オプション
    タイムアウト インストールが失敗し、インストール操作が監視されなくなった可能性があるとインストーラーが判断するまでに、インストール プロセスを実行できる時間 (分)。
    RetryCount インストールが失敗としてマークされるまでに、ダウンロードとインストール操作が再試行される回数。
    RetryInterval 再試行操作間の時間 (分単位)。

    要求に対する一般的な応答の例を次に示します。

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

MSI パッケージに使用するインストール コンテキストを決定する方法

次の表は、アプリのターゲット設定と MSI パッケージの種類 (ユーザーごと、コンピューターごと、またはデュアル モード) がクライアントにインストールされる方法を示しています。

スタンドアロン環境Intune場合、MSI パッケージによって MSI 実行コンテキストが決定されます。

ターゲット ユーザーごとの MSI マシンごとの MSI デュアル モード MSI
ユーザー ユーザーごとの MSI のインストール
LocURI には、./User などのユーザー プレフィックスが含まれています
デバイスごとの MSI のインストール
LocURI には、./Device などのデバイス プレフィックスが含まれています
ユーザーごとの MSI のインストール
LocURI には、./User などのユーザー プレフィックスが含まれています
System ユーザーごとの MSI のインストール
LocURI には、./User などのユーザー プレフィックスが含まれています
デバイスごとの MSI のインストール
LocURI には、./Device などのデバイス プレフィックスが含まれています
ユーザーごとの MSI のインストール
LocURI には、./User などのユーザー プレフィックスが含まれています

次の表は、ハイブリッド環境Configuration Manager適用されます。

ターゲット ユーザーごとの MSI マシンごとの MSI デュアル モード MSI
ユーザー ユーザーごとの MSI のインストール
LocURI には、./User などのユーザー プレフィックスが含まれています
デバイスごとの MSI のインストール
LocURI には、./Device などのデバイス プレフィックスが含まれています
ユーザーごとの MSI のインストール
LocURI には、./User などのユーザー プレフィックスが含まれています
System ユーザーごとの MSI のインストール
LocURI には、./User などのユーザー プレフィックスが含まれています
デバイスごとの MSI のインストール
LocURI には、./Device などのデバイス プレフィックスが含まれています
システム ごとの MSI コンテキストをインストールする
LocURI には、./Device などのデバイス プレフィックスが含まれています

MSI パッケージからパッケージの種類を確認する方法

  • ALLUSERS="" - ユーザーごとのパッケージの種類
  • ALLUSERS=1 - マシンごとのパッケージの種類
  • ALLUSERS=2、MSIINSTALLPERUSER=1 - デュアル モード パッケージの種類

プロパティは、パッケージ内で指定したり、コマンド ラインを介して渡したり、変換によって変更したり、(より一般的に) ユーザー インターフェイス ダイアログで選択したりできます。

参照の一覧を次に示します。

アラートの例

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

構成サービス プロバイダーのリファレンス