pac power-fx

(Önizleme) Power Fx ile çalışmaya yönelik komutlar

Bir komut satırı veya betik kullanarak Dataverse'deki verilerle etkileşime geçmek için bu komutları kullanın. Power Fx kullanarak Dataverse işlemlerinizin süresini ve karmaşıklığını azaltın.

Formül başvurusu - Power Platform CLI'sinde listelenen formülleri kullanabilirsiniz.

Commands

Command	Description
pac power-fx repl	(Önizleme) Etkileşimli Power Fx Okuma-Eval-Print Döngüsünü başlatma
pac power-fx run	(Önizleme) Power Fx yönergelerinden oluşan bir dosya çalıştırma

pac power-fx repl

(Önizleme) Etkileşimli Power Fx Okuma-Eval-Print Döngüsünü başlatma

Uyarı

Power Platform CLI'yı Windows MSI kullanarak yüklediyseniz, bu komutu kullanırken kabuğun yanıt vermeyebileceği bilinen bir sorun pac power-fx repl vardır.

Power-fx repl için İsteğe Bağlı Parametreler

`--environment` `-env`

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

Açıklamalar

Bu komut, Formül başvurusu - Power Platform CLI'da listelenen formülleri kullanmak için bir kabuk sağlar.

Aşağıdaki komutu çalıştırarak Power Fx repl'i başlatın:

pac power-fx repl

Bundan sonra Power Fx komutlarını çalıştırabilirsiniz.

Örnekler

Aşağıdaki örneklerde komutun kullanımı gösterilmektedir pac power-fx repl .

Satır ekleme
Yardım
Çıkış

Satır ekleme

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

Power Fx repl aşağıdakilerle yanıt verir:

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

Help

Power Fx repl'de kullanılabilen tüm komutlar hakkında yardım almak için aşağıdaki komutu çalıştırın:

Help()

Power Fx repl aşağıdaki çıkışla yanıt verir:

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

Uyarı

Bu komutlar zaman içinde daha fazla komut içerecek şekilde değişir. Belgelenmiş şu anda kullanılabilir komutlarla eşitlenmelidir.

Exit

komutundan Exit() çıkmak için kullanınrepl.

pac power-fx run

(Önizleme) Power Fx yönergelerinden oluşan bir dosya çalıştırma

Örnekler

Aşağıdaki örneklerde komutun kullanımı gösterilmektedir pac power-fx run .

Dataverse kayıtları oluşturma
Dataverse tablosunu sorgulama
PowerFx işlevlerini kullanma

Uyarı

Bu örneklerin her birinde şunları yapmanız gerekir:

Bilgisayarınızda gibi test-pfx.txtbir klasörde Power Fx ifadeleriyle adlı c:\test bir dosya oluşturun.
Bir Windows PowerShell penceresi açın, klasörüne test gidin ve şu komutları içeren dosyayı belirten komutu kullanın run : pac power-fx run --file test-pfx.txt.

Dataverse tablolarını kullanmak için bir kimlik doğrulama profili oluşturmanız ve seçmeniz gerekir. Bkz. pac auth oluşturma ve pac kimlik doğrulama seçimi.

Hata alırsanız Sorun giderme'yi denetleyin.

Dataverse kayıtları oluşturma

Dosyasına aşağıdaki metni test-pfx.txt ekleyin ve dosyayı kaydedin.

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

Şu komutu çalıştırın:

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

Aşağıdaki gibi bir çıkış bekleyebilirsiniz:

{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 tablosunu sorgulama

Bu metni öğesine test-pfx.txt ekleyin ve dosyayı kaydedin.
```
FirstN(Contacts, 5)
```
Bu komut Dataverse'den ilk beş kişiyi alır.

Şu komutu çalıştırın:

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

Aşağıdaki gibi bir çıkış bekleyebilirsiniz:

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 işlevlerini kullanma

Dosyasına aşağıdaki metni test-pfx.txt ekleyin ve dosyayı kaydedin.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
Bu örnekte Mid, If ve Set Power Fx işlevleri kullanılır.

Aşağıdaki komutu çalıştırın:

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

Aşağıdaki gibi bir çıkış bekleyebilirsiniz:

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

parametresini --echo eklediğinizde şu çıkışı bekleyebilirsiniz:

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 çalıştırması için gerekli Parametreler

`--file` `-f`

Yürütülecek dosyanın yolu

Power-fx çalıştırması için isteğe bağlı Parametreler

`--echo` `-e`

Giriş komutlarının çıkışa geri dönmesi gerekiyorsa True

Bu parametre için değer gerekmez. Bu bir anahtar.

`--environment` `-env`

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

Sorun giderme

Aşağıda, komutları kullanırken pac power-fx karşılaşabileceğiniz hataları giderme adımları yer alır.

Dataverse kimlik doğrulama profili olmadığında hata oluştu

Dataverse ortamıyla ilişkilendirilmiş bir evrensel kimlik doğrulama profiliniz olmadığında böyle bir hata alabilirsiniz.

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.

Bu gibi hataları çözmek için Dataverse ortamıyla ilişkilendirilmiş evrensel bir kimlik doğrulama profili oluşturun.

Pac kimlik doğrulaması komut listesini çalıştırın.

Dataverse ortamıyla ilişkili olduğunu belirten Url'si olmayan bir UNIVERSAL kimlik doğrulama profili içeren aşağıdakine benzer bir sonuç görebilirsiniz.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Dataverse ortamı belirtilmediğinden bu yeterli değildir.

Dataverse ortamına bağlı bir kimlik doğrulama profili oluşturmak için UNIVERSAL özelliğini kullanın.

Uyarı

--environment environmentid değerini kullanarak parametresini kullanın. Ortam kimliğinizi bulun.

Parametresini --url kullanmayın çünkü bu işlem profil yerine profil DATAVERSEUNIVERSAL oluşturur.

Örneğin:

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 kimlik doğrulama listesini yeniden çalıştırın. Dataverse ortamınızın URL'sini içeren bağlantı profiline sahip UNIVERSAL bir sonuç görmeniz gerekir.

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 auth select komutunu kullanarak ortamı varsayılan profil yapmak için seçin.

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>

Ayrıca bakınız

Microsoft Power Platform CLI Komut Grupları
Microsoft Power Platform CLI'ya genel bakış

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-01-07

Aracılığıyla paylaş

pac power-fx

Commands

pac power-fx repl

Power-fx repl için İsteğe Bağlı Parametreler

--environment -env

Açıklamalar

Örnekler

Satır ekleme

Help

Exit

pac power-fx run

Örnekler

Dataverse kayıtları oluşturma

Dataverse tablosunu sorgulama

PowerFx işlevlerini kullanma

Power-fx çalıştırması için gerekli Parametreler

--file -f

Power-fx çalıştırması için isteğe bağlı Parametreler

--echo -e

--environment -env

Sorun giderme

Dataverse kimlik doğrulama profili olmadığında hata oluştu

Ayrıca bakınız

Geri Bildirim

Ek kaynaklar

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`