Поделиться через


Обновление macOSLobApp

Пространство имен: microsoft.graph

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Обновление свойств объекта macOSLobApp .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) DeviceManagementApps.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Приложение DeviceManagementApps.ReadWrite.All

HTTP-запрос

PATCH /deviceAppManagement/mobileApps/{mobileAppId}

Заголовки запроса

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept 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 Имя основного файла бизнес-приложения. Наследуется от mobileLobApp.
size Int64 Общий размер, включая все отправленные файлы. Наследуется от mobileLobApp.
bundleId String Основной идентификатор bundleId пакета.
minimumSupportedOperatingSystem macOSMinimumOperatingSystem; ComplexType macOSMinimumOperatingSystem, указывающий минимальную операционную систему, применимую к приложению.
buildNumber String Номер сборки пакета. Он должен соответствовать пакету CFBundleShortVersionString .pkg файла.
versionNumber String Номер версии пакета. Он должен соответствовать значению пакета CFBundleVersion в файле packageinfo.
childApps Коллекция macOSLobChildApp Список объектов ComplexType macOSLobChildApp. Представляет приложения, которые должны быть установлены пакетом.
md5HashChunkSize Int32 Размер блока для хэша MD5. Значение "0" или пустое значение, если пакет был отправлен напрямую. Если Intune App Wrapping Tool используется для создания intunemac, это значение можно найти в Detection.xml файле.
md5Hash Коллекция строк Хэш-коды 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
}