Freigeben über


pac solution

Befehle zum Arbeiten mit Dataverse-Lösungsprojekten

Befehle

Command Beschreibung
PAC-Lösung, Lizenz hinzufügen Der Lösung Lizenz- und Planinformationen hinzufügen
Pac-Lösung Add-Reference Fügt einen Verweis aus dem Projekt im aktuellen Verzeichnis zum Projekt unter „Pfad“ hinzu.
Pac-Lösung Add-Solution-Component Fügen Sie eine oder mehrere Lösungskomponenten zur nicht verwalteten Ziellösung in Dataverse hinzu.
PAC-Lösungscheck Ein Dataverse-Lösungsprojekt hochladen, das mit dem Power Apps Checker-Dienst validiert werden soll
Pac-Lösungsklon Erstellen Sie ein Lösungsprojekt auf der Grundlage einer vorhandenen Lösung in Ihrer Organisation.
Pac-Lösung – Einstellungen erstellen Erstellen Sie eine Einstellungsdatei aus dem ZIP- oder Lösungsordner.
Pac-Lösung löschen Lösung aus Dataverse in der aktuellen Umgebung löschen
PAC-Lösungsexport Eine Lösung von Dataverse exportieren.
Pac-Lösung importieren Importieren Sie die Lösung in Dataverse.
Pac-Lösung init Initialisiert ein Verzeichnis mit einem neuen Dataverse-Lösungsprojekt
Pac-Lösungsliste Alle Lösungen aus der aktuellen Dataverse-Organisation auflisten
pac Lösung Online-Version Legt die Version für die in Dataverse geladene Lösung fest.
Pac-Lösungspaket Paketlösungskomponenten im lokalen Dateisystem nach solution.zip (SolutionPackager).
Pac-Lösung veröffentlichen Veröffentlicht alle Anpassungen
Pac-Lösungssynchronisierung Synchronisieren Sie das aktuelle Dataverse-Lösungsprojekt mit dem aktuellen Status der Lösung in Ihrer Organisation.
Pac-Lösung auspacken Lösungskomponenten aus solution.zip in das lokale Dateisystem extrahieren (SolutionPackager).
PAC-Lösungsupgrade Lösungsupgrade anwenden
Pac-Lösungsversion Build- oder Revision-Version für die Lösung aktualisieren

pac solution add-license

Der Lösung Lizenz- und Planinformationen hinzufügen

Beispiel

Dieses Beispiel zeigt, wie Sie einer Lösung ein Lizenzierungsinformation hinzufügen

pac solution add-license --planDefinitionFile ../ISV_Plan_Definition.csv --planMappingFile ../ISV_Plan_Mapping.csv

Plan-Definitionsdatei

Nachfolgend finden Sie ein Beispiel für die Plandefinitionsdatei:

ServiceID,Display name,More info URL
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.bronzeplan,Fabrikam Bronze Plan,http://www.microsoft.com
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,Fabrikam Silver Plan,http://www.microsoft.com
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,Fabrikam Gold Plan,http://www.microsoft.com

Plan-Zuordnungsdatei

Nachfolgend finden Sie ein Beispiel für die Planmappingdatei:

Service ID,Component name
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.bronzeplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,crf36_SilverApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_SilverApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_GoldApp

Erforderliche Parameter für das Hinzufügen der Lizenz zur Lösung

--planDefinitionFile-pd

Datei zur Lizenzplandefinition im CSV-Format; erwartete Spalten: Service-ID, Anzeigename, URL zu weiteren Informationen.

--planMappingFile-pm

Datei zur Lizenzplanzuordnung im CSV-Format; erwartete Spalten: Service-ID, Komponentenname

pac solution add-reference

Fügt einen Verweis aus dem Projekt im aktuellen Verzeichnis zum Projekt unter „Pfad“ hinzu.

Beispiel

pac solution add-reference --path c:\Users\Downloads\SampleComponent

Erforderliche Parameter für das Hinzufügen des Verweises zur Lösung

--path-p

Der Pfad zum referenzierten Projekt

pac solution add-solution-component

Fügen Sie eine oder mehrere Lösungskomponenten zur nicht verwalteten Ziellösung in Dataverse hinzu.

Beispiel

Dieses Beispiel zeigt, wie eine Lösungskomponente einer vorhandenen Lösung hinzugefügt wird. In diesem Fall fügen wir der Lösung die Kontakttabelle SampleSolution hinzu. Eine Tabelle ist eine Komponente vom Typ 1.

pac solution add-solution-component --solutionUniqueName SampleSolution --component contact --componentType 1

Erforderliche Parameter für das Hinzufügen der Lösungskomponente

--component-c

Schemaname oder -ID der Komponente, die der Ziellösung hinzugefügt werden soll.

--componentType-ct

Der Wert, der die hinzugefügte Lösungskomponente darstellt

--solutionUniqueName-sn

Name der Lösung.

Optionale Parameter für das Hinzufügen der Lösungskomponente

--AddRequiredComponents-arc

Gibt an, ob andere Lösungskomponenten, die für die hinzugefügte Lösungskomponente erforderlich sind, auch der nicht verwalteten Lösung hinzugefügt werden sollen

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

--environment-env

Umgebungs-URL oder ID der Zielumgebung.

pac solution check

Ein Dataverse-Lösungsprojekt hochladen, das mit dem Power Apps Checker-Dienst validiert werden soll

Beispiel

pac solution check --path c:\Users\Documents\Solution.zip --outputDirectory c:\samplepackage --geo UnitedStates

Optionale Parameter für die Lösungsüberprüfung

--clearCache-cc

Löscht den Solution Checker-Enforcement-Cache für Ihren Mandanten von allen Datensätzen, die sich auf frühere Ergebnisse für Ihre Lösungen beziehen.

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

--customEndpoint-ce

Eine benutzerdefinierte URL als Power Apps Checker-Endpunkt angeben

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

--excludedFiles-ef

Dateien von der Analyse ausschließen. Als kommagetrennte Werte weitergeben

--geo-g

Welche geografische Instanz des Power Apps-Überprüfungsdiensts soll verwendet werden.

Verwenden Sie einen dieser Werte:

  • PreviewUnitedStates
  • UnitedStates
  • Europe
  • Asia
  • Australia
  • Japan
  • India
  • Canada
  • SouthAmerica
  • UnitedKingdom
  • France
  • SouthAfrica
  • Germany
  • UnitedArabEmirates
  • Switzerland
  • Norway
  • Singapore
  • Korea
  • Sweden
  • USGovernment
  • USGovernmentL4
  • USGovernmentL5DoD
  • China

--outputDirectory-o

Ausgabeverzeichnis

--path-p

Pfad, in dem sich eine oder mehrere der zu überprüfenden Lösungsdateien befindet. Der Pfad kann Glob-/Platzhalterzeichen enthalten.

--ruleLevelOverride-rl

Pfad zu einer Datei, die Regeln und Ebenen für ein JSON-Array enthält, die außer Kraft gesetzt werden sollen. Zulässige Werte für OverrideLevel sind: Critical, High, Medium, Low, Informational. Beispiel: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]

--ruleSet-rs

Wählen Sie einen Regelsatz aus, der als Teil dieses Builds ausgeführt wird. Werte: Eine gültige GUID, „AppSource-Zertifizierung“, „Lösungsüberprüfung“ (Standard).

--saveResults-sav

Verwendet die aktuelle Umgebung zum Speichern der Lösungsanalyseergebnisse, die in der Lösungsintegritätshub-App angezeigt werden können. Standardmäßig ist dieses Argument auf „false“ gesetzt.

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

--solutionUrl-u

SAS-URI, die auf solution.zip zum Analysieren zeigen

pac solution clone

Erstellen Sie ein Lösungsprojekt auf der Grundlage einer vorhandenen Lösung in Ihrer Organisation.

Beispiele

Die folgenden Beispiele zeigen die Verwendung des pac solution clone Befehls.

Grundlegendes Klonen

Dieses Beispiel klont die sampleSolution-Lösung in das aktuelle Verzeichnis.

pac solution clone --name sampleSolution

Klonen mit allgemeiner und automatischer Nummerierung enthalten

Dieses Beispiel klont die sampleSolution-Lösung in das aktuelle Verzeichnis und beinhaltet die allgemeine und automatische Nummerierung.

pac solution clone --name sampleSolution --include general,autonumbering

Erforderliche Parameter für den Lösungsklon

--name-n

Der Name der zu exportierenden Lösung

Optionale Parameter für den Lösungsklon

--async-a

Exportiert die Lösung asynchron

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

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

--include-i

Gibt an, welche Einstellungen in die Lösung einbezogen werden sollen, die exportiert wird

Verwenden Sie einen oder mehrere dieser Werte, durch Kommas getrennt:

  • autonumbering
  • calendar
  • customization
  • emailtracking
  • externalapplications
  • general
  • isvconfig
  • marketing
  • outlooksynchronization
  • relationshiproles
  • sales

--localize-loc

Extrahieren Sie alle Zeichenfolgenressourcen in .resx-Dateien, oder führen Sie sie zusammen.

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

--map-m

Der vollständige Pfad zu einer XML-Zuordnungsdatei, aus der Komponentenordner zum Packen gelesen werden sollen.

--max-async-wait-time-wt

Maximale asynchrone Wartezeit in Minuten. Der Standardwert ist 60 Minuten

--outputDirectory-o

Ausgabeverzeichnis

--packagetype-p

Gibt den Extraktionstyp für die Lösung an. Können sein: „nicht verwaltet“, „verwaltet“ oder „beides“. Der Standardwert ist: „Beides“.

--targetversion-v

Veraltet: Dieser Parameter wird ignoriert.

pac solution create-settings

Erstellen Sie eine Einstellungsdatei aus dem ZIP- oder Lösungsordner.

Beispiel

pac solution create-settings --solution-zip C:\SampleSolution.zip --settings-file .\SampleDeploymentSettingsDev.json

Optionale Parameter für die Erstellungseinstellungen der Lösung

--settings-file-s

Die .json-Datei mit den Bereitstellungseinstellungen für Verbindungsreferenzen und Umgebungsvariablen.

--solution-folder-f

Pfad zum lokalen, entpackten Lösungsordner: entweder der Stamm der Datei „Other/Solution.xml“ oder ein Ordner mit einer .cdsproj-Datei.

--solution-zip-z

Pfad zur ZIP-Datei der Lösung.

pac solution delete

Lösung aus Dataverse in der aktuellen Umgebung löschen

Beispiel

pac solution delete --solution-name Samplesolution

Erforderliche Parameter für das Löschen der Lösung

--solution-name-sn

Name der Lösung.

Optionale Parameter für das Löschen der Lösung

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

pac solution export

Eine Lösung von Dataverse exportieren.

Beispiel

pac solution export --path c:\Users\Documents\Solution.zip --name SampleComponentSolution --managed true --include general

Erforderliche Parameter für das Exportieren der Lösung

--name-n

Der Name der zu exportierenden Lösung

Optionale Parameter für den Lösungsexport

--async-a

Exportiert die Lösung asynchron

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

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

--include-i

Gibt an, welche Einstellungen in die Lösung einbezogen werden sollen, die exportiert wird

Verwenden Sie einen oder mehrere dieser Werte, durch Kommas getrennt:

  • autonumbering
  • calendar
  • customization
  • emailtracking
  • externalapplications
  • general
  • isvconfig
  • marketing
  • outlooksynchronization
  • relationshiproles
  • sales

--managed-m

Gibt an, ob die Lösung als verwaltete Lösung exportiert werden soll

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

--max-async-wait-time-wt

Maximale asynchrone Wartezeit in Minuten. Der Standardwert ist 60 Minuten

--overwrite-ow

Die exportierte Lösungsdatei kann die ZIP-Datei der Lösung im lokalen Dateisystem überschreiben.

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

--path-p

Pfad, in dem die ZIP-Datei für die exportierte Lösung geschrieben wird

--targetversion-v

Veraltet: Dieser Parameter wird ignoriert.

pac solution import

Importieren Sie die Lösung in Dataverse.

Beispiel

pac solution import --path c:\Users\Documents\Solution.zip

Optionale Parameter für den Lösungsimport

--activate-plugins-ap

Plug-Ins und Workflows für die Lösung aktivieren

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

--async-a

Importiert die Lösung asynchron

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

--convert-to-managed-cm

In eine verwaltete Lösung konvertieren

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

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

Eine Überschreibung nicht verwalteter Anpassungen erzwingen

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

--import-as-holding-h

Die Lösung als Aufbewahrungslösung importieren

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

--max-async-wait-time-wt

Maximale asynchrone Wartezeit in Minuten. Der Standardwert ist 60 Minuten

--path-p

Pfad zur ZIP-Datei der Lösung. Wenn nicht angegeben, wird davon ausgegangen, dass der aktuelle Ordner ein cdsproj-Projekt ist.

--publish-changes-pc

Ihre Änderungen bei einem erfolgreichen Import veröffentlichen

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

--settings-file

Die .json-Datei mit den Bereitstellungseinstellungen für Verbindungsreferenzen und Umgebungsvariablen.

--skip-dependency-check-s

Abhängigkeitsüberprüfung auf Abhängigkeiten überspringen, die als Produktupdate markiert sind

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

--skip-lower-version-slv

Lösungsimport überspringen, wenn in der aktuellen Umgebung dieselbe oder eine höhere Version vorhanden ist

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

--stage-and-upgrade-up

Importieren und aktualisieren Sie die Lösung.

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

Anmerkungen

Sie werden mit einer Umgebung mithilfe des Befehls pac auth verbunden, zur Verwendung von pac solution import.

pac solution import

Wenn der Parameter Path nicht angegeben ist, wird davon ausgegangen, dass es sich beim aktuellen Ordner um ein cdsproj-Projekt handelt. Wenn die Eigenschaft SolutionPackageType in der Datei cdsproj auf Both gesetzt ist, wird standardmäßig verwaltete Lösung verwendet.

convert-to-managed

Der Parameter convert-to-managed übernimmt keine nicht verwaltete Lösung und importiert sie als verwaltet. Dieser Parameter ermöglicht es einer verwaltete Lösung, die in eine Umgebung importiert wird, nicht verwaltete Komponenten in verwaltete umzuwandeln.

Wenn diese Kennzeichen nicht explizit festgelegt ist, lässt das Lösungssystem die Importanforderung fehlschlagen, da verwaltete Schichten nicht über nicht verwaltete Basiskomponenten liegen können. Dieser Switch ermöglicht einen erfolgreichen Lösungsimport und das Endergebnis ist, dass die eingehende verwaltete Lösung die Basisebene für jede dieser Komponenten ist – die Komponenten in der Zielumgebung werden von einer nicht verwalteten Komponente in eine verwaltete Komponente konvertiert.

pac solution init

Initialisiert ein Verzeichnis mit einem neuen Dataverse-Lösungsprojekt

Beispiel

pac solution init --publisher-name developer --publisher-prefix dev

Erforderliche Parameter für das Lösungs-init

--publisher-name-pn

Name des Dataverse-Lösungsherausgebers

Hinweis: Es sind nur Zeichen innerhalb der Bereiche [A – Z], [a – z], [0 – 9] oder _ zulässig. Das erste Zeichen darf nur in den Bereichen [A - Z], [a - z] oder _ sein.

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

Optionale Parameter für das Lösungs-init

--outputDirectory-o

Ausgabeverzeichnis

pac solution list

Alle Lösungen aus der aktuellen Dataverse-Organisation auflisten

Beispiel

pac solution list

Optionale Parameter für die Lösungsliste

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

--includeSystemSolutions

Integrieren Sie Systemlösungen wie die von Microsoft

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

--json

Gibt die Ausgabe des Befehls als JSON-formatierte Zeichenfolge zurück.

pac solution online-version

Legt die Version für die in Dataverse geladene Lösung fest.

Beispiel

pac solution online-version --solution-name Samplesolution --solution-version 1.0.0.2

Erforderliche Parameter für die Onlineversion der Lösung

--solution-name-sn

Name der Lösung.

--solution-version-sv

Geben Sie die Versionsnummer der Lösung an.

Optionale Parameter für die Onlineversion der Lösung

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

pac solution pack

Paketlösungskomponenten im lokalen Dateisystem nach solution.zip (SolutionPackager).

Beispiel

pac solution pack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

Erforderliche Parameter für das Lösungspaket

--zipfile-z

Der vollständige Pfad zur Lösungs-ZIP-Datei

Optionale Parameter für das Lösungspaket

--allowDelete-ad

Legt fest, ob Löschvorgänge zulässig sind. Der Standardwert ist „false“.

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

--allowWrite-aw

Legt fest, ob Schreibvorgänge zulässig sind. Der Standardwert ist „false“.

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

--clobber-c

Lässt zu, dass schreibgeschützte Dateien gelöscht oder überschrieben werden können. Der Standardwert ist „false“.

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

--disablePluginRemap-dpm

Deaktiviertes Plug-In: Neuzuordnung des vollqualifizierten Typnamens. Der Standardwert ist „false“.

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

--errorlevel-e

Mindestprotokollierungsebene für die Protokollausgabe [Verbose|Info|Warning|Error|Off]. Der Standardwert ist „Info“.

--folder-f

Der Pfad zum Stammordner im lokalen Dateisystem. Beim Entpacken oder Extrahieren wird darauf geschrieben. Beim Packen wird daraus gelesen.

--localize-loc

Extrahieren Sie alle Zeichenfolgenressourcen in .resx-Dateien, oder führen Sie sie zusammen.

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

--log-l

Der Pfad zur Protokolldatei.

--map-m

Der vollständige Pfad zu einer XML-Zuordnungsdatei, aus der Komponentenordner zum Packen gelesen werden sollen.

--packagetype-p

Verwenden Sie dies beim Entpacken oder Extrahieren, um einen dualen „Verwaltet“- und „Nicht verwaltet“-Vorgang anzugeben. Beim Entpacken zu verwenden, um „Verwaltet“ oder „Nicht verwaltet“ aus einem vorherigen Entpackvorgang „Beides“ zu verwenden. Können sein: „nicht verwaltet“, „verwaltet“ oder „beides“. Der Standardwert ist „Nicht verwaltet“.

--singleComponent-sc

Führen Sie die Aktion nur auf einem einzelnen Komponententyp aus [WebResource|Plugin|Workflow|None]. Der Standardwert ist „Keine“.

--sourceLoc-src

Generiert eine Vorlagenressourcendatei. Gültig nur beim Extrahieren. Mögliche Werte lauten „auto“ oder der Sprachcode der Sprache, die Sie exportieren möchten. Sie können die Sprachcode-ID (LCID) oder die Sprachcodeformate der Internationalen Organisation für Norming (ISO) verwenden. Liegen diese vor, werden die Zeichenfolgenressourcen aus dem angegebenen Gebietsschema als neutrale .resx-Datei extrahiert. Wenn „auto“ oder nur die lange oder kurze Form des Umschalters angegeben ist, wird das Basisgebietsschema für die Lösung verwendet.

--useLcid-lcid

Verwenden Sie die Sprachcode-ID-Werte (LCID-Werte – 1033) statt der Codes der Internationalen Organisation für Norming (ISO) (en-US) für Sprachdateien.

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

--useUnmanagedFileForMissingManaged-same

Verwendet die gleiche XML-Quelldatei beim Verpacken einer „verwalteten“ Datei, wenn nur eine „unverwaltete“ XML-Datei gefunden wird. Gilt für: AppModuleSiteMap, AppModuleMap, FormXml-Dateien.

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

pac solution publish

Veröffentlicht alle Anpassungen

Beispiel

pac solution publish

Optionale Parameter für die Lösungsveröffentlichung

--async-a

Veröffentlicht alle Anpassungen asynchron.

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

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

--max-async-wait-time-wt

Maximale asynchrone Wartezeit in Minuten. Der Standardwert ist 60 Minuten

pac solution sync

Synchronisieren Sie das aktuelle Dataverse-Lösungsprojekt mit dem aktuellen Status der Lösung in Ihrer Organisation.

Beispiele

Die folgenden Beispiele zeigen die Verwendung des pac solution sync Befehls.

Grundlegendes Synchronisieren

Dieses Beispiel synchronisiert die Lösung in das aktuelle Verzeichnis.

pac solution sync

Optionale Parameter für die Lösungssynchronisierung

--async-a

Exportiert die Lösung asynchron

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

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

--include-i

Gibt an, welche Einstellungen in die Lösung einbezogen werden sollen, die exportiert wird

Verwenden Sie einen oder mehrere dieser Werte, durch Kommas getrennt:

  • autonumbering
  • calendar
  • customization
  • emailtracking
  • externalapplications
  • general
  • isvconfig
  • marketing
  • outlooksynchronization
  • relationshiproles
  • sales

--localize-loc

Extrahieren Sie alle Zeichenfolgenressourcen in .resx-Dateien, oder führen Sie sie zusammen.

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

--map-m

Der vollständige Pfad zu einer XML-Zuordnungsdatei, aus der Komponentenordner zum Packen gelesen werden sollen.

--max-async-wait-time-wt

Maximale asynchrone Wartezeit in Minuten. Der Standardwert ist 60 Minuten

--packagetype-p

Verwenden Sie dies beim Entpacken oder Extrahieren, um einen dualen „Verwaltet“- und „Nicht verwaltet“-Vorgang anzugeben. Beim Entpacken zu verwenden, um „Verwaltet“ oder „Nicht verwaltet“ aus einem vorherigen Entpackvorgang „Beides“ zu verwenden. Können sein: „nicht verwaltet“, „verwaltet“ oder „beides“. Der Standardwert ist: „Beides“.

--solution-folder-f

Pfad zum lokalen, entpackten Lösungsordner: entweder der Stamm der Datei „Other/Solution.xml“ oder ein Ordner mit einer .cdsproj-Datei.

pac solution unpack

Lösungskomponenten aus solution.zip in das lokale Dateisystem extrahieren (SolutionPackager).

Beispiel

pac solution unpack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

Erforderliche Parameter für das Entpacken der Lösung

--zipfile-z

Der vollständige Pfad zur Lösungs-ZIP-Datei

Optionale Parameter für das Entpacken der Lösung

--allowDelete-ad

Legt fest, ob Löschvorgänge zulässig sind. Der Standardwert ist „false“.

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

--allowWrite-aw

Legt fest, ob Schreibvorgänge zulässig sind. Der Standardwert ist „false“.

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

--clobber-c

Lässt zu, dass schreibgeschützte Dateien gelöscht oder überschrieben werden können. Der Standardwert ist „false“.

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

--disablePluginRemap-dpm

Deaktiviertes Plug-In: Neuzuordnung des vollqualifizierten Typnamens. Der Standardwert ist „false“.

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

--errorlevel-e

Mindestprotokollierungsebene für die Protokollausgabe [Verbose|Info|Warning|Error|Off]. Der Standardwert ist „Info“.

--folder-f

Der Pfad zum Stammordner im lokalen Dateisystem. Beim Entpacken oder Extrahieren wird darauf geschrieben. Beim Packen wird daraus gelesen.

--localize-loc

Extrahieren Sie alle Zeichenfolgenressourcen in .resx-Dateien, oder führen Sie sie zusammen.

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

--log-l

Der Pfad zur Protokolldatei.

--map-m

Der vollständige Pfad zu einer XML-Zuordnungsdatei, aus der Komponentenordner zum Packen gelesen werden sollen.

--packagetype-p

Verwenden Sie dies beim Entpacken oder Extrahieren, um einen dualen „Verwaltet“- und „Nicht verwaltet“-Vorgang anzugeben. Beim Entpacken zu verwenden, um „Verwaltet“ oder „Nicht verwaltet“ aus einem vorherigen Entpackvorgang „Beides“ zu verwenden. Können sein: „nicht verwaltet“, „verwaltet“ oder „beides“. Der Standardwert ist „Nicht verwaltet“.

--singleComponent-sc

Führen Sie die Aktion nur auf einem einzelnen Komponententyp aus [WebResource|Plugin|Workflow|None]. Der Standardwert ist „Keine“.

--sourceLoc-src

Generiert eine Vorlagenressourcendatei. Gültig nur beim Extrahieren. Mögliche Werte lauten „auto“ oder der Sprachcode der Sprache, die Sie exportieren möchten. Sie können die Sprachcode-ID (LCID) oder die Sprachcodeformate der Internationalen Organisation für Norming (ISO) verwenden. Liegen diese vor, werden die Zeichenfolgenressourcen aus dem angegebenen Gebietsschema als neutrale .resx-Datei extrahiert. Wenn „auto“ oder nur die lange oder kurze Form des Umschalters angegeben ist, wird das Basisgebietsschema für die Lösung verwendet.

--useLcid-lcid

Verwenden Sie die Sprachcode-ID-Werte (LCID-Werte – 1033) statt der Codes der Internationalen Organisation für Norming (ISO) (en-US) für Sprachdateien.

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

--useUnmanagedFileForMissingManaged-same

Verwendet die gleiche XML-Quelldatei beim Verpacken einer „verwalteten“ Datei, wenn nur eine „unverwaltete“ XML-Datei gefunden wird. Gilt für: AppModuleSiteMap, AppModuleMap, FormXml-Dateien.

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

pac solution upgrade

Lösungsupgrade anwenden

Beispiel

pac solution upgrade --solution-name SampleSolution --async --max-async-wait-time 60

Erforderliche Parameter für das Lösungsupgrade

--solution-name-sn

Name der Lösung.

Optionale Parameter für das Lösungsupgrade

--async-a

Aktualisiert die Lösung asynchron

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

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

--max-async-wait-time-wt

Maximale asynchrone Wartezeit in Minuten. Der Standardwert ist 60 Minuten

pac solution version

Build- oder Revision-Version für die Lösung aktualisieren

Beispiel

pac solution version --patchversion 2
pac solution version --strategy gittags

Optionale Parameter für die Lösungsversion

--buildversion-bv

Buildversion für die Lösung

Hinweis: Der Wert muss eine Ganzzahl mit einem Mindestwert von 0 sein.

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

Veraltet: Dieser Parameter wird ignoriert.

--revisionversion-rv

Revision-Version für die Lösung

Hinweis: Der Wert muss eine Ganzzahl mit einem Mindestwert von 0 sein.

--solutionPath-sp

Pfad zum Dataverse Projektmappenverzeichnis oder zur Solution.xml-Datei.

--strategy-s

Aktualisiert die Build-Version für die „Solution.xml“-Datei mit der angegebenen Strategie. Wenn Sie Git-Tags verwenden, legen Sie das persönliche Zugriffstoken in der folgenden Umgebungsvariable auf „PacCli.PAT“ fest

Verwenden Sie einen dieser Werte:

  • None
  • GitTags
  • FileTracking
  • Solution

Unterschiede zwischen Klonen und Exportieren von Pac-Lösungen

Es gibt Situationen, in denen Sie sich nicht sicher sind, ob Sie den Befehl pac solution clone oder pac solution export verwenden sollen. Sie können einen der Befehle in den folgenden Szenarien verwenden:

  • Verwenden Sie pac solution clone, wenn Sie der Lösung neue Komponenten hinzufügen müssen.
  • Verwenden Sie pac solution export, wenn Sie den vorhandenen Inhalt in einer Lösungsdatei ändern, aber der Lösung keine neuen Komponenten hinzufügen möchten.

pac solution clone

Die exportierte Lösung sieht wie ein Visual Studio-Projekt aus, wenn Sie die Lösung mit dem pac solution clone-Befehl exportieren. Anstelle einer .csproj- (wie in Visual Studio) sehen Sie eine cdsproj-Datei. Die cdsproj-Datei enthält alle Komponenteninformationen, die zum Erstellen des Projekts erforderlich sind. Die Buildausgabe ist eine Lösungs-ZIP-Datei, die Sie in verschiedene Umgebungen importieren können.

Klon der Pac-Lösung.

Der Entwickler muss die geklonte Lösung nicht entpacken, da sie in einem entpackten Format im src-Ordner (Quelle) gerendert wird.

Pac-Lösung wird entpackt.

Wenn Sie nun ein neu erstelltes Plug-In mit dieser Lösung verknüpfen möchten, können Sie bei entpackter Lösung den pac solution add-reference-Befehl zum Aktualisieren der .cdsproj-Datei verwenden, um das neue Plug-In hinzuzufügen. Dann können Sie das Projekt entweder mit dotnet build oder msbuild erstellen.

Es wird empfohlen, zuerst eine Build-Wiederherstellung durchzuführen, bevor Sie das Projekt erstellen. Eine Build-Wiederherstellung (dotnet Build führt zuerst automatisch eine Wiederherstellung durch) stellt die erforderlichen .NET-Bibliotheken wieder her, um eine gepackte Lösung zu generieren.

pac solution export

Beim Exportieren der Lösung mit pac solution export möchten Sie die Lösung über das Enwicklerportal exportieren, und die resultierende Ausgabe ist eine Lösungs-ZIP-Datei.

Export der Pac-Lösung.

Wenn Sie die ZIP-Datei der Lösung entpacken (wir empfehlen nicht, die ZIP-Datei mit Standardtools zu öffnen und den entsprechenden Befehl von CLI zu verwenden). Die resultierende Verzeichnisstruktur ähnelt der Struktur in pac solution clone. Der einzige Unterschied besteht darin, dass Sie dieser entpackten Lösung keine Verweise hinzufügen können, da sie nicht die .cdsproj-Projektdatei hat.

Pac-Lösungsstruktur.

Sie können die relevanten Dateien, die Sie aktualisieren möchten, ändern und dann mit dem Lösungspaket fortfahren, das die Lösungs-ZIP-Datei erneut generiert, um den Import der Lösung in die Zielumgebung zu erleichtern. Das Ergebnis der Aktion ist eine Lösungs-ZIP-Datei mit aktualisiertem Inhalt und einem aktualisierten Zeitstempel.

Siehe auch

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