pac power-fx

(Previzualizare) Comenzi pentru lucrul cu Power Fx

Utilizați aceste comenzi pentru a interacționa cu datele în Dataverse folosind o linie de comandă sau un script. Reduceți timpul și complexitatea operațiunilor Dataverse utilizând Power Fx.

Puteți utiliza formulele listate în referința pentru formule - Power Platform CLI.

Comenzi

Comanda	Descriere
pac power-fx repl	(Previzualizare) Lansați Power Fx Interactive Read - buclăEval-Print
pac power-fx run	(Previzualizare) Rularea unui fișier cu instrucțiuni Power Fx

pac power-fx repl

(Previzualizare) Lansați Power Fx Interactive Read - buclăEval-Print

Notă

Dacă ați instalat Power Platform CLI utilizând Windows MSI, există o problemă cunoscută cu pac power-fx repl cauza căreia shellul poate să nu mai răspundă atunci când utilizați această comandă.

Parametri opționali pentru power-fx repl

`--environment` `-env`

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

Remarci

Această comandă oferă un shell pentru a utiliza formule listate în Referințe formulă - Power Platform CLI.

Porniți reîncărcarea Power Fx rulând următoarea comandă:

pac power-fx repl

După aceea, puteți rula comenzi Power Fx.

Exemple

Următoarele exemple arată utilizarea comenzii pac power-fx repl .

Adăugarea rândurilor
Ajutor
Ieșire

Adăugarea rândurilor

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

Power Fx repl răspunde cu următoarele:

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

Help

Rulați următoarea comandă pentru a obține ajutor cu privire la toate comenzile care sunt disponibile în replul Power Fx:

Help()

Power Fx repl răspunde cu următoarea ieșire:

  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
>>

Notă

Aceste comenzi se vor modifica în timp, pentru a include mai multe comenzi. Ar trebui să fie sincronizat cu comenzile disponibile în prezent documentate.

Exit

Se utilizează Exit() pentru a ieși din repl comandă.

pac power-fx run

(Previzualizare) Rularea unui fișier cu instrucțiuni Power Fx

Exemple

Următoarele exemple arată utilizarea comenzii pac power-fx run .

Crearea de înregistrări Dataverse
Interogarea unui tabel Dataverse
Utilizarea funcțiilor PowerFx

Notă

În fiecare dintre aceste exemple, trebuie să:

Creați un fișier denumit test-pfx.txt cu expresii Power Fx într-un folder de pe computer, cum ar fi c:\test.
Deschideți o fereastră Windows PowerShell, navigați la test folder și utilizați run comanda care specifică fișierul care conține comenzile: pac power-fx run --file test-pfx.txt.

Pentru a utiliza tabele Dataverse, trebuie să creați și să selectați un profil de autentificare. Consultați pac Crearea și pac autentificarea.

Dacă primiți o verificare a erorilor la Depanare.

Crearea de înregistrări Dataverse

Adăugați textul test-pfx.txt următor și salvați fișierul.

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

Rulați această comandă:

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

Vă puteți aștepta la rezultate ca următoarele:

{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", ...}

Interogarea unui tabel Dataverse

Adăugați acest text test-pfx.txt și salvați fișierul.
```
FirstN(Contacts, 5)
```
Această comandă regăsește primele cinci persoane de contact din Dataverse.

Rulați această comandă:

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

Vă puteți aștepta la rezultate ca următoarele:

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>

Utilizarea funcțiilor PowerFx

Adăugați textul test-pfx.txt următor și salvați fișierul.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
Acest exemplu utilizează funcțiile Mid, If și Set Power Fx.

Rulați următoarea comandă:

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

Vă puteți aștepta la rezultate ca următoarele:

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

--echo Adăugați parametrul și vă puteți aștepta la această ieșire:

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>

Parametri obligatorii pentru power-fx run

`--file` `-f`

Calea fișierului de executat

Parametri opționali pentru power-fx run

`--echo` `-e`

True dacă comenzile de intrare trebuie să revină la ieșire

Acest parametru nu necesită nicio valoare. Este un comutator.

`--environment` `-env`

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

Depanare

Iată pașii pentru depanarea erorilor pe care le puteți întâlni atunci când utilizați pac power-fx comenzi.

Eroare atunci când nu există niciun profil de autentificare Dataverse

Puteți primi o eroare ca aceasta atunci când nu aveți un profil de autentificare universal asociat cu un mediu 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.

Pentru a rezolva erori ca acestea, creați un profil de autentificare universal asociat cu un mediu Dataverse.

Rulați lista de autentificare a comenziipac.

Este posibil să vedeți un rezultat ca următoarea care include un UNIVERSAL profil de autentificare fără url care indică faptul că este asociat cu un mediu Dataverse.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Acest lucru nu este suficient, deoarece nu s-a specificat niciun mediu Dataverse.

Utilizați pac autentificarea pentru a crea un UNIVERSAL profil de autentificare conectat la un mediu Dataverse.

Notă

--environment Utilizați parametrul utilizând valoarea environmentid. Găsiți ID-ul de mediu.

Nu utilizați --url parametrul, deoarece va crea un DATAVERSE profil, nu un UNIVERSAL profil.

De exemplu:

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>

Rulați pac din nou lista de autentificare . Ar trebui să vedeți un rezultat cu UNIVERSAL profilul de conexiune cu un URL pentru mediul 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 Selectați mediul pentru a-l transforma în profilul implicit utilizând comanda de selectare autentificarepac.

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>

Vezi și

Grupuri de comenzi CLI Microsoft Power Platform
Prezentare generală Microsoft Power Platform CLI

Feedback

Această pagină a fost utilă?

Last updated on 2026-01-14

Partajați prin

pac power-fx

Comenzi

pac power-fx repl

Parametri opționali pentru power-fx repl

--environment -env

Remarci

Exemple

Adăugarea rândurilor

Help

Exit

pac power-fx run

Exemple

Crearea de înregistrări Dataverse

Interogarea unui tabel Dataverse

Utilizarea funcțiilor PowerFx

Parametri obligatorii pentru power-fx run

--file -f

Parametri opționali pentru power-fx run

--echo -e

--environment -env

Depanare

Eroare atunci când nu există niciun profil de autentificare Dataverse

Vezi și

Feedback

Resurse suplimentare

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`