pac copilot-studio

(Vorschau) Verwalten sie Copilot Studio Agents, und exportieren Sie Mandantenlizenzberichte.

Commands

Befehl Description
pac copilot-studio delete-copilot-agent (Vorschau) Löschen eines Bots.
pac copilot-studio download-agent-channel-manifest (Vorschau) Lädt das Kanalmanifestpaket für den angegebenen Agent und Kanal als ZIP-Datei herunter. Derzeit wird nur der Kanal "M365" unterstützt.
pac copilot-studio download-licensing-report-file (Vorschau) Lädt einen generierten Lizenzierungsbericht als Gzip-komprimierte CSV-Datei herunter. Verwenden Sie den Dateinamen, der von einem Berichtsvorgang mit einem Status "Erfolgreich" zurückgegeben wird.
pac copilot-studio generate-licensing-report (Vorschau) Startet das Generieren eines Copilot Studio Lizenzierungsberichts für Ihren Mandanten über den angeforderten Datumsbereich. Die Generation wird asynchron ausgeführt; Abrufen der URL im Header "Speicherort" für den Status. Erfordert die Rolle "Global", "Dynamics 365" oder "Power Platform-Administrator".
pac copilot-studio get-bot-quarantine-status (Vorschau) Rufen Sie den Quarantänestatus eines Bots ab.
pac copilot-studio get-connector-consent-bypass (Vorschau) Rufen Sie die Umgehungseinstellung für den Administratorconnector für einen Bot ab.
pac copilot-studio get-licensing-report-operation (Vorschau) Ruft den Status eines Generierungsvorgangs eines Lizenzierungsberichts ab. Wenn der Status erfolgreich ist, enthält die Antwort den Namen der Berichtsdatei, und der Speicherortheader enthält die Download-URL.
pac copilot-studio get-maker-evaluation-test-run (Vorschau) Rufen Sie den Status und die Ergebnisse eines bestimmten Testlaufs für die Herstellerauswertung ab.
pac copilot-studio get-maker-evaluation-test-set (Vorschau) Erhalten Sie einen bestimmten Testsatz für die Herstellerauswertung eines Bots.
pac copilot-studio list-maker-evaluation-test-runs (Vorschau) Auflisten aller Testläufe der Herstellerauswertung für einen Bot.
pac copilot-studio list-maker-evaluation-test-sets (Vorschau) Ruft die Liste der Testsätze für einen Bot in einer angegebenen Umgebung ab.
pac copilot-studio reassign-copilot-agent (Vorschau) Weisen Sie den Besitzer des Bots erneut zu.
pac copilot-studio run-maker-evaluation-test-set (Vorschau) Auslösen eines Testlaufs für einen Herstellerauswertungstest für einen bestimmten Testsatz.
pac copilot-studio set-bot-as-quarantined (Vorschau) Legen Sie den Quarantänestatus eines Bots auf "true" fest.
pac copilot-studio set-bot-as-unquarantined (Vorschau) Legen Sie den Quarantänestatus eines Bots auf "false" fest.
pac copilot-studio set-connector-consent-bypass (Vorschau) Legen Sie die Einstellung für die Umgehung des Administratorconnectors für einen Bot fest.

pac copilot-studio delete-copilot-agent

(Vorschau) Löschen eines Bots.

Erforderliche Parameter für copilot-studio delete-copilot-agent

--bot-id

Die Bot-ID.

Optionale Parameter für copilot-studio delete-copilot-agent

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

delete-copilot-agent Bemerkungen

Sie können diesen Befehl auch mit den REST-API-Bots der Power Platform aufrufen – Copilot Agent löschen.

pac copilot-studio download-agent-channel-manifest

(Vorschau) Lädt das Kanalmanifestpaket für den angegebenen Agent und Kanal als ZIP-Datei herunter. Derzeit wird nur der Kanal "M365" unterstützt.

Erforderliche Parameter für copilot-studio download-agent-channel-manifest

--agent-id

Die Bot-ID.

--channel-name

Der Kanalname. Derzeit wird nur "M365" unterstützt.

--out-file

Der lokale Dateipfad, in den der heruntergeladene Inhalt geschrieben werden soll.

Optionale Parameter für copilot-studio download-agent-channel-manifest

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--include-agent-schema

Gibt an, ob das Agentschema in das heruntergeladene Manifestpaket eingeschlossen werden soll.

download-agent-channel-manifest Bemerkungen

Sie können diesen Befehl auch über die REST-API-Agentkanäle der Power Platform aufrufen – Agent-Kanalmanifest herunterladen.

pac copilot-studio download-licensing-report-file

(Vorschau) Lädt einen generierten Lizenzierungsbericht als Gzip-komprimierte CSV-Datei herunter. Verwenden Sie den Dateinamen, der von einem Berichtsvorgang mit einem Status "Erfolgreich" zurückgegeben wird.

Erforderliche Parameter für copilot-studio download-licensing-report-file

--file-name

Der Name der Berichtsdatei, der von einem Berichtsvorgang mit einem Status "Erfolgreich" zurückgegeben wird.

--out-file

Der lokale Dateipfad, in den der heruntergeladene Inhalt geschrieben werden soll.

--report-name

Der Name des generierten Berichts.

Verwenden Sie einen dieser Werte:

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

pac copilot-studio generate-licensing-report

(Vorschau) Startet das Generieren eines Copilot Studio Lizenzierungsberichts für Ihren Mandanten über den angeforderten Datumsbereich. Die Generation wird asynchron ausgeführt; Abrufen der URL im Header "Speicherort" für den Status. Erfordert die Rolle "Global", "Dynamics 365" oder "Power Platform-Administrator".

Erforderliche Parameter für copilot-studio generate-licensing-report

--end-date

Das inklusive UTC-Enddatum des Berichtsbereichs. Muss am oder nach dem Startdatum sein.

--report-name

Der Name des zu generierenden Berichts.

Verwenden Sie einen dieser Werte:

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

--start-date

Das inklusive UTC-Startdatum des Berichtsbereichs.

Optionale Parameter für copilot-studio generate-licensing-report

--granularity

Die Granularität eines Lizenzierungsberichts. Täglich wird eine Zeile pro Tag im Datumsbereich zurückgegeben, und "Zusammenfassung" gibt eine einzelne zusammengefasste Zeile für den gesamten Bereich zurück.

Verwenden Sie einen dieser Werte:

  • Daily
  • Summary

pac copilot-studio get-bot-quarantine-status

(Vorschau) Rufen Sie den Quarantänestatus eines Bots ab.

Erforderliche Parameter für copilot-studio get-bot-quarantine-status

--bot-id

Die Bot-ID.

Optionale Parameter für copilot-studio get-bot-quarantine-status

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

get-bot-quarantine-status Bemerkungen

Sie können diesen Befehl auch mit den REST-API-Bots der Power Platform aufrufen – Bot-Quarantänestatus abrufen.

(Vorschau) Rufen Sie die Umgehungseinstellung für den Administratorconnector für einen Bot ab.

--bot-id

Die Bot-ID.

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

Sie können diesen Befehl auch mithilfe der REST-API-Bots der Power Platform aufrufen – Konnektorzustimmungsumgehung abrufen.

pac copilot-studio get-licensing-report-operation

(Vorschau) Ruft den Status eines Generierungsvorgangs eines Lizenzierungsberichts ab. Wenn der Status erfolgreich ist, enthält die Antwort den Namen der Berichtsdatei, und der Speicherortheader enthält die Download-URL.

Erforderliche Parameter für copilot-studio get-licensing-report-operation

--operation-id

Die Berichtsvorgangs-ID, die beim Starten der Berichtsgenerierung im Header "Speicherort" zurückgegeben wird.

--report-name

Der Name des generierten Berichts.

Verwenden Sie einen dieser Werte:

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

pac copilot-studio get-maker-evaluation-test-run

(Vorschau) Rufen Sie den Status und die Ergebnisse eines bestimmten Testlaufs für die Herstellerauswertung ab.

Erforderliche Parameter für copilot-studio get-maker-evaluation-test-run

--bot-id

Die Bot-ID.

--test-run-id

Die Testausführungs-ID.

Optionale Parameter für copilot-studio get-maker-evaluation-test-run

--columns

Durch Trennzeichen getrennte Liste der Antworteigenschaften, die in die Tabellenausgabe aufgenommen werden sollen. Verwenden Sie "-json" für die vollständige Antwort.

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

get-maker-evaluation-test-run Bemerkungen

Sie können diesen Befehl auch mit den REST-API-Bots der Power Platform aufrufen – Testausführung für Die Maker-Auswertung abrufen.

pac copilot-studio get-maker-evaluation-test-set

(Vorschau) Erhalten Sie einen bestimmten Testsatz für die Herstellerauswertung eines Bots.

Erforderliche Parameter für copilot-studio get-maker-evaluation-test-set

--bot-id

Die Bot-ID.

--test-set-id

Die Testsatz-ID.

Optionale Parameter für copilot-studio get-maker-evaluation-test-set

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

get-maker-evaluation-test-set Bemerkungen

Sie können diesen Befehl auch mithilfe der Rest-API-Bots der Power Platform aufrufen – Testsatz zum Abrufen der Maker-Auswertung.

pac copilot-studio list-maker-evaluation-test-runs

(Vorschau) Auflisten aller Testläufe der Herstellerauswertung für einen Bot.

Erforderliche Parameter für copilot-studio list-maker-evaluation-test-runs

--bot-id

Die Bot-ID.

Optionale Parameter für copilot-studio list-maker-evaluation-test-runs

--columns

Durch Trennzeichen getrennte Liste der Antworteigenschaften, die in die Tabellenausgabe aufgenommen werden sollen. Verwenden Sie "-json" für die vollständige Antwort.

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

list-maker-evaluation-test-runs Bemerkungen

Sie können diesen Befehl auch mithilfe der Rest-API-Bots der Power Platform aufrufen – Testläufe für Listenerstellungstests.

pac copilot-studio list-maker-evaluation-test-sets

(Vorschau) Ruft die Liste der Testsätze für einen Bot in einer angegebenen Umgebung ab.

Erforderliche Parameter für copilot-studio list-maker-evaluation-test-sets

--bot-id

Die Bot-ID.

Optionale Parameter für copilot-studio list-maker-evaluation-test-sets

--columns

Durch Trennzeichen getrennte Liste der Antworteigenschaften, die in die Tabellenausgabe aufgenommen werden sollen. Verwenden Sie "-json" für die vollständige Antwort.

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

list-maker-evaluation-test-sets Bemerkungen

Sie können diesen Befehl auch mithilfe der Rest-API-Bots der Power Platform aufrufen – Testsätze für List Maker Evaluation Test Sets.

pac copilot-studio reassign-copilot-agent

(Vorschau) Weisen Sie den Besitzer des Bots erneut zu.

Erforderliche Parameter für copilot-studio reassign-copilot-agent

--bot-id

Die Bot-ID.

--new-owner-aad-user-id

Der neue Besitzer Entra ID.

Optionale Parameter für copilot-studio reassign-copilot-agent

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

reassign-copilot-agent Bemerkungen

Sie können diesen Befehl auch mithilfe der REST-API-Bots der Power Platform aufrufen – Copilot Agent neu zuweisen.

pac copilot-studio run-maker-evaluation-test-set

(Vorschau) Auslösen eines Testlaufs für einen Herstellerauswertungstest für einen bestimmten Testsatz.

Erforderliche Parameter für copilot-studio run-maker-evaluation-test-set

--bot-id

Die Bot-ID.

--test-set-id

Die Testsatz-ID.

Optionale Parameter für copilot-studio run-maker-evaluation-test-set

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--evaluation-run-name

Name der Auswertungsausführung

--mcs-connection-id

Die Verbindungs-ID für den MCS-Connector, der zum Ausführen der Auswertung verwendet wird, oder leer lassen, wenn eine anonyme Ausführung erfolgt.

--run-on-published-bot

Gibt an, ob der Vorgang auf einer veröffentlichten Bot-Instanz ausgeführt werden soll. Wenn dieser Wert auf "false" festgelegt ist, wird der Vorgang auf einer Entwurfs-Bot-Instanz ausgeführt.

--tools-connections

Die Toolsverbindungen, die zum Ausführen der Auswertung verwendet werden. Dies ist eine Liste der Tools zusammen mit den entsprechenden Benutzerverbindungen, die für jedes Tool verwendet werden sollen. Geben Sie den Wert als JSON-Array an.

run-maker-evaluation-test-set Bemerkungen

Sie können diesen Befehl auch mit den REST-API-Bots der Power Platform aufrufen– Testsatz "Maker Evaluation Test Set ausführen".

pac copilot-studio set-bot-as-quarantined

(Vorschau) Legen Sie den Quarantänestatus eines Bots auf "true" fest.

Erforderliche Parameter für copilot-studio set-bot-as-quarantined

--bot-id

Die Bot-ID.

Optionale Parameter für copilot-studio set-bot-as-quarantined

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

set-bot-as-quarantined Bemerkungen

Sie können diesen Befehl auch mithilfe der REST-API-Bots der Power Platform aufrufen – Bot als isoliert festlegen.

pac copilot-studio set-bot-as-unquarantined

(Vorschau) Legen Sie den Quarantänestatus eines Bots auf "false" fest.

Erforderliche Parameter für copilot-studio set-bot-as-unquarantined

--bot-id

Die Bot-ID.

Optionale Parameter für copilot-studio set-bot-as-unquarantined

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

set-bot-as-unquarantined Bemerkungen

Sie können diesen Befehl auch mit den REST-API-Bots der Power Platform aufrufen – Bot als nichtquarantiniert festlegen.

(Vorschau) Legen Sie die Einstellung für die Umgehung des Administratorconnectors für einen Bot fest.

--admin-consent-bypass

Gibt an, ob die Umgehung des Administratorconnectors für den Bot aktiviert werden soll.

--bot-id

Die Bot-ID.

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

Sie können diesen Befehl auch mithilfe der REST-API-Bots der Power Platform aufrufen – Konnektor-Zustimmungsumgehung festlegen.

Siehe auch

Microsoft Power Platform CLI-Befehlsgruppen
Microsoft Power Platform CLI – Übersicht

  • Zuletzt aktualisiert um