pac power-fx

(Προεπισκόπηση) Εντολές για εργασία με το Power Fx

Χρησιμοποιήστε αυτές τις εντολές για να αλληλεπιδράσετε με δεδομένα στο Dataverse χρησιμοποιώντας μια γραμμή εντολών ή δέσμη ενεργειών. Μειώστε τον χρόνο και την πολυπλοκότητα των λειτουργιών σας Dataverse χρησιμοποιώντας το Power Fx.

Μπορείτε να χρησιμοποιήσετε τους τύπους που παρατίθενται στην αναφορά τύπου - Power Platform CLI.

Εντολές

Command	Περιγραφή
pac power-fx repl	(Προεπισκόπηση) Εκκίνηση αλληλεπιδραστικού βρόχου Power Fx Read-Eval-Print
pac power-fx run	(Προεπισκόπηση) Εκτέλεση αρχείου οδηγιών του Power Fx

pac power-fx repl

(Προεπισκόπηση) Εκκίνηση αλληλεπιδραστικού βρόχου Power Fx Read-Eval-Print

Σημείωμα

Εάν εγκαταστήσατε το Power Platform CLI χρησιμοποιώντας Windows MSI, υπάρχει ένα γνωστό πρόβλημα με pac power-fx replτο σημείο όπου το κέλυφος ενδέχεται να σταματήσει να ανταποκρίνεται κατά τη χρήση αυτής της εντολής.

Προαιρετικές παράμετροι για power-fx repl

`--environment` `-env`

Καθορίζει το dataverse προορισμού. Η τιμή μπορεί να είναι μια διεύθυνση URL Guid ή απόλυτη διεύθυνση URL https. Όταν δεν καθορίζεται, θα χρησιμοποιηθεί ο ενεργός οργανισμός που επιλέγεται για το τρέχον προφίλ ελέγχου ταυτότητας.

Παρατηρήσεις

Αυτή η εντολή παρέχει ένα κέλυφος για τη χρήση τύπων που παρατίθενται στην αναφορά τύπου - Power Platform CLI.

Ξεκινήστε το Power Fx repl εκτελώντας την ακόλουθη εντολή:

pac power-fx repl

Μετά από αυτό, μπορείτε να εκτελέσετε εντολές Power Fx.

Παραδείγματα

Τα παρακάτω παραδείγματα δείχνουν τη χρήση της εντολής pac power-fx repl .

Προσθήκη γραμμών
Βοήθεια
Έξοδος

Προσθήκη γραμμών

Collect(Contacts, { firstname: "Patti", lastname: "Fernandez" })

Το Power Fx repl ανταποκρίνεται με τα εξής:

{contactid:GUID("118d7b47-8f80-ee11-8179-0022482a40c7"), fullname:"Patti Fernandez", ...}

Βοήθεια

Εκτελέστε την ακόλουθη εντολή για να λάβετε βοήθεια σχετικά με όλες τις εντολές που είναι διαθέσιμες στο Power Fx repl:

Help()

Το Power Fx repl αποκρίνεται με το ακόλουθο αποτέλεσμα:

  Abs             Acos            Acot            AddColumns      And
  Asin            AsType          Atan            Atan2           Average
  Blank           Boolean         Char            Clear           ClearCollect
  Coalesce        Collect         ColorFade       ColorValue      Concat
  Concatenate     Cos             Cot             Count           CountA
  CountIf         CountRows       Date            DateAdd         DateDiff
  DateTime        DateTimeValue   DateValue       Day             Dec2Hex
  Decimal         Degrees         Distinct        DropColumns     EDate
  EncodeUrl       EndsWith        EOMonth         Error           Exp
  Filter          Find            First           FirstN          Float
  ForAll          GUID            Help            Hex2Dec         Hour
  If              IfError         Index           Int             IsBlank
  IsBlankOrError  IsEmpty         IsError         IsMatch         IsNumeric
  IsToday         Language        Last            LastN           Left
  Len             Ln              Log             LookUp          Lower
  Match           MatchAll        Max             Mid             Min
  Minute          Mod             Month           Not             Notify
  Now             OptionSetInfo   Or              ParseJSON       Patch
  Pi              PlainText       Power           Proper          Radians
  Rand            RandBetween     Refresh         Remove          Replace
  RGBA            Right           Round           RoundDown       RoundUp
  Second          Sequence        Set             Shuffle         Sin
  Sort            Split           Sqrt            StartsWith      StdevP
  Substitute      Sum             Switch          Table           Tan
  Text            Time            TimeValue       TimeZoneOffset  Today
  Trim            TrimEnds        Trunc           Upper           Value
  VarP            Weekday         With            Year
>>

Σημείωμα

Αυτές οι εντολές θα αλλάξουν με την πάροδο του χρόνου για να συμπεριλάβουν περισσότερες εντολές. Θα πρέπει να συγχρονίζεται με τις τεκμηριωμένες τρέχουσες διαθέσιμες εντολές.

Έξοδος

Χρησιμοποιήστε Exit() το για έξοδο από την repl εντολή.

pac power-fx run

(Προεπισκόπηση) Εκτέλεση αρχείου οδηγιών του Power Fx

Παραδείγματα

Τα παρακάτω παραδείγματα δείχνουν τη χρήση της εντολής pac power-fx run .

Δημιουργία εγγραφών Dataverse
Υποβολή ερωτήματος σε πίνακα Dataverse
Χρήση συναρτήσεων PowerFx

Σημείωμα

Σε καθένα από αυτά τα παραδείγματα, πρέπει να κάνετε τα εξής:

Δημιουργήστε ένα αρχείο με την ονομασία test-pfx.txt με παραστάσεις Power Fx σε έναν φάκελο στον υπολογιστή σας, όπως c:\test.
Ανοίξτε ένα παράθυρο του Windows PowerShell, μεταβείτε στον test φάκελο και χρησιμοποιήστε την run εντολή καθορίζοντας το αρχείο που περιέχει τις εντολές: pac power-fx run --file test-pfx.txt.

Για να χρησιμοποιήσετε πίνακες Dataverse, πρέπει να δημιουργήσετε και να επιλέξετε ένα προφίλ ελέγχου ταυτότητας. Ανατρέξτε στο θέμα Δημιουργίαpac ελέγχου ταυτότητας και pac επιλογή ελέγχου ταυτότητας.

Εάν λάβετε τον έλεγχο σφάλματος Αντιμετώπιση προβλημάτων.

Δημιουργία εγγραφών Dataverse

Προσθέστε το ακόλουθο κείμενο test-pfx.txt και αποθηκεύστε το αρχείο.

Collect(Contacts, { firstname: "Megan", lastname: "Bowen" })
Collect(Contacts, { firstname: "Garth", lastname: "Forth" })
Collect(Contacts, { firstname: "Adele", lastname: "Vance" })
Collect(Contacts, { firstname: "Patti", lastname: "Fernandez" })

Εκτελέστε αυτήν την εντολή:

PS C:\test> pac power-fx run --file test-pfx.txt

Μπορείτε να περιμένετε έξοδο όπως το εξής:

{contactid:GUID("80eb0c02-9180-ee11-8179-0022482a40c7"), fullname:"Megan Bowen", ...}
{contactid:GUID("81eb0c02-9180-ee11-8179-0022482a40c7"), fullname:"Garth Forth", ...}
{contactid:GUID("82eb0c02-9180-ee11-8179-0022482a40c7"), fullname:"Adele Vance", ...}
{contactid:GUID("83eb0c02-9180-ee11-8179-0022482a40c7"), fullname:"Patti Fernandez", ...}

Υποβολή ερωτήματος σε πίνακα Dataverse

Προσθέστε αυτό το κείμενο test-pfx.txt και αποθηκεύστε το αρχείο.
```
FirstN(Contacts, 5)
```
Αυτή η εντολή ανακτά τις πρώτες πέντε επαφές από το Dataverse.

Εκτελέστε αυτήν την εντολή:

PS C:\test> pac power-fx run --file test-pfx.txt

Μπορείτε να περιμένετε έξοδο όπως το εξής:

Connected to... Your Organization
Connected as you@yourorg.onmicrosoft.com

contactid                                      fullname           ...
============================================== ================== =====
GUID("eeb27495-d127-ed11-9db1-00224804f8e2")   Yvonne McKay (sample)
GUID("cba0ed9e-d127-ed11-9db1-00224804f8e2")   Susanna Stubberod (sample)
GUID("cea0ed9e-d127-ed11-9db1-00224804f8e2")   Nancy Anderson (sample)
GUID("6cc7483c-7a77-ee11-8179-00224809f375")   Maria Campbell (sample)
GUID("49b0be2e-d01c-ed11-b83e-000d3a572421")   Sidney Higa (sample)
PS C:\test>

Χρήση συναρτήσεων PowerFx

Προσθέστε το ακόλουθο κείμενο test-pfx.txt και αποθηκεύστε το αρχείο.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
Αυτό το παράδειγμα χρησιμοποιεί τις συναρτήσεις Mid, If και Set Power Fx.

Εκτελέστε την ακόλουθη εντολή:

PS C:\test> pac power-fx run --file test-pfx.txt

Μπορείτε να περιμένετε έξοδο όπως το εξής:

PS C:\test> pac power-fx run --file test-pfx.txt
x: 1
true
Result: "X"
PS C:\test>

Προσθέστε την --echo παράμετρο και μπορείτε να περιμένετε αυτή την έξοδο:

PS C:\test> pac power-fx run --file test-pfx.txt --echo
Set(x, 1)

x: 1
true
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )

Result: "X"
PS C:\test>

Απαιτούμενες παράμετροι για power-fx run

`--file` `-f`

Διαδρομή του αρχείου για εκτέλεση

Προαιρετικές παράμετροι για power-fx run

`--echo` `-e`

True εάν οι εντολές εισόδου πρέπει να αντηχούν πίσω στην έξοδο

Αυτή η παράμετρος δεν απαιτεί καμία τιμή. Είναι διακόπτης.

`--environment` `-env`

Αντιμετώπιση προβλημάτων

Τα παρακάτω είναι τα βήματα για την αντιμετώπιση προβλημάτων σφαλμάτων που ενδέχεται να αντιμετωπίσετε κατά τη χρήση pac power-fx εντολών.

Σφάλμα όταν δεν υπάρχει προφίλ ελέγχου ταυτότητας Dataverse

Μπορείτε να λάβετε ένα σφάλμα όπως αυτό, όταν δεν έχετε ένα καθολικό προφίλ ελέγχου ταυτότητας συσχετισμένο με ένα περιβάλλον Dataverse.

PS C:\test> pac power-fx run --file test-pfx.txt
Error 8-16: Name isn't valid. 'Contacts' isn't recognized.
Error 18-59: The specified column 'firstname' does not exist.
Error 0-60: The function 'Collect' has some invalid arguments.
Error 8-16: Name isn't valid. 'Contacts' isn't recognized.
Error 18-59: The specified column 'firstname' does not exist.
Error 0-60: The function 'Collect' has some invalid arguments.
Error 8-16: Name isn't valid. 'Contacts' isn't recognized.
Error 18-59: The specified column 'firstname' does not exist.
Error 0-60: The function 'Collect' has some invalid arguments.
Error 8-16: Name isn't valid. 'Contacts' isn't recognized.
Error 18-63: The specified column 'firstname' does not exist.
Error 0-64: The function 'Collect' has some invalid arguments.

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

Εκτελέστε τη λίστα ελέγχου ταυτότητας εντολώνpac.

Μπορεί να δείτε ένα αποτέλεσμα όπως το παρακάτω, το οποίο περιλαμβάνει ένα UNIVERSAL προφίλ ελέγχου ταυτότητας χωρίς διεύθυνση URL που να υποδεικνύει ότι είναι συσχετισμένο με ένα περιβάλλον Dataverse.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Αυτό δεν επαρκεί, επειδή δεν έχει καθοριστεί περιβάλλον Dataverse.
Χρησιμοποιήστε pac τη δημιουργία ελέγχου ταυτότητας για να δημιουργήσετε ένα UNIVERSAL προφίλ ελέγχου ταυτότητας συνδεδεμένο σε ένα περιβάλλον Dataverse.

Σημείωμα

Χρησιμοποιήστε την --environment παράμετρο χρησιμοποιώντας την τιμή environmentid. Βρείτε το αναγνωριστικό περιβάλλοντος.

Μην χρησιμοποιήσετε την --url παράμετρο, επειδή αυτό θα δημιουργήσει ένα DATAVERSE προφίλ αντί για ένα UNIVERSAL προφίλ.

Για παράδειγμα:
```
PS C:\test> pac auth create --environment f2cef599-b112-4803-bb5d-090077017685 --name ConnectionName
'you@yourcompany.onmicrosoft.com' authenticated successfully.
Validating connection...
Default organization: YourOrganization
Connected to... YourOrganization
Connected as you@yourcompany.onmicrosoft.com
Authentication profile created
   * UNIVERSAL ConnectionName                 https://yourcompany.crm.dynamics.com/          : you@yourcompany.onmicrosoft.com              Public

PS C:\test>
```

Εκτελέστε pac ξανά τη λίστα ελέγχου ταυτότητας . Θα πρέπει να δείτε ένα αποτέλεσμα με UNIVERSAL το προφίλ σύνδεσης με μια διεύθυνση URL για το περιβάλλον σας Dataverse.

PS C:\test> pac auth list
Index Active Kind      Name           Friendly Name        Url                                   User                  Cloud  Type
[1]   *      UNIVERSAL                                                                           you@yourcompany.com   Public OperatingSystem
[2]   *      UNIVERSAL ConnectionName YourOrganization     https://yourcompany.crm.dynamics.com/ you@yourcompany.com   Public User

PS C:\test>

Επιλέξτε το UNIVERSAL περιβάλλον για να το καταστήσετε το προεπιλεγμένο προφίλ χρησιμοποιώντας την pac εντολή επιλογής ελέγχου ταυτότητας .
```
PS C:\test> pac auth select --index 2
New default profile:
   * UNIVERSAL ConnectionName                 https://yourcompany.crm.dynamics.com/          : you@yourcompany.com              Public

PS C:\test>
```

Δείτε επίσης

Ομάδες εντολών CLI του Microsoft Power Platform
Επισκόπηση CLI του Microsoft Power Platform

Ανάδραση

Ήταν χρήσιμη αυτή η σελίδα;

Last updated on 2026-01-07

Κοινοποίηση μέσω

pac power-fx

Εντολές

pac power-fx repl

Προαιρετικές παράμετροι για power-fx repl

--environment -env

Παρατηρήσεις

Παραδείγματα

Προσθήκη γραμμών

Βοήθεια

Έξοδος

pac power-fx run

Παραδείγματα

Δημιουργία εγγραφών Dataverse

Υποβολή ερωτήματος σε πίνακα Dataverse

Χρήση συναρτήσεων PowerFx

Απαιτούμενες παράμετροι για power-fx run

--file -f

Προαιρετικές παράμετροι για power-fx run

--echo -e

--environment -env

Αντιμετώπιση προβλημάτων

Σφάλμα όταν δεν υπάρχει προφίλ ελέγχου ταυτότητας Dataverse

Δείτε επίσης

Ανάδραση

Πρόσθετοι πόροι

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`