หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ใช้ตัวแปรสภาพแวดล้อมเพื่อกําหนดค่าการรับรองความถูกต้อง CLI Power Apps และให้ตัวเลือกคําสั่งในสคริปต์และไปป์ไลน์ CI/CD ตัวแปรสภาพแวดล้อมที่กําหนดโดย Power Apps CLI จะใช้คําPA_CLI_นําหน้า
Note
ตัวแปรสภาพแวดล้อมเป็นค่าที่ชื่อว่าระบบปฏิบัติการทําให้พร้อมใช้งานแอปพลิเคชัน Power Apps CLI จะจดจําตัวแปรที่อธิบายไว้ในการอ้างอิงนี้ หากต้องการเรียนรู้วิธีการทํางานของตัวแปรสภาพแวดล้อมและวิธีการจัดการ โปรดดูเกี่ยวกับตัวแปรสภาพแวดล้อม
การอ้างอิงนี้อธิบายตัวแปรสภาพแวดล้อมระบบปฏิบัติการที่กําหนดค่า Power Apps CLI ตัวแปรเหล่านี้จะแตกต่างจาก ตัวแปรสภาพแวดล้อมโซลูชัน Power Platform ซึ่งจัดเก็บค่าการกําหนดค่าที่ใช้โดยแอป
สําหรับตัวเลือกคําสั่ง CLI จะแก้ไขค่าตามลําดับนี้:
- ตัวเลือกบรรทัดคําสั่ง
- ตัวแปรของสภาพแวดล้อม
- ค่าเริ่มต้น ถ้าตัวเลือกมีหนึ่งรายการ
- พร้อมท์แบบโต้ตอบ เมื่อได้รับการรองรับ
ตัวเลือกที่ให้ไว้บนบรรทัดคําสั่งจะมีความสําคัญมากกว่าตัวแปรสภาพแวดล้อมที่สอดคล้องกัน
Important
ตัวแปรสภาพแวดล้อมสามารถเปิดเผยความลับกับกระบวนการบันทึกหรือประวัติของเชลล์อื่น ๆ จัดเก็บ 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 login หรือpa auth switch |
PA_CLI_SP_CLIENT_ID |
ระบุ ID แอปพลิเคชัน (ไคลเอนต์) Microsoft Entra สําหรับการรับรองความถูกต้องแบบโครงร่างสําคัญของบริการ |
PA_CLI_SP_CLIENT_SECRET |
ระบุความลับของไคลเอ็นต์สําหรับการรับรองความถูกต้องแบบโครงร่างสําคัญของบริการ |
PA_CLI_SP_TENANT_ID |
ระบุ 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 |
ระบุ ID สภาพแวดล้อมของ Power Platform เป้าหมาย |
การเตรียมใช้งานแอป
ตัวแปรเหล่านี้ให้ตัวเลือกเพื่อpa app init
| ตัวแปรของสภาพแวดล้อม | ตัวเลือกที่สอดคล้องกัน | คำอธิบาย |
|---|---|---|
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
| ตัวแปรของสภาพแวดล้อม | ตัวเลือกที่สอดคล้องกัน | คำอธิบาย |
|---|---|---|
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 ID ออบเจ็กต์อย่างน้อยหนึ่งรายการ |
โซลูชัน ตัวเชื่อมต่อ และแหล่งข้อมูล
| ตัวแปรของสภาพแวดล้อม | ตัวเลือกที่สอดคล้องกัน | คำอธิบาย |
|---|---|---|
PA_CLI_CONNECTION_DISPLAY_NAME |
--display-name |
ระบุชื่อที่แสดงเมื่อสร้างการเชื่อมต่อ |
PA_CLI_CONNECTION_ID |
--connection-id |
ระบุ ID อินสแตนซ์ของการเชื่อมต่อตัวเชื่อมต่อ |
PA_CLI_CONNECTION_REF |
--connection-ref |
ระบุชื่อตรรกะการอ้างอิงการเชื่อมต่อ |
PA_CLI_CONNECTION_SEARCH |
--search |
กรองผลลัพธ์จากpa connection list |
PA_CLI_CONNECTOR |
--connector |
ระบุ ID ตัวเชื่อมต่อ เช่น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 Stored Procedure |
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 API และโฟลว์ Power Automate
| ตัวแปรของสภาพแวดล้อม | ตัวเลือกที่สอดคล้องกัน | คำอธิบาย |
|---|---|---|
PA_CLI_DATAVERSE_API_NAME |
--api-name |
ระบุการดําเนินการ Dataverse หรือฟังก์ชันที่จะเพิ่มด้วย pa app เพิ่ม 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 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 ยังสังเกตตัวแปรสภาพแวดล้อมมาตรฐานนี้ด้วย:
| ตัวแปรของสภาพแวดล้อม | คำอธิบาย |
|---|---|
NO_COLOR |
ตั้งค่าตัวแปรนี้เป็นค่าไม่ว่างเพื่อปิดใช้งานเอาต์พุตสี ANSI คุณยังสามารถใช้ตัวเลือก --no-color ได้อีกด้วย |