PAC Power-FX |

(Pré-visualização) Comandos para trabalhar com Power Fx

Use esses comandos para interagir com dados no 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 da plataforma de energia.

Commands

Command	Description
PAC Power-FX Repl	(Pré-visualização) Inicie o Power Fx Read-Eval-Print Loop interativo
PAC Power-FX Executado	(Pré-visualização) Executar um ficheiro de instruções do Power Fx

PAC Power-FX Repl

(Pré-visualização) Inicie o Power Fx Read-Eval-Print Loop interativo

Observação

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

Parâmetros opcionais para power-fx repl

`--environment` `-env`

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

Observações

Este comando fornece um shell para usar fórmulas listadas em Referência de fórmula - CLI da plataforma de energia.

Inicie a repl Power Fx executando o seguinte comando:

pac power-fx repl

Depois disso, você pode executar comandos Power Fx.

Examples

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

Adicionar linhas
Ajuda
Sair

Adicionar linhas

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

O Power Fx repl 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 Power Fx repl:

Help()

O Power Fx repl 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 Executado

(Pré-visualização) Executar um ficheiro de instruções do Power Fx

Examples

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

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

Observação

Em cada um desses exemplos, você precisa:

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

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

Se você receber um erro, verifique Solução de problemas.

Criar registros Dataverse

Adicione o seguinte texto e test-pfx.txt 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 Dataverse

Adicione este texto e test-pfx.txt salve o arquivo.
```
FirstN(Contacts, 5)
```
Este 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 PowerFx

Adicione o seguinte texto e test-pfx.txt 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 seguinte comando:

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

`--file` `-f`

Caminho do arquivo a ser executado

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

`--echo` `-e`

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

Este parâmetro não requer valor. É uma mudança.

`--environment` `-env`

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

Solução de problemas

A seguir estão as etapas para solucionar erros que você pode encontrar ao usar pac power-fx comandos.

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

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

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

Execute o comando pac auth list.

Você pode ver um resultado como o seguinte que inclui um UNIVERSAL perfil de autenticação sem URL indicando que está associado a um ambiente 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 Dataverse é especificado.

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

Observação

Use o --environment parâmetro usando o valor environmentid. Encontre o ID do seu 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 pac auth list novamente. Você deve ver um resultado com UNIVERSAL o perfil de conexão com uma URL para seu 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>

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

Feedback

Esta página foi útil?

Last updated on 2025-12-02

Partilhar via

PAC Power-FX |

Commands

PAC Power-FX Repl

Parâmetros opcionais para power-fx repl

--environment -env

Observações

Examples

Adicionar linhas

Help

Exit

PAC Power-FX Executado

Examples

Criar registros Dataverse

Consultar uma tabela Dataverse

Usar funções PowerFx

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

--file -f

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

--echo -e

--environment -env

Solução de problemas

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

Consulte também

Feedback

Recursos adicionais

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`