Mettre à jour mobileAppInstallSummary

Espace de noms: microsoft.graph

Important: Les API Microsoft Graph sous la version /beta sont susceptibles d’être modifiées ; l’utilisation de production n’est pas prise en charge.

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

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

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}/installSummary

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 mobileAppInstallSummary .

Le tableau suivant indique les propriétés requises lorsque vous créez mobileAppInstallSummary.

Propriété	Type	Description
id	String	Clé de l’entité.
installedDeviceCount	Int32	Nombre d’appareils qui ont correctement installé cette application.
failedDeviceCount	Int32	Nombre d’appareils qui n’ont pas pu installer cette application.
notApplicableDeviceCount	Int32	Nombre d’appareils qui ne sont pas applicables à cette application.
notInstalledDeviceCount	Int32	Nombre d’appareils où cette application n’est pas installée.
pendingInstallDeviceCount	Int32	Nombre d’appareils qui ont été avertis d’installer cette application.
installedUserCount	Int32	Nombre d’utilisateurs dont tous les appareils ont réussi à installer cette application.
failedUserCount	Int32	Nombre d’utilisateurs disposant d’au moins 1 appareil qui n’ont pas pu installer cette application.
notApplicableUserCount	Int32	Nombre d’utilisateurs dont tous les appareils ne s’appliquaient pas à cette application.
notInstalledUserCount	Int32	Nombre d’utilisateurs disposant d’au moins 1 appareil qui n’ont pas installé cette application.
pendingInstallUserCount	Int32	Nombre d’utilisateurs disposant d’au moins 1 appareil qui ont été avertis d’installer cette application et dont 0 appareil présente des défaillances.

Réponse

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

Exemple

Demande

Voici un exemple de demande.

PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/installSummary
Content-type: application/json
Content-length: 374

{
  "@odata.type": "#microsoft.graph.mobileAppInstallSummary",
  "installedDeviceCount": 4,
  "failedDeviceCount": 1,
  "notApplicableDeviceCount": 8,
  "notInstalledDeviceCount": 7,
  "pendingInstallDeviceCount": 9,
  "installedUserCount": 2,
  "failedUserCount": 15,
  "notApplicableUserCount": 6,
  "notInstalledUserCount": 5,
  "pendingInstallUserCount": 7
}

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: 423

{
  "@odata.type": "#microsoft.graph.mobileAppInstallSummary",
  "id": "06a792e9-92e9-06a7-e992-a706e992a706",
  "installedDeviceCount": 4,
  "failedDeviceCount": 1,
  "notApplicableDeviceCount": 8,
  "notInstalledDeviceCount": 7,
  "pendingInstallDeviceCount": 9,
  "installedUserCount": 2,
  "failedUserCount": 15,
  "notApplicableUserCount": 6,
  "notInstalledUserCount": 5,
  "pendingInstallUserCount": 7
}