pac power-fx

(Pratonton) Perintah untuk bekerja dengan Power Fx

Gunakan perintah ini untuk berinteraksi dengan data dalam Dataverse menggunakan baris arahan atau skrip. Kurangkan masa dan kerumitan operasi Dataverse anda dengan menggunakan Power Fx.

Anda boleh menggunakan formula yang disenaraikan dalam rujukan Formula - Power Platform CLI.

Perintah

Perintah	Keterangan
pac power-fx repl	(Pratonton) Lancarkan Power Fx Read-Eval-Print Loop interaktif
pac power-fx run	(Pratonton) Jalankan fail arahan Power Fx

pac power-fx repl

(Pratonton) Lancarkan Power Fx Read-Eval-Print Loop interaktif

Nota

Jika anda memasang Power Platform CLI menggunakan Windows MSI, terdapat isu yang diketahui dengan pac power-fx repl tempat shell mungkin berhenti bertindak balas apabila menggunakan arahan ini.

Parameter Pilihan untuk power-fx repl

`--environment` `-env`

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

Ucapan

Perintah ini menyediakan shell untuk menggunakan formula yang disenaraikan dalam rujukan formula - Power Platform CLI.

Mulakan Power Fx repl dengan menjalankan arahan berikut:

pac power-fx repl

Selepas itu, anda boleh menjalankan arahan Power Fx.

Contoh

Contoh berikut menunjukkan penggunaan pac power-fx repl arahan.

Tambah baris
Membantu
Keluar

Tambah baris

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

Repl Power Fx bertindak balas dengan yang berikut:

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

Membantu

Jalankan arahan berikut untuk mendapatkan bantuan tentang semua arahan yang tersedia dalam Power Fx repl:

Help()

Kuasa Fx repl bertindak balas dengan output berikut:

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

Nota

Arahan ini akan berubah dari semasa ke semasa untuk memasukkan lebih banyak arahan. Ia hendaklah disegerakkan dengan arahan yang didokumenkan yang tersedia pada masa ini.

Keluar

Gunakan Exit() untuk keluar repl dari arahan.

pac power-fx run

(Pratonton) Jalankan fail arahan Power Fx

Contoh

Contoh berikut menunjukkan penggunaan pac power-fx run arahan.

Cipta rekod Dataverse
Pertanyaan jadual Dataverse
Gunakan fungsi PowerFx

Nota

Dalam setiap contoh ini, anda perlu:

Cipta fail yang dinamakan test-pfx.txt dengan ungkapan Power Fx dalam folder pada komputer anda, seperti c:\test.
Buka tetingkap Windows PowerShell, navigasi ke test folder dan gunakan arahan run yang menentukan fail yang mengandungi arahan: pac power-fx run --file test-pfx.txt.

Untuk menggunakan jadual Dataverse, anda perlu mencipta dan memilih profil pengesahan. Lihat pac cipta pengesahan dan pac pilih pengesahan.

Jika anda mendapat ralat, semak Penyelesaian masalah.

Cipta rekod Dataverse

Tambahkan teks berikut kepada dan simpan test-pfx.txt fail.

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

Jalankan arahan ini:

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

Anda boleh menjangkakan output seperti berikut:

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

Pertanyaan jadual Dataverse

Tambahkan teks ini kepada dan simpan test-pfx.txt fail.
```
FirstN(Contacts, 5)
```
Perintah ini mendapatkan semula lima kenalan pertama daripada Dataverse.

Jalankan arahan ini:

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

Anda boleh menjangkakan output seperti berikut:

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>

Gunakan fungsi PowerFx

Tambahkan teks berikut kepada dan simpan test-pfx.txt fail.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
Contoh ini menggunakan fungsi Mid, If, dan Set Power Fx.

Jalankan perintah berikut:

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

Anda boleh menjangkakan output seperti berikut:

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

Tambah --echo parameter dan anda boleh menjangkakan output ini:

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>

Parameter yang diperlukan untuk power-fx run

`--file` `-f`

Laluan fail untuk dilaksanakan

Parameter Pilihan untuk power-fx run

`--echo` `-e`

Benar jika arahan input harus bergema kembali ke output

Parameter ini tidak memerlukan nilai. Ia adalah suis.

`--environment` `-env`

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

Pencarisilapan

Berikut ialah langkah untuk menyelesaikan masalah ralat yang mungkin anda hadapi apabila menggunakan pac power-fx arahan.

Ralat apabila tiada profil pengesahan Dataverse wujud

Anda boleh mendapatkan ralat seperti ini apabila anda tidak mempunyai profil pengesahan sejagat yang dikaitkan dengan persekitaran 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.

Untuk menyelesaikan ralat seperti ini, cipta profil pengesahan sejagat yang dikaitkan dengan persekitaran Dataverse.

Jalankan senarai pengesahan perintahpac.

Anda mungkin melihat hasil seperti berikut yang termasuk UNIVERSAL profil pengesahan tanpa Url yang menunjukkan ia dikaitkan dengan persekitaran Dataverse.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Ini tidak mencukupi kerana tiada persekitaran Dataverse ditentukan.

Gunakan pac cipta pengesahan untuk mencipta UNIVERSAL profil pengesahan yang disambungkan ke persekitaran Dataverse.

Nota

Gunakan --environment parameter menggunakan nilai environmentid. Cari ID persekitaran anda.

Jangan gunakan parameter kerana --url ini akan mencipta DATAVERSE profil dan bukannya UNIVERSAL profil.

Contohnya:

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>

Jalankan pac senarai pengesahan sekali lagi. Anda sepatutnya melihat hasil dengan UNIVERSAL profil sambungan dengan URL untuk persekitaran Dataverse anda.

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>

Pilih UNIVERSAL persekitaran untuk menjadikannya profil lalai menggunakan arahan pac pilih pengesahan .

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>

Lihat juga

Kumpulan Perintah CLI Microsoft Power Platform
Gambaran keseluruhan CLI Microsoft Power Platform

Maklum balas

Adakah halaman ini membantu?

Last updated on 2026-01-14

Kongsi melalui

pac power-fx

Perintah

pac power-fx repl

Parameter Pilihan untuk power-fx repl

--environment -env

Ucapan

Contoh

Tambah baris

Membantu

Keluar

pac power-fx run

Contoh

Cipta rekod Dataverse

Pertanyaan jadual Dataverse

Gunakan fungsi PowerFx

Parameter yang diperlukan untuk power-fx run

--file -f

Parameter Pilihan untuk power-fx run

--echo -e

--environment -env

Pencarisilapan

Ralat apabila tiada profil pengesahan Dataverse wujud

Lihat juga

Maklum balas

Sumber tambahan

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`