Aktualisieren von copilotPolicySetting

Aktualisiert die Eigenschaften eines copilotPolicySetting-Objekts .

Aktualisieren Sie den Wert einer Copilot-Richtlinieneinstellung. Die API löst den richtigen zugrunde liegenden Richtliniendienst auf und wendet das Update an. Wenn policyId im Anforderungstext weggelassen wird, löst die API die erste übereinstimmende Richtlinie auf Mandantenebene automatisch auf.

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

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

Pfadparameter

Anforderungsheader

Anforderungstext

Antwort

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

Beispiele

Beispiel 1: Aktualisieren mit angegebener policyId

Das folgende Beispiel zeigt, wie Sie einen Copilot-Einstellungswert mit einer expliziten Richtlinien-ID aktualisieren.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/beta/copilot/admin/policySettings/microsoft.copilot.copilotchatpinning
Content-Type: application/json

{
  "value": "0",
  "policyId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
  "id": "microsoft.copilot.copilotchatpinning",
  "value": "0",
  "policyId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Beispiel 2: Update ohne policyId (API wird automatisch aufgelöst)

Das folgende Beispiel zeigt, wie Sie einen Einstellungswert aktualisieren, ohne eine Richtlinien-ID anzugeben. Die API löst die erste übereinstimmende Richtlinie auf Mandantenebene auf und wendet das Update an.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/beta/copilot/admin/policySettings/microsoft.copilot.copilotchatpinning
Content-Type: application/json

{
  "value": "1"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
  "id": "microsoft.copilot.copilotchatpinning",
  "value": "1",
  "policyId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Beispiel 3: Aktualisieren einer Einstellung, die auf eine Richtlinie auf Gruppenebene festgelegt ist

Das folgende Beispiel zeigt eine Anforderung zum Aktualisieren einer unterstützten 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.

PATCH https://graph.microsoft.com/beta/copilot/admin/policySettings/microsoft.copilot.copilotchatpinning
Content-Type: application/json

{
  "value": "0"
}

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 4: Aktualisieren einer nicht unterstützten Einstellung

Das folgende Beispiel zeigt eine Anforderung zum Aktualisieren eines Einstellungsbezeichners, der nicht in der Liste der unterstützten Elemente enthalten ist. Die API gibt zurück 404 Not Found.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/beta/copilot/admin/policySettings/microsoft.copilot.pinning
Content-Type: application/json

{
  "value": "1"
}

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 5: Aktualisieren einer Einstellung, wenn der Mandant über zu viele Gruppenrichtlinien verfügt

Das folgende Beispiel zeigt eine Anforderung zum Aktualisieren einer 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.

PATCH https://graph.microsoft.com/beta/copilot/admin/policySettings/microsoft.copilot.copilotchatpinning
Content-Type: application/json

{
  "value": "0"
}

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"
    }
  }
}