مرجع أمر Power Apps CLI

هذه هي الأوامر لأحدث الإصدارات:

يوفر Power Apps CLI أوامر لإنشاء تطبيقات التعليمات البرمجية Power Apps وتطويرها وتوصيلها ونشرها. يستخدم CLI الأوامر المجمعة بالتنسيق التالي:

pa <command-group> <command>

هذه هي مجموعات الأوامر:

مجموعة القيادة الوصف
pa app إنشاء تطبيقات التعليمات البرمجية وتشغيلها وتوصيلها ونشرها.
pa auth تسجيل الدخول وإدارة الحسابات.
pa connector ابحث عن الموصلات المتوفرة في بيئة Power Platform.
pa connection إنشاء الاتصالات وإدارتها واكتشاف مواردها.
pa telemetry إدارة إعدادات القياس عن بعد ل CLI.

لعرض التعليمات في المحطة الطرفية، استخدم --help على أي مستوى:

pa --help
pa app --help
pa app init --help

الأوامر

هذه هي الأوامر المتوفرة:

Command الوصف
pa app add data-source إضافة موصل أو مصدر بيانات جدولي إلى تطبيق التعليمات البرمجية.
pa app add dataverse-api أضف إجراء أو دالة Dataverse إلى تطبيق التعليمات البرمجية.
pa app add flow أضف تدفق Power Automate إلى تطبيق التعليمات البرمجية.
pa app find-dataverse-api ابحث عن إجراءات ووظائف Dataverse في البيئة الحالية.
pa app init تهيئة تطبيق التعليمات البرمجية في الدليل الحالي.
pa app list سرد تطبيقات التعليمات البرمجية في البيئة الحالية.
pa app list-environment-variables سرد متغيرات البيئة المتوفرة لتطبيق التعليمات البرمجية.
pa app list-flows سرد تدفقات Power Automate المدركة للحل في البيئة الحالية.
pa app push نشر إصدار جديد من تطبيق التعليمات البرمجية Power Apps.
pa app refresh data-source تحديث الملفات التي تم إنشاؤها لمصدر بيانات.
pa app remove data-source إزالة مصدر بيانات من تطبيق التعليمات البرمجية.
pa app remove flow إزالة تدفق Power Automate من تطبيق التعليمات البرمجية.
pa app run ابدأ تشغيل المضيف المحلي Power Apps لتطبيق التعليمات البرمجية.
pa app share مشاركة تطبيق التعليمات البرمجية مع المستخدمين أو كيانات الخدمة.
pa auth login تسجيل الدخول من خلال متصفح النظام.
pa auth logout تسجيل الخروج وإزالة معلومات المصادقة المحفوظة.
pa auth status عرض حسابات تسجيل الدخول وتحديد الحساب النشط.
pa auth switch تغيير الحساب النشط.
pa connection create إنشاء اتصال لموصل.
pa connection list سرد الاتصالات في البيئة الحالية.
pa connection list-datasets سرد مجموعات البيانات المتوفرة من خلال اتصال.
pa connection list-procedures سرد إجراءات SQL المخزنة المتوفرة في مجموعة بيانات.
pa connection list-references سرد مراجع الاتصال في حل.
pa connection list-tables سرد الجداول المتوفرة في مجموعة بيانات.
pa connector list قائمة الموصلات المتوفرة في بيئة Power Platform الحالية.
pa telemetry disable تعطيل مجموعة بيانات تتبع الاستخدام.
pa telemetry enable تمكين جمع بيانات تتبع الاستخدام.
pa telemetry status عرض إعدادات بيانات تتبع الاستخدام الحالية.

pa app add data-source

إضافة موصل أو مصدر بيانات جدولي إلى تطبيق التعليمات البرمجية.

pa app add data-source --connector <connector-id> [options]

pa app add data-source البارامترات

المعلمه الوصف
--connector معرف الموصل، مثل shared_office365users.
--connection-id معرف الاتصال المراد استخدامه لمصدر البيانات.
--connection-ref الاسم المنطقي لمرجع اتصال.
--solution-id الحل الذي يحتوي على مرجع الاتصال.
--dataset مجموعة البيانات لمصدر بيانات جدولي.
--table الجدول المراد إضافته.
--procedure إجراء SQL المخزن لإضافته.

pa app add dataverse-api

إضافة إجراء أو وظيفة Dataverse إلى تطبيق التعليمات البرمجية.

pa app add dataverse-api --api-name <operation-name>

pa app add dataverse-api البارامترات

المعلمه الوصف
--api-name اسم الإجراء أو الدالة Dataverse المراد إضافتها.

اعرف المزيد‬:

pa app add flow

إضافة تدفق Power Automate إلى تطبيق التعليمات البرمجية.

pa app add flow --flow-id <flow-id>

pa app add flow البارامترات

المعلمه الوصف
--flow-id معرف تدفق Power Automate لإضافته.

الأمر:

  • تنزيل تعريف OpenAPI للتدفق.
  • إنشاء نماذج وخدمات TypeScript مكتوبة بقوة.
  • يضيف التدفق ومراجع الاتصال الخاصة به إلى power.config.json.

إذا تغير تعريف التدفق، فقم بتشغيل هذا الأمر مرة أخرى لإعادة إنشاء التعليمات البرمجية لأحدث إصدار.

مهم

يجب أن يكون لدى الشخص الذي يتم تشغيله pa app add flow حق الوصول إلى التدفق واتصالاته الأساسية. يفشل الأمر إذا لم يكن لدى الشخص حق الوصول إلى اتصال مطلوب.

تعرف على المزيد حول السيناريوهات التي تستخدم فيها هذا الأمر:

pa app find-dataverse-api

البحث عن إجراءات ووظائف Dataverse في البيئة الحالية.

pa app find-dataverse-api --search <operation-name> [--json]

pa app find-dataverse-api البارامترات

المعلمه الوصف
--search اسم العملية للبحث عن.
--json إرجاع النتائج ك JSON.

تعرف على كيفية العثور على عمليات Dataverse المتوفرة

pa app init

تهيئة تطبيق التعليمات البرمجية في الدليل الحالي.

pa app init [--display-name <name>] [--environment-id <environment-id>]

pa app init البارامترات

المعلمه الوصف
--display-name اسم العرض لتطبيق التعليمات البرمجية.
--environment-id بيئة Power Platform لتطبيق التعليمات البرمجية.
--build-path الدليل الذي يحتوي على أصول التطبيق المحولة برمجيا.
--cloud مثيل سحابة Power Platform.

تعرف على المزيد حول السيناريوهات التي يمكنك فيها استخدام هذا الأمر:

pa app list

يسرد تطبيقات التعليمات البرمجية في البيئة الحالية.

pa app list

pa app list-environment-variables

يسرد متغيرات البيئة المتوفرة لتطبيق التعليمات البرمجية.

pa app list-environment-variables

pa app list-flows

يسرد تدفقات Power Automate المدركة للحلول في البيئة الحالية.

pa app list-flows [--search <term>]

Example:

pa app list-flows

Name                    Status   Modified On   Flow ID
──────────────────────────────────────────────────────────────────────────────
Approval Workflow       Started  2026-01-15    a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1
Send Notification       Started  2026-02-01    b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2

Total flows: 2

pa app list-flows البارامترات

المعلمه الوصف
--search تصفية التدفقات حسب الاسم.

pa app push

نشر إصدار جديد من تطبيق التعليمات البرمجية إلى Power Apps.

pa app push [--solution-id <solution-id>]

pa app push البارامترات

المعلمه الوصف
--solution-id معرف الحل لإضافة تطبيق التعليمات البرمجية إليه.
--non-interactive نشر التطبيق بشكل غير تفاعلي. تعلم كيفية نشر التطبيقات باستخدام كيان الخدمة

تعرف على كيفية إنشاء تطبيق تعليمة برمجية باستخدام Power Apps CLI

pa app refresh data-source

تحديث الملفات التي تم إنشاؤها لمصدر بيانات.

pa app refresh data-source --name <data-source-name>

pa app refresh data-source البارامترات

المعلمه الوصف
--name اسم مصدر البيانات المراد تحديثه.

pa app remove data-source

إزالة مصدر بيانات من تطبيق التعليمات البرمجية.

pa app remove data-source --connector <connector-id> --name <data-source-name> [--force]

pa app remove data-source البارامترات

المعلمه الوصف
--connector معرف الموصل لمصدر البيانات.
--name اسم مصدر البيانات المراد إزالته.
--force قم بإزالة مصدر البيانات دون المطالبة بالتأكيد.

pa app remove flow

إزالة تدفق Power Automate من تطبيق التعليمات البرمجية.

pa app remove flow [--flow-name <name> | --flow-id <flow-id>] [--force]

pa app remove flow البارامترات

المعلمه الوصف
--flow-name اسم تدفق Power Automate لإزالته.
--flow-id معرف تدفق Power Automate لإزالته.
--force قم بإزالة التدفق دون المطالبة بالتأكيد.

تعرف على كيفية إزالة تدفق

pa app run

بدء تشغيل المضيف المحلي Power Apps لتطبيق التعليمات البرمجية.

pa app run [--port <port>] [--local-app-url <url>]

pa app run البارامترات

المعلمه الوصف
--port منفذ المضيف المحلي.
--local-app-url عنوان URL لتطبيق التعليمات البرمجية قيد التشغيل محليا.

pa app share

مشاركة تطبيق التعليمات البرمجية مع المستخدمين أو كيانات الخدمة.

pa app share --principal <principal> [--access play|edit]

pa app share البارامترات

المعلمه الوصف
--principal عناوين البريد الإلكتروني المفصولة بفواصل أو Microsoft Entra معرفات الكائنات للمستخدمين أو كيانات الخدمة للمشاركة معها.
--access مستوى الوصول المطلوب منحه: play (افتراضي) أو edit.

pa app share ملاحظات

يجب نشر تطبيق التعليمات البرمجية بالفعل وأن يكون له معرف تطبيق من أمر ناجح pa app push . امنح edit حق الوصول عندما يحتاج كيان الخدمة إلى تشغيل pa app push.

عند المشاركة مع كيان خدمة، استخدم معرف كائن تطبيق المؤسسة، وليس معرف كائن تسجيل التطبيق.

pa auth login

تسجيل الدخول من خلال متصفح النظام.

pa auth login

لملء الحساب مسبقا في صفحة تسجيل الدخول، استخدم:

pa auth login --account user@contoso.com

pa auth login البارامترات

المعلمه الوصف
--account الحساب المراد طباعته مسبقا في صفحة تسجيل الدخول.

pa auth logout

تسجيل الخروج وإزالة معلومات المصادقة المحفوظة.

pa auth logout

ملحوظة

يقوم هذا الأمر بتسجيل خروجك من جميع الحسابات. لا يمكن تسجيل خروجك من حساب واحد فقط. لتغيير الحساب النشط، استخدم pa auth switch بدلا من ذلك.

تعرف على كيفية تسجيل الخروج

pa auth status

يعرض حسابات تسجيل الدخول ويحدد الحساب النشط.

لعرض حالة المصادقة ك JSON، استخدم:

pa auth status --json

pa auth status البارامترات

المعلمه الوصف
--json إرجاع حالة المصادقة ك JSON.

تعرف على كيفية التحقق من الحساب النشط

pa auth switch

تغيير الحساب النشط.

pa auth switch --account user@contoso.com

pa auth switch البارامترات

المعلمه الوصف
--account الحساب المراد تنشيطه.

تعرف على المزيد حول متى يمكنك استخدام هذا الأمر:

pa connection create

إنشاء اتصال لموصل.

pa connection create --connector <connector-id> [--display-name <name>] [--json]

pa connection create البارامترات

المعلمه الوصف
--connector معرف الموصل، مثل shared_office365.
--display-name اسم العرض للاتصال.
--json إرجاع النتيجة ك JSON.

pa connection list

يسرد الاتصالات في البيئة الحالية.

pa connection list [--search <term>] [--json]

pa connection list البارامترات

المعلمه الوصف
--search تصفية الاتصالات حسب الاسم.
--json إرجاع النتائج ك JSON.

pa connection list-datasets

يسرد مجموعات البيانات المتوفرة من خلال اتصال.

pa connection list-datasets --connector <connector-id> [--connection-id <connection-id>]

pa connection list-datasets البارامترات

المعلمه الوصف
--connector معرف الموصل.
--connection-id معرف الاتصال المراد استخدامه عند سرد مجموعات البيانات.

pa connection list-procedures

يسرد إجراءات SQL المخزنة المتوفرة في مجموعة بيانات.

pa connection list-procedures --connection-id <connection-id> --dataset <dataset>

pa connection list-procedures البارامترات

المعلمه الوصف
--connection-id معرف الاتصال المراد استخدامه عند سرد الإجراءات المخزنة.
--dataset مجموعة البيانات التي تحتوي على الإجراءات المخزنة.

pa connection list-references

يسرد مراجع الاتصال في حل.

pa connection list-references --solution-id <solution-id>

pa connection list-references البارامترات

المعلمه الوصف
--solution-id معرف الحل الذي يحتوي على مراجع الاتصال.

pa connection list-tables

يسرد الجداول المتوفرة في مجموعة بيانات.

pa connection list-tables --connector <connector-id> [--connection-id <connection-id>] [--dataset <dataset>]

pa connection list-tables البارامترات

المعلمه الوصف
--connector معرف الموصل.
--connection-id معرف الاتصال المراد استخدامه عند سرد الجداول.
--dataset مجموعة البيانات التي تحتوي على الجداول.

pa connector list

يسرد الموصلات المتوفرة في بيئة Power Platform الحالية.

pa connector list [--search <term>] [--json]

pa connector list البارامترات

المعلمه الوصف
--search تصفية الموصلات حسب الاسم أو اسم العرض.
--json إرجاع قائمة الموصلات الكاملة ك JSON.

تعرف على كيفية إنشاء اتصال

pa telemetry disable

تعطيل مجموعة بيانات تتبع الاستخدام.

pa telemetry disable

pa telemetry enable

تمكين جمع بيانات تتبع الاستخدام.

pa telemetry enable

pa telemetry status

يعرض إعدادات بيانات تتبع الاستخدام الحالية.

pa telemetry status
  • Last updated on