مرجع أمر Power Apps CLI

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

pa <command-group> <command>

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

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

الخيارات العمومية

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

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

استخدم --version لعرض إصدار Power Apps CLI المثبت:

pa --version

أوامر Power Apps CLI

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

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 solution list	سرد الحلول في البيئة الحالية.
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	الجدول المراد إضافته.
--org-url	عنوان URL لمؤسسة Dataverse لاستخدامه عند استرداد بيانات تعريف الجدول.
--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_CLI_DATAVERSE_API_NAME هو المتغير البيئي المقابل للمعلمة --api-name .

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

• تعرف على كيفية تحديث عملية Dataverse
• استكشاف أخطاء عمليات Dataverse وإصلاحها

pa app add flow

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

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

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

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

PA_CLI_FLOW_ID هو المتغير البيئي المقابل للمعلمة --flow-id .

الأمر:

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

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

مهم

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

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

• تعرف على ما يحدث عند إضافة تدفق Power Automate
• تعرف على كيفية تحديث تدفق Power Automate
• مراجعة القيود والاعتبارات الخاصة بتدفقات Power Automate

pa app find-dataverse-api

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

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

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

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

تحتوي هذه المعلمات على واجهات برمجة تطبيقات Dataverse المقابلة وتتدفق Power Automate المتغيرات البيئية.

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

pa app init

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

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

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

المعلمه	الوصف
--display-name	اسم العرض لتطبيق التعليمات البرمجية.
--environment-id	بيئة Power Platform لتطبيق التعليمات البرمجية.
--description	وصف تطبيق التعليمات البرمجية.
--build-path	الدليل الذي يحتوي على أصول التطبيق المحولة برمجيا.
--file-entry-point	نقطة إدخال HTML في إخراج البنية.
--app-type	نوع التطبيق. القيم الصالحة هي CodeApp و MobileApp.
--app-url	عنوان URL لتطبيق التعليمات البرمجية قيد التشغيل محليا.
--cloud	مثيل سحابة Power Platform.

تحتوي هذه المعلمات على متغيرات بيئية مقابلة لتهيئة التطبيق .

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

• مراجعة المتطلبات الأساسية لإضافة إجراء أو دالة Dataverse
• مراجعة المتطلبات الأساسية لإضافة تدفقات Power Automate
• تعرف على كيفية تهيئة تطبيق التعليمات البرمجية
• تعرف على كيفية عمل تسجيل الدخول عند تهيئة تطبيق التعليمات البرمجية

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_CLI_FLOW_SEARCH هو المتغير البيئي المقابل للمعلمة --search .

pa app push

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

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

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

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

PA_CLI_SOLUTION_ID هو المتغير البيئي الذي يجب استخدامه مع المعلمة --solution-id .

تعرف على كيفية إنشاء تطبيق تعليمة برمجية باستخدام 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_CLI_FLOW_DATA_SOURCE_NAME وهي PA_CLI_REMOVE_FLOW_ID متغيرات بيئية مقابلة لاستخدام هذه المعلمات.

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

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_CLI_ACCOUNT هو المتغير البيئي المقابل للمعلمة --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_CLI_ACCOUNT هو المتغير البيئي المقابل للمعلمة --account .

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

• تعرف على كيفية التحقق من الحساب النشط
• تعرف على كيفية تبديل الحساب النشط
• تعرف على كيفية تسجيل الخروج

pa connection create

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

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

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

المعلمه	الاسم المستعار	مطلوب	الوصف
--connector	-	نعم	معرف الموصل، مثل shared_office365 أو shared_teams.
--display-name	-n	لا	اسم العرض للاتصال. إذا لم تقدم اسما، فإن CLI يستخدم اسما افتراضيا.
--json	-	لا	إرجاع النتيجة ك JSON.

pa connection create امثله

إنشاء اتصال Office 365 Outlook:

pa connection create --connector shared_office365

إنشاء اتصال Microsoft Teams باسم عرض مخصص:

pa connection create --connector shared_teams --display-name "My Teams"

إنشاء اتصال وإرجاع النتيجة ك JSON:

pa connection create --connector shared_office365 --json

pa connection create الناتج

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

تعرف على كيفية إنشاء اتصال من Power Apps CLI

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_CLI_SOLUTION_ID هو المتغير البيئي المقابل لاستخدامه مع المعلمة --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_CLI_CONNECTOR_SEARCH هو المتغير البيئي المقابل لاستخدامه مع المعلمة --search .

pa connector list الناتج

في محطة طرفية تفاعلية، تظهر النتائج في صفحات من 20 صفا. اضغط على مفتاح الإدخال Enter لإظهار الصفحة التالية. اضغط على Esc أو Q للخروج. عند إعادة توجيه الإخراج أو تضمين --json، يقوم الأمر بإرجاع القائمة الكاملة.

بشكل افتراضي، يقوم الأمر بإرجاع جدول بالأعمدة التالية:

عمود	الوصف
الاسم المعروض‬	اسم عرض الموصل، مثل Office 365 Outlook.
الموصل	معرف الموصل، مثل shared_office365. استخدم هذه القيمة مع --connector خيار pa connection create.

عند استخدام المعلمة --json ، يتضمن إخراج JSON الحقول التالية:

الحقل	الوصف
id	معرف الموصل.
name	معرف الموصل، مثل shared_office365.
displayName	اسم عرض الموصل.
description	وصف الموصل.
isTabular	يشير إلى ما إذا كان الموصل يدعم عمليات البيانات الجدولية.

pa connector list امثله

سرد كافة الموصلات المتوفرة:

pa connector list

البحث عن الموصلات:

pa connector list --search teams

إرجاع قائمة الموصل ك JSON:

pa connector list --json

تعرف على كيفية سرد الموصلات المتوفرة

pa solution list

يسرد الحلول في البيئة الحالية، بما في ذلك الاسم المألوف والاسم الفريد ومعرف الحل.

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

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

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

PA_CLI_SOLUTION_SEARCH هو المتغير البيئي المقابل للمعلمة --search .

في محطة طرفية تفاعلية، تظهر النتائج في صفحات من 20 صفا. اضغط على مفتاح الإدخال Enter لإظهار الصفحة التالية. اضغط على Esc أو Q للخروج. عند إعادة توجيه الإخراج أو تضمين --json، يقوم الأمر بإرجاع القائمة الكاملة.

pa telemetry disable

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

pa telemetry disable

pa telemetry enable

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

pa telemetry enable

pa telemetry status

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

pa telemetry status

معلومات ذات صلة

• متغيرات بيئة Power Apps CLI
• التشغيل السريع: إنشاء تطبيق تعليمة برمجية باستخدام Power Apps CLI
• تسجيل الدخول وإدارة الحسابات باستخدام Power Apps CLI
• إضافة مصادر بيانات إلى تطبيق التعليمات البرمجية