pac power-fx

(Алдын ала қарау) Power Fx-пен жұмыс істеуге арналған командалар.

Пәрмен жолын немесе сценарийді пайдаланып Dataverse-тегі деректермен өзара әрекеттесу үшін осы пәрмендерді пайдаланыңыз. Power Fx бағдарламасын пайдалану арқылы Dataverse операцияларының уақыты мен күрделілігін қысқартыңыз.

Формула сілтемесі - Power Platform CLI-де тізімделген формулаларды пайдалануға болады.

Ð Ð°Ð°

Пәрмен	Сипаттама
pac power-fx repl	(Алдын ала қарау) Интерактивті Power Fx оқу-Eval-Print циклін іске қосыңыз
pac power-fx run	(Алдын ала қарау) Power Fx нұсқауларының файлын іске қосу

pac power-fx repl

(Алдын ала қарау) Интерактивті Power Fx оқу-Eval-Print циклін іске қосыңыз

Ескертпе

Егер Windows MSI көмегімен Power Platform CLI бағдарламасын орнатсаңыз, осы пәрменді пайдаланған кезде қабықшаның жауап беруді тоқтатуы мүмкін екендігі туралы белгілі мәселе pac power-fx repl бар.

Қосымша параметрлер power-fx repl

`--environment` `-env`

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

Ескертулер

Бұл пәрмен Формула сілтемесі - Power Platform CLI-де тізімделген формулаларды пайдалану үшін қоршауды ұсынады.

Power Fx repl бағдарламасын келесі пәрменді орындау арқылы іске қосыңыз:

pac power-fx repl

Осыдан кейін сіз Power Fx пәрмендерін іске қоса аласыз.

Мысалдар

Төменде келтірілген мысалдар бұйрықты pac power-fx repl орындау тәртібін көрсетеді.

Жолдарды қосу
Анықтама
Ð Ð°Ñ T

Жолдарды қосу

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

Ескертпе

Бұл бұйрықтар уақыт өте келе көбірек бұйрықтарды қосу үшін өзгереді. Ол қазіргі уақытта қол жетімді құжаттармен синхрондалған болуы керек.

Ð Ð°Ñ T

Бұйрықты Exit() орындау үшін пайдаланыңызrepl.

pac power-fx run

(Алдын ала қарау) Power Fx нұсқауларының файлын іске қосу

Мысалдар

Төменде келтірілген мысалдар бұйрықты pac power-fx run орындау тәртібін көрсетеді.

Dataverse жазбаларын жасау
Dataverse кестесін сұрау
PowerFx функцияларын пайдалану

Ескертпе

Осы мысалдардың әрқайсысында сізге қажет:

Компьютеріңіздегі қалтада Power Fx өрнектерімен аталатын test-pfx.txt файл жасаңыз, мысалы c:\test.
Windows PowerShell терезесін ашып, қалтаға test өтіп, пәрмендерді қамтитын файлды көрсететін пәрменді пайдаланыңыз run : pac power-fx run --file test-pfx.txt.

Dataverse кестелерін пайдалану үшін аутентификация профилін жасап, таңдауыңыз керек. Auth create және pac authentic select бөлімдерін қараңыз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 аутентификация тізімін іске қосыңыз.

Dataverse ортасымен байланысты екенін көрсететін URL мекенжайы жоқ аутентификация профилін UNIVERSAL қамтитын төмендегідей нәтижені көре аласыз.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Бұл жеткіліксіз, өйткені Dataverse ортасы анықталған жоқ.

Dataverse ортасына қосылған аутентификация профилін pac жасау UNIVERSAL.

Ескертпе

--environment Параметрді қоршаған ортаны қорғау мәнін пайдаланыңыз. Қоршаған ортаны табыңыз.

Параметрді --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. Dataverse ортасына арналған URL мекенжайы бар байланыс профилі бар нәтижені UNIVERSAL көруіңіз керек.

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>

Келесіні де қараңыз:

Microsoft Power Platform CLI пәрмен топтары
Microsoft Power Platform CLI шолуына шолу

Кері байланыс

Бет пайдалы болды ма?

Last updated on 2026-02-25

Бөлісу құралы:

pac power-fx

Ð Ð°Ð°

pac power-fx repl

Қосымша параметрлер power-fx repl

--environment -env

Ескертулер

Мысалдар

Жолдарды қосу

Анықтама

Ð Ð°Ñ T

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`