Aktualisieren von mobileAppInstallStatus

Namespace: microsoft.graph

Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Aktualisieren sie die Eigenschaften eines mobileAppInstallStatus-Objekts .

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	DeviceManagementApps.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	DeviceManagementApps.ReadWrite.All

HTTP-Anforderung

PATCH /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}
PATCH /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/deviceStatuses/{mobileAppInstallStatusId}

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Annehmen	application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung für das mobileAppInstallStatus-Objekt an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von mobileAppInstallStatus erforderlich sind.

Eigenschaft	Typ	Beschreibung
id	String	Schlüssel der Entität
deviceName	String	Gerätename
deviceId	String	Geräte-ID
lastSyncDateTime	DateTimeOffset	Uhrzeit der letzten Synchronisierung
mobileAppInstallStatusValue	resultantAppState	Der Installationsstatus der App. Mögliche Werte: installed, failed, notInstalled, uninstallFailed, pendingInstall, unknown, notApplicable.
installState	resultantAppState	Der Installationsstatus der App. Mögliche Werte: installed, failed, notInstalled, uninstallFailed, pendingInstall, unknown, notApplicable.
installStateDetail	resultantAppStateDetail	Der Installationsstatus der App. Mögliche Werte sind: noAdditionalDetails, dependencyFailedToInstall, dependencyWithRequirementsNotMet, dependencyPendingReboot, dependencyWithAutoInstallDisabled, supersededAppUninstallFailed, supersededAppUninstallPendingReboot, removingSupersededAppsminimumDiskSpaceNotMetminimumOsVersionNotMetminimumPhysicalMemoryNotMetminimumLogicalProcessorCountNotMetplatformNotApplicableminimumCpuSpeedNotMetfileSystemRequirementNotMetpowerShellScriptRequirementNotMetregistryRequirementNotMetsupersedingAppsNotApplicableinstallingDependenciescontentDownloadedpendingRebootappRemovedBySupersedenceseeUninstallErrorCodeuntargetedSupersedingAppsDetecteduserIsNotLoggedIntoAppStoreiosAppStoreUpdateFailedToInstalluserRejectedInstallmanagedAppNoLongerPresentvppAppHasUpdateAvailableautoInstallDisabledseeInstallErrorCodeuninstallPendingRebootuserRejectedUpdatesupersedingAppsDetectedsupersededAppsDetected. processorArchitectureNotApplicable
errorCode	Int32	Der Fehlercode für Installations- oder Deinstallationsfehler.
osVersion	String	Betriebssystemversion
osDescription	String	Betriebssystembeschreibung
userName	String	Gerätebenutzername
userPrincipalName	String	Benutzerprinzipalname
displayVersion	String	Lesbare Version der Anwendung

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und ein aktualisiertes mobileAppInstallStatus-Objekt im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

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

{
  "@odata.type": "#microsoft.graph.mobileAppInstallStatus",
  "deviceName": "Device Name value",
  "deviceId": "Device Id value",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "mobileAppInstallStatusValue": "failed",
  "installState": "failed",
  "installStateDetail": "dependencyFailedToInstall",
  "errorCode": 9,
  "osVersion": "Os Version value",
  "osDescription": "Os Description value",
  "userName": "User Name value",
  "userPrincipalName": "User Principal Name value",
  "displayVersion": "Display Version value"
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 604

{
  "@odata.type": "#microsoft.graph.mobileAppInstallStatus",
  "id": "7560ee45-ee45-7560-45ee-607545ee6075",
  "deviceName": "Device Name value",
  "deviceId": "Device Id value",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "mobileAppInstallStatusValue": "failed",
  "installState": "failed",
  "installStateDetail": "dependencyFailedToInstall",
  "errorCode": 9,
  "osVersion": "Os Version value",
  "osDescription": "Os Description value",
  "userName": "User Name value",
  "userPrincipalName": "User Principal Name value",
  "displayVersion": "Display Version value"
}