isM365CopilotEnabled (Client-API-Referenz)

Gibt zurück, ob Microsoft 365 Copilot in der aktuellen Umgebung aktiviert ist.

Syntax

Xrm.Copilot.isM365CopilotEnabled().then(successCallback, errorCallback);

Parameter

Parametername Typ Erforderlich Beschreibung
successCallback Funktion Yes Eine Funktion zum Aufrufen, wenn der Vorgang erfolgreich war.
errorCallback Funktion Yes Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug.

Rückgabewert

Typ: Promise<boolean>

Gibt true zurück, wenn Microsoft 365 Copilot in der aktuellen Umgebung aktiviert ist; andernfalls false.

Remarks

Die Aktivierung wird durch eine rangierte Prüfreihenfolge bestimmt: ein Featuresteuerelement-Kill-Switch, drei parallele Berechtigungsprüfungen (Lizenz-, Umgebungseinstellung und Dataverse-Indizierungsstatus), eine optionale Außerkraftsetzung der Einstellung auf App-Ebene und ein graduelles Rollout-Flag. Das Ergebnis wird für 30 Minuten zwischengespeichert, und gleichzeitige Anrufe werden dedupliziert.

Alle anderen Microsoft 365 Copilot Methoden überprüfen diesen Wert vor dem Ausführen und Abschließen ohne Aktion, wenn sie false zurückgibt.

Example

const isEnabled = await Xrm.Copilot.isM365CopilotEnabled();
if (isEnabled) {
    // Show Copilot-related controls
}

Xrm.Copilot (Client-API-Referenz)