Freigeben über


Aktualisieren von copilotAdminLimitedMode

Wichtig

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

Aktualisieren sie die Eigenschaften eines copilotAdminLimitedMode-Objekts .

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

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

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.

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
Application Nicht unterstützt Nicht unterstützt

Wichtig

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer die Rolle Globaler Administrator Microsoft Entra zugewiesen werden.

HTTP-Anforderung

PATCH https://graph.microsoft.com/v1.0/copilot/admin/settings/limitedMode
PATCH https://graph.microsoft.com/beta/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
groupId Zeichenfolge Die ID einer Microsoft Entra Gruppe, auf die der Wert von isEnabledForGroup angewendet wird. Der Standardwert ist null. Wenn isEnabledForGroup auf truefestgelegt ist, muss der groupId Wert angegeben werden, damit der eingeschränkte Copilot-Modus in Teams-Besprechungen für die Mitglieder der Gruppe aktiviert wird. Optional.
isEnabledForGroup Boolean Ermöglicht es dem Benutzer, sich in Teams-Besprechungen im eingeschränkten Modus für Copilot zu befinden. Wenn copilotAdminLimitedMode=true, können Benutzer in diesem Modus alle Fragen stellen, aber Copilot antwortet nicht auf bestimmte Fragen im Zusammenhang mit dem Rückschluss auf Emotionen, Verhalten oder Urteile. Bei copilotAdminLimitedMode=falsewird auf alle Arten von Fragen geantwortet, die für die Besprechungsunterhaltung begründet sind. Der Standardwert ist false.

Antwort

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

Diese API kann auch weitere HTTP-status-Codes zurückgeben, z403 Forbidden. B. , 500 Internal Server Errorund 429 Too Many Requests.

Beispiel

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

{
  "@odata.type": "#microsoft.graph.copilotAdminLimitedMode",
  "isEnabledForGroup": true,
  "groupId": "4c563cdf-0efa-44c5-a384-dbf57db277df"
}
PATCH https://graph.microsoft.com/beta/copilot/admin/settings/limitedMode
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.copilotAdminLimitedMode",
  "isEnabledForGroup": true,
  "groupId": "4c563cdf-0efa-44c5-a384-dbf57db277df"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
  "isEnabledForGroup": true,
  "groupId": "4c563cdf-0efa-44c5-a384-dbf57db277df"
}