Freigeben über

Microsoft Power Platform Build Tool Aufgaben

  • Artikel

Die verfügbaren Erstellungsaufgaben werden in den folgenden Abschnitten beschrieben. Anschließend werden wir einige Beispiele für Azure Pipelines vorstellen, die diese Aufgaben nutzen. Informationen zu den Build-Tools und zum Herunterladen finden Sie unter Microsoft Power Platform Build Tools für Azure Pipelines.

Helferaufgabe

Die verfügbaren Helferaufgaben werden als Nächstes beschrieben.

Power Platform-Toolinstaller

Diese Aufgabe muss einmal vor jeder anderen Power Platform Build Tools-Aufgabe in Build- und Release-Pipelines hinzugefügt werden. Diese Aufgabe installiert eine Reihe von Power Platform-spezifischen Tools, die für den Agent erforderlich sind, um die Microsoft Power Platform-Buildaufgaben auszuführen. Für diese Aufgabe ist keine weitere Konfiguration erforderlich, wenn sie hinzugefügt wird. Diese Aufgabe enthält Parameter für die spezifischen Versionen der einzelnen Tools, die installiert werden.

Stellen Sie sicher, dass diese Parameter den Versionen der Tools entsprechen, die für die ordnungsgemäße Ausführung der Pipeline erforderlich sind, um über einen längeren Zeitraum auf dem neuesten Stand zu bleiben.

YAML Ausschnitt (Installer)

# Installs default Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'

# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    DefaultVersion: false
    XrmToolingPackageDeploymentVersion: 3.3.0.928

Parameter (Installer)

Parameter Beschreibung
DefaultVersion
Standard-Toolversionen verwenden		 Auf True festlegen, um die Standardversion aller Tools zu verwenden, andernfalls False. Erforderlich (und false), wenn Toolversionen angegeben sind.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Toolversion		 Die bestimmten Version des zu verwendenden Tools.

Power Platform WhoAmI

Überprüft eine Power Platform-Umgebungsdienstverbindung durch Verbinden und Erstellen einer WhoAmI-Anfrage. Diese Aufgabe kann sich als nützlich erweisen, wenn sie frühzeitig in die Pipeline aufgenommen wird, um die Konnektivität zu überprüfen, bevor die Verarbeitung beginnt.

YAML-Ausschnitt (WhoAmI)

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@2
  displayName: 'Power Platform WhoAmI'

  inputs: 
#   Service Principal/client secret (supports MFA)
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'My service connection'

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@2
  displayName: 'Power Platform WhoAmI'

  inputs:
#   Username/password (no MFA support)
    PowerPlatformEnvironment: 'My service connection'

Parameter (WhoAmI)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Optional) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt für die Umgebung, zu der Sie verbinden möchten. Definiert unter Dienstverbindungen in Projekteinstellungen. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
PowerPlatformSPN
Power Platform Dienstprinzipal		 Der Dienstendpunkt für die Umgebung, zu der Sie verbinden möchten. Definiert unter Dienstverbindungen in Projekteinstellungen.

Qualitätsprüfung

Im nächsten Abschnitt finden Sie die verfügbaren Aufgaben zur Überprüfung der Qualität einer Lösung.

Power Platform Checker

Diese Aufgabe führt eine statische Analyseprüfung Ihrer Lösungen in Zusammenhang mit bewährten Regeln durch, um problematische Muster zu identifizieren, die Sie unbeabsichtigterweise beim Erstellen der Lösung eingeführt haben.

YAML-Ausschnitt (Checker)

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@2
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@2
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    UseDefaultPACheckerEndpoint: false
    CustomPACheckerEndpoint: 'https://japan.api.advisor.powerapps.com/'
    FileLocation: sasUriFile
    FilesToAnalyzeSasUri: 'SAS URI'
    FilesToAnalyze: '**\*.zip'
    FilesToExclude: '**\*.tzip'
    RulesToOverride: 'JSON array'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

Parameter (Checker)

Parameter Beschreibung des Dataflows
PowerPlatformSPN
Service-Verbindung		 (Erforderlich) Eine Verbindung zu einer lizenzierten Microsoft Power Platform Umgebung ist erforderlich, um den Power Platform Prüfer zu verwenden. Dienstverbindungen sind definiert in Serviceverbindungen unter Projekt-Einstellungen mithilfe von Power Platform Verbindungstyp. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform-Umgebung erstellen

Hinweis: Dienstprinzipal- und Benutzername/Kennwort-Authentifizierungsmethoden sind für die Überprüfungsaufgabe verfügbar. Weitere Informationen zum Konfigurieren vom Dienstprinzipal für diese Aufgabe finden Sie unter Konfigurieren Sie die Dienstprinzipalverbindungen für Power Platform Umgebungen.
UseDefaultPACheckerEndpoint
Standard-Power Platform-Checker-Endpunkt verwenden		 Standardmäßig (true) verwendet der geografische Standort des Checker-Dienstes dieselbe geografische Position wie die Umgebung, mit der Sie sich verbinden.
CustomPACheckerEndpoint
Benutzerdefinierter PAC Checker-Endpunkt		 Erforderlich, wenn UseDefaultPACheckerEndpoint false ist. Sie können beispielsweise einen anderen geografischen Raum zur Verwendung angeben, zum Beispiel https://japan.api.advisor.powerapps.com.Eine Liste der verfügbaren geografischen Regionen finden Sie unter Verwenden der Power Platform-Überprüfungs-API.
FileLocation
Speicherorte der zu analysierenden Dateien		 Erforderlich beim Verweisen auf eine Datei über eine Shared Access Signature(SAS)-URL sasUriFile.

Hinweis: Es ist wichtig, auf eine exportierte Lösungsdatei zu verweisen und nicht auf die entpackten Quelldateien in Ihrem Repository. Es können sowohl verwaltete als auch nicht verwaltete Lösungsdateien analysiert werden.
FilesToAnalyzeSasUri
Zu analysierende SAS-Dateien		 Erforderlich, wenn FileLocation auf sasUriFile festgelegt, ist. Geben Sie den SAS-URI ein. Sie können mehr als eine SAS-URI über eine durch Kommas (,) oder Semikolons (;) getrennte Liste hinzufügen.
FilesToAnalyze
Zu analysierende lokale Dateien		 Erforderlich, wenn SAS-Dateien nicht analysiert werden. Geben Sie den Pfad und Dateinamen der zu analysierenden ZIP-Dateien an. Platzhalter können verwendet werden. Geben Sie z.B. **\*.zip für alle ZIP-Dateien in allen Unterordnern ein.
FilesToExclude
Auszuschließende lokale Dateien		 Geben Sie die Namen der Dateien an, die von der Analyse ausgeschlossen werden sollen. Wenn es mehrere gibt, geben Sie eine durch Komma (,) oder Semikolon (;) getrennte Liste an. Diese Liste kann einen vollständigen Dateinamen oder einen Namen mit führenden oder nachgestellten Platzhaltern enthalten, wie z. B. *jquery oder form.js
RulesToOverride
Außer Kraft zu setzende Regeln		 Ein JSON-Array mit Regeln und Ebenen, dei außer Kraft gesetzt werden sollen. Zulässige Werte für OverrideLevel sind: Critical, High, Medium, Low, Informational. Beispiel: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Regelsatz		 (Erforderlich) Geben Sie an, welcher Regelsatz angewendet werden soll. Die folgenden zwei Regelsätze sind verfügbar:
  • Lösungsüberprüfung: Dieser Regelsatz ist der gleiche, der vom Power Apps Maker Portal aus ausgeführt wird.
  • AppSource: Der erweiterte Regelsatz, der verwendet wird, um eine Anwendung zu zertifizieren, bevor sie auf AppSource veröffentlicht werden kann.
ErrorLevel
Fehlerstufe		 In Kombination mit dem Fehlerschwellenwert-Parameter wird die Schwere der zulässigen Fehler und Warnungen definiert. Unterstützte Schwellenwerte sind <level>IssueCount wobei level=Critical, High, Medium, Low und Informational ist.
ErrorThreshold
Fehlerschwellenwert		 Definiert die Anzahl der Fehler (>=0) einer bestimmten Ebene, die der Prüfer die geprüften Lösungen bestehen darf.
FailOnPowerAppsCheckerAnalysisError
Abbruch bei Fehler		 Bei Wahr, scheitern, wenn die Analyse der Power Apps-Prüfung als Failed oder FinishedWithErrors zurückgegeben wird.
ArtifactDestinationName
DevOps-Artefaktname		 Geben Sie den Azure Artifcats-Namen für die Checker-SARIF-Datei an.

Lösungsaufgaben

Diese Aufgaben können Lösungsaktionen automatisieren. Die später in diesem Abschnitt beschriebenen Umgebungsaufgaben zum Erstellen, Kopieren oder Wiederherstellen einer Umgebung überschreiben die Dienstverbindungen mit den neu erstellten Umgebungen. Durch diese Aufgaben können Lösungsaufgaben für Umgebungen ausgeführt werden, die bei Bedarf erstellt werden.

Power Platform – Lösung importieren

Import einer Lösung in eine Zielumgebung.

YAML-Ausschnitt (Import)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
  displayName: 'Power Platform Import Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    HoldingSolution: true
    OverwriteUnmanagedCustomizations: true
    SkipProductUpdateDependencies: true
    ConvertToManaged: true

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
  displayName: 'Power Platform Import Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    AsyncOperation: true
    MaxAsyncWaitTime: 60
    PublishWorkflows: false

Parameter (Import)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt, in den Sie die Lösung importieren möchten (z. B. https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
PowerPlatformSPN
Power Platform-Dienstprinzipal		 Der Dienstendpunkt, in den Sie die Lösung importieren möchten (z. B. https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
SolutionInputFile
Lösungseingabedatei		 (Erforderlich) Der Pfad und der Dateiname der Datei solution.zip, die in die Zielumgebung importiert werden soll (zum Beispiel $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Hinweis: Variablen bieten Ihnen eine bequeme Möglichkeit, wichtige Daten in verschiedene Teile Ihrer Pipeline zu übertragen. Siehe Verwenden Sie vordefinierte Variablen für eine umfassende Liste.
HoldingSolution
Importieren als Holding-Lösung		 Ein Vorab-Parameter (true|false), der verwendet wird, wenn eine Lösung aufgerüstet werden muss. Mit diesem Parameter wird die Lösung in Dataverse gehalten, aber erst dann aktualisiert, wenn die Aufgabe Apply Solution Upgrade ausgeführt wird.
OverwriteUnmanagedCustomizations
Nicht verwaltete Anpassungen überschreiben		 Geben Sie an, ob nicht verwaltete Anpassungen überschrieben werden sollen (true|false).
SkipProductUpdateDependencies
Abhängigkeiten von Produktupdates überspringen		 Geben Sie an, ob die Erzwingung von Abhängigkeiten im Zusammenhang mit Produktupdates übersprungen werden soll (true|false).
ConvertToManaged
Zu verwaltet konvertieren		 Geben Sie an, ob als verwaltete Lösung importiert werden soll (true|false).
AsyncOperation
Asynchroner Import		 Falls ausgewählt (true) wird der Importvorgang asynchron ausgeführt. Dies wird für größere Lösungen empfohlen, da diese Aufgabe ansonsten nach 4 Minuten automatisch abläuft. Bei Auswahl von asynchron wird abgefragt und gewartet, bis MaxAsyncWaitTime erreicht wurde (true|false).
MaxAsyncWaitTime
Maximale Wartezeit		 Die maximale Wartezeit in Minuten für den asynchronen Vorgang; Standard ist 60 min (1 h), wie der Azure DevOps-Standard für Aufgaben.
PublishWorkflows
Prozesse nach dem Import aktivieren		 Geben Sie an, ob Prozesse (Workflows) in der Lösung nach dem Import aktiviert werden sollen (true|false).
UseDeploymentSettingsFile
Bereitstellungseinstellungsdatei verwenden		 Werte für Verbindungsreferenzen und Umgebungsvariablen können mit einer Bereitstellungseinstellungs-Datei festgelegt werden (true|false).
DeploymentSettingsFile
Bereitstellungseinstellungsdatei erstellt		 (Erforderlich, wenn UseDeploymentSettingsFile=true) Der Pfad und der Dateiname der Bereitstellungseinstellungsdatei.

Power Platform Lösungskomponente hinzufügen

Fügt eine Lösungskomponente zu einer nicht verwalteten Lösung hinzu.

YAML-Ausschnitt (Hinzufügen)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.add-solution-component.PowerPlatformAddSolutionComponent@2
  displayName: 'Power Platform Add Solution Component '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    SolutionName: 'SampleSolution '
    Component: contact
    ComponentType: 1
    AddRequiredComponents: false

Parameter (Hinzufügen)

Parameter Beschreibung
ComponentId
ID der Lösungskomponente		 Schemaname oder -ID der Komponente, die der Ziellösung hinzugefügt werden soll.
ComponentType
Power Platform: Umgebungs-URL		 Der Wert, der die hinzugefügte Lösungskomponente darstellt. Eine umfassende Liste der vordefinierten Variablen finden Sie unter Vordefinierte Variablen verwenden.
SolutionUniqueName
Der Name des Lösungsherausgebers.		 Eindeutige Name der Lösung.
AddRequiredComponents
Alle Komponenten, die von einer anderen Lösung benötigt werden, abhängig von der Lösungskomponente		 (Optional) Gibt an, ob andere Lösungskomponenten, die für die hinzugefügte Lösungskomponente erforderlich sind, auch der nicht verwalteten Lösung hinzugefügt werden sollen.
Environment
Umgebungs-URL oder ID		 (Optional) Umgebungs-URL oder ID der Zielumgebung.

Power Platform Projektmappen-Upgrade anwenden

Führt ein Upgrade einer Lösung durch, die als Holding-Lösung importiert wurde.

YAML-Ausschnitt (Upgrade)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@2
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    AsyncOperation: false

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@2
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    MaxAsyncWaitTime: 45

Parameter (Upgrade)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt, in den Sie die Lösung upgraden möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
PowerPlatformSPN
Power Platform-Dienstprinzipal		 Der Dienstendpunkt, in den Sie die Lösung upgraden möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
SolutionName
Lösungsname		 (Erforderlich) Der Name der Lösung zum Anwenden des Upgrades. Verwenden Sie immer den Name der Lösung und nicht ihren Anzeigenamen.
AsyncOperation
Asynchrones Upgrade		 Falls ausgewählt (true) wird der Upgrade-Vorgang als asynchroner Batch-Auftrag ausgeführt. Bei Auswahl von asynchron wird abgefragt und gewartet, bis MaxAsyncWaitTime erreicht wurde.
MaxAsyncWaitTime
Maximale Wartezeit		 Die maximale Wartezeit in Minuten für den asynchronen Vorgang; Standard ist 60 min (1 h), wie der Azure DevOps-Standard für Aufgaben.

Notiz

Variablen sind eine bequeme Möglichkeit, wichtige Daten in verschiedene Teile der Pipeline zu übertragen. Siehe Verwenden Sie vordefinierte Variablen für eine umfassende Liste. Sie können Verbindungsreferenz- und Umgebungsvariableninformationen für die Zielumgebung vorab ausfüllen, während Sie eine Lösung mithilfe einer Bereitstellungseinstellungsdatei importieren.

Mehr Informationen: Füllen Sie Verbindungsreferenzen und Umgebungsvariablen für automatisierte Bereitstellungen vorab aus

Power Platform – Lösung exportieren

Exportiert eine Lösung aus einer Quellumgebung.

YAML-Ausschnitt (Export)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@2
  displayName: 'Power Platform Export Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@2
  displayName: 'Power Platform Export Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120
    ExportAutoNumberingSettings: true
    ExportCalendarSettings: true
    ExportCustomizationSettings: true
    ExportEmailTrackingSettings: true
    ExportGeneralSettings: true
    ExportIsvConfig: true
    ExportMarketingSettings: true
    ExportOutlookSynchronizationSettings: true
    ExportRelationshipRoles: true
    ExportSales: true

Parameter (Export)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt, in den Sie die Lösung upgraden möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
PowerPlatformSPN
Power Platform-Dienstprinzipal		 Der Dienstendpunkt, in den Sie die Lösung upgraden möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
SolutionName
Lösungsname		 (Erforderlich) Der Name der zu exportierenden Lösung. Verwenden Sie immer den Name der Lösung und nicht ihren Anzeigenamen.
SolutionOutputFile
Lösungsausgabedatei		 (Erforderlich) Der Pfad und der Dateiname der Datei „solution.zip“, die in die Quellumgebung exportiert werden soll (zum Beispiel $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Hinweis: Variablen bieten Ihnen eine bequeme Möglichkeit, wichtige Daten in verschiedene Teile Ihrer Pipeline zu übertragen. Siehe Verwenden Sie vordefinierte Variablen für eine umfassende Liste.
AsyncOperation
Asynchroner Export		 Falls ausgewählt (true) wird der Exportvorgang als asynchroner Batch-Auftrag ausgeführt. Bei Auswahl von asynchron wird abgefragt und gewartet, bis MaxAsyncWaitTime erreicht wurde.
MaxAsyncWaitTime
Maximale Wartezeit		 Die maximale Wartezeit in Minuten für den asynchronen Vorgang; Standard ist 60 min (1 h), wie der Azure DevOps-Standard für Aufgaben.
Managed
Als verwaltet exportiert		 Falls ausgewählt (true), wird die Lösung als verwaltete Lösung exportiert; andernfalls als nicht verwaltete Lösung.
ExportAutoNumberingSettings
Einstellungen für die automatische Nummerierung exportieren		 Einstellungen für die automatische Nummerierung exportieren (true|false).
ExportCalendarSettings
Kalendereinstellungen exportieren		 Kalendereinstellungen exportieren (true|false).
ExportCustomizationSettings
Anpassungseinstellungen exportieren		 Anpassungseinstellungen exportieren (true|false).
ExportEmailTrackingSettings
Einstellungen für die E-Mail-Verfolgung exportieren		 E-Mail-Tracking-Einstellungen exportieren (true|false).
ExportGeneralSettings
Allgemeine Einstellungen exportieren		 Allgemeine Einstellungen exportieren (true|false).
ExportIsvConfig
ISV-Konfiguration exportieren		 ISV-Konfiguration exportieren (true|false).
ExportMarketingSettings
Marketingeinstellungen exportieren		 Marketingeinstellungen exportieren (true|false).
ExportOutlookSynchronizationSettings
Outlook-Synchronisierungseinstellungen exportieren		 Outlook-Synchronisierungseinstellungen exportieren (true|false).
ExportRelationshipRoles
Geschäftsbeziehungsrollen exportieren		 Geschäftsbeziehungsrollen exportieren (true|false).
ExportSales
Exportumsätze		 Exportumsätze (true|false).

Power Platform – Lösung entpacken

Die Aufgabe zum Entpacken einer Lösung nimmt eine komprimierte Lösungsdatei und entpackt sie in mehrere XML-Dateien und andere Dateien, damit diese Dateien durch ein Quellcodeverwaltungssystem leichter verwaltet werden können.

YAML-Ausschnitt (Entpacken)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.unpack-solution.PowerPlatformUnpackSolution@2
  displayName: 'Power Platform Unpack Solution '
  inputs:
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    SolutionTargetFolder: 'C:\Public'
    SolutionType: Both

Parameter (Entpacken)

Parameter Beschreibung
SolutionInputFile
Lösungseingabedatei		 (Erforderlich) Der Pfad und Dateiname der zu entpackenden Datei solution.zip an.
SolutionTargetFolder
Zielordner zum Entpacken der Lösung		 (Erforderlich) Der Pfad und Zielordner, in den Sie die Lösung entpacken möchten.
SolutionType
Lösungstyp		 (Erforderlich) Die Art der Lösung, die Sie entpacken möchten. Zu den Optionen gehören: Nicht verwaltet (empfohlen), verwaltet, und Beide.

Power Platform – Lösung verpacken

Packt eine Lösung, die im Quellsteuerelement dargestellt wird, in eine solution.zip-Datei, die in eine andere Umgebung importiert werden kann.

YAML-Ausschnitt (Packen)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.pack-solution.PowerPlatformPackSolution@2
  displayName: 'Power Platform Pack Solution '
  inputs:
    SolutionSourceFolder: 'C:\Public'
    SolutionOutputFile: 'Contoso_sample_1_0_0_1_managed.zip'
    SolutionType: Managed

Parameter (Packen)

Parameter Beschreibung
SolutionOutputFile
Lösungsausgabedatei		 (Erforderlich) Der Pfad und der Dateiname der Datei solution.zip, in welche die Zielumgebung gepackt werden soll.
SolutionSourceFolder
Quellordner der zu packenden Lösung		 (Erforderlich) Der Pfad und der Quellordner der zu packenden Lösung.
SolutionType
Lösungstyp		 (Erforderlich) Die Art der Lösung, die Sie packen möchten. Zu den Optionen gehören: Verwaltet (empfohlen), Nicht verwaltet und Beide.

Power Platform Lösung löschen

Löscht eine Projektmappe in der Zielumgebung.

YAML-Ausschnitt (Löschen)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-solution.PowerPlatformDeleteSolution@2
  displayName: 'Power Platform Delete Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'

Parameter (Löschen)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt, für den Sie die Lösung löschen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
PowerPlatformSPN
Power Platform Dienstprinzipal		 Der Dienstendpunkt, für den Sie die Lösung löschen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
SolutionName
Lösungsname		 (Erforderlich) Der Name der zu löschenden Lösung. Verwenden Sie immer den Name der Lösung und nicht ihren Anzeigenamen.

Power Platform – Anpassungen veröffentlichen

Veröffentlicht alle Anpassungen in einer Umgebung.

YAML-Ausschnitt (Veröffentlichen)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.publish-customizations.PowerPlatformPublishCustomizations@2
  displayName: 'Power Platform Publish Customizations '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '

Parameter (Veröffentlichen)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt, in dem Sie die Anpassungen veröffentlichen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
PowerPlatformSPN
Power Platform-Dienstprinzipal		 Der Dienstendpunkt, in dem Sie die Anpassungen veröffentlichen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen

Power Platform – Lösungsversion festlegen

Aktualisiert die Version einer Lösung.

YAML-Ausschnitt (Version)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-solution-version.PowerPlatformSetSolutionVersion@2
  displayName: 'Power Platform Set Solution Version '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionVersionNumber: 1.0.0.0

Parameter (Version)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt, in dem Sie die Lösungsversion festlegen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
PowerPlatformSPN
Power Platform-Dienstprinzipal		 Der Dienstendpunkt, in dem Sie die Lösungsversion festlegen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
SolutionName
Lösungsname		 (Erforderlich) Der Name der Lösung, für die die Version festgelegt wird. Verwenden Sie immer den Name der Lösung und nicht ihren Anzeigenamen.
SolutionVersionNumber
Lösungsversionsnummer		 (Erforderlich) Versionsnummer, die Sie einstellen möchten.

Obwohl die Versionsnummer in der Pipeline hartcodiert werden kann, wird empfohlen, eine Azure DevOps Pipeline-Variable wie BuildId zu nutzen. Hier können Sie auf der Registerkarte "Optionen" die genaue Form der Versionsnummer festlegen, z. B.: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Diese Definition kann dann in der Aufgabe "Lösungsversion festlegen" verwendet werden, indem die Eigenschaft "Versionsnummer" wie folgt festgelegt wird: $(Build.BuildId) anstelle der harten Codierung 20200824.0.0.2.

Alternativ kann ein Powershell-Inline-Aufgabenskript $(Get-Date-Format yyyy.MM.dd.HHmm) auf eine leere Variable namens SolutionVersion als Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$Version"), Set Solution Version als $(SolutionVersion) festgelegt werden.

Power Platform – Verbindungsvariablen festlegen

Legt BuildTools.*-Variablen fest, um benutzerdefinierten Skriptaufgaben Zugriff zu gewähren und die Dienstverbindung als zentrale Informationsquelle zu nutzen.

YAML-Snippet (SetConnectionVariables)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-connection-variables.PowerPlatformSetConnectionVariables@2
  displayName: 'Power Platform Set Connection Variables '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
  timeoutInMinutes: 2
  retryCountOnTaskFailure: 5

Parameter (SetConnectionVariables)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformSPN
Power Platform Dienstprinzipal		 Der Dienstendpunkt, für den Sie die Verbindungsvariablen festlegen möchten. Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
timeoutInMinutes
Zeitüberschreitung		 Gibt die maximale Zeit in Minuten an, die eine Aufgabe ausgeführt werden darf, bevor sie vom Server abgebrochen wird. Ein Nullwert weist auf ein unendliches Timeout hin.
retryCountOnTaskFailure
Anzahl der Wiederholungsversuche, wenn die Aufgabe fehlgeschlagen ist		 Gibt die Anzahl der Wiederholungsversuche für diese Aufgabe an, die im Falle eines Aufgabenfehlers ausgeführt werden. Wird für agentenlose Aufgaben nicht unterstützt.
ApplicationId
Anwendungs-ID für die Anmeldung		 (Erforderlich für Benutzername/Kennwort) Anwendungs-ID zur Anmeldung (siehe zusätzlichen Hinweis unten).
RedirectUri
Umleitungs-URI der angegebenen App		 (Erforderlich für Benutzername/Kennwort) Umleitungs-URI der angegebenen App. Wird bei der Angabe einer App-ID benötigt. (siehe zusätzlichen Hinweis unten).

Anmerkung

Bei Verwendung des Authentifizierungstyps Benutzername/Kennwort sind die Anwendungs-ID und die Umleitungs-URI erforderlich. Das Dokument OAuth authentifizieren enthält eine Erklärung, warum Sie für die Authentifizierung mit Dataverse eine App-Registrierung erstellen müssen. Wenn Sie eine Verbindung mit der Authentifizierung Benutzername/Kennwort herstellen, verhält sich die Verbindung wie eine Anwendung, die im Namen eines Benutzenden eine Verbindung mit Dataverse herstellt.

Power Platform – Bereitstellungspaket

Stellt ein Paket in einer Umgebung bereit. Das Bereitstellen des Pakets im Gegensatz zu einer einzelnen Lösungsdatei bietet eine Möglichkeit, mehrere Lösungen, Daten und Code in einer Umgebung bereitzustellen.

YAML-Ausschnitt (Bereitstellen)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.deploy-package.PowerPlatformDeployPackage@2
  displayName: 'Power Platform Deploy Package '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    PackageFile: 'C:\Users\Public\package.dll'
    MaxAsyncWaitTime: 120

Parameter (Bereitstellen)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt, in dem Sie das Packet bereitstellen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
PowerPlatformSPN
Power Platform-Dienstprinzipal		 Der Dienstendpunkt, in dem Sie das Packet bereitstellen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert. Weitere Informationen: siehe BuildTools.EnvironmentUrl unter Power Platform Umgebung erstellen
PackageFile
Paketdatei		 (Erforderlich) Der Pfad und der Dateiname der Paketdateiassembly (.dll).
MaxAsyncWaitTime
Maximale Wartezeit		 Die maximale Wartezeit in Minuten für den asynchronen Vorgang; Standard ist 60 min (1 h), wie der Azure DevOps-Standard für Aufgaben.

Umgebungsverwaltungsaufgaben

Automatisieren Sie ELM-Aufgaben (Environment Lifecycle Management).

Power Platform – Umgebung erstellen

Erstellt eine neue Umgebung. Beim Erstellen einer neuen Umgebung erstellt auch automatisch BuildTools.EnvironmentUrl.

Wichtig

Wenn dies festgelegt ist, wird BuildTools.EnvironmentUrl als Standarddienstverbindung für nachfolgende Aufgaben in der Pipeline verwendet. Jede in diesem Artikel beschriebene Aufgabe verwendet nur den Endpunkt der Dienstverbindung, wenn BuildTools.EnvironmentUrl nicht festgelegt ist.

Ein neues Umgebung kann nur bereitgestellt werden, wenn Ihre Lizenz oder Kapazität die Erstellung zusätzlicher Umgebungen zulässt. Weitere Informationen zum Anzeigen der Kapazität finden Sie unter Details zur Kapazitätsseite.

YAML-Ausschnitt (Create-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@2
  displayName: 'Power Platform Create Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    DisplayName: 'First Coffee test'
    DomainName: firstcoffee

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@2
  displayName: 'Power Platform Create Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    DisplayName: 'First Coffee prod'
    EnvironmentSku: Production
    AppsTemplate: 'D365_CustomerService,D365_FieldService'
    LocationName: canada
    LanguageName: 1036
    CurrencyName: ALL
    DomainName: firstcoffee

Parameter (Create-env)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt, für den Sie die Umgebung erstellen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
PowerPlatformSPN
Power Platform-Dienstprinzipal		 Der Dienstendpunkt, für den Sie die Umgebung erstellen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
DisplayName
Display name		 (Erforderlich) Der Anzeigename der erstellten Umgebung.
LocationName
Bereitstellungsregion		 (Erforderlich) Die Region, in der die Umgebung erstellt werden sollte.
EnvironmentSku
Umgebungstyp		 (Erforderlich) Der Typ der bereitzustellenden Instanz. Optionen sind Sandkasten, Produktion, Test und SubscriptionBasedTrial.
AppsTemplate
Apps		 Für einen Umgebungstyp ohne Testversion werden die Apps D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation und D365_Sales unterstützt.
CurrencyName
Währung		 (Erforderlich) Basiswährung für die erstellte Umgebung. Die Währung kann nicht aktualisiert werden, nachdem die Umgebung erstellt wurde.
LanguageName
Language		 (Erforderlich) Die Ausgangssprache in der Umgebung.
DomainName
Domänenname		 (Erforderlich) Dies ist die umgebungsspezifische Zeichenfolge, die einen Teil der URL bildet. Für eine Umgebung mit der folgenden URL: https://powerappsbuildtasks.crm.dynamics.com/ wäre der Domänenname z.B. 'powerappsbuildtasks'.

Hinweis: Wenn Sie einen Domänennamen eingeben, der bereits verwendet wird, hängt Aufgabe einen numerischen Wert an den Domänennamen an, beginnend mit 0. Für das obige Beispiel könnte die URL zu https://powerappsbuildtasks0.crm.dynamics.com/ werden.

Power Platform – Umgebung löschen

Löschte eine Umgebung.

YAML-Ausschnitt (Delete-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@2
  displayName: 'Power Platform Delete Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'

Parameter (Delete-env)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt, für den Sie die Umgebung löschen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
PowerPlatformSPN
Power Platform-Dienstprinzipal		 Der Dienstendpunkt, für den Sie die Umgebung löschen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.

Power Platform Benutzer zuweisen

Weisen Sie einer Zielumgebung Benutzer mit angegebenen Sicherheitsrollen zu.

YAML-Snippet (AssignUser-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.assign-user.PowerPlatformAssignUser@2
  displayName: 'Power Platform Assign User '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    User: EnvironmentUsername
    Role: 'Environment Maker'
    ApplicationUser: true

Parameter (AssignUser-env)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformSPN
Power Platform Dienstprinzipal		 Der Dienstendpunkt für die Umgebung, die Sie dem Benutzenden zuweisen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
User
Power Platform Benutzername		 Microsoft Entra Objekt-ID oder Prinzipalname des Benutzers, der der Zielumgebung zugewiesen werden soll.
Role
Sicherheitsrolle Name oder ID		 Name oder ID der Sicherheitsrolle, die auf den Benutzer angewendet werden soll.
ApplicationUser
Power Platform Anwendungsbenutzername		 Gibt an, ob der Eingabebenutzer ein Anwendungsbenutzer ist (true|false).

Power Platform Umgebung zurücksetzen

Setzt eine Umgebung zurück.

YAML-Ausschnitt (Reset-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.reset-environment.PowerPlatformResetEnvironment@2
  displayName: 'Power Platform Reset Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    CurrencyName: ALL
    Purpose: 'Reset to PointInTime'
    AppsTemplate: 'D365_CustomerService,D365_FieldService'

Parameter (Reset-env)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt, für den Sie die Umgebung zurücksetzen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
PowerPlatformSPN
Power Platform Dienstprinzipal		 Der Dienstendpunkt, für den Sie die Umgebung zurücksetzen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.

Power Platform – Sicherungsumgebung

Sichert eine Umgebung.

YAML-Ausschnitt (Backup-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.backup-environment.PowerPlatformBackupEnvironment@2
  displayName: 'Power Platform Backup Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    BackupLabel: 'Full backup - $(Build.BuildNumber)'

Parameter (Backup-env)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt, für den Sie die Umgebung sichern möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
PowerPlatformSPN
Power Platform-Dienstprinzipal		 Der Dienstendpunkt, für den Sie die Umgebung sichern möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
BackupLabel
Sicherungsbeschriftung		 (Erforderlich) Die Bezeichnung, die der Sicherung zugewiesen werden soll.

Power Platform – Umgebung kopieren

Kopiert eine Umgebung in eine Zielumgebung. Zwei Arten von Kopien stehen zur Verfügung: vollständig und minimal. Beim vollständigen Kopieren werden sowohl Daten als auch Lösungsmetadaten (Anpassungen) kopiert, während beim minimalen Kopieren nur die Lösungsmetadaten, nicht aber die tatsächlichen Daten kopiert werden.

YAML-Ausschnitt (Copy-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@2
  displayName: 'Power Platform Copy Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@2
  displayName: 'Power Platform Copy Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    CopyType: MinimalCopy
    OverrideFriendlyName: true
    FriendlyName: 'Contoso Test'
    DisableAdminMode: false

Parameter (Copy-env)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt für die Quellumgebung, aus der Sie die Lösung kopieren möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
PowerPlatformSPN
Power Platform-Dienstprinzipal		 Der Dienstendpunkt für die Quellumgebung, aus der Sie die Lösung kopieren möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
TargetEnvironmentUrl
Zielumgebungs-URL		 (Erforderlich) Die URL für die Zielumgebung, in die Sie kopieren möchten.
CopyType
Kopiertyp		 Der Typ der durchzuführenden Kopie: FullCopy oder MinimalCopy
OverrideFriendlyName
Anzeigename überschreiben		 Ändern Sie den Anzeigenamen der Zielumgebung in einen anderen Namen (true|false).
FriendlyName
DisplayName		 Der Anzeigename der Zielumgebung.
DisableAdminMode
Admin-Modus deaktivieren		 Ob der Administrationsmodus deaktiviert werden soll (true|false).

Eine Power Platform-Umgebung wiederherstellen

Stellt eine Umgebung für eine bestimmte Sicherung wieder her.

YAML-Ausschnitt (Restore-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.restore-environment.PowerPlatformRestoreEnvironment@2
  displayName: 'Power Platform Restore Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    RestoreLatestBackup: false
    RestoreTimeStamp: '12/01/2022 09:00'
    FriendlyName: 'Contoso Test'

Parameter (Restore-env)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformEnvironment
Power Platform: Umgebungs-URL		 Der Dienstendpunkt für die Quellumgebung, aus der Sie die Lösung wiederherstellen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
PowerPlatformSPN
Power Platform-Dienstprinzipal		 Der Dienstendpunkt für die Quellumgebung, aus der Sie die Lösung wiederherstellen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
RestoreLatestBackup
Letzte herzustellende Sicherung		 Ob die letzte Sicherung wiederhergestellt oder RestoreTimeStamp (true|false) bereitgestellt werden soll.
RestoreTimeStamp
DateTime der Sicherung		 DateTime der Sicherung im „mm/dd/jjjj hh:mm“-Format ODER als „latest“-Zeichenfolge.
TargetEnvironmentUrl
Zielumgebungs-URL		 (Erforderlich) Die URL für die Zielumgebung, in die Sie wiederherstellen möchten.
FriendlyName
Name der wiederhergestellten Umgebung		 (Optionaler) Name der wiederhergestellten Umgebung.
DisableAdminMode
Admin-Modus deaktivieren		 Ob der Administrationsmodus deaktiviert werden soll (true|false).

Dataverse-Daten exportieren

Exportieren Sie Daten aus einer Umgebung mit dem bereitgestellten Schema.

YAML-Snippet (exportdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-data.PowerPlatformExportData@2
  displayName: 'Power Platform Export Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    SchemaFile: 'C:\tempschema.xml'
    DataFile: exportdata.zip
    Overwrite: true

Parameter (Exportdata-env)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformSPN
Power Platform Dienstprinzipal		 Der Dienstendpunkt für die Umgebung, aus der Sie Daten exportieren möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
SchemaFile
Name der XML Schemadatei		 Name der XML Schemadatei. Sie kann mit dem dem Configuration Migration ootl erstellt werden.
DataFile
Datendateiname		 Dateiname für den Datenexport (ZIP-Datendatei).
Overwrite
Inhalt überschreiben		 Power Pages Website-Inhalte zum Überschreiben (true|false).

Dataverse Daten importieren

Daten in eine Umgbung importieren.

YAML-Snippet (importdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-data.PowerPlatformImportData@2
  displayName: 'Power Platform Import Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DataFile: 'C:\Data\Import.zip'

Parameter (importdata-env)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformSPN
Power Platform Dienstprinzipal		 Der Dienstendpunkt für die Umgebung, in die Sie Daten importieren möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
DataFile
Datendateiname		 Dateiname für die zu importierende komprimierte ZIP-Datei oder der Ordner mit data-schema.xml und data.xml, die importiert werden sollen.

Power Pages Schlüsselverwaltungsaufgaben

Aufgaben zum Arbeiten mit einer Power Pages Website.

Power Platform PAPortal herunterladen

Inhalt der Power Pages-Website der aktuellen Dataverse-Umgebung herunterladen.

YAML-Ausschnitt (PAPortal herunterladen)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.download-paportal.PowerPlatformDownloadPaportal@2
  displayName: 'Power Platform Download PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DownloadPath: 'C:\portals'
    WebsiteId: 'f88b70cc-580b-4f1a-87c3-41debefeb902'
    Overwrite: true

Parameter (paportal herunterladen)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformSPN
Power Platform Dienstprinzipal		 Der Dienstendpunkt für die Umgebung, aus der Sie Inhalte herunterladen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
WebsiteId
Portalwebsite-ID		 Power Pages Website-ID zum Herunterladen.
Overwrite
Inhalt überschreiben		 Power Pages Website-Inhalte zum Überschreiben (true|false).
ModelVersion
Website-Datenmodell		 Gibt an, ob die hochzuladenden Websitedaten das Standard-Datenmodell (1) oder das erweiterte Datenmodell (2) verwenden. Standardwert ist „1“.

Power Platform PAPortal hochladen

Hochladen von Power Pages Website-Inhalten in die aktuelle Dataverse Umgebung.

YAML-Ausschnitt (Paportal hochladen)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.upload-paportal.PowerPlatformUploadPaportal@2
  displayName: 'Power Platform Upload PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    UploadPath: 'C:\portals\starter-portal'

Parameter (paportal hochladen)

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformSPN
Power Platform Dienstprinzipal		 Der Dienstendpunkt für die Umgebung, in die Sie Inhalte hochladen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
UploadPath
Inhaltpfad hochladen		 Pfad, aus dem die Power Pages-Websiteinhalte hochgeladen werden.
ModelVersion
Website-Datenmodell		 Gibt an, ob die hochzuladenden Websitedaten das Standard-Datenmodell (1) oder das erweiterte Datenmodell (2) verwenden. Standardwert ist „1“.

Katalog für Power Platform-Aufgaben (Vorschau)

Diese Aufgaben führen Aktionen für den Katalog in Power Platform aus und umfassen Folgendes.

Anmerkung

Derzeit sind Katalogaufgaben für Power Platform eine Vorschauversion.

Katalogelement installieren

Installieren Sie ein Catalog-Element in der Zielumgebung.

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformSPN
Power Platform Dienstprinzipal		 Der Dienstendpunkt für die Umgebung, in die Sie Inhalte hochladen möchten (zum Beispiel https://powerappsbuildtools.crm.dynamics.com). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
Environment
Zielumgebungs-URL		 (Erforderlich) Umgebungs-URL, auf die diese Aufgabe abzielt
CatalogItemId
Katalogelement-ID, die installiert werden soll		 (Erforderlich) Katalogelement, das in der Zielumgebung installiert werden soll
TargetEnvironmentUrl
Zielumgebungs-URL		 (Erforderlich) Die URL der Zielumgebung für die Installation von Katalogelementen (zum Beispiel „https://YourOrg.crm.dynamics.com“).
PollStatus
Umfragestatus überprüfen		 (Optional) Umfrage zur Überprüfung des Status Ihrer Anfrage (wahr|falsch)

Parameter (catalog-install)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.install-catalog.PowerPlatformInstallCatalog@2
  displayName: 'Power Platform Install Catalog '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    CatalogItemId: '00000000-0000-0000-0000-000000000001'
    TargetEnvironmentUrl: 'https://test.crm.dynamics.com/'
    PollStatus: true

Kataloggenehmigung einreichen

Catalog-Genehmigungsanforderung übermitteln

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformSPN
Power Platform Dienstprinzipal		 Der Dienstendpunkt für die Umgebung, in die Sie Inhalte hochladen möchten (zum Beispiel „https://powerappsbuildtools.crm.dynamics.com“). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
Environment
Zielumgebungs-URL		 (Erforderlich) Umgebungs-URL, auf die diese Aufgabe abzielt
CatalogSubmissionFile
Datei zur Katalogübermittlung		 (Erforderlich) Geben Sie den Pfad und Dateinamen der Datei zur Katalogübermittlung ein.
UsePackageSolutionZipFile
Dateityp		 Dateityp: Paket- oder Lösungs-ZIP-Datei.
SolutionZipFile
ZIP-Dateiname der Lösung		 Geben Sie den Pfad und den ZIP-Dateinamen der Lösung ein.
PollStatus
Umfragestatus überprüfen		 (Optional) Umfrage zur Überprüfung des Status Ihrer Anfrage (wahr|falsch)

Parameter (catalog-submit)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.submit-catalog.PowerPlatformSubmitCatalog@2
  displayName: 'Power Platform Submit Catalog '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    CatalogSubmissionFile: submission.json
    UsePackageSolutionZipFile: true
    FileType: SolutionZipFile
    SolutionZipFile: solution.zip
    PollStatus: true

Kataloganforderungsstatus

Den Status der Kataloginstallation/Übermittlungsanfrage abrufen

Parameter Beschreibung
authenticationType
Authentifizierungstyp		 (Für SPN erforderlich) Geben Sie entweder PowerPlatformEnvironment für eine Benutzername/Passwort-Verbindung oder PowerPlatformSPN für eine geheime Dienstprinzipal-/Client-Verbindung an.
PowerPlatformSPN
Power Platform Dienstprinzipal		 Der Dienstendpunkt für die Umgebung, in die Sie Inhalte hochladen möchten (zum Beispiel „https://powerappsbuildtools.crm.dynamics.com“). Unter Dienstverbindungen in Projekteinstellungen mithilfe des Power Platform-Verbindungstyps definiert.
Environment
Zielumgebungs-URL		 (Erforderlich) Umgebungs-URL, auf die diese Aufgabe abzielt
TrackingId
Nachverfolgungs-ID anfordern		 (Erforderlich) Nachverfolgungs-ID anfordern
RequestType
Anforderungstyp		 (Erforderlich) Anforderungstyp (Werte: Installieren | Einreichen).

Parameter (catalog-status)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.catalog-status.PowerPlatforCatalogStatus@2
  displayName: 'Power Platform Catalog Status '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    TrackingId: '00000000-0000-0000-0000-000000000002'
    RequestType: Submit

Erstellen und Freigeben von Pipelines

Nachdem wir festgestellt haben, was mit den Build Tools erreicht werden kann, wollen wir nun sehen, wie Sie diese Tools auf Ihre Erstell- und Veröffentlichungspipelines anwenden können. Ein konzeptioneller Überblick ist unten dargestellt. Nun sehen wir uns einige Details der Pipeline-Implementierung mit den Aufgaben des Build Tools in den folgenden Unterabschnitten an.

Um mehr über die Erstellung dieser Pipelines zu erfahren und Pipeline-Authoring mit den Microsoft Power Platform Build Tools tatsächlich praktisch durchzuführen, füllen Sie die Build Tools-Labs aus, die Sie von GitHub herunterladen können.

Weitere Informationen über Azure Pipelines: Azure Pipelines verwenden

Pipeline erstellen: Exportieren einer Lösung aus einer Entwicklungsumgebung (DEV)

Die folgende Abbildung zeigt die Aufgaben des Build Tools, die Sie zu einer Pipeline hinzufügen können, die eine Lösung aus einer Entwicklungsumgebung exportiert.

Eine Lösung aus einer Entwicklungsumgebung (DEV) exportieren

Pipeline erstellen: Erstellen einer verwalteten Lösung

Die folgende Abbildung zeigt die Aufgaben des Build Tools, die Sie zu einer Pipeline hinzufügen können, die eine verwaltete Lösung erstellt.

Eine verwaltete Lösung erstellen

Veröffentlichungspipeline: Bereitstellung in einer Produktionsumgebung (PROD)

Die folgende Abbildung zeigt die Aufgaben des Build Tools, die Sie zu einer Pipeline hinzufügen können, die in einer Produktionsumgebung bereitgestellt wird.

In einer Produktionsumgebung (PROD) bereitstellen

Siehe auch

Microsoft Power Platform Erstellen Sie Tools für Azure DevOps