הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
השתמש במשתנה סביבה כדי לקבוע תצורה Power Apps CLI ולספק אפשרויות פקודה בקבצי Script ובצינורות CI/CD. משתני סביבה המוגדרים על-ידי Power Apps CLI משתמשים בקידומתPA_CLI_.
הערה
משתני סביבה הם ערכים בעלי שם שמערכת ההפעלה הופכת לזמינים ליישומים. Power Apps CLI מזהה את המשתנים המתוארים בהפניה זו. כדי ללמוד כיצד פועלים משתני סביבה וכיצד לנהל אותם, ראה אודות משתני סביבה.
חומר עזר זה מתאר משתני סביבה של מערכת הפעלה שמגדירים את Power Apps CLI. משתנים אלה שונים ממשתני הסביבה של פתרונות Power Platform, המאחסנים ערכי תצורה שבהם משתמש יישום.
עבור אפשרות פקודה, ה- CLI פותר ערך בסדר זה:
- אפשרות שורת פקודה
- משתנה סביבה
- ערך ברירת מחדל, אם האפשרות כוללת ערך
- בקשה אינטראקטיבית, כאשר היא נתמכת
אפשרות שסופקה בשורת הפקודה מקבלת קדימות על פני משתנה הסביבה המתאים שלה.
חשוב
משתני סביבה יכולים לחשוף סודות לתהליכים, יומני רישום או היסטוריית מעטפת אחרים. אחסן PA_CLI_SP_CLIENT_SECRET במאגר הסודי של פלטפורמת ה- CI/CD שלך, הסתר אותו מיומני הרישום ואל תחייב סודות לבקרת המקור.
הגדרת משתני סביבה
הדוגמאות הבאות מוגדרות PA_CLI_ENVIRONMENT_ID לפני הפעלת Power Apps CLI.
$env:PA_CLI_ENVIRONMENT_ID = "<environment-id>"
pa app list
משתנה הסביבה נשאר זמין לפקודות שהופעלו מאותה הפעלת מסוף. השתמש בפקודה הרגילה של המעטפת כדי להסיר אותה כאשר אין בה עוד צורך.
אימות
| משתנה סביבה | תיאור |
|---|---|
PA_CLI_ACCOUNT |
מציין את החשבון עבור או pa auth loginpa 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.
| משתנה סביבה | אפשרות תואמת | תיאור |
|---|---|---|
PA_CLI_CLOUD |
--cloud |
בוחר את ענן היעד. ערכים חוקיים הם: - public (ברירת מחדל)- usgov- usgovhigh- usgovdod- chinaהערכים אינם תלויי רישיות. |
PA_CLI_ENVIRONMENT_ID |
--environment-id |
מציין את מזהה הסביבה של Power Platform המשמש כיעד. |
אתחול יישום
משתנים אלה מספקים אפשרויות ל- pa app init.
| משתנה סביבה | אפשרות תואמת | תיאור |
|---|---|---|
PA_CLI_APP_BUILD_PATH |
--build-path |
מציין את ספריית הפלט של גירסת ה- Build. ברירת המחדל היא ./dist. |
PA_CLI_APP_DESCRIPTION |
--description |
מציין את תיאור היישום. |
PA_CLI_APP_DISPLAY_NAME |
--display-name |
מציין את שם התצוגה של היישום. |
PA_CLI_APP_FILE_ENTRY_POINT |
--file-entry-point |
מציין את נקודת הכניסה של HTML בפלט גירסת ה- Build. ברירת המחדל היא 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.
| משתנה סביבה | אפשרות תואמת | תיאור |
|---|---|---|
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.
| משתנה סביבה | אפשרות תואמת | תיאור |
|---|---|---|
PA_CLI_SHARE_ACCESS |
--access |
מציין את רמת הגישה. ערכים חוקיים הם: - play (ברירת מחדל)- edit |
PA_CLI_SHARE_PRINCIPAL |
--principal |
מציין כתובת דואר אלקטרוני אחת או יותר המופרדות באמצעות פסיק Microsoft Entra מזהי אובייקטים. |
פתרונות, מחברים ומקורות נתונים
| משתנה סביבה | אפשרות תואמת | תיאור |
|---|---|---|
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.
ממשקי API וזרימות Power Automate Dataverse
| משתנה סביבה | אפשרות תואמת | תיאור |
|---|---|---|
PA_CLI_DATAVERSE_API_NAME |
--api-name |
מציין את הפעולה או הפונקציה Dataverse להוספה עם האפליקציה pa add 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 |
פלט מדידת שימוש וקונסולה
| משתנה סביבה | אפשרות תואמת | תיאור |
|---|---|---|
PA_CLI_CONSOLE_ONLY |
--console-only |
הגדר את הערך ל true - (אותיות קטנות) pa telemetry disablepa telemetry enable עם או כדי לכתוב מדידת שימוש בקונסולה בלבד ולא לשלוח אותו מרחוק. |
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 מבחין במשתנה סביבה סטנדרטי זה:
| משתנה סביבה | תיאור |
|---|---|
NO_COLOR |
הגדר משתנה זה לערך שאינו ריק כדי להפוך פלט צבע ANSI ללא זמין. באפשרותך גם להשתמש באפשרות --no-color זו. |