pac power-fx

(Előzetes verzió) Parancsok a Power Fx-hez

Ezekkel a parancsokkal parancssorból vagy parancsfájlból Dataverse kezelheti az adatokat. Csökkentse a Dataverse-műveletek idejét és összetettségét a Power Fx használatával.

A Képletek hivatkozás – Power Platform parancssori felület című témakörben felsorolt képleteket használhatja.

Commands

Command	Description
pac power-fx repl	(Előzetes verzió) Interaktív Power Fx Read-Eval-Print hurok indítása
pac power-fx run	(Előzetes verzió) Power Fx-utasítások fájljának futtatása

pac power-fx repl

(Előzetes verzió) Interaktív Power Fx Read-Eval-Print hurok indítása

Megjegyzés:

Ha Windows MSI-vel telepítette a Power Platform parancssori felületét, ismert probléma merül fel azzal kapcsolatban pac power-fx repl , hogy a rendszerhéj hol hagyhatja abba a válaszadást a parancs használatakor.

Választható paraméterek a következőhöz: power-fx repl

`--environment` `-env`

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

Megjegyzések

Ez a parancs egy rendszerhéjat biztosít a Képletek hivatkozás – Power Platform parancssori felületében felsorolt képletek használatához.

Indítsa el a Power Fx-repl parancsot a következő parancs futtatásával:

pac power-fx repl

Ezután Power Fx-parancsokat futtathat.

Példák

Az alábbi példák a parancs használatát pac power-fx repl mutatják be.

Sorok hozzáadása
Segítség
Kijárat

Sorok hozzáadása

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

A Power Fx repl a következőkkel válaszol:

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

Help

Futtassa a következő parancsot a Power Fx-replben elérhető összes parancsra vonatkozó segítségért:

Help()

A Power Fx repl a következő kimenettel válaszol:

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

Megjegyzés:

Ezek a parancsok idővel változnak, hogy több parancsot is tartalmazzanak. Szinkronizálni kell a dokumentált , jelenleg elérhető parancsokkal.

Exit

A parancsból való kilépéshez Exit() használhatórepl.

pac power-fx run

(Előzetes verzió) Power Fx-utasítások fájljának futtatása

Példák

Az alábbi példák a parancs használatát pac power-fx run mutatják be.

Dataverse-rekordok létrehozása
Dataverse-tábla lekérdezése
PowerFx-függvények használata

Megjegyzés:

Az alábbi példák mindegyikében a következőkre van szükség:

Hozzon létre egy Power Fx-kifejezésekkel ellátott test-pfx.txt fájlt a számítógép egyik mappájában, például c:\test.
Nyisson meg egy Windows PowerShell-ablakot, keresse meg a test mappát, és használja a run parancsot tartalmazó fájlt megadva: pac power-fx run --file test-pfx.txt.

Dataverse-táblák használatához létre kell hoznia és ki kell választania egy hitelesítési profilt. Lásd apac hitelesítés létrehozását és pac a hitelesítés kiválasztását.

Ha hibaüzenet jelenik meg, ellenőrizze a hibaelhárítást.

Dataverse-rekordok létrehozása

Adja hozzá a következő szöveget, test-pfx.txt és mentse a fájlt.

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

Futtassa ezt a parancsot:

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

Az alábbihoz hasonló kimenet várható:

{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-tábla lekérdezése

Adja hozzá ezt a szöveget, test-pfx.txt és mentse a fájlt.
```
FirstN(Contacts, 5)
```
Ez a parancs lekéri az első öt névjegyet a Dataverse-ből.

Futtassa ezt a parancsot:

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

Az alábbihoz hasonló kimenet várható:

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-függvények használata

Adja hozzá a következő szöveget, test-pfx.txt és mentse a fájlt.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
Ez a példa a Közép, a Ha és a Power Fx függvényt használja.

Futtassa a következő parancsot:

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

Az alábbihoz hasonló kimenet várható:

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

Adja hozzá a paramétert --echo , és számíthat a kimenetre:

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>

Kötelező paraméterek a következőhöz: power-fx run

`--file` `-f`

A végrehajtandó fájl elérési útja

Választható paraméterek a következőhöz: power-fx run

`--echo` `-e`

Igaz, ha a bemeneti parancsok visszahangzanak a kimenetre

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

`--environment` `-env`

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

Hibaelhárítás

Az alábbiakban a parancsok használatakor pac power-fx előforduló hibák elhárításának lépéseit követjük.

Hiba, ha nincs dataverse hitelesítési profil

Ilyen hibaüzenet akkor jelenhet meg, ha nem rendelkezik a Dataverse-környezethez társított univerzális hitelesítési profillal.

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.

Az ilyen hibák megoldásához hozzon létre egy Dataverse-környezethez társított univerzális hitelesítési profilt.

Futtassa a parancs pac hitelesítési listáját.

A következőhöz hasonló eredmény jelenhet meg, amely tartalmaz egy olyan hitelesítési profilt UNIVERSAL , amely nem tartalmaz URL-címet, amely azt jelzi, hogy az egy Dataverse-környezethez van társítva.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Ez nem elegendő, mert nincs megadva Dataverse-környezet.

Hitelesítési létrehozássalpac hozzon létre egy UNIVERSAL Dataverse-környezethez csatlakoztatott hitelesítési profilt.

Megjegyzés:

Használja a paramétert --environment a környezeti azonosító értékével. Keresse meg a környezet azonosítóját.

Ne használja a paramétert--url, mert ez profil helyett profilt DATAVERSE hoz létreUNIVERSAL.

Például:

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>

Futtassa pac újra a hitelesítési listát . A Dataverse-környezet URL-címével rendelkező UNIVERSAL kapcsolatprofillal rendelkező eredményt kell látnia.

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>

Válassza ki a UNIVERSAL környezetet, hogy az legyen az alapértelmezett profil az pac auth select paranccsal.

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>

Lásd még

Microsoft Power Platform parancssori felület parancscsoportjai
A Microsoft Power Platform parancssori felületének áttekintése

Visszacsatolás

Hasznos volt ez az oldal?

Last updated on 2026-01-14

Megosztás:

pac power-fx

Commands

pac power-fx repl

Választható paraméterek a következőhöz: power-fx repl

--environment -env

Megjegyzések

Példák

Sorok hozzáadása

Help

Exit

pac power-fx run

Példák

Dataverse-rekordok létrehozása

Dataverse-tábla lekérdezése

PowerFx-függvények használata

Kötelező paraméterek a következőhöz: power-fx run

--file -f

Választható paraméterek a következőhöz: power-fx run

--echo -e

--environment -env

Hibaelhárítás

Hiba, ha nincs dataverse hitelesítési profil

Lásd még

Visszacsatolás

További források

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`