copilotPolicySetting-Ressourcentyp

Wichtig

APIs unter der /beta Version können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.

Stellt eine Copilot-Einstellung dar, die über einen Richtliniendienst (CPS oder Intune) verwaltet wird.

Die API adressiert Einstellungen einzeln nach ihrem Bezeichner, und nur Richtlinien auf Mandantenebene werden unterstützt. Richtlinien auf Benutzer- und Gruppenebene werden nicht unterstützt.

Hinweis

Diese API befindet sich derzeit in der Vorschauphase. Wenn der Mandant während der Vorschau über mehr Richtlinien auf Gruppenebene verfügt als der unterstützte Grenzwert, gibt die API einen 502 Bad Gateway Fehler mit dem tooManyGroupPolicies inneren Fehlercode zurück.

Methoden

Methode Rückgabetyp Beschreibung
Get copilotPolicySetting Liest die Eigenschaften und Beziehungen eines copilotPolicySetting Objekts.
Update copilotPolicySetting Aktualisiert die Eigenschaften eines copilotPolicySetting -Objekts.

Eigenschaften

Eigenschaft Typ Beschreibung
id Zeichenfolge Der benutzerfreundliche Bezeichner der Copilot-Einstellung (z. B microsoft.copilot.copilotchatpinning. ). Wird als Ressourcenschlüssel im URL-Pfad verwendet. Schreibgeschützt.
policyId Zeichenfolge Die ID der Richtlinie auf Mandantenebene, die diese Einstellung im zugrunde liegenden Richtliniendienst enthält. Nullwerte zulassend. Gibt zurück null , wenn für diese Einstellung keine Richtlinie auf Mandantenebene vorhanden ist. Wenn beim Update ausgelassen wird, löst die API die erste übereinstimmende Richtlinie auf Mandantenebene auf.
value Zeichenfolge Der aktuelle Wert der Einstellung als Zeichenfolge. Das Format ist einstellungsspezifisch und kann eine Ziffer sein, 0die einen Zustand (z. B. , 1), eine URL, eine XML-Zeichenfolge oder eine JSON-Zeichenfolge darstellt. Nullwerte zulassend. Gibt zurück null , wenn die Einstellung in der aufgelösten Richtlinie auf Mandantenebene nicht konfiguriert ist.

Unterstützte Einstellungen

Die folgenden Einstellungsbezeichner werden beim Start unterstützt. Nur diese Werte werden als path-Parameter {id} akzeptiert. Beim Anfordern eines nicht unterstützten Bezeichners wird ein 404 Not Found Fehler zurückgegeben.

Einstellungs-ID Name der Einstellung
microsoft.copilot.copilotchatpinning Microsoft 365 Copilot Chat anheften
microsoft.copilot.blockaccesstoopenfiles Copilot-Zugriff zum Öffnen von Inhalten blockieren
microsoft.copilot.imagegeneration Steuern des Zugriffs auf die Designer-Imagegenerierung
microsoft.copilot.allowwebsearch Websuche in Copilot zulassen
microsoft.copilot.allowinadmincenters Steuern der verfügbarkeit von Admin Copilot in Microsoft 365 Admin Center

Beziehungen

Keine. Auf diese Ressource wird als eigenständige Entität in copilotAdmin über die policySettings Navigationseigenschaft zugegriffen.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.copilotPolicySetting",
  "id": "String (identifier)",
  "policyId": "String",
  "value": "String"
}
  • Last updated on