Freigeben über


Microsoft Power Platform Build-Tools für Azure DevOps

Verwenden Sie Microsoft Power Platform Buildtools, um allgemeine Build- und Bereitstellungsaufgaben im Zusammenhang mit Apps zu automatisieren, die auf Microsoft Power Platform basieren. Zu diesen Aufgaben gehören:

  • Synchronisieren von Lösungsmetadaten (auch als Lösungen bezeichnet), die die verschiedenen Plattformkomponenten enthalten, wie zum Beispiel:
    • Kundenbindungs-Apps: Dynamics 365 Sales, Kundendienst, Field Service, Marketing und Project Service Automation
    • Canvas-Apps
    • Modellbasierte Apps
    • Benutzeroberflächenabläufe
    • Virtuelle Agenten
    • AI Builder-Modelle
    • Konnektoren zwischen Entwicklungsumgebungen und Quellcodeverwaltung
  • Build-Artefakte generieren
  • Implementierung in nachgeschalteten Umgebungen
  • Bereitstellungs- oder De-Bereitstellungsumgebungen
  • Durchführen statischer Analyseprüfungen auf Lösungen mithilfe des Power Apps-Prüfdiensts

Verwenden Sie Microsoft Power Platform Build-Tools-Aufgaben in Verbindung mit allen anderen verfügbaren Azure DevOps-Aufgaben, um Ihre Build- und Release-Pipelines zu erstellen. Zu den Pipelines, die Teams üblicherweise einrichten, gehören Einleiten, Export aus Entwicklung, Build und Veröffentlichen.

ALM powered by Azure DevOps.

Anmerkung

Microsoft Power Platform Buildtools werden nur für eine Microsoft Dataverse Umgebung mit einer Datenbank unterstützt. Weitere Informationen: Umgebung mit einer Datenbank erstellen

Microsoft Power Platform Buildtools sind jetzt für die Verwendung in GCC und GCC High Regionen verfügbar.

Was sind Microsoft Power Platform Buildtools?

Microsoft Power Platform Buildtools sind eine Sammlung von power Platform-spezifischen Azure DevOps Buildaufgaben, die die Notwendigkeit beseitigen, benutzerdefinierte Tools und Skripts manuell herunterzuladen, um den Anwendungslebenszyklus von Apps zu verwalten, die auf Microsoft Power Platform basieren.

Die Aufgaben können einzeln, wie z. B. das Importieren einer Lösung in eine nachfolgende Umgebung, oder zusammen in einer Pipeline verwendet werden, um ein Szenario zu orchestrieren, wie z. B. das Generieren eines Build-Artefakts, das Bereitstellen in die Testumgebung oder das Erfassen von Entwickleränderungen. Die Buildaufgaben können größtenteils in folgende Typen kategorisiert werden:

  • Helfer
  • Qualitätsprüfung
  • Lösung
  • Umgebungsverwaltung

Weitere Informationen zu den verfügbaren Aufgaben finden Sie unter Microsoft Power Platform Build tools tasks.

Was ist die Power Platform Build Tools Version 2.0?

Neben dem, was die Power Platform Build Tools bereitstellen, ist die Version 2.0 von Power Platform Build-Tools Power Platform CLI-basiert.

Power Platform Build Tools Version 1.0 basiert auf PowerShell. Power Platform Build Tools 2.0 ist die Version, die gewartet wird und in der neuere Funktionen hinzugefügt wird.

Für frühere Versionen von Power Platform Build Tools führen wir bei Bedarf wichtige Sicherheitsupdates durch. Wir empfehlen unseren Kunden dringend, sobald wie möglich auf Power Platform Build Tools Version 2.0 zu wechseln.

Wichtig

Sie können keine Aufgabenversionen für Power Platform Build-Tools in Ihrer Build-Pipeline kombinieren.

Abrufen Sie Microsoft Power Platform Build-Tools

Microsoft Power Platform Buildtools können in Ihrer Azure DevOps Organisation aus Azure Marketplace installiert werden.

Nach der Installation stehen alle in der Microsoft Power Platform Buildtools enthaltenen Aufgaben zur Verfügung, um sie einer neuen oder vorhandenen Pipeline hinzuzufügen. Sie können sie finden, indem Sie nach Power Platform suchen.

Holen Sie sich die Microsoft Power Platform Build-Tools

Verbindung mit den Umgebungen

Um mit der Microsoft Power Platform-Umgebung zu interagieren, müssen Sie eine Verbindung herstellen, damit die Buildtoolaufgaben die erforderlichen Aktionen ausführen können. Es gibt zwei Typen von Verbindungen:

Verbindungstyp Beschreibung
Service Principal über Workload Identity Federation (empfohlen) Verwendet eine serviceprinzipalbasierte Authentifizierung mithilfe von föderierten Anmeldeinformationen. Empfohlen für Mandanten, die eine Multi-Faktor-Authentifizierung erfordern.
Dienstprinzipal und Clientgeheimnis Verwendet die dienstprinzipalbasierte Authentifizierung.
Benutzername/Kennwort Eine generische Serviceverbindung mit Benutzername und Kenntwort. Unterstützt keine Benutzer, die eine Multi-Faktor-Authentifizierung benötigen.

Konfigurieren Sie Dienstverbindungen mithilfe eines Dienstprincipals

Um eine Verbindung mithilfe des Dienstprinzipals zu konfigurieren, müssen Sie zunächst ein Power Platform Profil mit den erforderlichen Berechtigungen authentifizieren. Sie müssen der Dataverse-Umgebung eine Microsoft Entra ID Anwendung und einen zugeordneten Anwendungsbenutzer hinzufügen.

Serviceprinzipal und Clientgeheimnis erstellen

Verwenden Sie den Befehl pac admin create-service-principal, um den Dienstprinzipal zu erstellen und zu konfigurieren, der mit den Aufgaben der Microsoft Power Platform Build Tools verwendet werden soll.

Dieser Befehl registriert zuerst ein Application-Objekt und den entsprechenden Dienstprinzipalnamen (Service Principal Name, SPN) in Microsoft Entra ID. Anschließend wird die Anwendung als Administratorbenutzer zum Microsoft Power Platform Mandanten hinzugefügt.

Dieser Befehl hat zwei Parameter:

Name Kurzbezeichnung Erforderlich Beschreibung
environment env Ja Die ID oder URL der Umgebung, der ein Anwendungsbenutzer hinzugefügt werden soll.
role r Nein Name oder ID der Sicherheitsrolle, die auf den Anwendungsbenutzenden angewendet werden soll. Der Standardwert ist: „Systemadministrator“.

Solution Checker erfordert eine Rolle mit der Berechtigung prvAppendmsdyn_analysisjob, um an die Tabelle msdyn_analysisjob anzuhängen. Die Systemadministrator-Rolle besitzt standardmäßig dieses Recht.

Sie können dies wie folgt verwenden:

C:\> pac admin create-service-principal  --environment <environment id>

Bei Erfolg werden vier Spalten angezeigt:

  • Power Platform-Mandanten-ID
  • Anwendungs-ID
  • Geheimer Clientschlüssel (im Klartext)
  • Verfall

Zum Beispiel:

PS C:\>pac admin create-service-principal --environment d3fcc479-0122-e7af-9965-bde57f69ee1d
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69eeld with security role System Administrator
Tenant ID                            Application ID                       Client Secret                           Expiration
2b0463ed-efd7-419d-927d-a9dca49d899c adde6d52-9582-4932-a43a-beca5d182301 beY8Q~JBZ~CBDgIKKBjbZ3g6BofKzoZkYj23Hbf 7/31/2024 4:27:03 PM

Verwenden Sie die angezeigten Informationen, um die Power Platform Serviceverbindung zu konfigurieren.

Wichtig

Bewahren Sie das Clientgeheimnis vertraulich und sicher auf. Sobald die Eingabeaufforderung gelöscht ist, können Sie dasselbe Client-Geheimnis nicht noch einmal abrufen.

Konfigurieren Sie die Umgebung mit der Anwendungs-ID

Sie müssen die Anwendungs-ID als Anwendungsbenutzer in der Microsoft Power Platform Umgebung hinzufügen, zu der Sie eine Verbindung herstellen. Hier sind zwei Möglichkeiten, wie Sie dies tun können.

PS C:\>pac admin assign-user --user "adde6d52-9582-4932-a43a-beca5d182301" --role "System administrator" --environment d3fcc479-0122-e7af-9965-bde57f69ee1d --application-user
Connected to... SnDemoDev
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69ee1d with security role System Administrator

Stellen Sie sicher, dass dem hinzugefügten Anwendungsbenutzer die Systemrolle Administrator zugewiesen ist (verfügbar unter Rollen verwalten in den Sicherheitseinstellungen für den Anwendungsbenutzer).

Häufig gestellte Fragen (Frequently Asked Questions, FAQs)

Werden meine alten Microsoft Power Platform Build-Tool-Pipelines weiterhin funktionieren?

Die älteren Pipelines funktionieren weiterhin, neuere Funktionen werden jedoch nicht zu den älteren Aufgaben hinzugefügt. Wenn Sie die neueren Funktionen nutzen möchten, empfehlen wir Ihnen dringend, die Version Ihrer Aufgabe in der Pipeline zu ändern.

Warum haben Sie die neue Aufgabe auf Power Platform CLI statt auf PowerShell gestützt?

Die Power Platform CLI-Aufgaben sind plattformübergreifend mit großer Flexibilität, einschließlich der Ausführung auf Linux. Dies sind die gleichen Aufgaben, die mit Power Platform Actions für GitHub verfügbar sind. Sie haben jetzt eine konsistente Erfahrung zwischen Azure DevOps und GitHub.

Funktionieren die Microsoft Power Platform Build-Tools nur für Power Apps?

Die Buildtools funktionieren sowohl für Canvas- als auch modellgesteuerte Apps, Microsoft Copilot Studio virtuelle Agents, UI Flows und herkömmliche Flüsse, AI Builder, benutzerdefinierte Connectors und Datenflüsse, die jetzt einer Lösung hinzugefügt werden können. Diese Liste enthält auch Kundenbindungs-Apps (Dynamics 365 Sales, Kundendienst, Field Service, Marketing und Project Service Automation). Für Finance and Operations-Anwendungen sind separate Build-Tasks verfügbar.

Ich hatte zuvor die Vorschau der Build Tools installiert - kann ich von der Vorschau der Power Apps Build Tools auf die Power Platform Build Tools aktualisieren?

Sie können kein Upgrade von der Vorschauversion durchführen, da wir in der allgemein verfügbaren Version einige wichtige Änderungen vornehmen mussten. Um von der Vorschauversion zu wechseln, müssen Sie die Microsoft Power Platform Buildtools installieren und entweder Ihre Pipelines neu erstellen oder Ihre vorhandenen Pipelines neu konfigurieren, um die neuen Buildtools-Aufgaben zu verwenden. Sie müssen auch neue Dienstverbindungen erstellen.

Kann ich Flow- und Canvas-Apps einbinden?

Ja, Flows und Canvas Apps sind lösungsorientiert, d.h. wenn diese Komponenten zu Ihrer Lösung hinzugefügt werden, können sie am Lebenszyklus Ihrer App teilnehmen. Gewisse Schritte erfordern jedoch weiterhin manuelle Konfigurationen. Der Bedarf an manueller Konfiguration wird später in diesem Jahr behoben, wenn wir Umgebungsvariablen und Konnektoren einführen. Eine Liste der aktuellen Einschränkungen ist hier verfügbar: Bekannte Einschränkungen.

Wie viel kostet die Microsoft Power Platform Buildtools?

Die Build-Tools sind kostenlos verfügbar. Ein gültiges Abonnement für Azure DevOps ist jedoch erforderlich, um die Buildtools zu nutzen. Weitere Informationen zu Preisen für Azure DevOps sind verfügbar.

Ich kann die Erweiterung sehen, aber warum habe ich keine Option, sie zu installieren?

Wenn die Option install nicht angezeigt wird, fehlen Ihnen wahrscheinlich die erforderlichen Installationsberechtigungen in Ihrer Azure DevOps Organisation. Mehr Informationen: Verwalten von Erweiterungsberechtigungen.

Wie können Entwickler die Ergebnisse der Checker-Aufgabe nutzen?

Die Ausgabe der Checker-Aufgabe ist eine Sarif-Datei und sowohl VS Code- als auch Visual Studio Erweiterungen stehen zum Anzeigen und Ausführen von Aktionen für Sarif-Dateien zur Verfügung

Siehe auch

Power Platform Build Tools für Azure DevOps Versionshinweise
Aufgaben des Build-Tools
Microsoft Power Platform Build Tools-Labs