pac power-fx

(Versão prévia) Comandos para trabalhar com o Power Fx

Use esses comandos para interagir com dados do Dataverse usando uma linha de comando ou script. Reduza o tempo e a complexidade de suas operações do Dataverse usando o Power Fx.

Você pode usar as fórmulas listadas na referência de fórmula – CLI do Power Platform.

Commands

Command	Description
pac power-fx repl	(Versão prévia) Iniciar loop interativo de leitura do Power FxEval-Print
pac power-fx run	(Versão prévia) Executar um arquivo de instruções do Power Fx

pac power-fx repl

(Versão prévia) Iniciar loop interativo de leitura do Power FxEval-Print

Observação

Se você instalou a CLI do Power Platform usando a MSI do Windows, há um problema conhecido em que pac power-fx repl o shell pode parar de responder ao usar esse comando.

Parâmetros opcionais para o repl power-fx

`--environment` `-env`

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

Observações

Esse comando fornece um shell para usar fórmulas listadas na referência de fórmula – CLI do Power Platform.

Inicie o repl do Power Fx executando o seguinte comando:

pac power-fx repl

Depois disso, você pode executar comandos do Power Fx.

Exemplos

Os exemplos a seguir mostram o uso do pac power-fx repl comando.

Adicionar linhas
Help
Sair

Adicionar linhas

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

O repl do Power Fx responde com o seguinte:

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

Help

Execute o seguinte comando para obter ajuda sobre todos os comandos disponíveis no repl do Power Fx:

Help()

O repl do Power Fx responde com a seguinte saída:

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

Observação

Esses comandos serão alterados ao longo do tempo para incluir mais comandos. Ele deve ser sincronizado com os comandos documentados atualmente disponíveis.

Exit

Use Exit() para sair do repl comando.

pac power-fx run

(Versão prévia) Executar um arquivo de instruções do Power Fx

Exemplos

Os exemplos a seguir mostram o uso do pac power-fx run comando.

Criar registros do Dataverse
Consultar uma tabela do Dataverse
Usar funções do PowerFx

Observação

Em cada um desses exemplos, você precisa:

Crie um arquivo nomeado test-pfx.txt com expressões do Power Fx em uma pasta em seu computador, como c:\test.
Abra uma janela do Windows PowerShell, navegue até a test pasta e use o run comando que especifica o arquivo que contém os comandos: pac power-fx run --file test-pfx.txt.

Para usar tabelas do Dataverse, você precisa criar e selecionar um perfil de autenticação. Consulte pac auth create and pac auth select.

Se você receber uma verificação de erro , solucione problemas.

Criar registros do Dataverse

Adicione o texto a test-pfx.txt seguir e salve o arquivo.

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

Execute este comando:

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

Você pode esperar uma saída como a seguinte:

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

Consultar uma tabela do Dataverse

Adicione este texto test-pfx.txt e salve o arquivo.
```
FirstN(Contacts, 5)
```
Esse comando recupera os cinco primeiros contatos do Dataverse.

Execute este comando:

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

Você pode esperar uma saída como a seguinte:

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>

Usar funções do PowerFx

Adicione o texto a test-pfx.txt seguir e salve o arquivo.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
Este exemplo usa as funções Mid, If e Set Power Fx.

Execute o comando a seguir:

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

Você pode esperar uma saída como a seguinte:

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

Adicione o --echo parâmetro e você pode esperar esta saída:

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âmetros necessários para a execução do power-fx

`--file` `-f`

Caminho do arquivo a ser executado

Parâmetros opcionais para execução do power-fx

`--echo` `-e`

True se os comandos de entrada devem ecoar de volta para a saída

Esse parâmetro não requer nenhum valor. É um comutador.

`--environment` `-env`

Resolução de problemas

Veja a seguir as etapas para solucionar erros que você pode encontrar ao usar pac power-fx comandos.

Erro quando nenhum perfil de autenticação do Dataverse existe

Você pode obter um erro como esse quando não tiver um perfil de autenticação universal associado a um ambiente do 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.

Para resolver erros como esses, crie um perfil de autenticação universal associado a um ambiente do Dataverse.

Execute a lista de autenticação de pac de comandos.

Você pode ver um resultado como o seguinte que inclui um UNIVERSAL perfil de autenticação sem url indicando que ele está associado a um ambiente do Dataverse.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Isso não é suficiente porque nenhum ambiente do Dataverse é especificado.

Use a criação de autenticação pac para criar um UNIVERSAL perfil de autenticação conectado a um ambiente do Dataverse.

Observação

Use o --environment parâmetro usando o valor environmentid. Localize a ID do ambiente.

Não use o --url parâmetro porque isso criará um DATAVERSE perfil em vez de um UNIVERSAL perfil.

Por exemplo:

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>

Execute a lista de autenticação pac novamente. Você deve ver um resultado com UNIVERSAL o perfil de conexão com uma URL para seu ambiente do 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>

Selecione o UNIVERSAL ambiente para torná-lo o perfil padrão usando o 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>

Consulte também

Grupos de comandos da CLI do Microsoft Power Platform
Visão geral da CLI do Microsoft Power Platform

Comentários

Esta página foi útil?

Last updated on 2025-12-02

Compartilhar via

pac power-fx

Commands

pac power-fx repl

Parâmetros opcionais para o repl power-fx

--environment -env

Observações

Exemplos

Adicionar linhas

Help

Exit

pac power-fx run

Exemplos

Criar registros do Dataverse

Consultar uma tabela do Dataverse

Usar funções do PowerFx

Parâmetros necessários para a execução do power-fx

--file -f

Parâmetros opcionais para execução do power-fx

--echo -e

--environment -env

Resolução de problemas

Erro quando nenhum perfil de autenticação do Dataverse existe

Consulte também

Comentários

Recursos adicionais

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`