pac power-fx

(Predogled) Ukazi za delo s tehnologijo Power Fx.

Uporabite te ukaze za interakcijo s podatki v Dataverse uporabi ukazne vrstice ali skripta. S tehnologijo Power Fx zmanjšajte čas in kompleksnost postopkov Dataverse.

Uporabite lahko formule, ki so navedene v sklicu formule – Power Platform CLI.

Ukazi

Command	Opis
pac power-fx repl	(Predogled) Zaženi interaktivno Power Fx Read-Eval-Print Loop
pac power-fx run	(Predogled) Zagon datoteke z navodili za Power Fx

pac power-fx repl

(Predogled) Zaženi interaktivno Power Fx Read-Eval-Print Loop

opomba,

Če ste namestili power platformo CLI s sistemom Windows MSI, pac power-fx repl je prišlo do znane težave, zaradi katere se lahko lupina preneha odzivati, ko uporabljate ta ukaz.

Izbirni parametri za power-fx repl

`--environment` `-env`

Določa ciljni Dataverse. Vrednost je lahko GUID ali absolutni URL https. Če ni določeno, bo uporabljena aktivna organizacija, ki je izbrana za trenutni profil za preverjanje pristnosti.

Pripombe

Ta ukaz zagotavlja lupino za uporabo formul, navedenih v sklicu formule – Power Platform CLI.

Znova zaženite orodje Power Fx tako, da zaženete ta ukaz:

pac power-fx repl

Nato lahko zaženete ukaze Power Fx.

Primeri

Ti primeri prikazujejo uporabo ukaza pac power-fx repl .

Dodajanje vrstic
Pomoč
Izhod

Dodajanje vrstic

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

Znova se odzove Power Fx z naslednjimi koraki:

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

Help

Zaženite ta ukaz, če želite pomoč za vse ukaze, ki so na voljo v orodju Power Fx repl:

Help()

Znova se odziva Power Fx s tem rezultatom:

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

opomba,

Ti ukazi se bodo sčasoma spremenili, da bodo vključevali več ukazov. Sinhronizirati jo je treba z dokumentiranimi ukazi, ki so trenutno na voljo.

Exit

Uporabite Exit() za izhod iz repl ukaza.

pac power-fx run

(Predogled) Zagon datoteke z navodili za Power Fx

Primeri

Ti primeri prikazujejo uporabo ukaza pac power-fx run .

Ustvarjanje zapisov Dataverse
Query a Dataverse table
Uporaba funkcij PowerFx

opomba,

V vsakem od teh primerov morate:

Ustvarite datoteko z izrazi test-pfx.txt Power Fx v mapi v računalniku, na primer c:\test.
Odprite okno lupine Windows PowerShell, poiščite test mapo in run uporabite ukaz, ki določa datoteko z ukazi: pac power-fx run --file test-pfx.txt.

Če želite uporabiti tabele Dataverse, morate ustvariti in izbrati profil za preverjanje pristnosti. Oglejte pac si ustvarjanje in pac preverjanje pristnosti.

Če se prikaže preverjanje napak odpravljanje težav.

Ustvarjanje zapisov Dataverse

Dodajte to besedilo in test-pfx.txt shranite datoteko.

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

Zaženite ta ukaz:

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

Rezultat lahko pričakujete tako:

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

Query a Dataverse table

Dodajte to besedilo in test-pfx.txt shranite datoteko.
```
FirstN(Contacts, 5)
```
S tem ukazom pridobite prvih pet stikov iz storitve Dataverse.

Zaženite ta ukaz:

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

Rezultat lahko pričakujete tako:

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>

Uporaba funkcij PowerFx

Dodajte to besedilo in test-pfx.txt shranite datoteko.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
V tem primeru so uporabljeni funkciji Mid, If in Set Power Fx.

Zaženite ta ukaz:

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

Rezultat lahko pričakujete tako:

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

Dodajte --echo parameter in lahko pričakujete ta izhod:

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>

Zahtevani parametri za power-fx run

`--file` `-f`

Pot datoteke za izvedbo

Izbirni parametri za power-fx run

`--echo` `-e`

True, če naj vhodni ukazi odmevajo nazaj na izhod

Ta parameter ne zahteva vrednosti. Stikalo je.

`--environment` `-env`

Določa ciljni Dataverse. Vrednost je lahko GUID ali absolutni URL https. Če ni določeno, bo uporabljena aktivna organizacija, ki je izbrana za trenutni profil za preverjanje pristnosti.

Odpravljanje težav

V nadaljevanju so navodila za odpravljanje napak, na katere lahko naletite pri uporabi pac power-fx ukazov.

Napaka, ko profil za preverjanje pristnosti Dataverse ne obstaja

Do napake lahko pride, če nimate univerzalnega profila preverjanja pristnosti, povezanega z okoljem 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.

Če želite odpraviti takšne napake, ustvarite profil univerzalnega preverjanja pristnosti, ki je povezan z okoljem Dataverse.

Zaženite seznam zapac preverjanje pristnosti ukazov.

Morda boste videli rezultat, kot UNIVERSAL je ta, ki vključuje profil za preverjanje pristnosti brez URL-ja, ki označuje, da je povezan z okoljem Dataverse.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
To ne zadostuje, ker ni določeno nobeno okolje Dataverse.

Ustvarite pac preverjanje pristnosti, če želite ustvariti profil za preverjanje UNIVERSAL pristnosti, ki je povezan z okoljem Dataverse.

opomba,

Uporabite parameter --environment z vrednostjo environmentid. Poiščite ID okolja.

Ne uporabite parametra --url , ker boste s tem ustvarili DATAVERSE profil in ne UNIVERSAL profil.

Na primer:

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>

Znova pac zaženite seznam za preverjanje pristnosti. Prikaže se rezultat s profilom povezave UNIVERSAL z URL-jem za okolje 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>

Izberite okoljeUNIVERSAL, da ga spremenite v privzeti profil z ukazompac za izbiro pristnosti.

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>

Glej tudi

Microsoft Power Platform CLI Command Groups
Pregled okolja Microsoft Power Platform CLI

Povratne informacije

Ali je bila ta stran uporabna?

Last updated on 2026-02-25

Deli z drugimi prek

pac power-fx

Ukazi

pac power-fx repl

Izbirni parametri za power-fx repl

--environment -env

Pripombe

Primeri

Dodajanje vrstic

Help

Exit

pac power-fx run

Primeri

Ustvarjanje zapisov Dataverse

Query a Dataverse table

Uporaba funkcij PowerFx

Zahtevani parametri za power-fx run

--file -f

Izbirni parametri za power-fx run

--echo -e

--environment -env

Odpravljanje težav

Napaka, ko profil za preverjanje pristnosti Dataverse ne obstaja

Glej tudi

Povratne informacije

Dodatni viri

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`