Microsoft Power Platform CLI-Unterstützung für Power Pages

Microsoft Power Platform CLI (Befehlszeilenschnittstelle) ist eine einfache, einstufige Entwickler-Befehlszeilenschnittstelle, mit der Entwickler und App-Entwickler Codekomponenten erstellen können.

Microsoft Power Platform CLI-Werkzeuge sind der erste Schritt hin zu einer umfassenden ALM-Geschichte (Application Life Cycle Management), in der Unternehmensentwickler und ISVs schnell und effizient ihre Erweiterungen und Anpassungen erstellen, bauen, debuggen und veröffentlichen können. Weitere Informationen hierzu: Was ist Microsoft Power Platform CLI?

Mit dieser Funktion ermöglicht die Microsoft Power Platform CLI die CI/CD (kontinuierliche Integration/Continuous Bereitstellung) einer Power Pages-Websitekonfiguration. Sie können jetzt die Websitekonfiguration zur Quellcodeverwaltung einchecken und die Websitekonfiguration mithilfe der Microsoft Power Platform CLI in eine beliebige Umgebung verschieben.

Warum microsoft Power Platform CLI für die Websiteentwicklung verwenden?

Mit der Microsoft Power Platform CLI können Sie jetzt offline-ähnliche Funktionen für die Websiteanpassung verwenden, indem Sie Änderungen an den Websiteinhalten vornehmen. Und sobald alle Anpassungen oder Änderungen gespeichert wurden, können Sie die Websitekonfiguration wieder auf Microsoft Dataverse hochladen. Wenn Sie Websiteinhalte mithilfe der Microsoft Power Platform CLI herunterladen, ist der Inhalt in YAML- und HTML-Formaten strukturiert, sodass sie einfach angepasst werden können und so eine Pro-Development-Erfahrung ermöglicht.

Hier finden Sie eine Liste der Features und Funktionen, von denen Portale mit der Unterstützung von Microsoft Power Platform CLI profitieren:

Einfache Bedienung

• Unterstützung für den Download/Upload von Websitekonfigurationsdaten in/aus dem lokalen Dateisystem

• Bauen Sie auf dem vorhandenen Microsoft Power Platform CLI-Tool auf.

Application Lifecycle Management (ALM)

• Nachverfolgen von Änderungen an der Websitekonfiguration innerhalb einer Organisation

• Konfigurationsdateien zwischen Organisationen oder Mandanten verschieben

Pro-Dev- und Enterprise-Support

• Hilft bei der nahtlosen Integration in alle Quellcodeverwaltungstools, z. B. "git".

• Einfaches Einrichten von CI/CD-Pipelines

Installieren der Microsoft Power Platform CLI

Schrittweise Anleitungen finden Sie unter Installieren der Microsoft Power Platform CLI.

Unterstützte Tabellen

Die Portalunterstützung für Microsoft Power Platform CLI ist auf die folgenden Tabellen beschränkt.

Installieren und Überprüfen der Microsoft Power Platform CLI für Portale

Informationen zum Installieren der Microsoft Power Platform CLI finden Sie unter Installieren der Microsoft Power Platform CLI.

Öffnen Sie nach der Installation der Microsoft Power Platform CLI eine Eingabeaufforderung, und führen Sie pac aus, um zu überprüfen, ob die Ausgabe "paportal" enthält – den Befehl für Power Apps-Portale.

Microsoft Power Platform CLI-Befehle für Portale

Microsoft Power Platform CLI-Befehl für Portale ist "paportal".

Die folgenden Abschnitte enthalten weitere Details zu verschiedenen Eigenschaften des Befehls "paportal" .

Parameter

Verwenden des Bereitstellungsprofils

Mit dem deploymentProfile-Switch können Sie einen Satz von Variablen für die Umgebung im YAML-Format definieren. Sie können z. B. unterschiedliche Bereitstellungsprofile (z. B. Dev, Test, Prod) haben, die unterschiedliche Schemadetails im Profil definiert haben.

Wenn Sie ein Testprofil erstellen, können Sie eine Datei unter Bereitstellungsprofilen mit dem Namen "test.deployment.yml" (d. b <. profileTag>.deployment.yml) erstellen. Und Sie können befehl mit Tag (<profileTag>) ausführen, um dieses Profil zu verwenden:

pac pages upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2

In dieser Datei können Sie den Tabellennamen (Entitätsname) mit Der Tabellen-ID, der Liste der Attribute und den Werten haben, die Sie beim Hochladen der Portalkonfiguration mithilfe des deploymentProfile Parameters außer Kraft setzen möchten.

Darüber hinaus können Sie die OS Variable verwenden, um auf die Umgebungsvariablen des Betriebssystems zuzugreifen.

Hier sehen Sie ein Beispiel für diese YAML-Profildatei "test.deployment.yml", die eindeutige Schemadetails enthält:

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

Manifestdateien

Wenn Sie die Website-Inhalte mit dem CLI-Befehl pac pages download herunterladen, werden dabei auch zwei Manifestdateien generiert.

• Umgebungsmanifestdatei (org-url-manifest.yml)
• Tracking-Manifestdatei löschen (manifest.yml)

Umgebungsmanifestdatei (org-url-manifest.yml)

Die Umgebungsmanifestdatei wird jedes Mal generiert, wenn der pac pages download-Befehl ausgeführt wird.

Nach jedem Download liest das PAC CLI-Tool die vorhandene Umgebungsmanifestdatei und aktualisiert die einträge, die in der Umgebung gelöscht wurden, oder erstellt die Umgebungsmanifestdatei, falls sie nicht vorhanden ist.

Wenn Sie den Befehl "PAC-Seiten hochladen " ausführen, um den Inhalt der Portalwebsite hochzuladen. Sie liest die Umgebungsmanifestdatei und identifiziert die seit dem letzten Download vorgenommenen Änderungen und lädt nur den aktualisierten Inhalt hoch. Dies hilft beim Optimieren des Uploadvorgangs, da nur aktualisierte Websiteinhalte hochgeladen werden, anstatt den gesamten Inhalt in jedem Uploadbefehl hochzuladen.

Die Datei des Umgebungsmanifests ist nur lesbar, wenn sie eine Verbindung mit derselben Umgebung herstellt (die URL der Umgebung stimmt mit dem Dateinamen überein), um versehentliche Änderungen zu vermeiden.

Tracking-Manifestdatei löschen (manifest.yml)

Diese Datei wird zum Nachverfolgen der gelöschten Datensätze aus der Umgebung verwendet.

Wenn Websiteinhalte mit dem Befehl pac pages download heruntergeladen werden, fügt dies die gelöschten Datensätze aus der Umgebungsmanifestdatei (org-url-manifest.yml) der Datei manifest.yml hinzu. Wenn Sie also den Websiteinhalt mithilfe des Pac-Seiten-Uploadbefehls hochladen, werden die Dateien aus der Umgebung (auch in eine andere Umgebung) gelöscht. Diese Datei wird nicht gelöscht, und sie wird unabhängig davon verwendet, welche Umgebung Sie verbunden haben. Diese Datei muss berücksichtigt werden, wenn Änderungen an die Quellcodeverwaltung übertragen werden, um das Löschen von Elementen in der Zielumgebung zu erwägen.

Die Visual Studio Code-Erweiterung verwenden

Sie können auch die VS Code-Erweiterung Power Platform VS Code Extension verwenden, um von integrierten Funktionen wie der Liquid-Sprache von IntelliSense, Code-Vervollständigung, Hinweisen zu profitieren und mit dem Microsoft Power Platform CLI im integrierten VS Code-Terminal zu interagieren. Weitere Informationen: Verwenden der Visual Studio Code-Erweiterung (Vorschau)

Weitere Überlegungen

• Ein Fehler wird gemeldet, wenn der Dateipfad die maximale Pfadlängenbeschränkung überschreitet. Weitere Informationen: Maximale Einschränkung der Pfadlänge in Windows
• Bei doppelten Datensätzen wie einem doppelten Webseitennamen erstellt Microsoft Power Platform CLI zwei unterschiedliche Ordner – eine mit dem Namen der Webseite und die andere mit demselben Namen, der einem Hashcode vorangestellt ist. Beispiel: "My-page" und "My-page-hash-code".

Nächste Schritte

Lernprogramm: Verwenden der Microsoft Power Platform CLI mit Portalen

Siehe auch

• Microsoft Power Platform CLI
• Verwenden der Visual Studio Code-Erweiterung (Vorschau)