pac power-fx

(Anteprima) Comandi per l'uso di Power Fx

Utilizza questi comandi per interagire con i dati in Dataverse utilizzando una riga di comando o uno script. Ridurre il tempo e la complessità delle operazioni di Dataverse usando Power Fx.

È possibile usare le formule elencate nell'interfaccia della riga di comando formula - Power Platform.

Commands

Command	Description
pac power-fx repl	(Anteprima) Avviare il ciclo interattivo Power Fx Read-Eval-Print
pac power-fx run	(Anteprima) Eseguire un file di istruzioni di Power Fx

pac power-fx repl

(Anteprima) Avviare il ciclo interattivo Power Fx Read-Eval-Print

Annotazioni

Se è stata installata l'interfaccia della riga di comando di Power Platform usando l'identità del servizio gestito di Windows, si verifica un problema noto per pac power-fx repl cui la shell potrebbe smettere di rispondere quando si usa questo comando.

Parametri facoltativi per power-fx repl

`--environment` `-env`

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

Osservazioni:

Questo comando fornisce una shell per usare le formule elencate in Informazioni di riferimento sulla formula - Interfaccia della riga di comando di Power Platform.

Avviare il repl di Power Fx eseguendo il comando seguente:

pac power-fx repl

Successivamente, è possibile eseguire i comandi di Power Fx.

Esempi

Negli esempi seguenti viene illustrato l'uso del pac power-fx repl comando .

Aggiungere righe
Help
Uscita

Aggiungere righe

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

Il repl Power Fx risponde con quanto segue:

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

Help

Eseguire il comando seguente per ottenere informazioni su tutti i comandi disponibili in Power Fx repl:

Help()

Il repl Power Fx risponde con l'output seguente:

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

Annotazioni

Questi comandi cambieranno nel tempo per includere più comandi. Deve essere sincronizzata con i comandi attualmente disponibili documentati.

Exit

Usare Exit() per uscire dal repl comando.

pac power-fx run

(Anteprima) Eseguire un file di istruzioni di Power Fx

Esempi

Negli esempi seguenti viene illustrato l'uso del pac power-fx run comando .

Creare record di Dataverse
Eseguire query su una tabella Dataverse
Usare le funzioni di PowerFx

Annotazioni

In ognuno di questi esempi è necessario:

Creare un file denominato test-pfx.txt con espressioni Power Fx in una cartella nel computer, ad esempio c:\test.
Aprire una finestra di Windows PowerShell, passare alla test cartella e usare il run comando che specifica il file che contiene i comandi: pac power-fx run --file test-pfx.txt.

Per usare le tabelle di Dataverse, è necessario creare e selezionare un profilo di autenticazione. Vedere pac auth create and pac auth select(Pac auth create and pac auth select).

Se viene visualizzato un errore, vedere Risoluzione dei problemi.

Creare record di Dataverse

Aggiungere il testo seguente a test-pfx.txt e salvare il file.

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

Eseguire questo comando:

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

È possibile prevedere un output simile al seguente:

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

Eseguire query su una tabella Dataverse

Aggiungere il testo e test-pfx.txt salvare il file.
```
FirstN(Contacts, 5)
```
Questo comando recupera i primi cinque contatti da Dataverse.

Eseguire questo comando:

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

È possibile prevedere un output simile al seguente:

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>

Usare le funzioni di PowerFx

Aggiungere il testo seguente a test-pfx.txt e salvare il file.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
Questo esempio usa le funzioni Mid, If e Set Power Fx.

Esegui questo comando:

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

È possibile prevedere un output simile al seguente:

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

Aggiungere il --echo parametro ed è possibile prevedere questo 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>

Parametri obbligatori per l'esecuzione power-fx

`--file` `-f`

Percorso del file da eseguire

Parametri facoltativi per l'esecuzione power-fx

`--echo` `-e`

True se i comandi di input devono restituire l'eco all'output

Questo parametro non richiede alcun valore. È un cambio.

`--environment` `-env`

Risoluzione dei problemi

Di seguito sono riportati i passaggi per risolvere gli errori che possono verificarsi quando si usano pac power-fx i comandi.

Errore quando non esiste alcun profilo di autenticazione dataverse

È possibile ottenere un errore simile al seguente quando non si dispone di un profilo di autenticazione universale associato a un ambiente 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 risolvere gli errori come questi, creare un profilo di autenticazione universale associato a un ambiente Dataverse.

Eseguire il comando pac auth list.

È possibile che venga visualizzato un risultato simile al seguente che include un UNIVERSAL profilo di autenticazione senza URL che indica che è associato a un ambiente Dataverse.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Questo non è sufficiente perché non viene specificato alcun ambiente Dataverse.

Usare pac auth create per creare un UNIVERSAL profilo di autenticazione connesso a un ambiente Dataverse.

Annotazioni

Usare il --environment parametro usando il valore environmentid. Trovare l'ID ambiente.

Non usare il --url parametro perché verrà creato un DATAVERSE profilo anziché un UNIVERSAL profilo.

Per esempio:

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>

Eseguire nuovamente l'elenco di autenticazione pac . Verrà visualizzato un risultato con UNIVERSAL il profilo di connessione con un URL per l'ambiente 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>

Selezionare l'ambiente UNIVERSAL per impostarlo come profilo predefinito usando il comando 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>

Vedere anche

Gruppi di comandi dell'interfaccia della riga di comando di Microsoft Power Platform
Panoramica dell'interfaccia della riga di comando di Microsoft Power Platform

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2025-12-02

Condividi tramite

pac power-fx

Commands

pac power-fx repl

Parametri facoltativi per power-fx repl

--environment -env

Osservazioni:

Esempi

Aggiungere righe

Help

Exit

pac power-fx run

Esempi

Creare record di Dataverse

Eseguire query su una tabella Dataverse

Usare le funzioni di PowerFx

Parametri obbligatori per l'esecuzione power-fx

--file -f

Parametri facoltativi per l'esecuzione power-fx

--echo -e

--environment -env

Risoluzione dei problemi

Errore quando non esiste alcun profilo di autenticazione dataverse

Vedere anche

Commenti e suggerimenti

Risorse aggiuntive

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`