Tâches Microsoft Power Platform Build Tools

Les tâches de build disponibles sont décrites dans les sections suivantes. Ensuite, nous présentons quelques exemples Azure Pipelines faisant usage de ces tâches. Pour plus d’informations sur Build Tools et comment le télécharger, consultez Microsoft Power Platform Build Tools pour Azure Pipelines.

Tâche d’aide

Les tâches d’aide disponibles sont décrites ci-après.

Programme d’installation de l’outil Power Platform

Cette tâche doit être ajoutée une fois avant toute autre tâche Power Platform Build Tools dans les pipelines de génération et de publication. Cette tâche installe un ensemble d'outils spécifiques à Power Platform requis par l'assistant pour exécuter les tâches de build de Microsoft Power Platform. Cette tâche ne requiert aucune configuration supplémentaire. Cette tâche contient des paramètres pour les versions spécifiques de chacun des outils en cours d’installation.

Pour rester à jour avec les versions d’outils au fil du temps, assurez-vous que ces paramètres correspondent aux versions des outils nécessaires au bon fonctionnement du pipeline.

Extrait YAML (programme d’installation)

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

# Installs default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    AddToolsToPath: true

# 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

Paramètres (programme d’installation)

Power Platform QuiSuisJe

Vérifie une connexion au service d’environnement Power Platform en vous connectant et en effectuant une requête WhoAmI. Cette tâche peut être utile à inclure tôt dans le pipeline, pour vérifier la connectivité avant le début du traitement.

Extrait YAML (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'

Paramètres (WhoAmI)

Contrôle de la qualité

La section suivante présente les tâches disponibles pour vérifier la qualité d’une solution.

Power Platform Checker

Cette tâche exécute un contrôle d’analyse statique sur vos solutions par rapport à un ensemble de règles de bonnes pratiques pour identifier tous les modèles problématiques que vous pourriez avoir introduits par inadvertance lors de la création de votre solution.

Extrait YAML (vérificateur)

# 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'

Paramètres (vérificateur)

Tâches de solution

Cet ensemble de tâches peut automatiser les actions de la solution. Les tâches d’environnement mises en avant ultérieurement dans cette section, permettant de créer, copier ou restaurer un environnement remplacent les connexions de service avec les environnements récemment créés. Ces tâches permettent d’exécuter des tâches de solution dans des environnements créés à la demande.

Solution d’importation Power Platform

Importe une solution dans un environnement cible.

Extrait YAML (Importation)

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

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

Paramètres (Importation)

Power Platform - Ajouter un composant de solution

Ajoute un composant de solution à une solution non gérée.

Extrait YAML (Ajouter)

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

Paramètres (Ajouter)

Power Platform - Appliquer la mise à niveau de la solution

Met à niveau une solution qui a été importée en tant que solution d’attente.

Extrait YAML (Mise à niveau)

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

Paramètres (Mise à niveau)

Solution d’exportation Power Platform

Exporte une solution à partir d’un environnement source.

Extrait YAML (Exportation)

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

Paramètres (Exportation)

Solution de décompression Power Platform

Prend un fichier de solution compressé et le décompose en plusieurs fichiers XML, afin qu’ils puissent être plus facilement lus et gérés par un système de contrôle de code source.

Extrait YAML (Décompresser)

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

Paramètres (Décompresser)

Solution de compression Power Platform

Compresse une solution représentée dans le contrôle source dans un fichier solution.zip pouvant être importé dans un autre environnement.

Extrait YAML (Compresser)

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

Paramètres (Compresser)

Power Platform – Supprimer la solution

Ensuite, importez la solution dans l’environnement cible.

Extrait YAML (Supprimer)

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'

Paramètres (Supprimer)

Personnalisations de publication Power Platform

Publie toutes les personnalisations dans un environnement.

Extrait YAML (Publier)

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

Paramètres (Publier)

Version de la solution définie Power Platform

Met à jour la version d’une solution.

Extrait YAML (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

Paramètres (Version)

Si le numéro de version peut être codé en dur dans le pipeline, il est recommandé d’utiliser une variable de pipeline Azure DevOps comme BuildId. Cela fournit des options pour définir la forme exacte du numéro de version sous l’onglet "Options", par exemple : $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Cette définition peut ensuite être utilisée dans la tâche Définir la version de la solution en définissant la propriété Numéro de version avec : $(Build.BuildId) au lieu de coder en dur 20200824.0.0.2.

Sinon une sortie de script de tâche en ligne powershell $(Get-Date -Format yyyy.MM.dd.HHmm) définie sur une variable vide nommée SolutionVersion comme Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Set Solution Version en tant que $(SolutionVersion).

Définir les variables de connexion Power Platform

Définit des PowerPlatformSetConnectionVariables.BuildTools.* variables pour fournir un accès aux tâches de script personnalisées pour utiliser la connexion de service comme source unique de vérité.

Les variables suivantes sont définies :

• PowerPlatformSetConnectionVariables.BuildTools.TenantId
• PowerPlatformSetConnectionVariables.BuildTools.ApplicationId
• PowerPlatformSetConnectionVariables.BuildTools.ClientSecret
• PowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString

Extrait YAML (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

Paramètres (SetConnectionVariables)

Package de déploiement Power Platform

Déploie un package dans un environnement. Le déploiement d’un package, contrairement à un fichier de solution unique, fournit une option pour déployer plusieurs solutions, données, codes dans un environnement.

Extrait YAML (Déployer)

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

Paramètres (Déployer)

Tâches de gestion d’environnement

Automatisez les tâches de gestion du cycle de vie de l’environnement commun (ELM).

Créer un environnement Power Platform

Crée un environnement. La création d’un nouvel environnement crée également automatiquement BuildTools.EnvironmentUrl.

Extrait YAML (Créer-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

Paramètres (Créer-env)

Supprimer un environnement Power Platform

Supprime un environnement.

Extrait YAML (Supprimer-env)

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

Paramètres (Supprimer-env)

Attribuer des utilisateurs Power Platform

Attribuez un utilisateur à un environnement cible avec le rôle de sécurité spécifié.

Extrait YAML (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

Paramètres (AssignUser-env)

Environnement de réinitialisation Power Platform

Réinitialise un environnement.

Extrait YAML (Rétablir-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'

Paramètres (Rétablir-env)

Environnement de sauvegarde Power Platform

Sauvegarde un environnement.

Extrait YAML (Sauvegarder-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)'

Paramètres (Sauvegarder-env)

Environnement de copie Power Platform

Copie un environnement dans un environnement cible. Deux types de copies sont disponibles : complète et minimale. Une copie Complète inclut les données et les métadonnées de la solution (personnalisations), alors qu’une copie Minimale inclut uniquement les métadonnées de la solution mais pas les données réelles.

Extrait YAML (Copier-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'
    SkipAuditData: true
    MaxAsyncWaitTime: 60

Paramètres (Copier-env)

Environnement de restauration Power Platform

Restaure un environnement à une sauvegarde donnée.

Extrait YAML (Restaurer-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'

Paramètres (Restaurer-env)

Exporter les données Dataverse

Exportez les données d’un environnement avec le schéma fourni.

Extrait YAML (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

Paramètres (exportdata-env)

Importer les données Dataverse

Importez des données dans un environnement.

Extrait YAML (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'

Paramètres (importdata-env)

Tâches Power Pages Management

Tâches pour utiliser un site web Power Pages.

Télécharger PAPortal Power Platform

Téléchargez le contenu du site web Power Pages de l’environnement Dataverse actuel.

Extrait YAML (download-paportal)

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

Paramètres (download-paportal)

Charger PAPortal Power Platform

Chargez le contenu du site web Power Pages vers l’environnement Dataverse actuel.

Extrait YAML (upload-paportal)

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'

Paramètres (upload-paportal)

Catalogue pour les tâches Power Platform (version préliminaire)

Ces tâches exécutent des actions sur le catalogue dans Power Platform et incluent ce qui suit.

Installer l’élément du catalogue

Installez un élément de catalogue dans l’environnement cible.

Paramètres (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

Soumettre l’approbation du catalogue

Permet de soumettre la demande d’approbation de Catalog.

Paramètres (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

Statut de la demande du catalogue

Obtenez le statut de la demande d’installation/de soumission du catalogue.

Paramètres (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

Pipelines de build et de version

Maintenant que nous avons identifié ce qui peut être fait à l’aide des build tools, voyons comment vous pouvez appliquer ces outils à vos pipelines de build et de version. Un aperçu conceptuel est présenté ci-dessous. Voyons quelques détails de l’implémentation du pipeline à l’aide des tâches des build tools dans les sous-sections qui suivent.

Pour en savoir plus sur la création de ces pipelines et sur la création pratique de pipelines à l'aide de Microsoft Power Platform Build Tools, effectuez les ateliers build tools, en téléchargement sur GitHub.

Plus d’informations sur Azure Pipelines : Utiliser Azure Pipelines

Pipeline de build : Exporter une solution à partir d’un environnement de développeur (DEV)

La figure suivante montre les tâches de build tools que vous pouvez ajouter à un pipeline qui exporte une solution à partir d’un environnement de développeur.

Pipeline de build : Créer un solution gérée

La figure suivante montre les tâches de build tools que vous pouvez ajouter à un pipeline qui crée une solution gérée.

Pipeline des versions : Déploiement dans un environnement de production (PROD)

La figure suivante montre les tâches de build tools que vous pouvez ajouter à un pipeline qui se déploie dans un environnement de production.

Voir aussi

Microsoft Power Platform Build Tools pour Azure DevOps