Lưu ý
Cần có ủy quyền mới truy nhập được vào trang này. Bạn có thể thử đăng nhập hoặc thay đổi thư mục.
Cần có ủy quyền mới truy nhập được vào trang này. Bạn có thể thử thay đổi thư mục.
Sử dụng các biến môi trường để cấu Power Apps xác thực CLI và cung cấp các tùy chọn lệnh trong tập lệnh và đường ống dẫn CI/CD. Các biến môi trường được định nghĩa bởi Power Apps CLI sử dụng PA_CLI_ tiền tố.
Lưu ý
Biến môi trường là các giá trị được đặt tên mà hệ điều hành làm cho có sẵn cho các ứng dụng. Power Apps CLI nhận ra các biến được mô tả trong tham chiếu này. Để tìm hiểu cách hoạt động của các biến môi trường và cách quản lý chúng, hãy xem về Biến môi trường.
Tài liệu tham khảo này mô tả các biến môi trường hệ điều hành cấu hình Power Apps CLI. Các biến này khác với các biến môi trường giải pháp Power Platform, chúng lưu trữ các giá trị cấu hình được ứng dụng sử dụng.
Đối với tùy chọn lệnh, CLI giải quyết một giá trị theo thứ tự này:
- Tùy chọn dòng lệnh
- Biến Môi trường
- Giá trị mặc định, nếu tùy chọn có một giá trị
- Lời nhắc tương tác, khi được hỗ trợ
Một tùy chọn được cung cấp trên dòng lệnh sẽ được ưu tiên hơn biến môi trường tương ứng của nó.
Quan trọng
Biến môi trường có thể hiển thị bí mật cho các quá trình khác, nhật ký, hoặc lịch sử vỏ. Lưu PA_CLI_SP_CLIENT_SECRET trữ trong cửa hàng bí mật của nền tảng CI / CD của bạn, che nó từ các bản ghi, và không cam kết bí mật để kiểm soát nguồn.
Đặt biến môi trường
Các ví dụ sau đây được PA_CLI_ENVIRONMENT_ID đặt trước khi chạy Power Apps lệnh CLI.
$env:PA_CLI_ENVIRONMENT_ID = "<environment-id>"
pa app list
Biến môi trường vẫn có sẵn cho lệnh bắt đầu từ cùng một phiên đầu cuối. Sử dụng lệnh tiêu chuẩn của shell để loại bỏ lệnh đó khi không còn cần nữa.
Xác thực
| Biến Môi trường | Sự miêu tả |
|---|---|
PA_CLI_ACCOUNT |
Xác định tài khoản cho hoặc pa auth loginpa auth switch. |
PA_CLI_SP_CLIENT_ID |
Xác định ID ứng Microsoft Entra (máy khách) cho xác thực chính của dịch vụ. |
PA_CLI_SP_CLIENT_SECRET |
Xác định bí mật máy khách cho xác thực chính của dịch vụ. |
PA_CLI_SP_TENANT_ID |
Xác định ID thư Microsoft Entra mục (đối tượng thuê) cho xác thực chính của dịch vụ. |
PA_CLI_USE_SP_AUTH |
Đặt giá trị thành true (chữ thường) để sử dụng xác thực chính của dịch vụ. |
Bắt buộc phải PA_CLI_SP_có ba biến chứng danh * khi xác thực chính của dịch vụ được chọn. Mặc dù CI=true cũng chọn xác thực chính của dịch vụ cho khả năng tương thích, sử dụng PA_CLI_USE_SP_AUTH=true để làm cho chế độ xác thực rõ ràng.
Để biết hướng dẫn thiết lập, hãy xem Phát Power Apps ứng dụng mã có tên dịch vụ chính.
Tùy chọn lệnh chung
Các biến này tương ứng với các tùy chọn có sẵn Power Apps lệnh CLI.
| Biến Môi trường | Tùy chọn tương ứng | Sự miêu tả |
|---|---|---|
PA_CLI_CLOUD |
--cloud |
Chọn đám mây đích. Giá trị hợp lệ là: - public (mặc định)- usgov- usgovhigh- usgovdod- chinaCác giá trị không phân biệt chữ hoa chữ thường. |
PA_CLI_ENVIRONMENT_ID |
--environment-id |
Xác định ID môi trường Power Platform đích. |
Khởi tạo ứng dụng
Các biến cung cấp tùy chọn để pa app init.
| Biến Môi trường | Tùy chọn tương ứng | Sự miêu tả |
|---|---|---|
PA_CLI_APP_BUILD_PATH |
--build-path |
Xác định thư mục đầu ra của bản dựng. Mặc định là ./dist. |
PA_CLI_APP_DESCRIPTION |
--description |
Xác định mô tả ứng dụng. |
PA_CLI_APP_DISPLAY_NAME |
--display-name |
Xác định tên hiển thị ứng dụng. |
PA_CLI_APP_FILE_ENTRY_POINT |
--file-entry-point |
Xác định điểm nhập HTML trong đầu ra của bản dựng. Mặc định là index.html. |
PA_CLI_APP_TYPE |
--app-type |
Chỉ định loại ứng dụng. Giá trị hợp lệ là: - CodeApp (mặc định)- MobileAppGiá trị được lưu và sử power.config.json dụng làm loại ứng dụng khi ứng dụng được phát hành. |
PA_CLI_APP_URL |
--app-url |
Xác định URL ứng dụng cục bộ trong .pa app init Giá trị được lưu như trong localAppUrl và power.config.json trở thành URL mặc định cho các lệnh trong pa app run tương lai. Mặc định là http://localhost:3000. |
Chạy ứng dụng
Các biến cung cấp tùy chọn để pa app run.
| Biến Môi trường | Tùy chọn tương ứng | Sự miêu tả |
|---|---|---|
PA_CLI_LOCAL_APP_URL |
--local-app-url |
Ghi đè giá trị từ localAppUrl lệnh hiện tại power.config.json mà không thay đổi cấu hình đã lưu. Nếu không có giá trị nào được đặt, mặc định là http://localhost:3000. |
PA_CLI_PORT |
--port |
Xác định cổng cho máy chủ Power Apps cục bộ. Mặc định là 8080. |
Chia sẻ ứng dụng
Các biến cung cấp tùy chọn để pa app share.
| Biến Môi trường | Tùy chọn tương ứng | Sự miêu tả |
|---|---|---|
PA_CLI_SHARE_ACCESS |
--access |
Xác định mức truy nhập. Giá trị hợp lệ là: - play (mặc định)- edit |
PA_CLI_SHARE_PRINCIPAL |
--principal |
Xác định một hoặc nhiều địa chỉ email phân tách bằng dấu phẩy Microsoft Entra ID đối tượng. |
Giải pháp, trình kết nối và nguồn dữ liệu
| Biến Môi trường | Tùy chọn tương ứng | Sự miêu tả |
|---|---|---|
PA_CLI_CONNECTION_DISPLAY_NAME |
--display-name |
Xác định tên hiển thị khi tạo kết nối. |
PA_CLI_CONNECTION_ID |
--connection-id |
Xác định ID phiên bản kết nối bộ kết nối. |
PA_CLI_CONNECTION_REF |
--connection-ref |
Xác định tên lô-gic tham chiếu kết nối. |
PA_CLI_CONNECTION_SEARCH |
--search |
Lọc kết quả từ pa connection list. |
PA_CLI_CONNECTOR |
--connector |
Xác định ID bộ kết nối, chẳng hạn như shared_office365users. |
PA_CLI_CONNECTOR_SEARCH |
--search |
Lọc kết quả từ pa connector list. |
PA_CLI_DATASET |
--dataset |
Xác định một tập dữ liệu, chẳng hạn như một SharePoint trang hoặc cơ sở dữ liệu SQL. |
PA_CLI_DATA_SOURCE_NAME |
--name |
Xác định nguồn dữ liệu cần làm mới hoặc loại bỏ. |
PA_CLI_ORG_URL |
--org-url |
Ghi đè URL của tổ chức Dataverse dùng để truy xuất siêu dữ liệu khi thêm nguồn dữ liệu. |
PA_CLI_PROCEDURE |
--procedure |
Xác định thủ tục đã lưu trữ SQL. |
PA_CLI_SOLUTION_ID |
--solution-id |
Xác định giải pháp cho pa app push, pa app add data-sourcehoặc pa connection list-references. |
PA_CLI_SOLUTION_SEARCH |
--search |
Lọc kết quả từ pa solution list. |
PA_CLI_TABLE |
--table |
Xác định tên tài nguyên của bảng hoặc bộ kết nối. |
Đối với các lệnh chấp nhận từng tùy chọn, hãy xem mục Power Apps tham chiếu lệnh CLI.
API nghịch đảo và dòng Power Automate dữ liệu
| Biến Môi trường | Tùy chọn tương ứng | Sự miêu tả |
|---|---|---|
PA_CLI_DATAVERSE_API_NAME |
--api-name |
Xác định hành động hoặc hàm Dataverse để thêm với ứng dụng pa thêm dataverse-api. |
PA_CLI_DATAVERSE_API_SEARCH_TERM |
--search |
Lọc các hành động và hàm Dataverse theo tên với pa app find-dataverse-api. |
PA_CLI_FLOW_DATA_SOURCE_NAME |
--flow-name |
Xác định nguồn dữ liệu dòng cần loại bỏ khỏi ứng dụng bằng pa app remove flow |
PA_CLI_FLOW_ID |
--flow-id |
Xác định Power Automate dòng cần thêm vào pa app add flow. |
PA_CLI_FLOW_SEARCH |
--search |
Lọc dòng công việc Power Automate có sẵn theo tên vớipa app list-flows |
PA_CLI_REMOVE_FLOW_ID |
--flow-id |
Xác định dòng Power Automate để loại bỏ bằngpa app remove flow |
Đầu ra từ xa và bảng điều khiển
| Biến Môi trường | Tùy chọn tương ứng | Sự miêu tả |
|---|---|---|
PA_CLI_CONSOLE_ONLY |
--console-only |
Đặt giá trị thành true (chữ thường) có pa telemetry enablepa telemetry disable hoặc chỉ ghi phép đo từ xa vào bảng điều khiển và không gửi dữ liệu đo từ xa. |
PA_CLI_OUTPUT_TO_CONSOLE |
--output-to-console |
Đặt giá trị thành true (chữ thường) có hoặc pa telemetry enable phản chiếu pa telemetry disable các sự kiện phép đo từ xa được gửi từ xa đến bảng điều khiển. |
PA_CLI_TELEMETRY |
Không ai | Đặt một trong các giá trị này để tắt phép đo từ xa cho quy trình hiện tại: - 0- false- no- offCác giá trị không phân biệt chữ hoa chữ thường và không gian xung quanh bị bỏ qua. |
Để biết các cài đặt phép đo từ xa liên tục, hãy xem Quản lý cài đặt phép đo từ xa Power Apps CLI.
Biến môi trường tiêu chuẩn
CLI cũng quan sát thấy biến môi trường tiêu chuẩn này:
| Biến Môi trường | Sự miêu tả |
|---|---|
NO_COLOR |
Đặt biến này thành một giá trị không trống để vô hiệu hóa đầu ra màu ANSI. Bạn cũng có thể sử dụng tùy --no-color chọn này. |