mobileAppSupersedence aktualisieren
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 mobileAppSupersedence-Objekts .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
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) | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
| Anwendung | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
HTTP-Anforderung
PATCH /deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId}
PATCH /deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId}
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung für das mobileAppSupersedence-Objekt an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von mobileAppSupersedence erforderlich sind.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | String | Der eindeutige Bezeichner für die Beziehungsentität der mobilen App. Dies wird bei der Erstellung der MobileAppRelationship-Entität zugewiesen. Beispiel: 2dbc75b9-e993-4e4d-a071-91ac5a218672_43aaaf35-ce51-4695-9447-5eac6df31161. Schreibgeschützt. Wird standardmäßig zurückgegeben. Unterstützt: $select. Unterstützt keine $search, $filter, $orderBy. Geerbt von mobileAppRelationship |
| targetId | String | Der eindeutige App-Bezeichner des Ziels der Beziehungsentität der mobilen App. Beispiel: 2dbc75b9-e993-4e4d-a071-91ac5a218672. Schreibgeschützt. Wird standardmäßig zurückgegeben. Unterstützt: $select. Unterstützt keine $search, $filter, $orderBy. Geerbt von mobileAppRelationship |
| targetDisplayName | String | Der Anzeigename der App, die das Ziel der Beziehungsentität der mobilen App ist. Beispiel: Firefox Setup 52.0.2 32bit.intunewin. Die maximale Länge beträgt 500 Zeichen. Schreibgeschützt. Wird standardmäßig zurückgegeben. Unterstützt: $select. Unterstützt keine $search, $filter, $orderBy. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship |
| targetDisplayVersion | String | Die Anzeigeversion der App, die das Ziel der Mobile App-Beziehungsentität ist. Beispiel: 1.0 oder 1.2203.156. Schreibgeschützt. Wird standardmäßig zurückgegeben. Unterstützt: $select. Unterstützt keine $search, $filter, $orderBy. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship |
| targetPublisher | String | Der Herausgeber der App, die das Ziel der Beziehungsentität für mobile Apps ist. Beispiel: Fabrikam. Die maximale Länge beträgt 500 Zeichen. Schreibgeschützt. Wird standardmäßig zurückgegeben. Unterstützt: $select. Unterstützt keine $search, $filter, $orderBy. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship |
| targetPublisherDisplayName | String | Der Anzeigename des Herausgebers der App, die das Ziel der Beziehungsentität für mobile Apps ist. Beispiel: Fabrikam. Die maximale Länge beträgt 500 Zeichen. Schreibgeschützt. Unterstützt: $select. Unterstützt keine $search, $filter, $orderBy. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship |
| sourceId | String | Der eindeutige App-Bezeichner der Quelle der Beziehungsentität der mobilen App. Beispiel: 2dbc75b9-e993-4e4d-a071-91ac5a218672. Wenn während der Beziehungserstellung NULL ist, wird sie mit der übergeordneten ID aufgefüllt. Schreibgeschützt. Unterstützt: $select. Unterstützt keine $search, $filter, $orderBy. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship |
| sourceDisplayName | String | Der Anzeigename der App, die die Quelle der Beziehungsentität der mobilen App ist. Beispiel: Orca. Die maximale Länge beträgt 500 Zeichen. Schreibgeschützt. Unterstützt: $select. Unterstützt keine $search, $filter, $orderBy. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship |
| sourceDisplayVersion | String | Die Anzeigeversion der App, die die Quelle der Beziehungsentität der mobilen App ist. Beispiel: 1.0.12 oder 1.2203.156 oder 3. Schreibgeschützt. Unterstützt: $select. Unterstützt keine $search, $filter, $orderBy. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship |
| sourcePublisherDisplayName | String | Der Herausgeberanzeigename der App, die die Quelle der Beziehungsentität der mobilen App ist. Beispiel: Fabrikam. Die maximale Länge beträgt 500 Zeichen. Schreibgeschützt. Unterstützt: $select. Unterstützt keine $search, $filter, $orderBy. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship |
| targetType | mobileAppRelationshipType | Der Beziehungstyp, der angibt, ob die Zielanwendung einer Beziehung ein übergeordnetes oder untergeordnetes Element in der Beziehung ist. Mögliche Werte sind: übergeordnete, untergeordnete Werte. Schreibgeschützt. Wird standardmäßig zurückgegeben. Unterstützt: $select, $filter. Unterstützt $search, $orderBy nicht. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship. Mögliche Werte sind: child, parent und unknownFutureValue. |
| supersedenceType | mobileAppSupersedenceType | Der Ablösungsbeziehungstyp zwischen der übergeordneten und der untergeordneten App. Mögliche Werte sind: update, replace. Schreibgeschützt. Mögliche Werte sind: update, replace und unknownFutureValue. |
| supersedededAppCount | Int32 | Die Gesamtzahl der Apps, die direkt oder indirekt von der untergeordneten App abgelöst werden. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. |
| supersedingAppCount | Int32 | Die Gesamtzahl der Apps, die direkt oder indirekt die übergeordnete App ablösen. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und ein aktualisiertes mobileAppSupersedence-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId}
Content-type: application/json
Content-length: 665
{
"@odata.type": "#microsoft.graph.mobileAppSupersedence",
"targetId": "Target Id value",
"targetDisplayName": "Target Display Name value",
"targetDisplayVersion": "Target Display Version value",
"targetPublisher": "Target Publisher value",
"targetPublisherDisplayName": "Target Publisher Display Name value",
"sourceId": "Source Id value",
"sourceDisplayName": "Source Display Name value",
"sourceDisplayVersion": "Source Display Version value",
"sourcePublisherDisplayName": "Source Publisher Display Name value",
"targetType": "parent",
"supersedenceType": "replace",
"supersededAppCount": 2,
"supersedingAppCount": 3
}
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: 714
{
"@odata.type": "#microsoft.graph.mobileAppSupersedence",
"id": "c0254204-4204-c025-0442-25c0044225c0",
"targetId": "Target Id value",
"targetDisplayName": "Target Display Name value",
"targetDisplayVersion": "Target Display Version value",
"targetPublisher": "Target Publisher value",
"targetPublisherDisplayName": "Target Publisher Display Name value",
"sourceId": "Source Id value",
"sourceDisplayName": "Source Display Name value",
"sourceDisplayVersion": "Source Display Version value",
"sourcePublisherDisplayName": "Source Publisher Display Name value",
"targetType": "parent",
"supersedenceType": "replace",
"supersededAppCount": 2,
"supersedingAppCount": 3
}