Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig: Microsoft unterstützt Intune/beta-APIs, die jedoch häufiger geändert werden. Microsoft empfiehlt, nach Möglichkeit Version 1.0 zu verwenden. Überprüfen Sie die Verfügbarkeit einer API in Version 1.0 mithilfe der Versionsauswahl.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Erstellen Sie ein neues mobileAppDependency-Objekt .
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 |
| Application | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
HTTP-Anforderung
POST /deviceAppManagement/mobileAppRelationships
POST /deviceAppManagement/mobileApps/{mobileAppId}/relationships
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 mobileAppDependency-Objekt an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen der mobileAppDependency erforderlich sind.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | Zeichenfolge | Der eindeutige Bezeichner für die Beziehungsentität der mobilen App. Dieser eindeutige Bezeichner 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 | Zeichenfolge | 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 | Zeichenfolge | 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 | Zeichenfolge | 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 | Zeichenfolge | 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 | Zeichenfolge | 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 | Zeichenfolge | 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 | Zeichenfolge | 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 | Zeichenfolge | 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 | Zeichenfolge | 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. Die möglichen Werte sind: übergeordnetes Element, untergeordnetes Element. Schreibgeschützt. Wird standardmäßig zurückgegeben. Unterstützt: $select, $filter. Unterstützt $search, $orderBy nicht. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship. Die möglichen Werte sind: child, parent, unknownFutureValue. |
| dependencyType | mobileAppDependencyType | Der Typ der Abhängigkeitsbeziehung zwischen den übergeordneten und untergeordneten Apps. Die möglichen Werte sind: detect, autoInstall. Schreibgeschützt. Die möglichen Werte sind: detect, autoInstall, unknownFutureValue. |
| dependentAppCount | Int32 | Die Gesamtzahl der Apps, die direkt oder indirekt von der übergeordneten App abhängen. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. |
| dependsOnAppCount | Int32 | Die Gesamtzahl der Apps, von der die untergeordnete App direkt oder indirekt abhängt. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein mobileAppDependency-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships
Content-type: application/json
Content-length: 662
{
"@odata.type": "#microsoft.graph.mobileAppDependency",
"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",
"dependencyType": "autoInstall",
"dependentAppCount": 1,
"dependsOnAppCount": 1
}
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 201 Created
Content-Type: application/json
Content-Length: 711
{
"@odata.type": "#microsoft.graph.mobileAppDependency",
"id": "c7f6f9ab-f9ab-c7f6-abf9-f6c7abf9f6c7",
"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",
"dependencyType": "autoInstall",
"dependentAppCount": 1,
"dependsOnAppCount": 1
}