pac power-fx

(Предварителен преглед) Команди за работа с Power Fx.

Използвайте тези команди, за да взаимодействате с данните в Dataverse с помощта на команден ред или скрипт. Намалете времето и сложността на вашите операции с Dataverse с помощта на Power Fx.

Можете да използвате формулите, изброени в препратката към формула – CLI за Power Platform.

Команди

Command	Описание
pac power-fx repl	(Предварителен преглед) Стартиране на интерактивен Цикъл за четене на Power FxEval-Print
pac power-fx run	(Предварителен преглед) Изпълнете файл с инструкции за Power Fx

pac power-fx repl

(Предварителен преглед) Стартиране на интерактивен Цикъл за четене на Power FxEval-Print

Бележка

Ако сте инсталирали CLI за Power Platform с помощта на Windows MSI, има известен проблем, pac power-fx repl при който обвивката може да спре да отговаря при използване на тази команда.

Незадължителни параметри за power-fx repl

`--environment` `-env`

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

Забележки

Тази команда предоставя обвивка за използване на формулите, изброени в справката за формули – CLI за Power Platform.

Стартирайте 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-02-25

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`