pac power-fx

(Priekšskatījums) Komandas darbam ar Power Fx.

Izmantojiet šīs komandas, lai mijiedarbotos ar datiem Dataverse, izmantojot komandrindu vai skriptu. Samaziniet savu Dataverse operāciju laiku un sarežģītību, izmantojot Power Fx.

Varat izmantot formulas, kas norādītas sadaļā Formulas atsauce - Power Platform CLI.

Komandas

Komanda	Apraksts
pac power-fx repl	(Priekšskatījums) Interaktīvās Power Fx lasīšanasEval-Print cilpas palaišana
pac power-fx run	(Priekšskatījums) Power Fx instrukciju faila palaišana

pac power-fx repl

(Priekšskatījums) Interaktīvās Power Fx lasīšanasEval-Print cilpas palaišana

Piezīmes

Ja instalējāt Power Platform CLI, izmantojot Windows MSI, pastāv zināma problēma pac power-fx repl , kad apvalks var pārtraukt reaģēt, izmantojot šo komandu.

Neobligātie parametri power-fx repl

`--environment` `-env`

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

Piezīmes

Šī komanda nodrošina čaulu, lai izmantotu formulas, kas norādītas sadaļā Formulas atsauce - Power Platform CLI.

Startējiet Power Fx repl, izpildot šādu komandu:

pac power-fx repl

Pēc tam varat palaist Power Fx komandas.

Piemēri

Tālāk sniegtajos piemēros ir parādīta pac power-fx repl komandas izmantošana.

Rindu pievienošana
Palīgā
Iziešana

Rindu pievienošana

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

Power Fx atbilde atbild šādi:

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

Palīgā

Palaidiet tālāk norādīto komandu, lai saņemtu palīdzību par visām komandām, kas ir pieejamas pakalpojumā Power Fx repl:

Help()

Power Fx repl atbild ar šādu izvadi:

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

Piezīmes

Šīs komandas laika gaitā mainīsies, iekļaujot vairāk komandu. Tas ir jāsinhronizē ar dokumentētajām pašlaik pieejamajām komandām.

Iziešana

Izmantojiet Exit() , lai izietu no komandas repl .

pac power-fx run

(Priekšskatījums) Power Fx instrukciju faila palaišana

Piemēri

Tālāk sniegtajos piemēros ir parādīta pac power-fx run komandas izmantošana.

Dataverse ierakstu izveide
Vaicājums Dataverse tabulā
PowerFx funkciju izmantošana

Piezīmes

Katrā no šiem piemēriem jums ir nepieciešams:

Izveidojiet failu ar test-pfx.txt Power Fx izteiksmēm datora mapē, piemēram c:\test, .
Atveriet Windows PowerShell logu, pārejiet uz mapi test un izmantojiet komandu run , norādot failu, kurā ir komandas: pac power-fx run --file test-pfx.txt.

Lai izmantotu Dataverse tabulas, jums ir jāizveido un jāatlasa autentifikācijas profils. Skatiet sadaļu autentifikācijaspac izveide un pac autentifikācijas atlase.

Ja tiek parādīts kļūdas ziņojums, pārbaudiet sadaļu Problēmu novēršana.

Dataverse ierakstu izveide

Pievienojiet tālāk norādīto tekstu test-pfx.txt un saglabājiet failu.

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

Palaidiet šo komandu:

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

Jūs varat sagaidīt šādu rezultātu:

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

Vaicājums Dataverse tabulā

Pievienojiet šo tekstu test-pfx.txt un saglabājiet failu.
```
FirstN(Contacts, 5)
```
Šī komanda izgūst pirmās piecas kontaktpersonas no Dataverse.

Palaidiet šo komandu:

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

Jūs varat sagaidīt šādu rezultātu:

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 funkciju izmantošana

Pievienojiet tālāk norādīto tekstu test-pfx.txt un saglabājiet failu.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
Šajā piemērā tiek izmantotas funkcijas Mid, If un Set Power Fx.

Palaidiet tālāk norādīto komandu.

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

Jūs varat sagaidīt šādu rezultātu:

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

Pievienojiet parametru, --echo un jūs varat sagaidīt šo izvadi:

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>

Nepieciešamie parametri power-fx run

`--file` `-f`

Izpildāmā faila ceļš

Neobligātie parametri power-fx run

`--echo` `-e`

True, ja ievades komandām ir jāatbalsojas atpakaļ uz izvadi

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

`--environment` `-env`

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

Problēmu novēršana

Tālāk ir norādītas darbības, lai novērstu kļūdas, kas var rasties, lietojot pac power-fx komandas.

Kļūda, ja nav Dataverse autentifikācijas profila

Šādu kļūdu var parādīt, ja jums nav universālā autentifikācijas profila, kas saistīts ar Dataverse vidi.

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.

Lai novērstu šādas kļūdas, izveidojiet universālu autentifikācijas profilu, kas saistīts ar Dataverse vidi.

Palaidiet komandu pac autentifikācijas sarakstu.

Iespējams, redzēsit šādu rezultātu, kurā ir iekļauts autentifikācijas profils UNIVERSAL bez URL, kas norāda, ka tas ir saistīts ar Dataverse vidi.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Tas nav pietiekami, jo nav norādīta Dataverse vide.

Izmantojiet pac autentifikācijas izveidi , lai izveidotu autentifikācijas profilu, kas savienots UNIVERSAL ar Dataverse vidi.

Piezīmes

Izmantojiet parametru, --environment izmantojot vērtību environmentid. Atrodiet savu vides ID.

Neizmantojiet šo parametru, --url jo tas izveidos profilu, DATAVERSE nevis UNIVERSAL profilu.

Piemēram:

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>

Vēlreiz palaist pac autentifikācijas sarakstu . Jums vajadzētu redzēt rezultātu ar UNIVERSAL savienojuma profilu ar Dataverse vides URL.

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>

Atlasiet vidi, UNIVERSAL lai to padarītu par noklusējuma profilu, izmantojot autentifikācijas atlases komandupac.

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>

Skatiet arī

Microsoft Power Platform CLI komandu grupas
Microsoft Power Platform CLI pārskats

Atsauksmes

Vai šī lapa palīdzēja?

Last updated on 2026-02-25

Kopīgot, izmantojot

pac power-fx

Komandas

pac power-fx repl

Neobligātie parametri power-fx repl

--environment -env

Piezīmes

Piemēri

Rindu pievienošana

Palīgā

Iziešana

pac power-fx run

Piemēri

Dataverse ierakstu izveide

Vaicājums Dataverse tabulā

PowerFx funkciju izmantošana

Nepieciešamie parametri power-fx run

--file -f

Neobligātie parametri power-fx run

--echo -e

--environment -env

Problēmu novēršana

Kļūda, ja nav Dataverse autentifikācijas profila

Skatiet arī

Atsauksmes

Papildu resursi

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`