Microsoft Power Platform CLI-Support für Power Pages

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

Microsoft Power Platform CLI-Tooling ist der erste Schritt zu einem umfassenden Application Life Cycle Management (ALM), bei dem Unternehmensentwickler und ISVs ihre Erweiterungen und Anpassungen schnell und effizient erstellen, bauen, debuggen und veröffentlichen können. Weitere Informationen finden Sie unter Was ist Microsoft Power Platform CLI?

Mit dieser Funktion aktiviert Microsoft Power Platform CLI CI/CD (Continuous Integration/Continuous Deployment) auf einer Power Pages-Websitekonfiguration. Sie können jetzt die Websitekonfiguration in die Quellcodeverwaltung einchecken und die Websitekonfiguration mithilfe der Microsoft Power Platform CLI in jede Umgebung verschieben.

Anmerkung

• Diese Funktion ist allgemein ab der Power Platform CLI-Version 1.9.8 verfügbar. Wie Sie die neueste Version installieren, erfahren Sie unter Installation von Microsoft Power Platform CLI.
• Ab der Power Platform-CLI-Version 1.27 wird der pac paportal-Befehl in pac powerpages geändert. paportal wird weiterhin funktionieren, wir empfehlen jedoch, in Zukunft powerpages zu verwenden. Dieser Artikel wird in Kürze aktualisiert, damit darin powerpages anstelle von paportal verwendet wird.

Warum sollte ich Microsoft Power Platform CLI für die Entwicklung von Websites verwenden?

Mit der Microsoft Power Platform CLI können Sie jetzt offline-ähnliche Funktionen für die Website-Anpassungen verwenden, indem Sie Änderungen am Website-Inhalt vornehmen. Und sobald alle Anpassungen oder Änderungen gespeichert sind, Sie können die Websitekonfiguration wieder zu Microsoft Dataverse hochladen. Wenn Sie Website-Inhalte mit Microsoft Power Platform CLI herunterladen, ist der Inhalt in YAML- und HTML-Formaten strukturiert, sodass er leicht angepasst werden kann und eine entwicklungsfreundliche Erfahrung bietet.

Hier ist eine Liste von Funktionen und Fähigkeiten, von denen Portale mit der Unterstützung Microsoft Power Platform CLI profitieren:

Einfache Verwendung

• Unterstützung für das Herunterladen/Hochladen von Website-Konfigurationsdaten zum/vom lokalen Dateisystem

• Aufbau auf dem bestehenden Microsoft Power Platform CLI-Tool.

Application Lifecycle Management (ALM)

• Verfolgen Sie Änderungen an der Websitekonfiguration innerhalb einer Organisation

• Verschieben von Konfigurationsdateien zwischen Organisationen oder Mandanten

Unterstützung für Profientwickler und Unternehmen

• Hilft bei der nahtlosen Integration mit allen Quellcodeverwaltungstools wie „git“

• Einfache Einrichtung von CI/CD-Pipelines

Microsoft Power Platform CLI installieren

Schritt-für-Schritt-Anleitungen finden Sie unter Installieren von Microsoft Power Platform CLI.

Unterstützte Tabellen

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

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding (nur herunterladen)

adx_websitelanguage

adx_webtemplate

Anmerkung

Wichtig

• Benutzerdefinierte Tabellen und portalvorlagenspezifische Tabellen (wie Blog-, Community- oder Ideenportal) werden für die Anpassung mit Microsoft Power Platform CLI nicht unterstützt.
• Bilddateianhänge für Anzeigendatensätze (adx_ad) werden nicht mit der Power Platform-CLI heruntergeladen. Verwenden Sie als Problemumgehung das Bild URL-Feld oder durch Hinzufügen einer HTML-Referenz im Kopieren-Feld zu einem Web-Datei-Datensatz, der eine Bilddatei enthält.

Microsoft Power Platform CLI für Portale installieren und überprüfen

Mehr über die Installation von Microsoft Power Platform CLI erfahren Sie unter Microsoft Power Platform CLI installieren.

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

Microsoft Power Platform CLI-Befehle für Portale

Der Microsoft Power Platform CLI-Befehl für Portale ist „paportal“.

In den folgenden Abschnitten finden Sie zusätzliche Details zu den verschiedenen Eigenschaften des „paportal“ Befehls.

Parameter

Eigenschaftsname	Beschreibung	Beispiel
list	Listen Sie alle Portal-Webseiten aus der aktuellen Dataverse-Umgebung auf. Sie können den Parameter -v hinzufügen, um anzugeben, ob die Website das standardmäßige oder das erweiterte Datenmodell verwendet	pac paportal list
download	Laden Sie den Inhalt der Portal-Website aus der aktuellen Dataverse-Umgebung herunter. Verfügt über die folgenden Parameter: - path: Pfad, zu dem der Website-Inhalt heruntergeladen wird (Alias: -p) - webSiteId: Portal-Website-ID, die heruntergeladen werden soll (Alias: -id) - überschreiben: (Optional) wahr – um vorhandenen Inhalt zu überschreiben, falsch – um fehlzuschlagen, wenn der Ordner bereits Website-Inhalt hat (Alias: -o) - modelVersion: 1 oder 2, um anzugeben, ob die Websitedaten, die heruntergeladen werden sollen, das Standard-Datenmodell (1) oder das erweiterte Datenmodell (2) verwenden.	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
upload	Hochladen von Portal-Website-Inhalten in die aktuelle Dataverse-Umgebung. Es hat die folgenden Parameter: - Pfad: Pfad, in dem der Website-Inhalt gespeichert ist (Alias: -p) - deploymentProfile: Portaldaten mit Umgebungsdetails hochladen, die durch Profilvariablen in der Datei deployment-profiles/[profile-name].deployment.yaml definiert wurden - modelVersion: 1 oder 2, um anzugeben, ob die Websitedaten, die hochgeladen werden sollen, das Standard-Datenmodell (1) oder das erweiterte Datenmodell (2) verwenden.	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Bereitstellungsprofil verwenden

Der Bereitstellungsprofil Wechsler kann eine Reihe von Variablen für die Umgebung im YAML-Format definieren. Sie können beispielsweise unterschiedliche Bereitstellungsprofile (wie dev, Test, prod) haben, für die unterschiedliche Schemadetails im Profil definiert sind.

Wenn Sie ein Testprofil erstellen, können Sie eine Datei unter Bereitstellungsprofile mit dem Namen „test.deployment.yml“ (d. h. <profileTag>.deployment.yml) verwenden. Und Sie können den Befehl mit dem Tag (<profileTag>) ausführen, um dieses Profil zu verwenden:

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

In dieser Datei können Sie den Tabellen-(Entitäts-)Namen mit der Tabellen-ID, die Liste der Attribute und die Werte haben, die Sie beim Hochladen der Portalkonfiguration deploymentProfile Parameter überschreiben möchten.

Zusätzlich können Sie die OS Variable verwenden, um auf die Umgebungsvariablen des Betriebssystems zuzugreifen.

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

Anmerkung

Um mehr über alle Befehle zu erfahren, die in CLI zusätzlich zu Portalen verwendet werden, gehen Sie zu Häufige Befehle in Microsoft Power Platform CLI.

Manifestdateien

Wenn Sie den Website-Inhalt mit dem CLI-Befehl pac paportal download herunterladen, werden zusammen mit dem Herunterladen des Website-Inhalts auch zwei Manifestdateien generiert.

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

Umgebungsmanifestdatei (org-url-manifest.yml)

Die Manifestdatei der Umgebung wird jedes Mal generiert, wenn der pac paportal download-Befehl ausgeführt wird.

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

Beim Ausführen des pac paportal upload-Befehls zum Hochladen des Inhalts der Portal-Website. Es liest die Umgebungsmanifestdatei und identifiziert die seit dem letzten Download vorgenommenen Änderungen und lädt nur die aktualisierten Inhalte hoch. Dies hilft bei der Optimierung des Upload-Prozesses, da nur aktualisierte Website-Inhalte hochgeladen werden, anstatt den gesamten Inhalt bei jedem Upload-Befehl hochzuladen.

Die Umgebungsmanifestdatei ist schreibgeschützt, wenn eine Verbindung mit derselben Umgebung hergestellt wird (Umgebungs-URL stimmt mit Dateinamen überein), um versehentliche Änderungen zu vermeiden.

Anmerkung

• Die Umgebungsmanifestdatei ist nicht dafür gedacht, die Änderungen beim Bereitstellen der Website in verschiedenen Umgebungen zu verfolgen.
• Die Umgebungsmanifestdatei ist für Entwickler gedacht, die sie lokal in ihrer Entwicklerumgebung bereitstellen möchten, und sollte zur Git-Ignorierliste hinzugefügt werden.

Tracking-Manifestdatei löschen (manifest.yml)

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

Wenn Website-Inhalte mit dem Befehl pac paportal download heruntergeladen werden, werden die gelöschten Datensätze aus der Umgebungsmanifestdatei (org-url-Manifest.yml) zur Datei manifest.yml hinzugefügt. Wenn Sie also den Website-Inhalt mit dem Befehl pac paportal upload hochladen, werden die Dateien aus der Umgebung gelöscht (auch in eine andere Umgebung). Diese Datei wird nicht gelöscht und wird unabhängig von der Umgebung, mit der Sie verbunden sind, verwendet. Diese Datei muss beim Übertragen von Änderungen in das Steuerelement berücksichtigt werden, um das Löschen von Elementen in der Zielumgebung zu berücksichtigen.

Anmerkung

Um die Website-Inhaltsdatensätze in einer Umgebung zu löschen und dieselben Inhaltsdatensätze in einer anderen Umgebung mit der PAC-CLI zu löschen, müssen Sie den pac paportal download-Befehl vor und nach dem Löschen des Website-Datensatzinhalts verwenden. Die manifest.yml verfolgt diese Änderungen und entfernt die entsprechenden Datensätze in der Zielumgebung, wenn der pac paportal upload-Befehl ausgeführt wird.

Erweiterung von Visual Studio Code verwenden

Sie können auch die VS Code-Erweiterung Power Platform VS Code-Erweiterung verwenden, um die integrierte Liquid-Sprache von IntelliSense zu nutzen, Hilfe bei der Codevervollständigung zu erhalten, Hinweise zu nutzen und mit dem Microsoft Power Platform CLI mit dem integrierten VS Code-Terminal zu interagieren. Weitere Informationen: Erweiterung von Visual Studio Code verwenden (Vorschauversion)

Weitere Überlegungen

• Ein Fehler wird gemeldet, wenn Ihr Dateipfad die Beschränkung der maximalen Pfadlänge überschreitet. Weitere Informationen: Begrenzung der maximalen Pfadlänge in Windows
• Bei doppelten Datensätzen, wie einem doppelten Webseitennamen, erstellt Microsoft Power Platform CLI zwei verschiedene Ordner – einen mit dem Namen der Webseite und einen anderen mit demselben Namen, dem ein Hashcode vorangestellt ist. Zum Beispiel „Meine Seite“ und „Meine Seite-Hash“.

Nächste Schritte

Tutorial: Microsoft Power Platform CLI mit Portalen verwenden

Siehe auch

• Microsoft Power Platform CLI
• Erweiterung von Visual Studio Code verwenden (Vorschauversion)