Power Apps μεταβλητών περιβάλλοντος CLI

Χρησιμοποιήστε μεταβλητές περιβάλλοντος για να ρυθμίσετε τις παραμέτρους του ελέγχου ταυτότητας Power Apps CLI και να παρέχετε επιλογές εντολών σε δέσμες ενεργειών και διοχετεύσεις CI/CD. Οι μεταβλητές περιβάλλοντος που ορίζονται από το Power Apps CLI χρησιμοποιούν το PA_CLI_ πρόθεμα.

Σημείωμα

Οι μεταβλητές περιβάλλοντος ονομάζονται τιμές που το λειτουργικό σύστημα καθιστά διαθέσιμες στις εφαρμογές. Power Apps CLI αναγνωρίζει τις μεταβλητές που περιγράφονται σε αυτήν την αναφορά. Για να μάθετε πώς λειτουργούν οι μεταβλητές περιβάλλοντος και πώς να τις διαχειρίζεστε, ανατρέξτε στο θέμα Μεταβλητές περιβάλλοντος.

Αυτή η αναφορά περιγράφει μεταβλητές περιβάλλοντος λειτουργικού συστήματος που ρυθμίζουν τις παραμέτρους του Power Apps CLI. Αυτές οι μεταβλητές διαφέρουν από τις μεταβλητές περιβάλλοντος λύσης Power Platform, οι οποίες αποθηκεύουν τιμές ρύθμισης παραμέτρων που χρησιμοποιούνται από μια εφαρμογή.

Για μια επιλογή εντολής, η CLI επιλύει μια τιμή με αυτήν τη σειρά:

  1. Επιλογή γραμμής εντολών
  2. Μεταβλητή περιβάλλοντος
  3. Προεπιλεγμένη τιμή, εάν η επιλογή έχει
  4. Αλληλεπιδραστική προτροπή, όταν υποστηρίζεται

Μια επιλογή που παρέχεται στη γραμμή εντολών έχει προτεραιότητα έναντι της αντίστοιχης μεταβλητής περιβάλλοντος.

Σημαντικό

Οι μεταβλητές περιβάλλοντος μπορούν να αποκαλύψουν μυστικά σε άλλες διαδικασίες, αρχεία καταγραφής ή ιστορικό κελύφους. Αποθηκεύστε 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 Καθορίζει το αναγνωριστικό 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 Επιλέγει το cloud προορισμού. Οι έγκυρες τιμές είναι:
- public (προεπιλογή)
- usgov
- usgovhigh
- usgovdod
- china
Οι τιμές δεν κάνουν διάκριση πεζών-κεφαλαίων.
PA_CLI_ENVIRONMENT_ID --environment-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 in power.config.json και γίνεται η προεπιλεγμένη διεύθυνση URL για μελλοντικές pa app run εντολές. Η προεπιλογή είναι http://localhost:3000.

Εκτέλεση εφαρμογών

Αυτές οι μεταβλητές παρέχουν επιλογές στο pa app run.

Μεταβλητή περιβάλλοντος Αντίστοιχη επιλογή Περιγραφή
PA_CLI_LOCAL_APP_URL --local-app-url Παρακάμπτει την τιμή από power.config.json το localAppUrl για την τρέχουσα εντολή χωρίς να αλλάξει η αποθηκευμένη ρύθμιση παραμέτρων. Εάν δεν έχει οριστεί καμία τιμή, η προεπιλογή είναι 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 dataverse και ροές Power Automate

Μεταβλητή περιβάλλοντος Αντίστοιχη επιλογή Περιγραφή
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

Έξοδος τηλεμετρίας και κονσόλας

Μεταβλητή περιβάλλοντος Αντίστοιχη επιλογή Περιγραφή
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 επιλογή.
  • Last updated on