pac copilot-studio

(معاينة) إدارة وكلاء Copilot Studio وتصدير تقارير ترخيص المستأجر.

Commands

الأمر الوصف
pac copilot-studio delete-copilot-agent (معاينة) حذف روبوت.
pac copilot-studio download-agent-channel-manifest (معاينة) تنزيل حزمة بيان القناة للعامل المحدد والقناة كملف مضغوط. يتم حاليا دعم قناة "M365" فقط.
pac copilot-studio download-licensing-report-file (معاينة) تنزيل تقرير ترخيص تم إنشاؤه كملف CSV مضغوط بواسطة gzip. استخدم اسم الملف الذي تم إرجاعه بواسطة عملية تقرير بحالة ناجحة.
pac copilot-studio generate-licensing-report (معاينة) يبدأ في إنشاء تقرير ترخيص Copilot Studio للمستأجر عبر نطاق التاريخ المطلوب. يعمل الجيل بشكل غير متزامن؛ قم باستطلاع عنوان URL في عنوان الموقع للحالة. يتطلب دور مسؤول النظام الأساسي العمومي أو Dynamics 365 أو Power Platform.
pac copilot-studio get-bot-quarantine-status (معاينة) استرداد حالة العزل لروبوت.
pac copilot-studio get-connector-consent-bypass (معاينة) احصل على إعداد تجاوز موافقة موصل المسؤول لروبوت.
pac copilot-studio get-licensing-report-operation (معاينة) الحصول على حالة عملية إنشاء تقرير الترخيص. عندما تكون الحالة ناجحة، تتضمن الاستجابة اسم ملف التقرير ويحتوي عنوان الموقع على عنوان URL للتنزيل.
pac copilot-studio get-maker-evaluation-test-run (معاينة) احصل على حالة ونتائج تشغيل اختبار تقييم صانع معين.
pac copilot-studio get-maker-evaluation-test-set (معاينة) احصل على مجموعة اختبار محددة لتقييم صانع الروبوت.
pac copilot-studio list-maker-evaluation-test-runs (معاينة) سرد جميع عمليات تشغيل اختبار تقييم صانع الروبوت.
pac copilot-studio list-maker-evaluation-test-sets (معاينة) استرداد قائمة مجموعات الاختبار لروبوت في بيئة محددة.
pac copilot-studio reassign-copilot-agent (معاينة) إعادة تعيين مالك الروبوت.
pac copilot-studio run-maker-evaluation-test-set (معاينة) تشغيل اختبار تقييم صانع لمجموعة اختبار معينة.
pac copilot-studio set-bot-as-quarantined (معاينة) تعيين حالة العزل للروبوت إلى true.
pac copilot-studio set-bot-as-unquarantined (معاينة) تعيين حالة العزل لروبوت إلى خطأ.
pac copilot-studio set-connector-consent-bypass (معاينة) تعيين إعداد تجاوز موافقة موصل المسؤول لروبوت.

pac copilot-studio delete-copilot-agent

(معاينة) حذف روبوت.

المعلمات المطلوبة ل copilot-studio delete-copilot-agent

--bot-id

معرف الروبوت.

معلمات اختيارية ل copilot-studio delete-copilot-agent

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

delete-copilot-agent ملاحظات

يمكنك أيضا استدعاء هذا الأمر باستخدام Power Platform REST API Bots - Delete Copilot Agent.

pac copilot-studio download-agent-channel-manifest

(معاينة) تنزيل حزمة بيان القناة للعامل المحدد والقناة كملف مضغوط. يتم حاليا دعم قناة "M365" فقط.

المعلمات المطلوبة ل copilot-studio download-agent-channel-manifest

--agent-id

معرف الروبوت.

--channel-name

اسم القناة. يتم حاليا دعم "M365" فقط.

--out-file

مسار الملف المحلي لكتابة المحتوى الذي تم تنزيله إليه.

معلمات اختيارية ل copilot-studio download-agent-channel-manifest

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--include-agent-schema

ما إذا كان سيتم تضمين مخطط العامل في حزمة البيان التي تم تنزيلها.

download-agent-channel-manifest ملاحظات

يمكنك أيضا استدعاء هذا الأمر باستخدام Power Platform REST API Agent Channels - Download Agent Channel Manifest.

pac copilot-studio download-licensing-report-file

(معاينة) تنزيل تقرير ترخيص تم إنشاؤه كملف CSV مضغوط بواسطة gzip. استخدم اسم الملف الذي تم إرجاعه بواسطة عملية تقرير بحالة ناجحة.

المعلمات المطلوبة ل copilot-studio download-licensing-report-file

--file-name

اسم ملف التقرير، الذي تم إرجاعه بواسطة عملية تقرير بحالة ناجحة.

--out-file

مسار الملف المحلي لكتابة المحتوى الذي تم تنزيله إليه.

--report-name

اسم التقرير الذي تم إنشاؤه.

استخدم إحدى هذه القيم:

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

pac copilot-studio generate-licensing-report

(معاينة) يبدأ في إنشاء تقرير ترخيص Copilot Studio للمستأجر عبر نطاق التاريخ المطلوب. يعمل الجيل بشكل غير متزامن؛ قم باستطلاع عنوان URL في عنوان الموقع للحالة. يتطلب دور مسؤول النظام الأساسي العمومي أو Dynamics 365 أو Power Platform.

المعلمات المطلوبة ل copilot-studio generate-licensing-report

--end-date

تاريخ انتهاء UTC الشامل لنطاق التقرير. يجب أن يكون في تاريخ البدء أو بعده.

--report-name

اسم التقرير المراد إنشاؤه.

استخدم إحدى هذه القيم:

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

--start-date

تاريخ بدء UTC الشامل لنطاق التقرير.

معلمات اختيارية ل copilot-studio generate-licensing-report

--granularity

دقة تقرير الترخيص. ترجع يوميا صفا واحدا في اليوم في نطاق التاريخ، ويرجع الملخص صفا واحدا ملخصا للنطاق بأكمله.

استخدم إحدى هذه القيم:

  • Daily
  • Summary

pac copilot-studio get-bot-quarantine-status

(معاينة) استرداد حالة العزل لروبوت.

المعلمات المطلوبة ل copilot-studio get-bot-quarantine-status

--bot-id

معرف الروبوت.

معلمات اختيارية ل copilot-studio get-bot-quarantine-status

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

get-bot-quarantine-status ملاحظات

يمكنك أيضا استدعاء هذا الأمر باستخدام Power Platform REST API Bots - الحصول على حالة عزل الروبوت.

(معاينة) احصل على إعداد تجاوز موافقة موصل المسؤول لروبوت.

--bot-id

معرف الروبوت.

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

يمكنك أيضا استدعاء هذا الأمر باستخدام Power Platform REST API Bots - الحصول على تجاوز موافقة الموصل.

pac copilot-studio get-licensing-report-operation

(معاينة) الحصول على حالة عملية إنشاء تقرير الترخيص. عندما تكون الحالة ناجحة، تتضمن الاستجابة اسم ملف التقرير ويحتوي عنوان الموقع على عنوان URL للتنزيل.

المعلمات المطلوبة ل copilot-studio get-licensing-report-operation

--operation-id

معرف عملية التقرير، الذي يتم إرجاعه في رأس الموقع عند بدء إنشاء التقرير.

--report-name

اسم التقرير الذي يتم إنشاؤه.

استخدم إحدى هذه القيم:

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

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

(معاينة) احصل على حالة ونتائج تشغيل اختبار تقييم صانع معين.

المعلمات المطلوبة ل copilot-studio get-maker-evaluation-test-run

--bot-id

معرف الروبوت.

--test-run-id

معرف تشغيل الاختبار.

معلمات اختيارية ل copilot-studio get-maker-evaluation-test-run

--columns

قائمة مفصولة بفواصل لخصائص الاستجابة لتضمينها في إخراج الجدول. استخدم --json للاستجابة الكاملة.

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

get-maker-evaluation-test-run ملاحظات

يمكنك أيضا استدعاء هذا الأمر باستخدام Power Platform REST API Bots - Get Maker Evaluation Test Run.

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

(معاينة) احصل على مجموعة اختبار محددة لتقييم صانع الروبوت.

المعلمات المطلوبة ل copilot-studio get-maker-evaluation-test-set

--bot-id

معرف الروبوت.

--test-set-id

معرف مجموعة الاختبار.

معلمات اختيارية ل copilot-studio get-maker-evaluation-test-set

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

get-maker-evaluation-test-set ملاحظات

يمكنك أيضا استدعاء هذا الأمر باستخدام Power Platform REST API Bots - Get Maker Evaluation Test Set.

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

(معاينة) سرد جميع عمليات تشغيل اختبار تقييم صانع الروبوت.

المعلمات المطلوبة ل copilot-studio list-maker-evaluation-test-runs

--bot-id

معرف الروبوت.

معلمات اختيارية ل copilot-studio list-maker-evaluation-test-runs

--columns

قائمة مفصولة بفواصل لخصائص الاستجابة لتضمينها في إخراج الجدول. استخدم --json للاستجابة الكاملة.

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

list-maker-evaluation-test-runs ملاحظات

يمكنك أيضا استدعاء هذا الأمر باستخدام Power Platform REST API Bots - List Maker Evaluation Test Runs.

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

(معاينة) استرداد قائمة مجموعات الاختبار لروبوت في بيئة محددة.

المعلمات المطلوبة ل copilot-studio list-maker-evaluation-test-sets

--bot-id

معرف الروبوت.

معلمات اختيارية ل copilot-studio list-maker-evaluation-test-sets

--columns

قائمة مفصولة بفواصل لخصائص الاستجابة لتضمينها في إخراج الجدول. استخدم --json للاستجابة الكاملة.

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

list-maker-evaluation-test-sets ملاحظات

يمكنك أيضا استدعاء هذا الأمر باستخدام Power Platform REST API Bots - List Maker Evaluation Test Sets.

pac copilot-studio reassign-copilot-agent

(معاينة) إعادة تعيين مالك الروبوت.

المعلمات المطلوبة ل copilot-studio reassign-copilot-agent

--bot-id

معرف الروبوت.

--new-owner-aad-user-id

المالك الجديد Entra ID.

معلمات اختيارية ل copilot-studio reassign-copilot-agent

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

reassign-copilot-agent ملاحظات

يمكنك أيضا استدعاء هذا الأمر باستخدام Power Platform REST API Bots - إعادة تعيين Copilot Agent.

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

(معاينة) تشغيل اختبار تقييم صانع لمجموعة اختبار معينة.

المعلمات المطلوبة ل copilot-studio run-maker-evaluation-test-set

--bot-id

معرف الروبوت.

--test-set-id

معرف مجموعة الاختبار.

معلمات اختيارية ل copilot-studio run-maker-evaluation-test-set

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--evaluation-run-name

اسم جولة التقييم.

--mcs-connection-id

معرف الاتصال لموصل MCS المستخدم لتنفيذ تشغيل التقييم، أو اتركه فارغا لتشغيل مجهول.

--run-on-published-bot

يشير إلى ما إذا كان يجب تشغيل العملية على مثيل روبوت منشور. إذا تم تعيينها إلى خطأ، فسيتم تشغيل العملية على مثيل روبوت مسودة.

--tools-connections

اتصالات الأدوات التي سيتم استخدامها لتنفيذ تشغيل التقييم. هذه قائمة بالأدوات جنبا إلى جنب مع اتصالات المستخدم المقابلة التي يجب استخدامها لكل أداة. توفير القيمة كصفيف JSON.

run-maker-evaluation-test-set ملاحظات

يمكنك أيضا استدعاء هذا الأمر باستخدام Power Platform REST API Bots - تشغيل مجموعة اختبار تقييم Maker.

pac copilot-studio set-bot-as-quarantined

(معاينة) تعيين حالة العزل للروبوت إلى true.

المعلمات المطلوبة ل copilot-studio set-bot-as-quarantined

--bot-id

معرف الروبوت.

معلمات اختيارية ل copilot-studio set-bot-as-quarantined

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

set-bot-as-quarantined ملاحظات

يمكنك أيضا استدعاء هذا الأمر باستخدام Power Platform REST API Bots - تعيين الروبوت ك معزول.

pac copilot-studio set-bot-as-unquarantined

(معاينة) تعيين حالة العزل لروبوت إلى خطأ.

المعلمات المطلوبة ل copilot-studio set-bot-as-unquarantined

--bot-id

معرف الروبوت.

معلمات اختيارية ل copilot-studio set-bot-as-unquarantined

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

set-bot-as-unquarantined ملاحظات

يمكنك أيضا استدعاء هذا الأمر باستخدام Power Platform REST API Bots - تعيين الروبوت ك Unquarantined.

(معاينة) تعيين إعداد تجاوز موافقة موصل المسؤول لروبوت.

يشير إلى ما إذا كان يجب تمكين تجاوز موافقة موصل المسؤول للروبوت.

--bot-id

معرف الروبوت.

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

يمكنك أيضا استدعاء هذا الأمر باستخدام Power Platform REST API Bots - تعيين تجاوز موافقة الموصل.

(راجع أيضًا)

Microsoft Power Platform مجموعات أوامر CLI
نظرة عامة على Microsoft Power Platform CLI