pac copilot-studio

(Préversion) Administrer Copilot Studio agents et exporter des rapports de licence de locataire.

Commands

Command Description
pac copilot-studio delete-copilot-agent (Préversion) Supprimez un bot.
pac copilot-studio download-agent-channel-manifest (Préversion) Télécharge le package de manifeste de canal pour l’agent et le canal spécifiés en tant que fichier zip. Actuellement, seul le canal « M365 » est pris en charge.
pac copilot-studio download-licensing-report-file (Préversion) Télécharge un rapport de licence généré sous la forme d’un fichier CSV compressé par gzip. Utilisez le nom de fichier retourné par une opération de rapport avec un état Réussi.
pac copilot-studio generate-licensing-report (Préversion) Commence à générer un rapport de licence Copilot Studio pour votre locataire sur la plage de dates demandée. La génération s’exécute de manière asynchrone ; interrogez l’URL dans l’en-tête Emplacement pour obtenir l’état. Nécessite le rôle d’administrateur Général, Dynamics 365 ou Power Platform.
pac copilot-studio get-bot-quarantine-status (Préversion) Récupérez l’état de quarantaine d’un bot.
pac copilot-studio get-connector-consent-bypass (Préversion) Obtenez le paramètre de contournement du consentement du connecteur administrateur pour un bot.
pac copilot-studio get-licensing-report-operation (Préversion) Obtient l’état d’une opération de génération de rapports de licence. Lorsque l’état est Réussi, la réponse inclut le nom du fichier de rapport et l’en-tête Emplacement contient l’URL de téléchargement.
pac copilot-studio get-maker-evaluation-test-run (Préversion) Obtenez l’état et les résultats d’une exécution de test d’évaluation de créateur spécifique.
pac copilot-studio get-maker-evaluation-test-set (Préversion) Obtenez un jeu de test spécifique pour l’évaluation du créateur d’un bot.
pac copilot-studio list-maker-evaluation-test-runs (Préversion) Répertoriez toutes les exécutions de test d’évaluation de créateur pour un bot.
pac copilot-studio list-maker-evaluation-test-sets (Préversion) Récupère la liste des jeux de tests pour un bot dans un environnement spécifié.
pac copilot-studio reassign-copilot-agent (Préversion) Réaffectez le propriétaire du bot.
pac copilot-studio run-maker-evaluation-test-set (Préversion) Déclenchez une exécution de test d’évaluation de créateur pour un jeu de tests spécifique.
pac copilot-studio set-bot-as-quarantined (Préversion) Définissez l’état de quarantaine d’un bot sur true.
pac copilot-studio set-bot-as-unquarantined (Préversion) Définissez l’état de quarantaine d’un bot sur false.
pac copilot-studio set-connector-consent-bypass (Préversion) Définissez le paramètre de contournement du consentement du connecteur administrateur pour un bot.

pac copilot-studio delete-copilot-agent

(Préversion) Supprimez un bot.

Paramètres requis pour copilot-studio delete-copilot-agent

--bot-id

ID du bot.

Paramètres facultatifs pour copilot-studio delete-copilot-agent

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

delete-copilot-agent Remarques

Vous pouvez également appeler cette commande à l’aide des bots d’API REST Power Platform - Supprimer Copilot Agent.

pac copilot-studio download-agent-channel-manifest

(Préversion) Télécharge le package de manifeste de canal pour l’agent et le canal spécifiés en tant que fichier zip. Actuellement, seul le canal « M365 » est pris en charge.

Paramètres requis pour copilot-studio download-agent-channel-manifest

--agent-id

ID du bot.

--channel-name

Nom du canal. Actuellement, seul « M365 » est pris en charge.

--out-file

Chemin d’accès au fichier local dans lequel écrire le contenu téléchargé.

Paramètres facultatifs pour copilot-studio download-agent-channel-manifest

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--include-agent-schema

Indique s’il faut inclure le schéma de l’agent dans le package de manifeste téléchargé.

download-agent-channel-manifest Remarques

Vous pouvez également appeler cette commande à l’aide des canaux de l’agent d’API REST Power Platform - Télécharger le manifeste du canal de l’agent.

pac copilot-studio download-licensing-report-file

(Préversion) Télécharge un rapport de licence généré sous la forme d’un fichier CSV compressé par gzip. Utilisez le nom de fichier retourné par une opération de rapport avec un état Réussi.

Paramètres requis pour copilot-studio download-licensing-report-file

--file-name

Nom du fichier de rapport retourné par une opération de rapport avec un état Réussi.

--out-file

Chemin d’accès au fichier local dans lequel écrire le contenu téléchargé.

--report-name

Nom du rapport généré.

Utilisez l’une de ces valeurs :

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

pac copilot-studio generate-licensing-report

(Préversion) Commence à générer un rapport de licence Copilot Studio pour votre locataire sur la plage de dates demandée. La génération s’exécute de manière asynchrone ; interrogez l’URL dans l’en-tête Emplacement pour obtenir l’état. Nécessite le rôle d’administrateur Général, Dynamics 365 ou Power Platform.

Paramètres requis pour copilot-studio generate-licensing-report

--end-date

Date de fin UTC inclusive de la plage de rapports. Doit être le ou après la date de début.

--report-name

Nom du rapport à générer.

Utilisez l’une de ces valeurs :

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

--start-date

Date de début UTC inclusive de la plage de rapports.

Paramètres facultatifs pour copilot-studio generate-licensing-report

--granularity

Granularité d’un rapport de licence. Le quotidien retourne une ligne par jour dans la plage de dates, et Summary retourne une seule ligne résumée pour l’ensemble de la plage.

Utilisez l’une de ces valeurs :

  • Daily
  • Summary

pac copilot-studio get-bot-quarantine-status

(Préversion) Récupérez l’état de quarantaine d’un bot.

Paramètres requis pour copilot-studio get-bot-quarantine-status

--bot-id

ID du bot.

Paramètres facultatifs pour copilot-studio get-bot-quarantine-status

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

get-bot-quarantine-status Remarques

Vous pouvez également appeler cette commande à l’aide des bots d’API REST Power Platform - Obtenir l’état de mise en quarantaine des bots.

(Préversion) Obtenez le paramètre de contournement du consentement du connecteur administrateur pour un bot.

--bot-id

ID du bot.

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

Vous pouvez également appeler cette commande à l’aide des bots d’API REST Power Platform - Obtenir le contournement du consentement du connecteur.

pac copilot-studio get-licensing-report-operation

(Préversion) Obtient l’état d’une opération de génération de rapports de licence. Lorsque l’état est Réussi, la réponse inclut le nom du fichier de rapport et l’en-tête Emplacement contient l’URL de téléchargement.

Paramètres requis pour copilot-studio get-licensing-report-operation

--operation-id

ID de l’opération de rapport, retourné dans l’en-tête Emplacement au démarrage de la génération de rapport.

--report-name

Nom du rapport généré.

Utilisez l’une de ces valeurs :

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

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

(Préversion) Obtenez l’état et les résultats d’une exécution de test d’évaluation de créateur spécifique.

Paramètres requis pour copilot-studio get-maker-evaluation-test-run

--bot-id

ID du bot.

--test-run-id

ID d’exécution de test.

Paramètres facultatifs pour copilot-studio get-maker-evaluation-test-run

--columns

Liste séparée par des virgules des propriétés de réponse à inclure dans la sortie de la table. Utilisez --json pour la réponse complète.

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

get-maker-evaluation-test-run Remarques

Vous pouvez également appeler cette commande à l’aide des bots d’API REST Power Platform - Get Maker Evaluation Test Run.

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

(Préversion) Obtenez un jeu de test spécifique pour l’évaluation du créateur d’un bot.

Paramètres requis pour copilot-studio get-maker-evaluation-test-set

--bot-id

ID du bot.

--test-set-id

ID du jeu de tests.

Paramètres facultatifs pour copilot-studio get-maker-evaluation-test-set

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

get-maker-evaluation-test-set Remarques

Vous pouvez également appeler cette commande à l’aide des bots d’API REST Power Platform - Get Maker Evaluation Test Set.

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

(Préversion) Répertoriez toutes les exécutions de test d’évaluation de créateur pour un bot.

Paramètres requis pour copilot-studio list-maker-evaluation-test-runs

--bot-id

ID du bot.

Paramètres facultatifs pour copilot-studio list-maker-evaluation-test-runs

--columns

Liste séparée par des virgules des propriétés de réponse à inclure dans la sortie de la table. Utilisez --json pour la réponse complète.

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

list-maker-evaluation-test-runs Remarques

Vous pouvez également appeler cette commande à l’aide des bots d’API REST Power Platform - Exécutions de test d’évaluation List Maker.

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

(Préversion) Récupère la liste des jeux de tests pour un bot dans un environnement spécifié.

Paramètres requis pour copilot-studio list-maker-evaluation-test-sets

--bot-id

ID du bot.

Paramètres facultatifs pour copilot-studio list-maker-evaluation-test-sets

--columns

Liste séparée par des virgules des propriétés de réponse à inclure dans la sortie de la table. Utilisez --json pour la réponse complète.

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

list-maker-evaluation-test-sets Remarques

Vous pouvez également appeler cette commande à l’aide des bots d’API REST Power Platform - Ensembles de tests d’évaluation List Maker.

pac copilot-studio reassign-copilot-agent

(Préversion) Réaffectez le propriétaire du bot.

Paramètres requis pour copilot-studio reassign-copilot-agent

--bot-id

ID du bot.

--new-owner-aad-user-id

Le nouveau propriétaire Entra ID.

Paramètres facultatifs pour copilot-studio reassign-copilot-agent

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

reassign-copilot-agent Remarques

Vous pouvez également appeler cette commande à l’aide des bots d’API REST Power Platform - Réaffecter Copilot Agent.

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

(Préversion) Déclenchez une exécution de test d’évaluation de créateur pour un jeu de tests spécifique.

Paramètres requis pour copilot-studio run-maker-evaluation-test-set

--bot-id

ID du bot.

--test-set-id

ID du jeu de tests.

Paramètres facultatifs pour copilot-studio run-maker-evaluation-test-set

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--evaluation-run-name

Nom de l’exécution de l’évaluation.

--mcs-connection-id

ID de connexion du connecteur MCS utilisé pour exécuter l’exécution d’évaluation ou laisser vide pour une exécution anonyme.

--run-on-published-bot

Indique si l’opération doit s’exécuter sur une instance de bot publiée. Si la valeur est false, l’opération s’exécute sur une instance de bot brouillon.

--tools-connections

Connexions d’outils qui seront utilisées pour exécuter l’exécution de l’évaluation. Il s’agit d’une liste d’outils avec les connexions utilisateur correspondantes qui doivent être utilisées pour chaque outil. Fournissez la valeur en tant que tableau JSON.

run-maker-evaluation-test-set Remarques

Vous pouvez également appeler cette commande à l’aide des bots d’API REST Power Platform - Run Maker Evaluation Test Set.

pac copilot-studio set-bot-as-quarantined

(Préversion) Définissez l’état de quarantaine d’un bot sur true.

Paramètres requis pour copilot-studio set-bot-as-quarantined

--bot-id

ID du bot.

Paramètres facultatifs pour copilot-studio set-bot-as-quarantined

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

set-bot-as-quarantined Remarques

Vous pouvez également appeler cette commande à l’aide des bots d’API REST Power Platform - Définir bot en quarantaine.

pac copilot-studio set-bot-as-unquarantined

(Préversion) Définissez l’état de quarantaine d’un bot sur false.

Paramètres requis pour copilot-studio set-bot-as-unquarantined

--bot-id

ID du bot.

Paramètres facultatifs pour copilot-studio set-bot-as-unquarantined

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

set-bot-as-unquarantined Remarques

Vous pouvez également appeler cette commande à l’aide des bots d’API REST Power Platform - Définir bot comme nonquarantined.

(Préversion) Définissez le paramètre de contournement du consentement du connecteur administrateur pour un bot.

--admin-consent-bypass

Indique s’il faut activer le contournement du consentement du connecteur administrateur pour le bot.

--bot-id

ID du bot.

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

Vous pouvez également appeler cette commande à l’aide des bots d’API REST Power Platform - Définir le contournement du consentement du connecteur.

Voir aussi

Groupes de commandes Microsoft Power Platform CLI
Vue d'ensemble du Microsoft Power Platform CLI

  • Dernière mise à jour :