pac power-fx

(Forhåndsvisning) Kommandoer for å arbeide med Power Fx

Bruk disse kommandoene til å samhandle med data i Dataverse ved hjelp av en kommandolinje eller et skript. Reduser tiden og kompleksiteten for dataverse operasjoner ved hjelp av Power Fx.

Du kan bruke formlene som er oppført i formelreferansen – Power Platform CLI.

Kommandoer

Kommando	Beskrivelse
pac power-fx repl	(Forhåndsvisning) Start interaktiv Power Fx Read-Eval-Print Loop
pac power-fx run	(Forhåndsvisning) Kjøre en fil med Power Fx-instruksjoner

pac power-fx repl

(Forhåndsvisning) Start interaktiv Power Fx Read-Eval-Print Loop

Note

Hvis du installerte Power Platform CLI ved hjelp av Windows MSI, er det et kjent problem med pac power-fx repl hvor skallet kan slutte å svare når du bruker denne kommandoen.

Valgfrie parametere for power-fx repl

`--environment` `-env`

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

Merknader

Denne kommandoen inneholder et skall for å bruke formler som er oppført i Formelreferanse – Power Platform CLI.

Start Power Fx-koblingen ved å kjøre følgende kommando:

pac power-fx repl

Deretter kan du kjøre Power Fx-kommandoer.

Eksempler

Eksemplene nedenfor viser bruken av pac power-fx repl kommandoen.

Legge til rader
Hjelp
Utgang

Legge til rader

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

Power Fx svarer på nytt med følgende:

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

Help

Kjør følgende kommando for å få hjelp med alle kommandoene som er tilgjengelige i Power Fx-koblet på nytt:

Help()

Power Fx svarer på nytt med følgende utdata:

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

Note

Disse kommandoene endres over tid for å inkludere flere kommandoer. Den skal synkroniseres med de dokumenterte tilgjengelige kommandoene.

Exit

Brukes Exit() til å avslutte repl kommandoen.

pac power-fx run

(Forhåndsvisning) Kjøre en fil med Power Fx-instruksjoner

Eksempler

Eksemplene nedenfor viser bruken av pac power-fx run kommandoen.

Opprette dataverse poster
Spørring i en datavers tabell
Bruke PowerFx-funksjoner

Note

I hvert av disse eksemplene må du:

Opprett en fil med test-pfx.txt Power Fx-uttrykk i en mappe på datamaskinen, for eksempel c:\test.
Åpne et Windows PowerShell-vindu, gå til test mappen og bruk run kommandoen som angir filen som inneholder kommandoene: pac power-fx run --file test-pfx.txt.

Hvis du vil bruke Dataverse-tabeller, må du opprette og velge en godkjenningsprofil. Se pac opprettings- og pac godkjenningsvalg for godkjenning.

Hvis du får en feilkontroll feilsøking.

Opprette dataverse poster

Legg til følgende tekst i test-pfx.txt og lagre filen.

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

Kjør denne kommandoen:

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

Du kan forvente utdata som følger:

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

Spørring i en datavers tabell

Legg til denne teksten i test-pfx.txt og lagre filen.
```
FirstN(Contacts, 5)
```
Denne kommandoen henter de fem første kontaktene fra Dataverse.

Kjør denne kommandoen:

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

Du kan forvente utdata som følger:

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>

Bruke PowerFx-funksjoner

Legg til følgende tekst i test-pfx.txt og lagre filen.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
Dette eksemplet bruker funksjonene Mid, If og Set Power Fx.

Kjør følgende kommando:

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

Du kan forvente utdata som følger:

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

Legg til parameteren --echo , og du kan forvente dette utdataene:

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 parametere for power-fx run

`--file` `-f`

Banen til filen som skal kjøres

Valgfrie parametere for power-fx run

`--echo` `-e`

Sann hvis inndatakommandoer skal gå tilbake til utdata

Denne parameteren krever ingen verdi. Det er en bryter.

`--environment` `-env`

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

Feilsøking

Nedenfor finner du en fremgangsmåte for å feilsøke feil du kan støte på når du bruker pac power-fx kommandoer.

Feil når det ikke finnes noen datavers godkjenningsprofil

Du kan få en feilmelding som dette når du ikke har en universell godkjenningsprofil som er knyttet til et dataverst 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.

Hvis du vil løse slike feil, oppretter du en universell godkjenningsprofil som er knyttet til et dataverst miljø.

Kjør kommandogodkjenningslistenpac.

Du kan se et resultat som følgende som inkluderer en UNIVERSAL godkjenningsprofil uten nettadresse som indikerer at den er knyttet til et dataverst miljø.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Dette er ikke tilstrekkelig fordi det ikke er angitt noe dataversmiljø.

Bruk pac godkjenningsoppretting til å opprette en UNIVERSAL godkjenningsprofil som er koblet til et dataversmiljø.

Note

Bruk parameteren --environment ved hjelp av miljø-ID-verdien. Finn miljø-ID-en din.

Ikke bruk parameteren --url fordi dette vil opprette 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>

Kjør pac godkjenningslisten på nytt. Du bør se et resultat med UNIVERSAL tilkoblingsprofil med en NETTADRESSE for dataversmiljøet.

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 Velg miljøet for å gjøre den til standardprofil ved pac hjelp av kommandoen for godkjenningsvalg.

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å

Kommandogrupper for Microsoft Power Platform CLI
Oversikt over Microsoft Power Platform CLI

Tilbakemeldinger

Var denne siden nyttig?

Last updated on 2026-01-14

Del via

pac power-fx

Kommandoer

pac power-fx repl

Valgfrie parametere for power-fx repl

--environment -env

Merknader

Eksempler

Legge til rader

Help

Exit

pac power-fx run

Eksempler

Opprette dataverse poster

Spørring i en datavers tabell

Bruke PowerFx-funksjoner

Obligatoriske parametere for power-fx run

--file -f

Valgfrie parametere for power-fx run

--echo -e

--environment -env

Feilsøking

Feil når det ikke finnes noen datavers godkjenningsprofil

Se også

Tilbakemeldinger

Flere ressurser

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`