pac power-fx

(Wersja zapoznawcza) Polecenia do pracy z programem Power Fx

Użyj tych poleceń do współpracy z danymi w Dataverse przy użyciu wiersza polecenia lub skryptu. Zmniejsz czas i złożoność operacji usługi Dataverse przy użyciu programu Power Fx.

Formuły wymienione w dokumentacji formuł — interfejs wiersza polecenia platformy Power Platform można użyć.

Commands

Command	Description
pac power-fx repl	(Wersja zapoznawcza) Uruchamianie interaktywnej pętli odczytuEval-Print Power Fx
pac power-fx run	(Wersja zapoznawcza) Uruchamianie pliku instrukcji power fx

pac power-fx repl

(Wersja zapoznawcza) Uruchamianie interaktywnej pętli odczytuEval-Print Power Fx

Uwaga / Notatka

Jeśli zainstalowano interfejs wiersza polecenia platformy Power Platform przy użyciu tożsamości usługi zarządzanej systemu Windows, występuje znany problem polegający pac power-fx repl na tym, że powłoka może przestać odpowiadać podczas korzystania z tego polecenia.

Parametry opcjonalne dla repl power-fx

`--environment` `-env`

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

Uwagi

To polecenie udostępnia powłokę do używania formuł wymienionych w dokumentacji formuł — interfejs wiersza polecenia platformy Power Platform.

Uruchom ponownie plik Power Fx, uruchamiając następujące polecenie:

pac power-fx repl

Następnie możesz uruchomić polecenia Power Fx.

Przykłady

W poniższych przykładach pokazano użycie pac power-fx repl polecenia .

Dodawanie wierszy
Pomoc
Wyjście

Dodawanie wierszy

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

Polecenie Power Fx repl odpowiada za pomocą następujących elementów:

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

Help

Uruchom następujące polecenie, aby uzyskać pomoc dotyczącą wszystkich poleceń dostępnych w programie Power Fx repl:

Help()

Polecenie Power Fx repl odpowiada następującymi danymi wyjściowymi:

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

Uwaga / Notatka

Te polecenia zmienią się w czasie, aby uwzględnić więcej poleceń. Powinna zostać zsynchronizowana z udokumentowanymi obecnie dostępnymi poleceniami.

Exit

Użyj Exit() polecenia repl , aby zamknąć polecenie .

pac power-fx run

(Wersja zapoznawcza) Uruchamianie pliku instrukcji power fx

Przykłady

W poniższych przykładach pokazano użycie pac power-fx run polecenia .

Tworzenie rekordów usługi Dataverse
Wykonywanie zapytań względem tabeli Dataverse
Korzystanie z funkcji PowerFx

Uwaga / Notatka

W każdym z tych przykładów należy wykonać następujące czynności:

Utwórz plik o nazwie za test-pfx.txt pomocą wyrażeń Power Fx w folderze na komputerze, na przykład c:\test.
Otwórz okno programu Windows PowerShell, przejdź do test folderu i użyj run polecenia określającego plik zawierający polecenia: pac power-fx run --file test-pfx.txt.

Aby użyć tabel usługi Dataverse, musisz utworzyć i wybrać profil uwierzytelniania. Zobacz temat pac auth create and pac auth select (Tworzenie uwierzytelniania pac i wybieranie uwierzytelniania pac).

Jeśli wystąpi błąd, sprawdź rozwiązywanie problemów.

Tworzenie rekordów usługi Dataverse

Dodaj następujący tekst do test-pfx.txt pliku i zapisz go.

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

Uruchom tę komendę:

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

Dane wyjściowe można oczekiwać w następujący sposób:

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

Wykonywanie zapytań względem tabeli Dataverse

Dodaj ten tekst do test-pfx.txt pliku i zapisz go.
```
FirstN(Contacts, 5)
```
To polecenie pobiera pierwsze pięć kontaktów z usługi Dataverse.

Uruchom tę komendę:

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

Dane wyjściowe można oczekiwać w następujący sposób:

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>

Korzystanie z funkcji PowerFx

Dodaj następujący tekst do test-pfx.txt pliku i zapisz go.
```
Set(x, 1)
Result = If( Mid( "asdf",x,1 ) = "a", "X", "Y" )
```
W tym przykładzie użyto funkcji Mid, If i Set Power Fx.

Uruchom następujące polecenie:

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

Dane wyjściowe można oczekiwać w następujący sposób:

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

--echo Dodaj parametr i możesz oczekiwać następujących danych wyjściowych:

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>

Wymagane parametry dla uruchomienia power-fx

`--file` `-f`

Ścieżka pliku do wykonania

Opcjonalne parametry przebiegu power-fx

`--echo` `-e`

Prawda, jeśli polecenia wejściowe powinny wrócić do danych wyjściowych

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

`--environment` `-env`

Rozwiązywanie problemów

Poniżej przedstawiono kroki rozwiązywania problemów z błędami, które mogą wystąpić podczas korzystania z pac power-fx poleceń.

Błąd, gdy nie istnieje profil uwierzytelniania usługi Dataverse

Jeśli nie masz profilu uwierzytelniania uniwersalnego skojarzonego ze środowiskiem Usługi Dataverse, może być wyświetlany błąd podobny do tego.

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.

Aby rozwiązać takie błędy, utwórz profil uwierzytelniania uniwersalnego skojarzony ze środowiskiem usługi Dataverse.

Uruchom polecenie pac auth list.

Może zostać wyświetlony wynik podobny do poniższego UNIVERSAL , który zawiera profil uwierzytelniania bez adresu URL wskazujący, że jest skojarzony ze środowiskiem usługi Dataverse.
```
Index Active Kind      Name Friendly Name Url User                Cloud  Type
[1]   *      UNIVERSAL                        you@yourcompany.com Public OperatingSystem
```
Nie jest to wystarczające, ponieważ nie określono żadnego środowiska usługi Dataverse.

Użyj polecenia pac auth create , aby utworzyć UNIVERSAL profil uwierzytelniania połączony ze środowiskiem usługi Dataverse.

Uwaga / Notatka

Użyj parametru --environment przy użyciu wartości environmentid. Znajdź identyfikator środowiska.

Nie używaj parametru --url , ponieważ spowoduje to utworzenie DATAVERSE profilu, a nie UNIVERSAL profilu.

Przykład:

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>

Ponownie uruchom listę uwierzytelniania pac . Powinien zostać wyświetlony wynik z UNIVERSAL profilem połączenia z adresem URL środowiska Usługi 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>

UNIVERSAL Wybierz środowisko, aby ustawić go jako domyślny profil przy użyciu polecenia 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>

Zobacz także

Grupy poleceń interfejsu wiersza polecenia platformy Microsoft Power Platform
Omówienie interfejsu wiersza polecenia platformy Microsoft Power Platform

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-12-02

Udostępnij przez

pac power-fx

Commands

pac power-fx repl

Parametry opcjonalne dla repl power-fx

--environment -env

Uwagi

Przykłady

Dodawanie wierszy

Help

Exit

pac power-fx run

Przykłady

Tworzenie rekordów usługi Dataverse

Wykonywanie zapytań względem tabeli Dataverse

Korzystanie z funkcji PowerFx

Wymagane parametry dla uruchomienia power-fx

--file -f

Opcjonalne parametry przebiegu power-fx

--echo -e

--environment -env

Rozwiązywanie problemów

Błąd, gdy nie istnieje profil uwierzytelniania usługi Dataverse

Zobacz także

Sprzężenie zwrotne

Dodatkowe źródła

`--environment` `-env`

`--file` `-f`

`--echo` `-e`

`--environment` `-env`