pac power-fx

(Eelvaade) Power Fx-iga töötamise käsud

Kasutage neid käske käsurea või skripti abil andmetega Dataverse suhtlemiseks. Andmesidetoimingute aja ja keerukuse vähendamiseks saate kasutada Power Fx-i.

Saate kasutada valemiviites – Power Platform CLI loetletud valemeid.

Käsud

Käsk	Kirjeldus
pac power-fx repl	(Eelvaade) Käivita interaktiivne Power Fx lugemis-Eval-Print tsükkel
pac power-fx run	(Eelvaade) Power Fx-i juhiste faili käivitamine

pac power-fx repl

(Eelvaade) Käivita interaktiivne Power Fx lugemis-Eval-Print tsükkel

Märkus.

Kui installisite Power Platform CLI Windows MSI abil, on teadaolev probleem pac power-fx repl , mille korral kest võib selle käsu kasutamisel lakata reageerimast.

Valikulised parameetrid: power-fx repl

`--environment` `-env`

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

Märkused

See käsk annab kesta valemite kasutamiseks, mis on loetletud jaotises Valemiviide – Power Platform CLI.

Käivitage Power Fx repl, käivitades järgmise käsu:

pac power-fx repl

Seejärel saate käivitada Power Fx-käsud.

Näited

Järgmised näited näitavad käsu kasutamist pac power-fx repl .

Ridade lisamine
Abi
Väljapääs

Ridade lisamine

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

Power Fx repl vastab järgmisega.

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

Abi

Kõigi Power Fx repli saadaolevate käskude kohta abi saamiseks käivitage järgmine käsk:

Help()

Power Fx repl reageerib järgmise väljundiga:

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

Märkus.

Need käsud muutuvad aja jooksul, et kaasata rohkem käske. See peaks olema sünkroonitud praegu saadaolevate dokumenteeritud käskudega.

Väljapääs

Sobib Exit() käsust repl väljumiseks.

pac power-fx run

(Eelvaade) Power Fx-i juhiste faili käivitamine

Näited

Järgmised näited näitavad käsu kasutamist pac power-fx run .

Create Dataverse records
Dataverse-tabeli päring
PowerFx-funktsioonide kasutamine

Märkus.

Igas järgmises näites peate tegema järgmist.

Looge fail, test-pfx.txt mille nimi on Power Fx-avaldised teie arvuti kaustas( nt c:\test.
Avage Windows PowerShelli aken, liikuge test kausta ja kasutage run käsku, mis määrab faili, mis sisaldab käske: pac power-fx run --file test-pfx.txt.

Dataverse'i tabelite kasutamiseks peate looma ja valima autentimisprofiili. Vaadake pac autentimise loomise ja pac autentimise valimist.

Kui kuvatakse tõrkekontroll Tõrkeotsing.

Create Dataverse records

Lisage faili järgmine tekst test-pfx.txt ja salvestage see.

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

Käivitage järgmine käsk:

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

Väljundit võite oodata järgmiselt.

{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-tabeli päring

Lisage see tekst test-pfx.txt faili ja salvestage see.
```
FirstN(Contacts, 5)
```
See käsk toob Dataverse'ist viis esimest kontakti.

Käivitage järgmine käsk:

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

Väljundit võite oodata järgmiselt.

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

Lisage faili järgmine tekst test-pfx.txt ja salvestage see.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
Selles näites kasutatakse funktsioone Mid, If ja Set Power Fx.

Käitage järgmine käsk.

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

Väljundit võite oodata järgmiselt.

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

Lisage parameeter --echo ja võite oodata järgmist väljundit:

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>

Nõutavad parameetrid: power-fx run

`--file` `-f`

Käivitatava faili tee

Valikulised parameetrid: power-fx run

`--echo` `-e`

Tõene, kui sisendkäsud peaksid väljundi tagasi kajama

See parameeter ei vaja väärtust. See on lüliti.

`--environment` `-env`

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

Tõrkeotsing

Järgnevalt on toodud juhised käskude kasutamisel pac power-fx ilmneda võivate tõrgete tõrkeotsinguks.

Tõrge Dataverse'i autentimisprofiili puudumise korral

Sellise tõrketeate saate siis, kui te pole Dataverse'i keskkonnaga seostatud universaalset autentimisprofiili.

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.

Selliste tõrgete lahendamiseks looge dataverse-keskkonnaga seotud universaalne autentimisprofiil.

Käivitage käsuautentimisepac loend.

Teile võidakse kuvada järgmine tulem, mis sisaldab UNIVERSAL autentimisprofiili, millel pole URL-i, mis viitab sellele, et see on seotud Dataverse'i keskkonnaga.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Sellest ei piisa, kuna Dataverse'i keskkonda pole määratud.

Autentimisfunktsiooni abil saate pac luua Dataverse'i keskkonnaga ühendatud autentimisprofiiliUNIVERSAL.

Märkus.

Kasutage parameetrit --environment environmentid väärtuse abil. Otsige üles oma keskkonna ID.

Ärge kasutage parameetrit --url , kuna sellega luuakse DATAVERSE profiil, mitte UNIVERSAL profiil.

Näiteks:

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>

Käivitage pac autentimisloend uuesti. Peaksite nägema tulemust UNIVERSAL oma Dataverse'i keskkonna ühendusprofiiliga URL-iga.

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 Valige keskkond, et muuta see autentimiskäsupac abil vaikeprofiiliks.

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>

Vt ka

Microsoft Power Platform CLI käsurühmad
Microsoft Power Platform CLI ülevaade

Tagasiside

Kas sellest lehest oli abi?

Last updated on 2026-01-14

Jagamisviis:

pac power-fx

Käsud

pac power-fx repl

Valikulised parameetrid: power-fx repl

--environment -env

Märkused

Näited

Ridade lisamine

Abi

Väljapääs

pac power-fx run

Näited

Create Dataverse records

Dataverse-tabeli päring

PowerFx-funktsioonide kasutamine

Nõutavad parameetrid: power-fx run

--file -f

Valikulised parameetrid: power-fx run

--echo -e

--environment -env

Tõrkeotsing

Tõrge Dataverse'i autentimisprofiili puudumise korral

Vt ka

Tagasiside

Lisaressursid

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`