Freigeben über


Auflisten von "appliesTo"

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Auflisten von Anwendungs- und Dienstprinzipalobjekten, denen ein appManagementPolicy-Richtlinienobjekt zugewiesen ist.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst 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) Application.Read.All und Policy.Read.All, Application.Read.All und Policy.ReadWrite.ApplicationConfiguration
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung Application.Read.All und Policy.Read.All, Application.Read.All und Policy.ReadWrite.ApplicationConfiguration

Um die Standardrichtlinie für die Anwendungsauthentifizierungsmethode zu lesen, muss dem aufrufenden Benutzer mindestens die VerzeichnisrolleGlobaler Leser zugewiesen sein.

HTTP-Anforderung

GET /policies/appManagementPolicies/{id}/appliesTo

Optionale Abfrageparameter

Diese Methode unterstützt die $selectOData-Abfrageparameter , $filterund $top zum Anpassen der Antwort. Sie können auf Eigenschaften von Anwendungs- oder servicePrincipal-Objekten anwenden$filter, die unterstützen$filter. Die folgende Abfrage ruft beispielsweise die appId und displayName von Anwendungen oder Dienstprinzipalen ab, denen die Richtlinie zugewiesen ist.


https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}/appliesTo?$select=appId,displayName

Allgemeine Informationen finden Sie unter OData-Abfrageparameter.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und eine Auflistung von Anwendungs - oder servicePrincipal-Objekten im Antworttext zurück.

Beispiele

Beispiel 1: Abrufen von Anwendungen und Dienstprinzipalobjekten, die auf eine App-Verwaltungsrichtlinie angewendet werden

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}/appliesTo

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
  "value": [
    {
      "@odata.type": "#microsoft.graph.application",
      "id": "0d77e011-2fc6-438f-8b93-decb4f926929",
      "appId": "8f527de6-05c9-4032-bca9-b2b56ab2358a",
      "displayName": "TestApp1",
      "createdDateTime": "2018-01-24T05:55:37Z"
    }
  ]
}

Beispiel 2: Abrufen bestimmter Eigenschaften von Anwendungen und Dienstprinzipalobjekten, die auf eine App-Verwaltungsrichtlinie angewendet werden, mithilfe $select Abfrageoption

Anforderung

Das folgende Beispiel zeigt eine Anforderung mit $select Abfrageoption.

GET https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}/appliesTo?$select=id,appId,displayName,createdDateTime

Antwort

Im Folgenden finden Sie ein Beispiel für die Antwort, die , appIdund createdDateTimedisplayName für Anwendungen und Dienstprinzipale zurückgibtid, in denen die Richtlinie angewendet wird.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects(id,appId,displayName,createdDateTime)",
  "value": [
    {
      "@odata.type": "#microsoft.graph.application",
      "id": "0d77e011-2fc6-438f-8b93-decb4f926929",
      "appId": "8f527de6-05c9-4032-bca9-b2b56ab2358a",
      "displayName": "TestApp1",
      "createdDateTime": "2018-01-24T05:55:37Z"
    },
    {
      "@odata.type": "#microsoft.graph.servicePrincipal",
      "id": "0e1fa067-dcc1-4d85-9b4c-e69145dd3efb",
      "appId": "255912cb-e31d-4dee-bee4-3fa5d774d6b9",
      "displayName": "TestApp2",
      "createdDateTime": "2018-01-24T05:55:37Z"
    }
  ]
}