pac solution

Befehle zum Arbeiten mit Dataverse-Lösungsprojekten

Befehle

Command	Beschreibung
pac solution add-license	Der Lösung Lizenz- und Planinformationen hinzufügen
pac solution add-reference	Fügt einen Verweis aus dem Projekt im aktuellen Verzeichnis zum Projekt unter „Pfad“ hinzu.
pac solution add-solution-component	Fügen Sie eine oder mehrere Lösungskomponenten zur nicht verwalteten Ziellösung in Dataverse hinzu.
pac solution check	Ein Dataverse-Lösungsprojekt hochladen, das mit dem Power Apps Checker-Dienst validiert werden soll
pac solution clone	Erstellen Sie ein Lösungsprojekt auf der Grundlage einer vorhandenen Lösung in Ihrer Organisation.
pac solution create-settings	Erstellen Sie eine Einstellungsdatei aus dem ZIP- oder Lösungsordner.
pac solution delete	Lösung aus Dataverse in der aktuellen Umgebung löschen
pac solution export	Eine Lösung von Dataverse exportieren.
pac solution import	Importieren Sie die Lösung in Dataverse.
pac solution init	Initialisiert ein Verzeichnis mit einem neuen Dataverse-Lösungsprojekt
pac solution list	Alle Lösungen aus der aktuellen Dataverse-Organisation auflisten
pac solution online-version	Legt die Version für die in Dataverse geladene Lösung fest.
pac solution pack	Paketlösungskomponenten im lokalen Dateisystem nach solution.zip (SolutionPackager).
pac solution publish	Veröffentlicht alle Anpassungen
pac solution sync	Synchronisieren Sie das aktuelle Dataverse-Lösungsprojekt mit dem aktuellen Status der Lösung in Ihrer Organisation.
pac solution unpack	Lösungskomponenten aus solution.zip in das lokale Dateisystem extrahieren (SolutionPackager).
pac solution upgrade	Anwenden solution upgrade
pac solution version	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 solution add-license

--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 solution add-reference

--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 solution add-solution-component

--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 solution add-solution-component

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

--async -a

Importiert die Lösung asynchron

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

--clearCache -cc

Löscht den solution checkErzwingungscache für Ihren Mandanten aller Datensätze, die zu früheren Ergebnissen für Ihre Lösungen gehören.

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, "Marketplace-Zertifizierung", "Lösungsprü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.

• Basisklon
• Klonen mit allgemeinen und automatischen Nummerierungseinstellungen

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

--name -n

Der Name der zu exportierenden Lösung

Optionale Parameter für solution clone

--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 solution create-settings

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

--solution-name -sn

Name der Lösung.

Optionale Parameter für solution delete

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

--name -n

Der Name der zu exportierenden Lösung

Optionale Parameter für solution export

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

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

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

Überspringen Sie solution import , wenn die gleiche oder höhere Version in der aktuellen Umgebung 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 sind mithilfe des pac zu verwendenden pac solution importAuthentifizierungsbefehls mit einer Umgebung verbunden.

pac solution import

Wann Path Der Parameter ist nicht angegeben. Es wird davon ausgegangen, dass der aktuelle Ordner ein CDSPROJ-Projekt ist. Wenn das SolutionPackageType Die Eigenschaft in der cdsproj-Datei ist auf Both, standardmäßig wird verwaltete Lösung verwendet.

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

--publisher-name -pn

Name des Dataverse solution publisher

Notiz : 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 dataverse solution publisher

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

--outputDirectory -o

Ausgabeverzeichnis

pac solution list

Alle Lösungen aus der aktuellen Dataverse-Organisation auflisten

Beispiel

pac solution list

Optionale Parameter für solution list

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

Systemlösungen wie die von Microsoft veröffentlichten einbeziehen

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 solution online-version

--solution-name -sn

Name der Lösung.

--solution-version -sv

Geben Sie die solution version Nummer an.

Optionale Parameter für solution online-version

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

--zipfile -z

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

Optionale Parameter für solution pack

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

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

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

--zipfile -z

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

Optionale Parameter für solution unpack

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

Anwenden solution upgrade

Beispiel

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

Erforderliche Parameter für solution upgrade

--solution-name -sn

Name der Lösung.

Optionale Parameter für solution upgrade

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

--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 pac solution clone und Export

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.

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

Wenn Sie nun ein neu erstelltes Plug-In mit dieser Lösung verknüpfen möchten, können Sie mit dem solution unpackpac solution add-reference Befehl die .cdsproj Datei aktualisieren, 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.

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.

Sie können den relevanten Satz von Dateien ändern, die Sie aktualisieren möchten, und dann mit der solution packZip-Datei der Lösung fortfahren, um das Importieren 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