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 | Lösungsupgrade anwenden |
| 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 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
--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:
PreviewUnitedStatesUnitedStatesEuropeAsiaAustraliaJapanIndiaCanadaSouthAmericaUnitedKingdomFranceSouthAfricaGermanyUnitedArabEmiratesSwitzerlandNorwaySingaporeKoreaUSGovernmentUSGovernmentL4USGovernmentL5DoDChina
--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
- Klon mit allgemeiner und automatischer Nummerierung enthalten
- Klon mit der Canvas-App entpacken
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
Klonen mit Entpacken der Canvas-App
Dieses Beispiel klont die sampleSolution-Lösung und entpackt die Canvas-Apps in einem Zug.
pac solution clone --name sampleSolution --processCanvasApps
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:
autonumberingcalendarcustomizationemailtrackingexternalapplicationsgeneralisvconfigmarketingoutlooksynchronizationrelationshiprolessales
--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.
--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“.
--processCanvasApps -pca
(Vorschauversion) Alle Canvas-Apps (.msapp) beim Verarbeiten der Lösung packen/entpacken. Der Standardwert ist „false“.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--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:
autonumberingcalendarcustomizationemailtrackingexternalapplicationsgeneralisvconfigmarketingoutlooksynchronizationrelationshiprolessales
--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.
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: Nur die folgenden Zeichen innerhalb der Bereiche [A - Z], [a - z], [0 - 9] oder _ sind 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.
--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“.
--processCanvasApps -pca
(Vorschauversion) Alle Canvas-Apps (.msapp) beim Verarbeiten der Lösung packen/entpacken. Der Standardwert ist „false“.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--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
Synchronisieren mit Entpacken der Canvas-App
Dieses Beispiel synchronisiert die Lösung mit dem aktuellen Verzeichnis und entpackt die Canvas-Apps in einem Zug.
pac solution sync --processCanvasApps
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:
autonumberingcalendarcustomizationemailtrackingexternalapplicationsgeneralisvconfigmarketingoutlooksynchronizationrelationshiprolessales
--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.
--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“.
--processCanvasApps -pca
(Vorschauversion) Alle Canvas-Apps (.msapp) beim Verarbeiten der Lösung packen/entpacken. Der Standardwert ist „false“.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--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“.
--processCanvasApps -pca
(Vorschauversion) Alle Canvas-Apps (.msapp) beim Verarbeiten der Lösung packen/entpacken. Der Standardwert ist „false“.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--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 ein Integer 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 ein Integer 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:
NoneGitTagsFileTrackingSolution
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.
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 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.
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 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