Freigeben über

Aktualisieren von copilotAdminLimitedMode

  • Artikel

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.

Aktualisieren sie die Eigenschaften eines copilotAdminLimitedMode-Objekts .

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.

Anmerkung: Zum Aufrufen dieser API ist die Berechtigung globaler Administrator oder globaler Leser erforderlich.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) CopilotSettings-LimitedMode.ReadWrite Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

PATCH /copilot/admin/settings/limitedMode

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Eigenschaft Typ Beschreibung
isEnabledForGroup Boolesch Ermöglicht es dem Benutzer, sich im eingeschränkten Modus für Copilot in Teams Besprechungen zu befinden. Wenn copilotLimitedMode=true ist, können Benutzer in diesem Modus beliebige Fragen stellen, aber Copilot antwortet nicht auf bestimmte Fragen im Zusammenhang mit dem Ableiten von Emotionen, Verhalten oder Urteilen. Bei copilotLimitedMode=false, dem aktuellen Modus für Copilot, antwortet er auf alle Arten von Fragen, die im Zusammenhang mit der Besprechungsunterhaltung enthalten sind. Der Standardwert ist false.
groupId String Die ID einer Microsoft Entra Gruppe, deren Wert für isEnabledForGroup deren Member angewendet wird. Der Standardwert ist null. Dieser Parameter ist optional. Wenn isEnabledForGroup auf true festgelegt ist, muss der groupId Wert angegeben werden, damit copilotLimitedMode für die Mitglieder der Gruppe aktiviert wird.

Antwort

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

Die API kann zusätzliche HTTP-status-Codes wie 403 Forbidden, 500 Internal Server Erroroder 429 Too Many Requestszurückgeben.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

{
  "@odata.type": "#microsoft.graph.copilotAdminLimitedMode",
  "isEnabledForGroup": "Boolean",
  "groupId": "String"
}

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