Partager via

Mettre à jour macOSLobApp

  • Article

Espace de noms: microsoft.graph

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.

Mettez à jour les propriétés d’un objet macOSLobApp .

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet
✅ ✅ ✅ ✅

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) DeviceManagementApps.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application DeviceManagementApps.ReadWrite.All

Requête HTTP

PATCH /deviceAppManagement/mobileApps/{mobileAppId}

En-têtes de demande

En-tête Valeur
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Accepter application/json

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON pour l’objet macOSLobApp .

Le tableau suivant présente les propriétés requises lorsque vous créez l’application macOSLobApp.

Propriété Type Description
id String Clé de l’entité. Hérité de mobileApp.
displayName String Titre de l’application, importé ou fourni par l’administrateur. Hérité de mobileApp.
description String Description de l’application. Hérité de mobileApp.
éditeur String Éditeur de l’application. Hérité de mobileApp.
largeIcon mimeContent Grande icône, à afficher dans les détails de l’application et permettant de télécharger l’icône. Hérité de mobileApp.
createdDateTime DateTimeOffset Date et heure de création de l’application. Hérité de mobileApp.
lastModifiedDateTime DateTimeOffset Date et heure de la dernière modification de l’application. Hérité de mobileApp.
isFeaturedisFeatured Booléen Valeur indiquant si l’application est marquée comme recommandée par l’administrateur- Hérité de mobileApp.
privacyInformationUrl String URL de déclaration de confidentialité. Hérité de mobileApp.
informationUrl String URL pour plus d’informations. Hérité de mobileApp.
owner String Propriétaire de l’application. Hérité de mobileApp.
developer String Développeur de l’application. Hérité de mobileApp.
notes String Notes de l’application. Hérité de mobileApp.
publishingState mobileAppPublishingState État de publication pour l’application. L’application ne peut pas être affectée, sauf si elle est publiée. Hérité de mobileApp. Les valeurs possibles sont notPublished, processing et published.
committedContentVersion String Version de contenu validé interne. Hérité de mobileLobApp.
fileName String Nom du fichier d’application métier principal. Hérité de mobileLobApp.
size Int64 Taille totale, tous les fichiers chargés compris. Hérité de mobileLobApp.
bundleId Chaîne BundleId principal du package.
minimumSupportedOperatingSystem macOSMinimumOperatingSystem ComplexType macOSMinimumOperatingSystem qui indique le système d’exploitation minimal applicable à l’application.
buildNumber Chaîne Numéro de build du package. Cela doit correspondre au package CFBundleShortVersionString du fichier .pkg.
versionNumber Chaîne Numéro de version du package. Cela doit correspondre au package CFBundleVersion dans le fichier packageinfo.
childApps Collection macOSLobChildApp Liste des objets ComplexType macOSLobChildApp. Représente les applications qui doivent être installées par le package.
md5HashChunkSize Int32 Taille du bloc pour le hachage MD5. Il s’agit de « 0 » ou vide si le package a été chargé directement. Si le Intune App Wrapping Tool est utilisé pour créer un fichier .intunemac, cette valeur se trouve dans le fichier Detection.xml.
md5Hash String collection Codes de hachage MD5. Ce champ est vide si le package a été chargé directement. Si le Intune App Wrapping Tool est utilisé pour créer un fichier .intunemac, cette valeur se trouve dans le fichier Detection.xml.
ignoreVersionDetection Valeur booléenne Si la valeur est TRUE, indique que la version de l’application ne sera PAS utilisée pour détecter si l’application est installée sur un appareil. Si la valeur est FALSE, indique que la version de l’application sera utilisée pour détecter si l’application est installée sur un appareil. Définissez cette valeur sur true pour les applications qui utilisent une fonctionnalité de mise à jour automatique.
installAsManaged Valeur booléenne Si la valeur est TRUE, indique que l’application sera installée comme gérée (nécessite macOS 11.0 et d’autres restrictions de package managé). Si la valeur est FALSE, indique que l’application sera installée comme non managée.

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet macOSLobApp mis à jour dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

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
}

Réponse

Voici un exemple de réponse. Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.

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
}