pac power-fx

(eksempelvisning) Kommandoer til at arbejde med Power Fx

Brug disse kommandoer til at interagere med data i Dataverse ved hjælp af en kommandolinje eller et script. Reducer tiden og kompleksiteten af dine dataverse-handlinger ved hjælp af Power Fx.

Du kan bruge de formler, der er angivet i kommandolinjegrænsefladen Formelreference – Power Platform.

Kommandoer

Kommando	Beskrivelse
pac power-fx repl	(eksempelvisning) Start interaktiv Power Fx Read-Eval-Print Loop
pac power-fx køre	(eksempelvisning) Kør en fil med Power Fx-instruktioner

pac power-fx repl

(eksempelvisning) Start interaktiv Power Fx Read-Eval-Print Loop

Notat

Hvis du har installeret kommandolinjegrænsefladen for Power Platform ved hjælp af Windows MSI, er der et kendt problem med, hvor shell'en kan holde op med pac power-fx repl at svare, når denne kommando bruges.

Valgfrie parametre for power-fx repl

`--environment` `-env`

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

Bemærkninger

Denne kommando indeholder en shell til brug af formler, der er angivet i Formelreference – Kommandolinjegrænseflade for Power Platform.

Start Power Fx-repl'en ved at køre følgende kommando:

pac power-fx repl

Derefter kan du køre Power Fx-kommandoer.

Eksempler

Følgende eksempler viser brugen af pac power-fx repl kommandoen.

Tilføj rækker
Hjælp
Udgang

Tilføj rækker

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

Power Fx-repl svarer med følgende:

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

Help

Kør følgende kommando for at få hjælp til alle de kommandoer, der er tilgængelige i Power Fx repl:

Help()

Power Fx-repl'en svarer med følgende output:

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

Notat

Disse kommandoer ændres med tiden, så de indeholder flere kommandoer. Den skal synkroniseres med de dokumenterede kommandoer, der er tilgængelige i øjeblikket.

Afslut

Bruges Exit() til at afslutte kommandoen repl .

pac power-fx køre

(eksempelvisning) Kør en fil med Power Fx-instruktioner

Eksempler

Følgende eksempler viser brugen af pac power-fx run kommandoen.

Opret Dataverse-poster
Forespørg om en dataversetabel
Brug PowerFx-funktioner

Notat

I hvert af disse eksempler skal du:

Opret en fil med navnet test-pfx.txt Power Fx-udtryk i en mappe på computeren, f.eks c:\test. .
Åbn et Windows PowerShell-vindue, naviger til mappen test , og brug den run kommando, der angiver den fil, der indeholder kommandoerne: pac power-fx run --file test-pfx.txt.

Hvis du vil bruge Dataverse-tabeller, skal du oprette og vælge en godkendelsesprofil. Se pac auth create and pac auth select.

Hvis du får vist en fejl, skal du kontrollere Fejlfinding.

Opret Dataverse-poster

Føj følgende tekst til test-pfx.txt filen, og gem den.

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

Kør denne kommando:

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

Du kan forvente output som følgende:

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

Forespørg om en dataversetabel

Føj denne tekst til test-pfx.txt filen, og gem den.
```
FirstN(Contacts, 5)
```
Denne kommando henter de første fem kontakter fra Dataverse.

Kør denne kommando:

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

Du kan forvente output som følgende:

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>

Brug PowerFx-funktioner

Føj følgende tekst til test-pfx.txt filen, og gem den.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
I dette eksempel bruges funktionerne Mid, If og Set Power Fx.

Kør følgende kommando:

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

Du kan forvente output som følgende:

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

Tilføj parameteren, --echo og du kan forvente dette output:

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>

Obligatoriske parametre for power-fx-kørsel

`--file` `-f`

Sti til den fil, der skal udføres

Valgfrie parametre til kørsel af power-fx

`--echo` `-e`

Sand, hvis inputkommandoer skal gå tilbage til output

Denne parameter kræver ingen værdi. Det er en kontakt.

`--environment` `-env`

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

Fejlfinding

Følgende er trin til fejlfinding af fejl, du kan støde på, når du bruger pac power-fx kommandoer.

Fejl, når der ikke findes nogen Dataverse-godkendelsesprofil

Du kan få vist en fejl som denne, når du ikke har en universel godkendelsesprofil knyttet til et Dataverse-miljø.

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.

Du kan løse fejl som disse ved at oprette en universel godkendelsesprofil, der er knyttet til et Dataverse-miljø.

Kør listen over kommandoer til godkendelse.

Du kan muligvis se et resultat som følgende, der indeholder en UNIVERSAL godkendelsesprofil uden url-adresse, der angiver, at den er knyttet til et Dataverse-miljø.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Dette er ikke tilstrækkeligt, fordi der ikke er angivet noget Dataverse-miljø.

Brug pac auth create til at oprette en UNIVERSAL godkendelsesprofil, der er forbundet til et Dataverse-miljø.

Notat

Brug parameteren --environment ved hjælp af værdien for environmentid. Find dit miljø-id.

Brug ikke --url parameteren, da dette vil oprette en DATAVERSE profil i stedet for en UNIVERSAL profil.

Eksempel:

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>

Kør pac auth liste igen. Du bør se et resultat med UNIVERSAL forbindelsesprofilen med en URL-adresse til dit Dataverse-miljø.

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ælg miljøet UNIVERSAL for at gøre det til standardprofilen ved hjælp af kommandoen pac auth select .

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>

Se også

Kommandolinjekommandogrupper for Microsoft Power Platform
Oversigt over kommandolinjegrænsefladen til Microsoft Power Platform

Feedback

Var denne side nyttig?

Last updated on 2025-12-02

Del via

pac power-fx

Kommandoer

pac power-fx repl

Valgfrie parametre for power-fx repl

--environment -env

Bemærkninger

Eksempler

Tilføj rækker

Help

Afslut

pac power-fx køre

Eksempler

Opret Dataverse-poster

Forespørg om en dataversetabel

Brug PowerFx-funktioner

Obligatoriske parametre for power-fx-kørsel

--file -f

Valgfrie parametre til kørsel af power-fx

--echo -e

--environment -env

Fejlfinding

Fejl, når der ikke findes nogen Dataverse-godkendelsesprofil

Se også

Feedback

Yderligere ressourcer

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`