pac power-fx

(Preview) Příkazy pro práci s Power Fx

Tyto příkazy použijte k interakci s daty v Dataverse pomocí příkazového řádku nebo skriptu. Zkraťte čas a složitost operací Dataverse pomocí Power Fx.

Můžete použít vzorce uvedené v odkazu na vzorec – Power Platform CLI.

Commands

Command	Description
pac power-fx repl	(Preview) Spuštění interaktivní smyčky čtení Power Fx –Eval-Print
pac power-fx run	(Preview) Spuštění souboru s pokyny k Power Fx

pac power-fx repl

(Preview) Spuštění interaktivní smyčky čtení Power Fx –Eval-Print

Poznámka:

Pokud jste nainstalovali rozhraní příkazového řádku Power Platform pomocí MSI systému Windows, je známý problém, kdy pac power-fx repl prostředí může přestat reagovat při použití tohoto příkazu.

Volitelné parametry pro repl power-fx

`--environment` `-env`

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

Poznámky

Tento příkaz poskytuje prostředí pro použití vzorců uvedených v referenčních informacích ke vzorcům – Power Platform CLI.

Spusťte repl Power Fx spuštěním následujícího příkazu:

pac power-fx repl

Potom můžete spouštět příkazy Power Fx.

Examples

Následující příklady ukazují použití pac power-fx repl příkazu.

Přidání řádků
Pomoc
Východ

Přidání řádků

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

Power Fx repl odpoví následujícím kódem:

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

Help

Spuštěním následujícího příkazu získejte nápovědu ke všem příkazům dostupným v power fx repl:

Help()

Repl Power Fx reaguje následujícím výstupem:

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

Poznámka:

Tyto příkazy se v průběhu času změní, aby zahrnovaly více příkazů. Měla by být synchronizovaná s zdokumentovanými aktuálně dostupnými příkazy.

Exit

Slouží Exit() k ukončení repl příkazu.

pac power-fx run

(Preview) Spuštění souboru s pokyny k Power Fx

Examples

Následující příklady ukazují použití pac power-fx run příkazu.

Vytvoření záznamů Dataverse
Dotazování na tabulku Dataverse
Použití funkcí PowerFx

Poznámka:

V každém z těchto příkladů musíte:

Vytvořte soubor s názvem test-pfx.txt s výrazy Power Fx ve složce v počítači, například c:\test.
Otevřete okno Windows PowerShellu, přejděte do test složky a použijte run příkaz určující soubor, který obsahuje příkazy: pac power-fx run --file test-pfx.txt.

Pokud chcete použít tabulky Dataverse, musíte vytvořit a vybrat profil ověřování. Podívejte se na výběr ověření pac create a pac auth.

Pokud se zobrazí chyba, zkontrolujte řešení potíží.

Vytvoření záznamů Dataverse

Do souboru přidejte následující text test-pfx.txt a uložte ho.

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

Spusťte tento příkaz:

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

Můžete očekávat výstup podobný tomuto:

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

Dotazování na tabulku Dataverse

Přidejte tento text do test-pfx.txt souboru a uložte ho.
```
FirstN(Contacts, 5)
```
Tento příkaz načte prvních pět kontaktů z Dataverse.

Spusťte tento příkaz:

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

Můžete očekávat výstup podobný tomuto:

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>

Použití funkcí PowerFx

Do souboru přidejte následující text test-pfx.txt a uložte ho.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
V tomto příkladu se používají funkce Mid, If a Set Power Fx.

Spusťte následující příkaz:

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

Můžete očekávat výstup podobný tomuto:

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

--echo Přidejte parametr a můžete očekávat tento výstup:

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>

Požadované parametry pro spuštění power-fx

`--file` `-f`

Cesta k souboru ke spuštění

Volitelné parametry pro spuštění power-fx

`--echo` `-e`

True if input commands should echo back to output

Tento parametr nevyžaduje žádnou hodnotu. Je to přepínač.

`--environment` `-env`

Řešení problémů

Při řešení chyb, ke kterým může dojít při použití pac power-fx příkazů, jsou následující kroky.

Chyba v případě, že neexistuje žádný profil ověřování Dataverse

Podobná chyba se může zobrazit v případě, že nemáte k prostředí Dataverse přidružený univerzální ověřovací profil.

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.

Pokud chcete tyto chyby vyřešit, vytvořte univerzální ověřovací profil přidružený k prostředí Dataverse.

Spusťte seznam ověřování pac příkazu.

Může se zobrazit výsledek podobný následujícímu UNIVERSAL , který obsahuje ověřovací profil bez adresy URL, což znamená, že je přidružená k prostředí Dataverse.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
To nestačí, protože není zadáno žádné prostředí Dataverse.

K vytvoření ověřovacího profilu připojeného k prostředí Dataverse použijte UNIVERSAL.

Poznámka:

--environment Použijte parametr s použitím hodnoty environmentid. Najděte ID vašeho prostředí.

Nepoužívejte --url parametr, protože se vytvoří DATAVERSE profil místo UNIVERSAL profilu.

Například:

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>

Znovu spusťte seznam ověřování pac . Měli byste vidět výsledek s profilem UNIVERSAL připojení s adresou URL vašeho prostředí 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 Pomocí příkazu pac auth select vyberte prostředí, aby byl výchozí profil.

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>

Viz také

Skupiny příkazů rozhraní příkazového řádku Microsoft Power Platform
Přehled rozhraní příkazového řádku Microsoft Power Platform

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-12-02

Sdílet prostřednictvím

pac power-fx

Commands

pac power-fx repl

Volitelné parametry pro repl power-fx

--environment -env

Poznámky

Examples

Přidání řádků

Help

Exit

pac power-fx run

Examples

Vytvoření záznamů Dataverse

Dotazování na tabulku Dataverse

Použití funkcí PowerFx

Požadované parametry pro spuštění power-fx

--file -f

Volitelné parametry pro spuštění power-fx

--echo -e

--environment -env

Řešení problémů

Chyba v případě, že neexistuje žádný profil ověřování Dataverse

Viz také

Váš názor

Další materiály

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`