pac power-fx

(Vista prèvia) Ordres per treballar amb Power Fx

Utilitzeu aquestes ordres per interactuar amb les dades mitjançant Dataverse una línia d'ordres o un script. Reduïu el temps i la complexitat de les operacions del Dataverse mitjançant el Power Fx.

Podeu utilitzar les fórmules que s'enumeren a la referència de fórmules - CLI del Power Platform.

Comandes

Ordre	Descripció
pac power-fx repl	(Vista prèvia) Inicieu el bucle interactiu de lectura de Power FxEval-Print
pac power-fx run	(Vista prèvia) Executar un fitxer d'instruccions del Power Fx

pac power-fx repl

(Vista prèvia) Inicieu el bucle interactiu de lectura de Power FxEval-Print

Nota

Si heu instal·lat l'CLI del Power Platform mitjançant Windows MSI, hi ha un problema conegut amb pac power-fx repl el qual l'intèrpret d'ordres pot deixar de respondre quan s'utilitza aquesta ordre.

Paràmetres opcionals per a power-fx repl

`--environment` `-env`

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

Observacions

Aquesta ordre proporciona un intèrpret d'ordres per utilitzar les fórmules llistades a Referència de fórmules - CLI del Power Platform.

Inicieu el repl del Power Fx executant l'ordre següent:

pac power-fx repl

Després d'això, podeu executar ordres de Power Fx.

Exemples

Els exemples següents mostren l'ús de l'ordre pac power-fx repl .

Afegir files
Ajudar
Sortida

Afegir files

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

El repl del Power Fx respon amb el següent:

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

Ajudar

Executeu l'ordre següent per obtenir ajuda sobre totes les ordres disponibles al Power Fx repl:

Help()

El repl Power Fx respon amb la sortida següent:

  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

Aquestes ordres canviaran amb el temps per incloure més ordres. S'ha de sincronitzar amb les ordres documentades actualment disponibles.

Sortida

Utilitzeu-lo Exit() per sortir de l'ordre repl .

pac power-fx run

(Vista prèvia) Executar un fitxer d'instruccions del Power Fx

Exemples

Els exemples següents mostren l'ús de l'ordre pac power-fx run .

Crear registres del Dataverse
Consulta d'una taula del Dataverse
Utilitzar les funcions de PowerFx

Nota

En cadascun d'aquests exemples, heu de:

Creeu un fitxer anomenat test-pfx.txt amb expressions del Power Fx en una carpeta de l'ordinador, com ara c:\test.
Obriu una finestra del Windows PowerShell, aneu a la test carpeta i utilitzeu l'ordre run que especifica el fitxer que conté les ordres: pac power-fx run --file test-pfx.txt.

Per utilitzar les taules del Dataverse, heu de crear i seleccionar un perfil d'autenticació. Vegeu pac autenticació crear i pac seleccionar l'autenticació.

Si rebeu un error, comproveu Resolució de problemes.

Crear registres del Dataverse

Afegiu el text següent i test-pfx.txt deseu el fitxer.

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

Executeu aquesta ordre:

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

Podeu esperar resultats com els següents:

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

Consulta d'una taula del Dataverse

Afegiu aquest text i test-pfx.txt deseu el fitxer.
```
FirstN(Contacts, 5)
```
Aquesta ordre recupera els cinc primers contactes del Dataverse.

Executeu aquesta ordre:

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

Podeu esperar resultats com els següents:

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>

Utilitzar les funcions de PowerFx

Afegiu el text següent i test-pfx.txt deseu el fitxer.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
En aquest exemple s'utilitzen les funcions Mid, If i Set Power Fx.

Executeu l'ordre següent:

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

Podeu esperar resultats com els següents:

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

Afegiu el --echo paràmetre i podeu esperar aquesta sortida:

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>

Paràmetres requerits per a power-fx run

`--file` `-f`

Ruta del fitxer a executar

Paràmetres opcionals per a power-fx run

`--echo` `-e`

Cert si les ordres d'entrada han de tornar a la sortida

Aquest paràmetre no requereix cap valor. És un canvi.

`--environment` `-env`

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

Solució de problemes

A continuació es mostren els passos per resoldre els errors que podeu trobar quan utilitzeu pac power-fx ordres.

Error quan no existeix cap perfil d'autenticació del Dataverse

Podeu obtenir un error com aquest quan no teniu un perfil d'autenticació universal associat a un entorn del 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.

Per resoldre errors com aquests, creeu un perfil d'autenticació universal associat a un entorn del Dataverse.

Fes la llista d'autorització de comandamentpac.

És possible que vegeu un resultat com el següent que inclou un UNIVERSAL perfil d'autenticació sense adreça URL que indiqui que està associat a un entorn del Dataverse.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Això no és suficient perquè no s'especifica cap entorn del Dataverse.

Utilitza pac auth create per crear un perfil d'autenticació UNIVERSAL connectat a un entorn Dataverse.

Nota

Utilitzeu el --environment paràmetre utilitzant el valor environmentid. Cerqueu l'identificador de l'entorn.

No utilitzeu el --url paràmetre perquè això crearà un DATAVERSE perfil en lloc d'un UNIVERSAL perfil.

Per exemple:

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>

Torna a fer pac la llista d'autorització . Hauríeu de veure un resultat amb UNIVERSAL el perfil de connexió amb una adreça URL per al vostre entorn del 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>

Selecciona l'entorn UNIVERSAL perquè sigui el perfil per defecte utilitzant la comanda de selecció d'autenticació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>

Vegeu també

Grups d'ordres de l'CLI del Microsoft Power Platform
Informació general de la CLI del Microsoft Power Platform

Retroalimentació

Ha estat útil aquesta pàgina?

Last updated on 2026-01-14

Comparteix via

pac power-fx

Comandes

pac power-fx repl

Paràmetres opcionals per a power-fx repl

--environment -env

Observacions

Exemples

Afegir files

Ajudar

Sortida

pac power-fx run

Exemples

Crear registres del Dataverse

Consulta d'una taula del Dataverse

Utilitzar les funcions de PowerFx

Paràmetres requerits per a power-fx run

--file -f

Paràmetres opcionals per a power-fx run

--echo -e

--environment -env

Solució de problemes

Error quan no existeix cap perfil d'autenticació del Dataverse

Vegeu també

Retroalimentació

Recursos addicionals

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`