macOSLobApp を作成する
名前空間: microsoft.graph
大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
新しい macOSLobApp オブジェクトを 作成します。
この 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 |
要求本文
要求本文で、macOSLobApp オブジェクトの JSON 表現を指定します。
次の表は、macOSLobApp を作成するときに必要なプロパティを示しています。
| プロパティ | 型 | 説明 |
|---|---|---|
| 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 から継承します |
| bundleId | String | パッケージのプライマリ bundleId。 |
| minimumSupportedOperatingSystem | macOSMinimumOperatingSystem | アプリケーションに適用できる最小オペレーティング システムを示す ComplexType macOSMinimumOperatingSystem。 |
| buildNumber | String | パッケージのビルド番号。 これは、.pkg ファイルのパッケージ CFBundleShortVersionString と一致する必要があります。 |
| VersionNumber | String | パッケージのバージョン番号。 これは packageinfo ファイルのパッケージ CFBundleVersion と一致する必要があります。 |
| childApps | macOSLobChildApp コレクション | ComplexType macOSLobChildApp オブジェクトの一覧。 パッケージによってインストールされると予想されるアプリを表します。 |
| md5HashChunkSize | Int32 | MD5 ハッシュのチャンク サイズ。 パッケージが直接アップロードされた場合、これは '0' または空です。 Intune App Wrapping Toolを使用して .intunemac を作成する場合、この値は Detection.xml ファイル内にあります。 |
| md5Hash | String collection | MD5 ハッシュ コード。 パッケージが直接アップロードされた場合、これは空です。 Intune App Wrapping Toolを使用して .intunemac を作成する場合、この値は Detection.xml ファイル内にあります。 |
| ignoreVersionDetection | ブール型 | TRUE の場合、アプリのバージョンは、アプリがデバイスにインストールされているかどうかを検出するために使用されないことを示します。 FALSE の場合は、アプリがデバイスにインストールされているかどうかを検出するためにアプリのバージョンが使用されることを示します。 自己更新機能を使用するアプリの場合は、これを true に設定します。 既定値は FALSE です。 |
| installAsManaged | ブール型 | TRUE の場合、アプリがマネージドとしてインストールされることを示します (macOS 11.0 およびその他のマネージド パッケージの制限が必要です)。 FALSE の場合は、アプリがアンマネージドとしてインストールされることを示します。 既定値は FALSE です。 |
応答
成功した場合、このメソッドは 201 Created 応答コードと macOSLobApp オブジェクトを応答本文に返します。
例
要求
以下は、要求の例です。
POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 1734
{
"@odata.type": "#microsoft.graph.macOSLobApp",
"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,
"bundleId": "Bundle Id value",
"minimumSupportedOperatingSystem": {
"@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",
"v10_7": true,
"v10_8": true,
"v10_9": true,
"v10_10": true,
"v10_11": true,
"v10_12": true,
"v10_13": true,
"v10_14": true,
"v10_15": true,
"v11_0": true,
"v12_0": true,
"v13_0": true,
"v14_0": true
},
"buildNumber": "Build Number value",
"versionNumber": "Version Number value",
"childApps": [
{
"@odata.type": "microsoft.graph.macOSLobChildApp",
"bundleId": "Bundle Id value",
"buildNumber": "Build Number value",
"versionNumber": "Version Number value"
}
],
"md5HashChunkSize": 0,
"md5Hash": [
"Md5Hash value"
],
"ignoreVersionDetection": true,
"installAsManaged": true
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1906
{
"@odata.type": "#microsoft.graph.macOSLobApp",
"id": "7be9250a-250a-7be9-0a25-e97b0a25e97b",
"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,
"bundleId": "Bundle Id value",
"minimumSupportedOperatingSystem": {
"@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",
"v10_7": true,
"v10_8": true,
"v10_9": true,
"v10_10": true,
"v10_11": true,
"v10_12": true,
"v10_13": true,
"v10_14": true,
"v10_15": true,
"v11_0": true,
"v12_0": true,
"v13_0": true,
"v14_0": true
},
"buildNumber": "Build Number value",
"versionNumber": "Version Number value",
"childApps": [
{
"@odata.type": "microsoft.graph.macOSLobChildApp",
"bundleId": "Bundle Id value",
"buildNumber": "Build Number value",
"versionNumber": "Version Number value"
}
],
"md5HashChunkSize": 0,
"md5Hash": [
"Md5Hash value"
],
"ignoreVersionDetection": true,
"installAsManaged": true
}
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示