Abrufen von copilotPolicySetting

Liest die Eigenschaften eines copilotPolicySetting-Objekts .

Rufen Sie den aktuellen Wert einer Copilot-Richtlinieneinstellung anhand ihres Bezeichners ab. Die API löst den richtigen zugrunde liegenden Richtliniendienst (CPS oder Intune) auf und gibt den Einstellungswert zusammen mit der zugehörigen Richtlinien-ID zurück.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

HTTP-Anforderung

GET https://graph.microsoft.com/beta/copilot/admin/policySettings/{id}

Pfadparameter

Optionale Abfrageparameter

Diese Methode unterstützt den $select OData-Abfrageparameter, um die Antwort anzupassen. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.

Anforderungsheader

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

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

Wenn die Einstellung nicht konfiguriert ist oder keine Richtlinie auf Mandantenebene vorhanden ist, gibt 200 OK die API mit value und/oder policyId auf nullfest.

Beispiele

Beispiel 1: Abrufen einer konfigurierten Einstellung

Das folgende Beispiel zeigt, wie Sie eine Copilot-Einstellung abrufen, die mit einem Wert in einer Richtlinie auf Mandantenebene konfiguriert ist.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/copilot/admin/policySettings/microsoft.copilot.copilotchatpinning

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#copilot/admin/policySettings/$entity",
  "@odata.type": "#microsoft.graph.copilotPolicySetting",
  "id": "microsoft.copilot.copilotchatpinning",
  "value": "1",
  "policyId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Beispiel 2: Abrufen einer nicht konfigurierten Einstellung

Das folgende Beispiel zeigt, wie Sie eine Einstellung abrufen, bei der eine Richtlinie auf Mandantenebene vorhanden ist, der Einstellungswert jedoch nicht konfiguriert ist. Die API gibt mit value als nullzurück200 OK.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/copilot/admin/policySettings/microsoft.copilot.imagegeneration

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#copilot/admin/policySettings/$entity",
  "@odata.type": "#microsoft.graph.copilotPolicySetting",
  "id": "microsoft.copilot.imagegeneration",
  "value": null,
  "policyId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Beispiel 3: Abrufen einer Einstellung, wenn keine Richtlinie vorhanden ist

Das folgende Beispiel zeigt, wie Sie eine Einstellung abrufen, bei der noch keine Richtlinie auf Mandantenebene erstellt wurde. Die API gibt sowohl mit als auch valuepolicyId als nullzurück200 OK.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/copilot/admin/policySettings/microsoft.copilot.allowwebsearch

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#copilot/admin/policySettings/$entity",
  "@odata.type": "#microsoft.graph.copilotPolicySetting",
  "id": "microsoft.copilot.allowwebsearch",
  "value": null,
  "policyId": null
}

Beispiel 4: Abrufen einer Einstellung, die auf eine Richtlinie auf Gruppenebene festgelegt ist

Das folgende Beispiel zeigt eine Anforderung für eine unterstützte Einstellung, die in einer Richtlinie auf Gruppenebene konfiguriert ist, die von diesem Endpunkt nicht unterstützt wird. Die API gibt zurück 422 Unprocessable Content.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/copilot/admin/policySettings/microsoft.copilot.copilotchatpinning

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 422 Unprocessable Content
Content-Type: application/json

{
  "error": {
    "code": "unprocessableEntity",
    "message": "The setting 'microsoft.copilot.copilotchatpinning' is scoped to a group-level policy, which is not supported by this endpoint. Only tenant-level policy settings are supported.",
    "innerError": {
      "code": "groupScopedSettingNotSupported",
      "request-id": "00000000-0000-0000-0000-000000000003",
      "date": "2026-04-06T13:37:18",
      "client-request-id": "00000000-0000-0000-0000-000000000004"
    }
  }
}

Beispiel 5: Abrufen einer nicht unterstützten Einstellung

Das folgende Beispiel zeigt eine Anforderung für einen Einstellungsbezeichner, der nicht in der liste unterstützt ist. Die API gibt zurück 404 Not Found.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/copilot/admin/policySettings/microsoft.copilot.pinning

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "error": {
    "code": "notFound",
    "message": "The setting 'microsoft.copilot.pinning' is not supported. Only supported Copilot settings can be accessed through this endpoint.",
    "innerError": {
      "code": "unsupportedSetting",
      "request-id": "00000000-0000-0000-0000-000000000001",
      "date": "2026-04-06T13:37:18",
      "client-request-id": "00000000-0000-0000-0000-000000000002"
    }
  }
}

Beispiel 6: Abrufen einer Einstellung, wenn der Mandant über zu viele Gruppenrichtlinien verfügt

Das folgende Beispiel zeigt eine Anforderung für eine Einstellung, wenn die Anzahl von Richtlinien auf Gruppenebene im Mandanten den unterstützten Grenzwert überschreitet. Die API gibt zurück 502 Bad Gateway.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/copilot/admin/policySettings/microsoft.copilot.copilotchatpinning

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 502 Bad Gateway
Content-Type: application/json

{
  "error": {
    "code": "badGateway",
    "message": "The operation could not be completed because the number of group-level policies exceeds the supported limit.",
    "innerError": {
      "code": "tooManyGroupPolicies",
      "request-id": "00000000-0000-0000-0000-000000000005",
      "date": "2026-04-13T11:16:52",
      "client-request-id": "00000000-0000-0000-0000-000000000006"
    }
  }
}