pac pcf

Befehle für die Arbeit mit Power Apps Component Framework-Projekten

Erstellen und Entwickeln einer Codekomponente erklärt, wie diese Befehle verwendet werden.

Befehle

Befehl Beschreibung
pac pcf init Initialisiert ein Verzeichnis mit einem neuen Power Apps Component Framework-Projekt
pac pcf push Das Power Apps Component Framework-Projekt in die aktuelle Dataverse-Organisation importieren
pac pcf version Patchversion für Steuerelemente

pac pcf init

Initialisiert ein Verzeichnis mit einem neuen Power Apps Component Framework-Projekt

Beispiel

pac pcf init --namespace SampleNameSpace --name SampleComponent --template field

Optionale Parameter für pcf init

--framework -fw

Das Renderingframework für das Steuerelement. Der Standardwert ist „Kein“, was HTML bedeutet.

Verwenden Sie einen dieser Werte:

  • none
  • react

--name -n

Der Name der Komponente

Hinweis: Nur die folgenden Zeichen innerhalb der Bereiche [A - Z], [a - z] oder [0 - 9] sind zulässig. Das erste Zeichen darf keine Zahl sein.

--namespace -ns

Der Namespace für die Komponente

Hinweis: Nur die folgenden Zeichen innerhalb der Bereiche [A - Z], [a - z], [0 - 9] oder „.“ sind zulässig. Das erste und letzte Zeichen darf nicht das Zeichen „.“ sein. Aufeinanderfolgende „.“-Zeichen sind nicht erlaubt. Zahlen sind als erstes Zeichen oder unmittelbar nach einem Punkt nicht zulässig.

--outputDirectory -o

Ausgabeverzeichnis

--run-npm-install -npm

Führen Sie „npm install“ nach dem Erstellen des Steuerelements automatisch aus. Der Standardwert ist „false“.

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--template -t

Vorlage für die Komponente auswählen

Verwenden Sie einen dieser Werte:

  • field
  • dataset

Anmerkungen

Verwenden Sie --framework react mit React-Steuerelemente und Plattformbibliotheken (Vorschau).

pac pcf push

Das Power Apps Component Framework-Projekt in die aktuelle Dataverse-Organisation importieren

Beispiel

pac pcf push --publisher-prefix dev

Optionale Parameter für pcf Push

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--force-import -f

Veraltet: Dieser Parameter wird ignoriert.

--incremental -inc

Überträgt mithilfe von Entitätsaktualisierungen nur Dateien, die sich unterscheiden.

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--interactive -i

Gibt an, dass Aktionen im Build mit dem Benutzer interagieren dürfen. Verwenden Sie dieses Argument nicht in einem automatisierten Szenario, in dem keine Interaktivität erwartet wird.

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--publisher-prefix -pp

Anpassungspräfixwert für den Dataverse-Lösungsherausgeber

Hinweis: Das Präfix muss 2 bis 8 Zeichen lang sein, darf nur aus alphanumerischen Zeichen bestehen, muss mit einem Buchstaben beginnen und darf nicht mit „mscrm“ beginnen.

--solution-unique-name

Der eindeutige Name der Lösung, der die Komponente hinzugefügt werden soll.

--verbosity -v

Ausführlichkeitsgrad für MSBuild beim Erstellen des Wrappers für temporäre Lösung.

Verwenden Sie einen dieser Werte:

  • minimal
  • normal
  • detailed
  • diagnostic

pac pcf version

Patchversion für Steuerelemente

Beispiel

pac pcf version --patchversion 1.0.0.0 --path c:\Users\Downloads\SampleComponent --allmanifests
pac pcf version --strategy gittags

Optionale Parameter für pcf-Version

--allmanifests -a

Aktualisiert die Patchversion für alle „ControlManifest.xml“-Dateien.

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--filename -fn

Name der Tracker-CSV-Datei, die bei der Verwendung von Dateinachverfolgung (filetracking) als Strategie verwendet wird. Der Standardwert ist „ControlsStateVersionInfo.csv“.

--patchversion -pv

Patchversion für Steuerelemente

Hinweis: Der Wert muss ein Integer mit einem Mindestwert von 0 sein.

--path -p

Absoluter/relativer Pfad der „ControlManifest.xml“ zum Aktualisieren.

--strategy -s

Aktualisiert die Patch-Version für „ControlManifest.xml“-Dateien unter Verwendung der angegebenen Strategie. Wenn Sie Gittags verwenden, legen Sie ein persönliches Zugriffstoken in der folgenden Umgebungsvariablen „PacCli.PAT“ fest

Verwenden Sie einen dieser Werte:

  • None
  • GitTags
  • FileTracking
  • Manifest

--updatetarget -ut

Angeben, welches Zielmanifest aktualisiert werden muss

Verwenden Sie einen dieser Werte:

  • build
  • project

Anmerkungen

--patchversion nimmt nur den Wert des dritten Teils des Versionstupels an: Major.Minor.Patch.

Für --strategy haben die verfügbaren Werte diese Bedeutungen:

Wert Beschreibung des Dataflows
gittags Verwenden Sie Git-Tags, um zu entscheiden, ob die Patch-Version einer bestimmten Komponente aktualisiert werden muss.
filetracking Verwenden Sie eine CSV-Datei, um zu entscheiden, ob die Patch-Version einer bestimmten Komponente aktualisiert werden muss.
manifest Erhöht die Patch-Version für alle Komponenten um 1.

Siehe auch

Microsoft Power Platform CLI-Befehlsgruppen
Microsoft Power Platform CLI – Übersicht