Tutorial: Microsoft Power Platform CLI mit Power Pages verwenden

  • Artikel

In diesem Beispieltutorial lernen Sie, wie Sie beginnen, mit Microsoft Power Platform CLI Beispielwebsitekonfigurationen zu aktualisieren.

Anmerkung

  • Dieses Tutorial konzentriert sich auf die erforderlichen Microsoft Power Platform CLI-Befehle für die Nutzung von Power Pages. Weitere Informationen zu Befehlen, die in Power Platform CLI verwendet werden, finden Sie unter Häufige Befehle.
  • 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.

Visual Studio Code herunterladen und installieren

Um sich mit Power Apps-Portalen zu verbinden und Microsoft Power Platform CLI-Befehle zu verwenden, nutzen Sie Visual Studio Code und das integrierte Terminal. Das integrierte Terminal erleichtert den Anschluss an die Dataverse Umgebung und zum Herunterladen, Ändern und Hochladen der Portalkonfiguration. Sie können stattdessen auch Windows PowerShell verwenden.

Schritt 1. Authentifizieren

Bevor Sie eine Verbindung herstellen, Änderungen für ein Power Apps-Portal auflisten, herunter- oder hochladen, müssen Sie sich bei der Dataverse-Umgebung authentifizieren. Weitere Informationen zur Authentifizierung mit der Microsoft Power Platform-CLI finden Sie unter pac auth.

Öffnen Sie zur Authentifizierung Windows PowerShell und führen Sie den pac auth create-Befehl mit der URL Ihrer Dataverse-Umgebung aus:

pac auth create -u [Dataverse URL]

Beispiel

pac auth create -u https://contoso-org.crm.dynamics.com

Befolgen Sie die Aufforderungen zur Authentifizierung, um sich bei der Umgebung anzumelden.

Beispiel für die Authentifizierung bei einer Dataverse-Umgebung mit Microsoft Power Platform CLI

Schritt 2. Liste der verfügbaren Websites

Verwenden Sie den Befehl Pac-Portal auflisten zum Auflisten der verfügbaren Power Pages-Websites in der Dataverse-Umgebung, mit der Sie sich im vorherigen Schritt verbunden haben.

pac paportal list

Beispiel einer Liste von Websites.

Schritt 3. Website-Inhalt herunterladen

Laden Sie den Inhalt der Website aus der verbundenen Dataverse-Umgebung mit dem pac paportal download Befehl herunter.

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Beispiel

pac paportal download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

Benutzen Sie für den ID-Parameter die Website-ID, die im vorherigen Schritt zurückgegeben wurde.

Von der Sprachausgabe verwendeter Text.

Schritt 4. Website-Inhalt ändern

Ändern Sie die Konfiguration mit Visual Studio Code und speichern Sie Ihre Änderungen.

Anmerkung

Stellen Sie sicher, dass Sie nur die für die Verwendung mit Power Platform CLI unterstützen Tabellen aktualisieren. Weitere Informationen finden Sie unter Unterstützte Tabellen.

Die Standardportalseite zeigt beispielsweise Text wie diesen:

Beispiel Portalseitentext

Dieser Text ist auf der Webseite html sichtbar:

Visual Studio Code mit hervorgehobenem Text zum Ändern.

Sie können diesen Text ändern und die Änderungen speichern:

Aktualisierter Text mit Visual Studio Code.

Tipp

Sie können den Speicherort des Ordnerpfads in PowerShell bzw. dem integrierten Terminal in den heruntergeladenen Speicherort ändern und code eingeben, um den Ordner direkt in Visual Studio Code zu öffnen.

Schritt 5. Hochladen der Änderungen

Anmerkung

  • Wenn Sie in mehrere Umgebungen hochladen, erfahren Sie unter Änderungen mit Hilfe des Bereitstellungsprofils hochladen, wie Sie Änderungen mit Hilfe des Bereitstellungsprofils hochladen können.
  • Stellen Sie sicher, dass die maximale Anhangsgröße der Zielumgebung auf dieselbe oder eine größere Größe als Ihre Quellumgebung eingestellt ist.
  • Die maximale Größe der Dateien wird durch die Einstellung maximale Dateigröße in der Registerkarte Systemeinstelllungen-E-Mail im Dialogfeld für die Umgebungssystemeinstellungen bestimmt.

Nachdem Sie die erforderlichen Änderungen vorgenommen haben, laden Sie sie mit dem pac paportal upload-Befehl hoch:

pac paportal upload --path [Folder-location]

Beispiel

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Hochladen beginnen

Anmerkung

Stellen Sie sicher, dass der von Ihnen eingegebene Pfad für den Portalinhalt korrekt ist. Standardmäßig wird ein vom Portal benannter Ordner (Anzeigename) mit den heruntergeladenen Portalinhalten erstellt. Wenn der Anzeigename des Portals beispielsweise custom-portal lautet, sollte der Pfad des oben genannten Befehls (--path) C:\pac-portals\downloads\custom-portal lauten.

Der Upload erfolgt nur für Inhalte, die geändert wurden. Da in diesem Beispiel die Änderung an einer Webseite vorgenommen wird, werden Inhalte nur für die Tabelle adx_webpage hochgeladen.

Upload nur für geänderte Inhalte abgeschlossen

Laden Sie die Änderungen mithilfe des Bereitstellungsprofils hoch

Wenn Sie mit mehreren verschiedenen Umgebungen arbeiten, können Sie die Verwendung von Bereitstellungsprofilen in Erwägung ziehen, um sicherzustellen, dass die Änderungen mithilfe des Bereitstellungsprofils in die richtige Umgebung hochgeladen werden.

  1. Erstellen Sie einen Ordner namens deployment-profiles innerhalb des Ordners, der den Portalinhalt enthält. Wenn sich der heruntergeladene Portalinhalt zum Beispiel im Ordner „starter-portal“ befindet, sollte der Ordner „deployment profiles“ in diesem Ordner liegen.

    Ordner für Bereitstellungsprofile

  2. Erstellen Sie im Ordner Deployment-Profile eine Deployment-YAML-Datei, die die umfeldspezifischen Änderungen enthält. Die Entwicklungsumgebung kann zum Beispiel „dev.deployment.yml“ heißen.

    Einsatzprofil YAML für Entwickler bereitstellen

  3. Bearbeiten Sie die YAML-Datei für die Bereitstellung mit Visual Studio Code mit folgendem Format:

    <table-name>:
- <record-id>: <GUID>
  <column-name>: <Name>
  <column-value>: <Value>

    Der folgende Beispiel-YAML-Code aktualisiert beispielsweise den Wert für „Browser Title Suffix“ von der Standardeinstellung „Custom Portal“ auf „Custom Portal (Dev)“.

    adx_contentsnippet:
    - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
      adx_name: Browser Title Suffix # Setting name
      adx_value:  &nbsp;· Custom Portal (Dev) # Setting value

  4. Um die Änderungen mit Hilfe einer YAML-Datei für das Bereitstellungsprofil in eine andere Umgebung hochzuladen, müssen Sie sich zuerst bei der Zielorganisation authentifizieren.

  5. Nachdem Sie sich authentifiziert und mit der richtigen Umgebung verbunden haben, verwenden Sie den pac paportal upload-Befehl, um den Inhalt hochzuladen:

    pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile dev

    Anmerkung

    Im obigen Beispiel lautet der Name des Bereitstellungsprofils „dev“, nachdem Sie die vorangegangenen Schritte zum Erstellen eines dev-Bereitstellungsprofils ausgeführt haben. Ändern Sie den Namen von „dev“ in einen beliebigen anderen Namen (z.B. QA für „qa.deployment.yml“ oder Test für „test.deployment.yml“), wenn Sie einen anderen Dateinamen für Ihre Bereitstellungs-YAML-Datei verwendet haben.

Schritt 6. Bestätigen Sie die Änderungen

So bestätigen Sie die an der Webseite vorgenommenen Änderungen:

  1. Wählen Sie im Power Pages Designstudio Synchronisieren aus.

  2. Navigieren Sie zur Webseite, um die Änderung anzuzeigen.

    Aktualisierten Seiteninhalt anzeigen

  3. Wenn Sie das Beispiel des Bereitstellungsprofils wie zuvor erklärt verwendet haben, aktualisiert das YAML-Snippet den Wert wie unten gezeigt.

    Browser-Titel-Suffix von der Portalverwaltungs-App

    Das durch die obige Änderung aktualisierte Browser-Titelsuffix zeigt die Änderung an, wenn Sie das Portal in einem Browser öffnen:

    Browser ändern

Wir sind am Ende des Tutorials angelangt. Sie können die obigen Schritte wiederholen und den Portalinhalt für andere unterstützte Tabellen ändern.

Nächste Schritte,

Erweiterung von Visual Studio Code verwenden

Siehe auch