EnterpriseDesktopAppManagement CSP
EnterpriseDesktopAppManagement 構成サービス プロバイダーは、インストールされているエンタープライズ アプリケーションのクエリ、アプリケーションのインストール、アプリケーションの削除など、エンタープライズ デスクトップ アプリケーション管理タスクを処理するために使用されます。
アプリケーションのインストールが完了するまでに時間がかかる場合があるため、非同期的に実行されます。 Exec コマンドが完了すると、クライアントは、エラーか成功かに関係なく、状態を持つ汎用アラートを管理サーバーに送信できます。 SyncML の例については、「 アラートの例」を参照してください。
次の一覧は、EnterpriseDesktopAppManagement 構成サービス プロバイダー ノードを示しています。
- ./Device/Vendor/MSFT/EnterpriseDesktopAppManagement
- ./User/Vendor/MSFT/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、Replace |
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、Replace |
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>