pac package

Befehle zum Arbeiten mit Dataverse-Paketprojekten.

Befehle

Command	Beschreibung des Dataflows
pac package add-external-package	Fügt ein für das Dataverse-Lösungssystem externes Paket zu einem Package Deployer-Paketprojekt hinzu
pac package add-reference	Fügt Verweis auf Dataverse-Lösungsprojekt hinzu
pac package add-solution	Fügt eine vordefinierte Dataverse-Lösungsdatei einem Package Deployer-Paketprojekt hinzu
pac package compile	(Vorschau) Kompiliert ein Paket. Kompiliert mit "-package-type erp" X++-Modelle mithilfe von xppc.exe aus dem installierten SDK und erzeugt pro Modell eine bereitstellungsfähige ZIP-Datei.
pac package db-sync	(Vorschau) Synchronisiert die Anwendungsdatenbank "Finance and Operations" mit Dataverse.
pac package deploy	Stellt Paket in Dataverse bereit
pac package init	Initialisiert ein Verzeichnis mit einem neuen Dataverse-Paketprojekt
pac package show	Zeigt Details des Dataverse-Pakets an

pac package add-external-package

Fügt ein für das Dataverse-Lösungssystem externes Paket zu einem Package Deployer-Paketprojekt hinzu

Erforderliche Parameter für package add-external-package

--package-type -t

Der Typ des Pakets, das hinzugefügt wird. Beispiel: „xpp“ für FnO-Pakete.

--path -p

Pfad zum externen Paket

Optionale Parameter für package add-external-package

--import-order

Eine ganze Zahl, die die Reihenfolge angibt, in der dieses Element zur Erstellungszeit in die endgültige ImportConfig.xml-Datei eingefügt wird. Negative Zahlen werden vor vorhandenen Elementen eingefügt. Positive Zahlen werden nach vorhandenen Elementen hinzugefügt.

--skip-validation -sv

Fügt das Element der Projektdatei hinzu, auch wenn die Datei nicht vorhanden ist oder ungültig zu sein scheint. Hinweis: Die Verwendung dieser Option hat keine Auswirkungen auf die von MSBuild durchgeführte Prüfung.

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

pac package add-reference

Fügt Verweis auf Dataverse-Lösungsprojekt hinzu

Beispiel

pac package add-reference --path c:\Users\Downloads\SampleSolution

Erforderliche Parameter für package add-reference

--path -p

Der Pfad zum referenzierten Dataverse-Lösungsprojekt

Optionale Parameter für package add-reference

--dependency-overrides

Eine durch Semikolons getrennte Liste von Außerkraftsetzungen. Dieser Wert setzt alle Abhängigkeitsinformationen außer Kraft, die in den Metadaten der Lösung codiert sind. Jede Außerkraftsetzung sollte folgendes Format haben: <uniquename>:<minVersion>:<maxVersion>. MinVersion und maxVersion sind dabei optional, sollten aber in der Syntax des .NET-Versionsformats vorliegen.

Notiz : Verwenden Sie eine durch Semikolon getrennte Liste von Abhängigkeitsüberschreibungen im Format < eindeutiger Name> :< minVersion> :< maxVersion>.

--import-mode

Gibt explizit den erforderlichen Modus beim Importieren dieser Lösung an.

Verwenden Sie einen dieser Werte:

• sync
• async

--import-order

Eine ganze Zahl, die die Reihenfolge angibt, in der dieses Element zur Erstellungszeit in die endgültige ImportConfig.xml-Datei eingefügt wird. Negative Zahlen werden vor vorhandenen Elementen eingefügt. Positive Zahlen werden nach vorhandenen Elementen hinzugefügt.

--missing-dependency-behavior

Gibt das Verhalten beim Importieren an, wenn eine Abhängigkeit dieser Lösung in der Zielumgebung fehlt.

Verwenden Sie einen dieser Werte:

• skip
• fault

--overwrite-unmanaged-customizations

Gibt explizit an, ob nicht verwaltete Anpassungen beim Importieren dieser Lösung überschrieben werden sollen.

Verwenden Sie einen dieser Werte:

• true
• false

--publish-workflows-activate-plugins

Gibt explizit an, ob die Workflows veröffentlicht und Plug-Ins aktiviert werden sollen, wenn diese Lösung importiert wird.

Verwenden Sie einen dieser Werte:

• true
• false

pac package add-solution

Fügt eine vordefinierte Dataverse-Lösungsdatei einem Package Deployer-Paketprojekt hinzu

Erforderliche Parameter für package add-solution

--path -p

Pfad zur Dataverse-Lösungsdatei. Bei der Datei muss es sich um eine komprimierte ZIP-Datei handeln.

Optionale Parameter für package add-solution

--dependency-overrides

Eine durch Semikolons getrennte Liste von Außerkraftsetzungen. Dieser Wert setzt alle Abhängigkeitsinformationen außer Kraft, die in den Metadaten der Lösung codiert sind. Jede Außerkraftsetzung sollte folgendes Format haben: <uniquename>:<minVersion>:<maxVersion>. MinVersion und maxVersion sind dabei optional, sollten aber in der Syntax des .NET-Versionsformats vorliegen.

Notiz : Verwenden Sie eine durch Semikolon getrennte Liste von Abhängigkeitsüberschreibungen im Format < eindeutiger Name> :< minVersion> :< maxVersion>.

--import-mode

Gibt explizit den erforderlichen Modus beim Importieren dieser Lösung an.

Verwenden Sie einen dieser Werte:

• sync
• async

--import-order

Eine ganze Zahl, die die Reihenfolge angibt, in der dieses Element zur Erstellungszeit in die endgültige ImportConfig.xml-Datei eingefügt wird. Negative Zahlen werden vor vorhandenen Elementen eingefügt. Positive Zahlen werden nach vorhandenen Elementen hinzugefügt.

--missing-dependency-behavior

Gibt das Verhalten beim Importieren an, wenn eine Abhängigkeit dieser Lösung in der Zielumgebung fehlt.

Verwenden Sie einen dieser Werte:

• skip
• fault

--overwrite-unmanaged-customizations

Gibt explizit an, ob nicht verwaltete Anpassungen beim Importieren dieser Lösung überschrieben werden sollen.

Verwenden Sie einen dieser Werte:

• true
• false

--publish-workflows-activate-plugins

Gibt explizit an, ob die Workflows veröffentlicht und Plug-Ins aktiviert werden sollen, wenn diese Lösung importiert wird.

Verwenden Sie einen dieser Werte:

• true
• false

--skip-validation -sv

Fügt das Element der Projektdatei hinzu, auch wenn die Datei nicht vorhanden ist oder ungültig zu sein scheint. Hinweis: Die Verwendung dieser Option hat keine Auswirkungen auf die von MSBuild durchgeführte Prüfung.

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

pac package compile

(Vorschau) Kompiliert ein Paket. Kompiliert mit "-package-type erp" X++-Modelle mithilfe von xppc.exe aus dem installierten SDK und erzeugt pro Modell eine bereitstellungsfähige ZIP-Datei.

Erforderliche Parameter für package compile

--package-type -pt

Zielplattform für die Bereitstellung. Zulässige Werte: dataverse, erp (Vorschau). Standard: dataverse.

Optionale Parameter für package compile

--app-version -av

Vierteilige F&O-Anwendungsversion des SDK zum Kompilieren (z. B. 10.0.2588.0). Wenn sie weggelassen wird, wird das für die aktive Umgebung registrierte SDK verwendet.

--incremental

Kompilieren sie nur geänderte Artefakte (übergibt -incremental an xppc).

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

--language -lang

Durch Trennzeichen getrennte Liste der Gebietsschemas zum Kompilieren von Bezeichnungen (z. B. en-US oder en-US,fr,de). Wenn "LabelC" ausgelassen wird, erstellt LabelC jedes Gebietsschema, das in der Quelle gefunden wurde, und entspricht dem Standardmäßigen Buildmodelle-Verhalten Visual Studio. Wirkt sich nur auf die Bezeichnungsstufe aus; xppc + best-practices + package run once over the combined output.

--license-file -lf

Pfad zu einer ISV-Lizenzdatei, die in jedes produzierte Modell ZIP eingefügt werden soll. <In "Model>/bin/<filename>" innerhalb der ZIP-Datei geschrieben.

--model -m

Modellname(n) zum Kompilieren. Akzeptiert einen einzelnen Namen oder eine durch Kommas getrennte Liste. Ohne Angabe werden alle in .erp/xpp.json aufgeführten Modelle kompiliert.

--output

Verzeichnis, in dem die bereitgestellten ZIPs geschrieben werden. Standard: <repoRoot>/bin.

--outputDirectory -o

Ausgabeverzeichnis

--skip-bp

Überspringen Sie den Prüfschritt für bewährte Methoden. Standardmäßig führt die Kompilierungspipeline Bezeichnungen –> X++ –> bewährte Methoden aus.

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

--solution-root -sr

Stammordner der X++-Lösung (enthält .erp/xpp.json). Standardmäßig wird das aktuelle Verzeichnis verwendet.

pac package db-sync

(Vorschau) Synchronisiert die Anwendungsdatenbank "Finance and Operations" mit Dataverse.

Optionale Parameter für package db-sync

--argument-file -af

(Vorschau) Pfad zu einer JSON-Datei, die dem InkrementellenSyncParameters (oder ModuleSyncParameters)-Vertrag entspricht. Erforderlich für inkrementelle --db-sync.

--db-sync -ds

Datenbanksynchronisierungsmodus. Zulässige Werte: Full, Module, Inkrementell. Standard: Vollständig.

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

--modules -m

(Vorschau) Kommagetrennte Liste der zu synchronisierenden Modulnamen. Erforderlich, wenn "--db-sync" Modul ist.

pac package deploy

Stellt Paket in Dataverse bereit

Anmerkung

Dieser Befehl ist nur für die .NET Full Framework-Version der PAC CLI verfügbar.

Beispiel

pac package deploy --logFile c:\samplelogdata --package c:\samplepackage

Optionale Parameter für package deploy

--argument-file -af

(Vorschau) Pfad zu einer JSON-Datei, die dem InkrementellenSyncParameters (oder ModuleSyncParameters)-Vertrag entspricht. Erforderlich für inkrementelle --db-sync.

--build-type -bt

(Vorschau) Wie das Paket angewendet wird. Zulässige Werte: Vollständig, inkrementell, Löschen. Standard: Vollständig. Wird mit --package-type erp verwendet.

--db-sync -ds

(Vorschau) Datenbanksynchronisierungsmodus, der nach der Bereitstellung ausgeführt werden soll. Zulässige Werte: None, Full, Module, Inkrementell. Standardwert: None. Wird mit --package-type erp verwendet.

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

--logConsole -c

Ausgabeprotokoll an Konsole

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

--logFile -lf

Protokolldateipfad

--modules -m

(Vorschau) Kommagetrennte Liste der zu synchronisierenden Modulnamen. Erforderlich, wenn "--db-sync" Modul ist.

--outputDirectory -o

(Vorschau) Nur Lösungsmodus: Stammordner mit .erp/xpp.json. Standardmäßig wird das aktuelle Verzeichnis verwendet. Wenn --package unter --package-type erp ausgelassen wird, werden alle in .erp/xpp.json aufgeführten Modelle in Abhängigkeitsreihenfolge bereitgestellt.

--package -p

Pfad zu einer Paket-DLL oder ZIP-Datei mit einem Paket

--package-type -pt

Zielplattform für die Bereitstellung. Zulässige Werte: dataverse, erp (Vorschau). Standard: dataverse.

--release-type -rt

(Vorschau) Paketklassifizierung. Zulässige Werte: Dev, Release. Standard: Dev. Releasepakete erzwingen eine vollständige Datenbanksynchronisierung auf dem Server. Wird mit --package-type erp verwendet.

--settings -s

Laufzeitpaketeinstellungen, die an das bereitzustellende Paket übergeben werden. Das Format der Zeichenfolge muss key=value|key=value sein.

Notiz : Das Format der Zeichenfolge muss key=value|key=value.

--solution -sz

Pfad zur Dataverse-Lösungsdatei. Bei der Datei muss es sich um eine komprimierte ZIP- oder CAB-Datei handeln.

--solution-root -sr

(Vorschau) Nur Lösungsmodus: Stammordner mit .erp/xpp.json. Standardmäßig wird das aktuelle Verzeichnis verwendet. Wenn --package unter --package-type erp ausgelassen wird, werden alle in .erp/xpp.json aufgeführten Modelle in Abhängigkeitsreihenfolge bereitgestellt.

--verbose -vdbg

Ausführliche Protokolle für die Protokollausgaben emittieren

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

Anmerkungen

Sie können entweder die Parameter logFile und logConsole zusammen oder nur den einen oder den anderen Parameter verwenden.

pac package init

Initialisiert ein Verzeichnis mit einem neuen Dataverse-Paketprojekt

Beispiel

pac package init --outputdirectory c:\samplepackage

Optionale Parameter für package init

--layer -l

(Vorschau) X++-Ebene. Zulässige Werte: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. Standard: ISV.

--model -m

(Vorschau) Name(n) der X++-Modell(en) zum Gerüst. Akzeptiert einen einzelnen Namen oder eine durch Trennzeichen getrennte Liste (z. B. ModelA,ModelB). Erforderlich, wenn "-package-type" erp ist.

--outputDirectory -o

Ausgabeverzeichnis

--package-name

Legt den Standardnamen des Pakets fest. Gilt für die Generierung von ImportExtension.GetNameOfImport.

--package-type -pt

Typ des Paketprojekts, das Gerüst erstellt werden soll. Zulässige Werte: dataverse, erp (Vorschau). Standard: dataverse.

--publisher -pub

(Vorschau) Publisher In den Modelldeskriptor geschriebenen Namen. Standardeinstellung: Microsoft.

--source-root -sr

(Vorschau) Quellstammpfad (relativ zum Ausgabeverzeichnis), in dem Sich Modelle befinden. Standard: ./src.

pac package show

Zeigt Details des Dataverse-Pakets an

Anmerkung

Dieser Befehl ist nur für die .NET Full Framework-Version der PAC CLI verfügbar.

Beispiel

pac package show c:\samplepackage.dll

Erforderliche Parameter für package show

--package -p

Pfad zu einer Paket-DLL oder ZIP-Datei mit einem Paket

Optionale Parameter für package show

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

--logFile -lf

Protokolldateipfad

--verbose -vdbg

Ausführliche Protokolle für die Protokollausgaben emittieren

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

Siehe auch

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