Taken in Microsoft Power Platform Build Tools

De beschikbare build-taken worden beschreven in de volgende secties. Daarna zullen we een voorbeeld laten zien van Azure DevOps-pipelines die gebruikmaken van deze taken. Zie Microsoft Power Platform Bouw Tools voor Azure DevOps voor informatie over de Build Tools en hoe u deze kunt downloaden.

Help-taak

De beschikbare helpertaken worden hieronder beschreven.

Power Platform-taak Installatieprogramma voor tool

Deze taak moet één keer worden toegevoegd voor andere Power Platform Build Tools-taken in build- en release-pipelines. Deze taak installeert een set Power Platform-specifieke hulpprogramma's die de agent nodig heeft om de Microsoft Power Platform-buildtaken uit te voeren. Deze taak vereist geen configuratie meer wanneer deze wordt toegevoegd, maar bevat parameters voor de specifieke versies van elk van de hulpprogramma's die worden geïnstalleerd.

Als u up-to-date wilt blijven met de toolversies, moet u ervoor zorgen dat deze parameters overeenkomen met de versies van de tools die nodig zijn om de pipeline correct te laten werken.

YAML-fragment (Installer)

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

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

Parameters (Installer)

Power Platform WhoAmI

Verifieert een Power Platform-omgevingsserviceverbinding door verbinding te maken en een WhoAmI-verzoek te doen. Deze taak kan handig zijn om vroeg in de pipeline op te nemen om de connectiviteit te verifiëren voordat de verwerking begint.

YAML-fragment (WhoAmI)

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@0
  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@0
  displayName: 'Power Platform WhoAmI'

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

Parameters (WhoAmI)

Kwaliteitscontrole

Hieronder worden de beschikbare taken vermeld om de kwaliteit van een oplossing te controleren.

Power Platform-controle

Met deze taak wordt een statische analysecontrole uitgevoerd op uw oplossingen aan de hand van een reeks aanbevolen procedures om eventuele problematische patronen te identificeren die u mogelijk onbedoeld hebt geïntroduceerd bij het bouwen van uw oplossing.

YAM-fragment (controle)

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  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@0
  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'

Parameters (controle)

Oplossingstaken

Deze set taken kan oplossingsacties automatiseren. De omgevingstaken die verderop in dit gedeelte worden beschreven en waarmee een omgeving wordt gemaakt, gekopieerd of hersteld, overschrijven de serviceverbindingen met de nieuw gemaakte omgevingen. Dit maakt het mogelijk om oplossingstaken uit te voeren voor omgevingen die op aanvraag worden gemaakt.

Power Platform-taak Oplossing importeren

Importeert een oplossing in een doelomgeving.

YAML-fragment (Import)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
  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@0
  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

Parameters (Import)

Power Platform Upgrade van oplossing toepassen

Upgradet een oplossing die is geïmporteerd als een tijdelijke oplossing.

YAML-fragment (Upgrade)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@0
  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@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    MaxAsyncWaitTime: 45

Parameters (Upgrade)

Power Platform-taak Oplossing exporteren

Exporteert een oplossing vanuit een bronomgeving.

YAML-fragment (Export)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  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@0
  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

Parameters (Export)

Power Platform-taak Oplossing uitpakken

Hierbij wordt een gecomprimeerd oplossingsbestand uitgepakt in meerdere XML-bestanden en andere bestanden, zodat deze bestanden eenvoudiger kunnen worden gelezen en beheerd door een bronbeheersysteem.

YAML-fragment (Unpack)

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

Parameters (Unpack)

Power Platform-taak Oplossing verpakken

Hiermee wordt een oplossing verpakt die wordt weergegeven in bronbeheer in het bestand solution.zip, dat in een andere omgeving kan worden geïmporteerd.

YAML-fragment (Pack)

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

Parameters (Pack)

Power Platform Oplossing verwijderen

Verwijdert een oplossing in de doelomgeving.

YAML-fragment (Delete)

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

Parameters (Delete)

Power Platform-taak Aanpassingen publiceren

Publiceert alle aanpassingen in een omgeving.

YAML-fragment (Publish)

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

Parameters (Publish)

Power Platform-taak Versie van oplossing instellen

Werkt de versie van een oplossing bij.

YAML-fragment (Version)

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

Parameters (Version)

Hoewel het versienummer in de pipeline hard kan worden gecodeerd, wordt aanbevolen om een Azure DevOps-pipeline-variabele zoals BuildId te gebruiken. Dit biedt opties om de exacte vorm van het versienummer te definiëren op het tabblad "Opties", bijvoorbeeld: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Deze definitie kan vervolgens worden gebruikt in de taak Oplossingsversie instellen door de eigenschap Versienummer in te stellen met: $(Build.BuildId) in plaats van harde codering 20200824.0.0.2.

Als alternatief de uitvoer van een PowerShell inline taakscript $(Get-Date -Format yyyy.MM.dd.HHmm) ingesteld op lege variabele met de naam SolutionVersion als Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), oplossingsversie instellen als $(SolutionVersion).

Power Platform-taak Pakket implementeren

Implementeert een pakket naar een omgeving. Door een pakket te implementeren in plaats van één oplossingsbestand, kunt u meerdere oplossingen, gegevens en code in een omgeving implementeren.

YAML-fragment (Deploy)

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

Parameters (Deploy)

Omgevingsbeheertaken

Automatiseer algemene taken voor het beheer van de omgevingslevenscyclus (ELM).

Power Platform-taak Omgeving maken

Maak een nieuwe omgeving. Met het maken van een nieuwe omgeving wordt ook automatisch BuildTools.EnvironmentUrl gemaakt.

YAML-fragment (Create-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@0
  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@0
  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

Parameters (Create-env)

Power Platform-taak Omgeving verwijderen

Hiermee verwijdert u een omgeving.

YAML-fragment (Delete-env)

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

Parameters (Delete-env)

Power Platform-taak Back-up maken van omgeving

Hiermee wordt een back-up van een omgeving gemaakt.

YAML-fragment (Backup-env)

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

Parameters (Backup-env)

Power Platform-taak Omgeving kopiëren

Hiermee wordt een omgeving naar een doelomgeving gekopieerd. Er zijn twee soorten kopieën beschikbaar: volledig en minimaal. Een volledige kopie bevat zowel gegevens als oplossingsmetagegevens (aanpassingen), terwijl een minimale kopie alleen metagegevens van de oplossing en niet de feitelijke gegevens bevat.

YAML-fragment (Copy-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@0
  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@0
  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

Parameters (Copy-env)

Pijplijnen voor maken en vrijgeven

Nu we hebben vastgesteld wat er met de build-tools kan worden gedaan, gaan we kijken hoe u deze tools kunt toepassen op uw build- en release-pijplijnen. Hieronder vindt u een conceptueel overzicht. In de volgende subsecties bekijken we een aantal details van de pipeline-implementatie met behulp van de taken voor Build Tools.

Als u meer wilt weten over het maken van deze pipelines en het daadwerkelijk maken van pipelines met behulp van de Microsoft Power Platform Build Tools, volgt u de labs voor Build Tools. U kunt deze downloaden van GitHub.

Meer informatie over Azure DevOps-pijpleidingen: Azure Pipelines

Build-pipeline: Een oplossing exporteren vanuit een ontwikkelomgeving (DEV)

De volgende afbeelding toont de taken van de build-tool die u zou kunnen toevoegen aan een pijplijn die een oplossing exporteert vanuit een ontwikkelomgeving.

Build-pipeline: Bouw een beheerde oplossing

De volgende afbeelding toont de taken van de build-tool die u zou kunnen toevoegen aan een pijplijn die een beheerde oplossing bouwt.

Release-pipeline: Implementeren naar een productieomgeving (PROD)

De volgende afbeelding toont de taken van de build-tool die u zou kunnen toevoegen aan een pijplijn die implementeert naar een productieomgeving.

Zie ook

Microsoft Power Platform Build Tools voor Azure DevOps