Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
- Modellgesteuerte Apps
- UI flows
- Virtuelle Agents
- 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.
Hinweis
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 nachgelagerte Umgebung, oder zusammen in einem Workflow verwendet werden, um ein Szenario zu orchestrieren, wie z. B. Generieren eines Build-Artefakts, Bereitstellen zum Testen oder Harvest Entwickler-Änderungen. Sie können die Buildaufgaben weitgehend in vier Typen kategorisieren:
- 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 Microsoft wartet und der Microsoft neuere Features hinzufügt.
Bei früheren Versionen von Power Platform Build Tools stellt Microsoft bei Bedarf wichtige Sicherheitsupdates bereit. Wechseln Sie so bald wie möglich zu Power Platform Build Tools, Version 2.0.
Wichtig
Sie können Aufgabenversionen für Power Platform Build Tools in Ihrer Buildpipeline nicht kombinieren und abgleichen.
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.
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 |
|---|---|
| Dienstprinzipal ü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 geheimer Clientschlüssel | 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.
Dienstprinzipal- und geheimer Clientschlüssel erstellen
Verwenden Sie den Befehl "pac admin create-service-principal", um den Dienstprinzipal zu erstellen und zu konfigurieren, der mit den Aufgaben Microsoft Power Platform Buildtools 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 Admin-Benutzer zum Microsoft Power Platform-Mandanten hinzugefügt.
Dieser Befehl hat zwei Parameter:
| Name | Kurzbezeichnung | Erforderlich | Beschreibung |
|---|---|---|---|
environment |
env |
Yes | Die ID oder URL der Umgebung, der ein Anwendungsbenutzer hinzugefügt werden soll. |
role |
r |
Nein | Name oder ID der Sicherheitsrolle, die auf den Anwendungsbenutzer 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. |
Verwenden Sie den Befehl wie folgt:
C:\> pac admin create-service-principal --environment <environment id>
Wenn der Befehl erfolgreich verläuft, werden vier Spalten angezeigt:
- Power Platform-Mandanten-ID
- Anwendungs-ID
- Geheimer Clientschlüssel (im Klartext)
- Ablauf
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 wurde, können Sie denselben geheimen Clientschlüssel nicht mehr 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.
- Sie können diesen Artikel bewerten: Anwendungsbenutzererstellung.
- Sie können Power Platform CLI verwenden. Zum Beispiel:
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 (FAQs)
Werden meine alten Microsoft Power Platform Build-Tool-Pipelines weiterhin funktionieren?
Die älteren Pipelines funktionieren weiterhin, aber neuere Features sind in den älteren Aufgaben nicht verfügbar. Wenn Sie die neueren Features verwenden möchten, ändern Sie die Version Ihrer Aufgabe in der Pipeline.
Warum haben Sie die neue Aufgabe auf Power Platform CLI statt auf PowerShell gestützt?
Die Power Platform CLI-Aufgaben sind multiplatform mit großer Flexibilität, einschließlich der Ausführung auf Linux-Läufern. Diese Aufgaben 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 Build-Tools funktionieren sowohl für Canvas-Apps als auch für modellgesteuerte Apps, virtuelle Agenten in Microsoft Copilot Studio, UI-Flows und klassische Flows, AI Builder, benutzerdefinierte Konnektoren und Datenflüsse, die Sie jetzt alle einer Lösung hinzufügen 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 habe zuvor die Vorschau der Buildtools installiert – kann ich von der Vorschau Power Apps Buildtools auf Power Platform Build Tools upgraden?
Sie können kein Upgrade von der Vorschauversion durchführen, da wir einige bahnbrechende Änderungen in der allgemein verfügbaren Version (GA) einführen 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ösungsfähig. Wenn Sie diese Komponenten zu Ihrer Lösung hinzufügen, können sie an dem 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 im Artikel " Bekannte Einschränkungen" verfügbar.
Wie viel kostet die Microsoft Power Platform Buildtools?
Die Build-Tools sind kostenlos verfügbar. Sie benötigen jedoch ein gültiges Abonnement für Azure DevOps, um die Build-Tools zu verwenden. Weitere Informationen finden Sie unter Pricing für Azure DevOps.
Ich kann die Erweiterung sehen, aber warum habe ich keine Option, sie zu installieren?
Wenn die Installationsoption nicht angezeigt wird, fehlen Ihnen wahrscheinlich die erforderlichen Installationsberechtigungen in Ihrer Azure DevOps Organisation. Weitere Informationen finden Sie unter Verwalten von Erweiterungsberechtigungen.
Wie können Entwickler die Ergebnisse der Checker-Aufgabe nutzen?
Die Ausgabe der Checker-Aufgabe ist eine SARIF-Datei. Sowohl VS Code- als auch Visual Studio-Erweiterungen stehen zum Anzeigen und Ausführen von Maßnahmen 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