win32LobApp を作成する
名前空間: microsoft.graph
大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
新しい win32LobApp オブジェクトを 作成します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | DeviceManagementConfiguration.ReadWrite.All、DeviceManagementApps.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | DeviceManagementConfiguration.ReadWrite.All、DeviceManagementApps.ReadWrite.All |
HTTP 要求
POST /deviceAppManagement/mobileApps
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
| 承諾 | application/json |
要求本文
要求本文で、win32LobApp オブジェクトの JSON 表現を指定します。
次の表は、win32LobApp を作成するときに必要なプロパティを示しています。
| プロパティ | 型 | 説明 |
|---|---|---|
| id | String | エンティティのキー。 このプロパティは読み取り専用です。 mobileApp から継承します |
| displayName | String | 管理者が提供またはインポートしたアプリのタイトル。 mobileApp から継承します |
| description | String | アプリの説明。 mobileApp から継承します |
| publisher | String | アプリの発行元。 mobileApp から継承します |
| largeIcon | mimeContent | アプリの詳細に表示され、アイコンのアップロードに使用される大きいアイコン。 mobileApp から継承します |
| createdDateTime | DateTimeOffset | アプリが作成された日時。 このプロパティは読み取り専用です。 mobileApp から継承します |
| lastModifiedDateTime | DateTimeOffset | アプリが最後に変更された日時。 このプロパティは読み取り専用です。 mobileApp から継承します |
| isFeatured | Boolean | アプリが管理者のおすすめとしてマークされたかどうかを示す値。mobileApp から継承します |
| privacyInformationUrl | String | プライバシーに関する声明の URL。 mobileApp から継承します |
| informationUrl | String | 詳細情報の URL。 mobileApp から継承します |
| owner | String | アプリの所有者。 mobileApp から継承します |
| developer | String | アプリの開発者。 mobileApp から継承します |
| notes | String | アプリ用のメモ。 mobileApp から継承します |
| uploadState | Int32 | アップロードの状態。 使用可能な値は、0 から Not Ready、1 から Ready2 - Processingです。 このプロパティは読み取り専用です。 mobileApp から継承します |
| publishingState | mobileAppPublishingState | アプリの発行の状態。 アプリが発行されていない限り、アプリを割り当てることができません。 このプロパティは読み取り専用です。 mobileApp から継承されます。 可能な値は notPublished、processing、published です。 |
| isAssigned | ブール型 | アプリが少なくとも 1 つのグループに割り当てられているかどうかを示す値。 このプロパティは読み取り専用です。 mobileApp から継承します |
| roleScopeTagIds | String collection | このモバイル アプリのスコープ タグ ID の一覧。 mobileApp から継承します |
| dependentAppCount | Int32 | 子アプリに含まれる依存関係の合計数。 このプロパティは読み取り専用です。 mobileApp から継承します |
| supersedingAppCount | Int32 | このアプリが直接的または間接的に置き換わるアプリの合計数。 このプロパティは読み取り専用です。 mobileApp から継承します |
| 置き換えAppCount | Int32 | このアプリが直接または間接的に置き換えられるアプリの合計数。 このプロパティは読み取り専用です。 mobileApp から継承します |
| committedContentVersion | String | 内部にコミットされたコンテンツのバージョン。 mobileLobApp から継承します |
| fileName | String | メインの LOB アプリケーションのファイル名。 mobileLobApp から継承します |
| size | Int64 | アップロードされたすべてのファイルを含む合計サイズ。 このプロパティは読み取り専用です。 mobileLobApp から継承します |
| installCommandLine | String | このアプリをインストールするコマンド ライン |
| uninstallCommandLine | String | このアプリをアンインストールするコマンド ライン |
| applicableArchitectures | windowsArchitecture | このアプリを実行できる Windows アーキテクチャ。 使用可能な値: none、x86、x64、arm、neutral、arm64。 |
| minimumSupportedOperatingSystem | windowsMinimumOperatingSystem | 該当するオペレーティング システムの最小の値。 |
| minimumFreeDiskSpaceInMB | Int32 | このアプリをインストールするために必要な最小空きディスク領域の値。 |
| minimumMemoryInMB | Int32 | このアプリをインストールするために必要な最小物理メモリの値。 |
| minimumNumberOfProcessors | Int32 | このアプリをインストールするために必要なプロセッサの最小数の値。 |
| minimumCpuSpeedInMHz | Int32 | このアプリをインストールするために必要な最小 CPU 速度の値。 |
| detectionRules | win32LobAppDetection コレクション | Win32 基幹業務 (LoB) アプリを検出するための検出ルール。 |
| requirementRules | win32LobAppRequirement コレクション | Win32 基幹業務 (LoB) アプリを検出するための要件ルール。 |
| ルール | win32LobAppRule コレクション | このアプリの検出と要件の規則。 |
| installExperience | win32LobAppInstallExperience | このアプリのインストール エクスペリエンス。 |
| returnCodes | win32LobAppReturnCode コレクション | インストール後の動作の戻りコード。 |
| msiInformation | win32LobAppMsiInformation | この Win32 アプリが MSI アプリの場合の MSI の詳細。 |
| setupFilePath | String | 暗号化された Win32LobApp パッケージ内のセットアップ ファイルの相対パス。 |
| minimumSupportedWindowsRelease | String | サポートされている最小 Windows リリースの値。 |
| displayVersion | String | このアプリの UX に表示されるバージョン。 |
| allowAvailableUninstall | ブール型 | TRUE の場合、Windows アプリ (Win32) のポータル サイトから使用可能な割り当てでアンインストールがサポートされていることを示します。 FALSE の場合は、Windows アプリ (Win32) で使用可能な割り当てでアンインストールがサポートされていないことを示します。 既定値は FALSE です。 |
応答
成功した場合、このメソッドは 201 Created 応答コードと、応答本文に win32LobApp オブジェクトを返します。
例
要求
以下は、要求の例です。
POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 3518
{
"@odata.type": "#microsoft.graph.win32LobApp",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2,
"committedContentVersion": "Committed Content Version value",
"fileName": "File Name value",
"size": 4,
"installCommandLine": "Install Command Line value",
"uninstallCommandLine": "Uninstall Command Line value",
"applicableArchitectures": "x86",
"minimumSupportedOperatingSystem": {
"@odata.type": "microsoft.graph.windowsMinimumOperatingSystem",
"v8_0": true,
"v8_1": true,
"v10_0": true,
"v10_1607": true,
"v10_1703": true,
"v10_1709": true,
"v10_1803": true,
"v10_1809": true,
"v10_1903": true,
"v10_1909": true,
"v10_2004": true,
"v10_2H20": true,
"v10_21H1": true
},
"minimumFreeDiskSpaceInMB": 8,
"minimumMemoryInMB": 1,
"minimumNumberOfProcessors": 9,
"minimumCpuSpeedInMHz": 4,
"detectionRules": [
{
"@odata.type": "microsoft.graph.win32LobAppRegistryDetection",
"check32BitOn64System": true,
"keyPath": "Key Path value",
"valueName": "Value Name value",
"detectionType": "exists",
"operator": "equal",
"detectionValue": "Detection Value value"
}
],
"requirementRules": [
{
"@odata.type": "microsoft.graph.win32LobAppRegistryRequirement",
"operator": "equal",
"detectionValue": "Detection Value value",
"check32BitOn64System": true,
"keyPath": "Key Path value",
"valueName": "Value Name value",
"detectionType": "exists"
}
],
"rules": [
{
"@odata.type": "microsoft.graph.win32LobAppRegistryRule",
"ruleType": "requirement",
"check32BitOn64System": true,
"keyPath": "Key Path value",
"valueName": "Value Name value",
"operationType": "exists",
"operator": "equal",
"comparisonValue": "Comparison Value value"
}
],
"installExperience": {
"@odata.type": "microsoft.graph.win32LobAppInstallExperience",
"runAsAccount": "user",
"maxRunTimeInMinutes": 3,
"deviceRestartBehavior": "allow"
},
"returnCodes": [
{
"@odata.type": "microsoft.graph.win32LobAppReturnCode",
"returnCode": 10,
"type": "success"
}
],
"msiInformation": {
"@odata.type": "microsoft.graph.win32LobAppMsiInformation",
"productCode": "Product Code value",
"productVersion": "Product Version value",
"upgradeCode": "Upgrade Code value",
"requiresReboot": true,
"packageType": "perUser",
"productName": "Product Name value",
"publisher": "Publisher value"
},
"setupFilePath": "Setup File Path value",
"minimumSupportedWindowsRelease": "Minimum Supported Windows Release value",
"displayVersion": "Display Version value",
"allowAvailableUninstall": true
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 3690
{
"@odata.type": "#microsoft.graph.win32LobApp",
"id": "9607b530-b530-9607-30b5-079630b50796",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2,
"committedContentVersion": "Committed Content Version value",
"fileName": "File Name value",
"size": 4,
"installCommandLine": "Install Command Line value",
"uninstallCommandLine": "Uninstall Command Line value",
"applicableArchitectures": "x86",
"minimumSupportedOperatingSystem": {
"@odata.type": "microsoft.graph.windowsMinimumOperatingSystem",
"v8_0": true,
"v8_1": true,
"v10_0": true,
"v10_1607": true,
"v10_1703": true,
"v10_1709": true,
"v10_1803": true,
"v10_1809": true,
"v10_1903": true,
"v10_1909": true,
"v10_2004": true,
"v10_2H20": true,
"v10_21H1": true
},
"minimumFreeDiskSpaceInMB": 8,
"minimumMemoryInMB": 1,
"minimumNumberOfProcessors": 9,
"minimumCpuSpeedInMHz": 4,
"detectionRules": [
{
"@odata.type": "microsoft.graph.win32LobAppRegistryDetection",
"check32BitOn64System": true,
"keyPath": "Key Path value",
"valueName": "Value Name value",
"detectionType": "exists",
"operator": "equal",
"detectionValue": "Detection Value value"
}
],
"requirementRules": [
{
"@odata.type": "microsoft.graph.win32LobAppRegistryRequirement",
"operator": "equal",
"detectionValue": "Detection Value value",
"check32BitOn64System": true,
"keyPath": "Key Path value",
"valueName": "Value Name value",
"detectionType": "exists"
}
],
"rules": [
{
"@odata.type": "microsoft.graph.win32LobAppRegistryRule",
"ruleType": "requirement",
"check32BitOn64System": true,
"keyPath": "Key Path value",
"valueName": "Value Name value",
"operationType": "exists",
"operator": "equal",
"comparisonValue": "Comparison Value value"
}
],
"installExperience": {
"@odata.type": "microsoft.graph.win32LobAppInstallExperience",
"runAsAccount": "user",
"maxRunTimeInMinutes": 3,
"deviceRestartBehavior": "allow"
},
"returnCodes": [
{
"@odata.type": "microsoft.graph.win32LobAppReturnCode",
"returnCode": 10,
"type": "success"
}
],
"msiInformation": {
"@odata.type": "microsoft.graph.win32LobAppMsiInformation",
"productCode": "Product Code value",
"productVersion": "Product Version value",
"upgradeCode": "Upgrade Code value",
"requiresReboot": true,
"packageType": "perUser",
"productName": "Product Name value",
"publisher": "Publisher value"
},
"setupFilePath": "Setup File Path value",
"minimumSupportedWindowsRelease": "Minimum Supported Windows Release value",
"displayVersion": "Display Version value",
"allowAvailableUninstall": true
}
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示