إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
استخدم متغيرات البيئة لتكوين مصادقة Power Apps CLI وتوفير خيارات الأوامر في البرامج النصية وتدفقات CI/CD. تستخدم متغيرات البيئة المحددة بواسطة Power Apps CLI البادئةPA_CLI_.
ملحوظة
متغيرات البيئة هي قيم مسماة يتيحها نظام التشغيل للتطبيقات. يتعرف Power Apps CLI على المتغيرات الموضحة في هذا المرجع. لمعرفة كيفية عمل متغيرات البيئة وكيفية إدارتها، راجع متغيرات البيئة.
يصف هذا المرجع متغيرات بيئة نظام التشغيل التي تقوم بتكوين Power Apps CLI. تختلف هذه المتغيرات عن متغيرات بيئة حل Power Platform، والتي تخزن قيم التكوين المستخدمة من قبل التطبيق.
بالنسبة لخيار الأمر، يحل CLI قيمة بهذا الترتيب:
- خيار سطر الأوامر
- متغير البيئة
- القيمة الافتراضية، إذا كان الخيار يحتوي على قيمة
- مطالبة تفاعلية، عند دعمها
يكون للخيار المتوفر في سطر الأوامر الأسبقية على متغير البيئة المقابل له.
مهم
يمكن أن تعرض متغيرات البيئة البيانات السرية لعمليات أو سجلات أو محفوظات shell أخرى. قم بتخزين PA_CLI_SP_CLIENT_SECRET في المخزن السري للنظام الأساسي CI/CD، وإخفائه من السجلات، ولا تلتزم بأسرار التحكم بالمصادر.
تعيين متغيرات البيئة
تم تعيين PA_CLI_ENVIRONMENT_ID الأمثلة التالية قبل تشغيل أمر Power Apps CLI.
يظل متغير البيئة متوفرا للأوامر التي بدأت من نفس جلسة المحطة الطرفية. استخدم الأمر القياسي ل shell لإزالته عندما لا تكون هناك حاجة إليه.
المصادقة
| متغير البيئة | Description |
|---|---|
PA_CLI_ACCOUNT |
يحدد الحساب ل pa auth login أو pa auth switch. |
PA_CLI_SP_CLIENT_ID |
يحدد معرف التطبيق Microsoft Entra (العميل) للمصادقة الأساسية للخدمة. |
PA_CLI_SP_CLIENT_SECRET |
تحديد سر العميل للمصادقة الأساسية للخدمة. |
PA_CLI_SP_TENANT_ID |
تحديد معرف دليل Microsoft Entra (المستأجر) للمصادقة الأساسية للخدمة. |
PA_CLI_USE_SP_AUTH |
تعيين القيمة إلى true (أحرف صغيرة) لاستخدام المصادقة الأساسية للخدمة. |
متغيرات بيانات الاعتماد الثلاثة PA_CLI_SP_* مطلوبة عند تحديد المصادقة الأساسية للخدمة. على الرغم من أنه CI=true يحدد أيضا المصادقة الأساسية للخدمة للتوافق، استخدم PA_CLI_USE_SP_AUTH=true لجعل وضع المصادقة صريحا.
للحصول على إرشادات الإعداد، راجع نشر تطبيقات التعليمات البرمجية Power Apps باستخدام كيان الخدمة.
خيارات الأوامر العمومية
تتوافق هذه المتغيرات مع الخيارات المتوفرة عبر أوامر Power Apps CLI.
| متغير البيئة | الخيار المقابل | Description |
|---|---|---|
PA_CLI_CLOUD |
--cloud |
تحديد السحابة المستهدفة. القيم الصالحة هي: - public (افتراضي)- usgov- usgovhigh- usgovdod- chinaالقيم غير حساسة لحالة الأحرف. |
PA_CLI_ENVIRONMENT_ID |
--environment-id |
تحديد معرف بيئة Power Platform الهدف. |
تهيئة التطبيق
توفر هذه المتغيرات خيارات إلى pa app init.
| متغير البيئة | الخيار المقابل | Description |
|---|---|---|
PA_CLI_APP_BUILD_PATH |
--build-path |
تحديد دليل إخراج البنية. الافتراضي هو ./dist. |
PA_CLI_APP_DESCRIPTION |
--description |
تحديد وصف التطبيق. |
PA_CLI_APP_DISPLAY_NAME |
--display-name |
تحديد اسم عرض التطبيق. |
PA_CLI_APP_FILE_ENTRY_POINT |
--file-entry-point |
تحديد نقطة إدخال HTML في إخراج البنية. الافتراضي هو index.html. |
PA_CLI_APP_TYPE |
--app-type |
تحديد نوع التطبيق. القيم الصالحة هي: - CodeApp (افتراضي)- MobileAppيتم حفظ القيمة واستخدامها power.config.json كنوع التطبيق عند نشر التطبيق. |
PA_CLI_APP_URL |
--app-url |
يحدد عنوان URL للتطبيق المحلي أثناء pa app init. يتم حفظ القيمة كما localAppUrl في power.config.json وتصبح عنوان URL الافتراضي للأوامر المستقبلية pa app run . الافتراضي هو http://localhost:3000. |
تشغيل التطبيقات
توفر هذه المتغيرات خيارات إلى pa app run.
| متغير البيئة | الخيار المقابل | Description |
|---|---|---|
PA_CLI_LOCAL_APP_URL |
--local-app-url |
يتجاوز localAppUrl القيمة من power.config.json للأمر الحالي دون تغيير التكوين المحفوظ. إذا لم يتم تعيين أي قيمة، فإن القيمة الافتراضية هي http://localhost:3000. |
PA_CLI_PORT |
--port |
تحديد منفذ المضيف المحلي Power Apps. الافتراضي هو 8080. |
مشَاركة التطبيقَات
توفر هذه المتغيرات خيارات إلى pa app share.
| متغير البيئة | الخيار المقابل | Description |
|---|---|---|
PA_CLI_SHARE_ACCESS |
--access |
تحديد مستوى الوصول. القيم الصالحة هي: - play (افتراضي)- edit |
PA_CLI_SHARE_PRINCIPAL |
--principal |
تحديد عنوان بريد إلكتروني واحد أو أكثر مفصول بفواصل أو معرفات كائن Microsoft Entra. |
الحلول والموصلات ومصادر البيانات
| متغير البيئة | الخيار المقابل | Description |
|---|---|---|
PA_CLI_CONNECTION_DISPLAY_NAME |
--display-name |
تحديد اسم العرض عند إنشاء اتصال. |
PA_CLI_CONNECTION_ID |
--connection-id |
تحديد معرف مثيل اتصال الموصل. |
PA_CLI_CONNECTION_REF |
--connection-ref |
تحديد اسم منطقي لمرجع اتصال. |
PA_CLI_CONNECTION_SEARCH |
--search |
تصفية النتائج من pa connection list. |
PA_CLI_CONNECTOR |
--connector |
تحديد معرف موصل، مثل shared_office365users. |
PA_CLI_CONNECTOR_SEARCH |
--search |
تصفية النتائج من pa connector list. |
PA_CLI_DATASET |
--dataset |
تحديد مجموعة بيانات، مثل موقع SharePoint أو قاعدة بيانات SQL. |
PA_CLI_DATA_SOURCE_NAME |
--name |
تحديد مصدر البيانات المراد تحديثه أو إزالته. |
PA_CLI_ORG_URL |
--org-url |
يتجاوز عنوان URL لمؤسسة Dataverse المستخدم لاسترداد بيانات التعريف عند إضافة مصدر بيانات. |
PA_CLI_PROCEDURE |
--procedure |
تحديد إجراء SQL المخزن. |
PA_CLI_SOLUTION_ID |
--solution-id |
يحدد الحل ل pa app pushأو pa app add data-sourceأو pa connection list-references. |
PA_CLI_SOLUTION_SEARCH |
--search |
تصفية النتائج من pa solution list. |
PA_CLI_TABLE |
--table |
تحديد اسم مورد جدول أو موصل. |
للحصول على الأوامر التي تقبل كل خيار، راجع مرجع أمر Power Apps CLI.
واجهات برمجة تطبيقات Dataverse وتدفقات Power Automate
| متغير البيئة | الخيار المقابل | Description |
|---|---|---|
PA_CLI_DATAVERSE_API_NAME |
--api-name |
يحدد الإجراء أو الدالة Dataverse لإضافتها باستخدام تطبيق pa إضافة dataverse-api. |
PA_CLI_DATAVERSE_API_SEARCH_TERM |
--search |
تصفية إجراءات ووظائف Dataverse بالاسم باستخدام pa app find-dataverse-api. |
PA_CLI_FLOW_DATA_SOURCE_NAME |
--flow-name |
تحديد مصدر بيانات التدفق لإزالته من التطبيق باستخدام pa app remove flow |
PA_CLI_FLOW_ID |
--flow-id |
يحدد تدفق Power Automate لإضافته باستخدام pa app add flow. |
PA_CLI_FLOW_SEARCH |
--search |
تصفية تدفقات Power Automate المتوفرة حسب الاسم باستخدامpa app list-flows |
PA_CLI_REMOVE_FLOW_ID |
--flow-id |
تحديد تدفق Power Automate لإزالته باستخدامpa app remove flow |
بيانات تتبع الاستخدام وإخراج وحدة التحكم
| متغير البيئة | الخيار المقابل | Description |
|---|---|---|
PA_CLI_CONSOLE_ONLY |
--console-only |
تعيين القيمة إلى true (أحرف صغيرة) مع pa telemetry enable أو pa telemetry disable لكتابة القياس عن بعد فقط إلى وحدة التحكم وعدم إرسالها عن بعد. |
PA_CLI_OUTPUT_TO_CONSOLE |
--output-to-console |
قم بتعيين القيمة إلى true (أحرف صغيرة) مع pa telemetry enable أو pa telemetry disable لعكس أحداث القياس عن بعد المرسلة عن بعد إلى وحدة التحكم. |
PA_CLI_TELEMETRY |
لا شيء | قم بتعيين إحدى هذه القيم لتعطيل بيانات تتبع الاستخدام للعملية الحالية: - 0- false- no- offالقيم غير حساسة لحالة الأحرف، ويتم تجاهل المسافات المحيطة. |
للحصول على إعدادات بيانات تتبع الاستخدام المستمرة، راجع إدارة إعدادات بيانات تتبع الاستخدام ل Power Apps CLI.
متغيرات البيئة القياسية
كما يلاحظ CLI متغير البيئة القياسي هذا:
| متغير البيئة | Description |
|---|---|
NO_COLOR |
قم بتعيين هذا المتغير إلى قيمة nonempty لتعطيل إخراج لون ANSI. يمكنك أيضا استخدام --no-color الخيار . |