pac power-fx

(Попередній перегляд) Команди для роботи з Power Fx

Використовуйте ці команди, щоб взаємодіяти з даними в Dataverse за допомогою командного рядка або сценарію. Зменште час і складність операцій Dataverse за допомогою Power Fx.

Ви можете використовувати формули, перелічені в посиланні на формулу – CLI платформи Power Platform.

Команди

Command	Опис
pac power-fx repl	(Попередній перегляд) Запуск інтерактивного циклу читання Power Fx –Eval-Print
pac power-fx run	(Попередній перегляд) Запуск файлу інструкцій Power Fx

pac power-fx repl

(Попередній перегляд) Запуск інтерактивного циклу читання Power Fx –Eval-Print

Нотатка

Якщо ви інсталювали CLI платформи Power Platform за допомогою Windows MSI, існує відома проблема з pac power-fx repl тим, де оболонка може припинити реагувати під час використання цієї команди.

Необов'язкові параметри для power-fx repl

`--environment` `-env`

Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

Зауваження

Ця команда надає оболонку для використання формул, перелічених у посиланні на формулу – 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.
Створення автентифікації дає змогу pacUNIVERSAL створити профіль автентифікації, підключений до середовища 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-01-07

Поділитися через

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`