次の方法で共有

macOSLobApp を更新する

  • [アーティクル]

名前空間: microsoft.graph

注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。

macOSLobApp オブジェクトのプロパティを更新します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ✅ ✅ ✅

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) DeviceManagementApps.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション DeviceManagementApps.ReadWrite.All

HTTP 要求

PATCH /deviceAppManagement/mobileApps/{mobileAppId}

要求ヘッダー

ヘッダー 値
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 から継承します
publishingState mobileAppPublishingState アプリの発行の状態。 アプリが発行されていない限り、アプリを割り当てることができません。 mobileApp から継承されます。 可能な値は notPublished、processing、published です。
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 に設定します。
installAsManaged ブール型 TRUE の場合、アプリがマネージドとしてインストールされることを示します (macOS 11.0 およびその他のマネージド パッケージの制限が必要です)。 FALSE の場合は、アプリがアンマネージドとしてインストールされることを示します。

応答

成功した場合、このメソッドは 200 OK 応答コードと更新された macOSLobApp オブジェクトを応答本文に返します。

例

要求

以下は、要求の例です。

PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}
Content-type: application/json
Content-length: 1523

{
  "@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",
  "publishingState": "processing",
  "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
  },
  "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 200 OK
Content-Type: application/json
Content-Length: 1695

{
  "@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",
  "publishingState": "processing",
  "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
  },
  "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
}