Taken in Microsoft Power Platform Build Tools

  • Artikel

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

Help-taak

De beschikbare helpertaken worden hierna 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. Met deze taak wordt een set Power Platform-specifieke hulpprogramma's geïnstalleerd die de agent nodig heeft om de Microsoft Power Platform-buildtaken uit te voeren. Deze taak vereist geen aanvullende configuratie bij toevoeging. Deze taak 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)

Parameters Beschrijving
DefaultVersion
Standaardversies van hulpprogramma's gebruiken		 Instellen op waar om de standaardversie van alle hulpprogramma's te gebruiken, anders op onwaar. Vereist (en onwaar) als er versies van hulpprogramma's zijn opgegeven.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Versie van hulpprogramma		 De specifieke versie van het hulpprogramma die gebruikt moet worden.

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)

Parameters Beschrijving
authenticationType
Type verificatie		 (Optioneel) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt voor de omgeving waarmee verbinding moet worden gemaakt. Gedefinieerd onder Serviceverbindingen in Projectinstellingen. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt voor de omgeving waarmee verbinding moet worden gemaakt. Gedefinieerd onder Serviceverbindingen in Projectinstellingen.

Kwaliteitscontrole

In de volgende sectie 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)

Parameters Beschrijving
PowerPlatformSPN
Serviceverbinding		 (Vereist) Een verbinding met een gelicentieerde Microsoft Power Platform-omgeving is vereist voor gebruik van de Power Platform-controle. Serviceverbindingen worden gedefinieerd in Serviceverbindingen onder Projectinstellingen via het Power Platform-verbindingstype. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform-omgeving maken

Opmerking: Service-principal en gebruikersnaam/wachtwoord zijn de enige verificatiemethoden die beschikbaar zijn voor de controletaak. Zie De service principal-verbindingen configureren voor Power Platform-omgevingen voor meer informatie over het configureren van service-principals voor gebruik met deze taak.
UseDefaultPACheckerEndpoint
Gebruik standaard eindpunt voor Power Platform-controle		 Standaard (waar), gebruikt de geografische locatie van de controleservice dezelfde geografie als de omgeving waarmee u verbinding maakt.
CustomPACheckerEndpoint
Aangepast eindpunt van PAC-controle		 Vereist wanneer UseDefaultPACheckerEndpointonwaar is. U kunt bijvoorbeeld een andere geografische locatie opgeven, kijk bijvoorbeeld https://japan.api.advisor.powerapps.com.voor een lijst met beschikbare geografische gebieden naar De API voor Power Platform-controle gebruiken.
FileLocation
Locatie van te analyseren bestanden		 Vereist bij het verwijzen naar een bestand vanuit een SAS-URL (Shared Access Signature) sasUriFile.

Opmerking: het is belangrijk om te verwijzen naar een geëxporteerd oplossingsbestand en niet naar de uitgepakte bronbestanden in uw opslagplaats. Zowel beheerde als onbeheerde oplossingsbestanden kunnen worden geanalyseerd.
FilesToAnalyzeSasUri
SAS-bestanden om te analyseren		 Vereist wanneer FileLocation is ingesteld op sasUriFile. Voer de SAS-URI in. U kunt meer dan één SAS-URI toevoegen via een door komma's (,) of puntkomma's (;) gescheiden lijst.
FilesToAnalyze
Lokale bestanden om te analyseren		 Vereist wanneer SAS-bestanden niet worden geanalyseerd. Geef het pad en de bestandsnaam op van de .zip-bestanden die u wilt analyseren. U kunt jokertekens gebruiken. Voer bijvoorbeeld **\*.zip in voor alle ZIP-bestanden in alle submappen.
FilesToExclude
Lokale bestanden om uit te sluiten		 Geef de namen op van bestanden die van de analyse moeten worden uitgesloten. Als er meer dan één zijn, geef dit dan aan in een door komma's (,) of puntkomma's (;) gescheiden lijst. Deze lijst kan een volledige bestandsnaam bevatten of een naam met voorloop- of volgjokertekens, zoals *jquery of form.js
RulesToOverride
Regels om te overschrijven		 Een JSON-array met regels en niveaus die moeten worden overschreven. Geaccepteerde waarden voor OverrideLevel zijn: Kritiek, Hoog, Gemiddeld, Laag, Informatief. Voorbeeld: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Regelset		 (Vereist) Geef op welke regelset u wilt toepassen. De volgende twee regelsets zijn beschikbaar:
  • Oplossingscontrole: deze regelset is dezelfde als degene die wordt uitgevoerd vanaf de Power Apps Maker Portal.
  • AppSource: de uitgebreide regelset die wordt gebruikt om een toepassing te certificeren voordat deze kan worden gepubliceerd in AppSource.
ErrorLevel
Foutniveau		 In combinatie met de drempelwaardeparameter voor fouten wordt de ernst van toegestane fouten en waarschuwingen gedefinieerd. Ondersteunde drempelwaarden zijn <level>IssueCount waarbij level=Kritiek, Hoog, Gemiddeld, Laag en Informatief.
ErrorThreshold
Drempelwaarde voor fouten		 Definieert het aantal fouten (>=0) van een bepaald niveau dat de controle mag passeren voor de oplossingen die worden gecontroleerd.
FailOnPowerAppsCheckerAnalysisError
Niet doorgaan bij fout		 Wanneer waar, dan mislukt als de Power Apps-controleanalyse wordt geretourneerd als Failed of FinishedWithErrors.
ArtifactDestinationName
DevOps-artefactnaam		 Specificeer de Azure Artifacts-naam voor het .sarif-bestand van de 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. Deze taken maken 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)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt waarin u de oplossing wilt importeren (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt waarin u de oplossing wilt importeren (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
SolutionInputFile
Invoerbestand voor oplossing		 (Vereist) Het pad en de bestandsnaam van het bestand solution.zip om in de doelomgeving te importeren (bijvoorbeeld $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Opmerking: variabelen zijn een handige manier om belangrijke stukjes gegevens in verschillende delen van uw pijplijn te introduceren. Zie Vooraf gedefinieerde variabelen gebuiken voor een uitgebreide lijst.
HoldingSolution
Importeren als tijdelijke oplossing		 Een geavanceerde parameter (waar|onwaar) die wordt gebruikt wanneer een oplossing moet worden geüpgraded. Deze parameter host de oplossing in Dataverse, maar de oplossing wordt pas geüpgraded als de taak Oplossingsupgrade toepassen is uitgevoerd.
OverwriteUnmanagedCustomizations
Overschrijven van onbeheerde aanpassingen		 Geef op of niet-beheerde aanpassingen moeten worden overschreven (waar|onwaar).
SkipProductUpdateDependencies
Afhankelijkheden van productupdates overslaan		 Geef op of het afdwingen van afhankelijkheden met betrekking tot productupdates moet worden overgeslagen (waar|onwaar).
ConvertToManaged
Converteren naar beheerd		 Geef aan of u wilt importeren als een beheerde oplossing (waar|onwaar).
AsyncOperation
Asynchrone import		 Indien geselecteerd (waar), wordt de importbewerking asynchroon uitgevoerd. Dit wordt aanbevolen voor grotere oplossingen omdat bij deze taak anders automatisch na 4 minuten een time-out optreedt. Als u asynchroon selecteert, wordt er gepeild en gewacht tot MaxAsyncWaitTime is bereikt (waar|onwaar).
MaxAsyncWaitTime
Maximale wachttijd		 Maximale wachttijd in minuten voor de asynchrone bewerking; standaard is 60 min (1 uur), hetzelfde als Azure DevOps-standaard voor taken.
PublishWorkflows
Processen activeren na import		 Geef aan of er processen (werkstromen) in de oplossing moeten worden geactiveerd na het importeren (waar|onwaar).
UseDeploymentSettingsFile
Bestand met implementatie-instellingen gebruiken		 Verbindingsverwijzingen en/of waarden van omgevingsvariabelen kunnen worden ingesteld met behulp van een bestand met implementatie-instellingen (waar|onwaar).
DeploymentSettingsFile
Bestand met implementatie-instellingen		 (Vereist wanneer UseDeploymentSettingsFile=waar) Het pad en de bestandsnaam van het bestand met implementatie-instellingen.

Power Platform Oplossingsonderdeel toevoegen

Voegt een oplossingsonderdeel toe aan een onbeheerde oplossing.

YAML-fragment (Toevoegen)

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

Parameters (Toevoegen)

Parameters Beschrijving
ComponentId
Id van het oplossingsonderdeel		 De schemanaam of id van het onderdeel dat moet worden toegevoegd aan de doeloplossing.
ComponentType
Power Platform-omgevings-URL		 De waarde die het oplossingsonderdeel vertegenwoordigt dat u toevoegt. Zie Vooraf gedefinieerde onderdeeltypen gebruiken voor een uitgebreide lijst met onderdeelwaarden.
SolutionUniqueName
Naam van de oplossing		 Unieke naam van de oplossing.
AddRequiredComponents
Alle onderdelen die zijn vereist van andere oplossing, afhankelijk van het oplossingsonderdeel		 (Optioneel) Geeft aan of andere oplossingsonderdelen die zijn vereist voor het oplossingsonderdeel dat u toevoegt, eveneens moeten worden toegevoegd aan de onbeheerde oplossing.
Environment
Omgevings-URL of -id		 (Optioneel) Omgevings-URL of -id van de doelomgeving.

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)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt waarin u de oplossing wilt upgraden (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt waarin u de oplossing wilt upgraden (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
SolutionName
Oplossingsnaam		 (Vereist) De naam van de oplossing om de upgrade op toe te passen. Gebruik altijd de Naam van de oplossing, niet de Weergavenaam.
AsyncOperation
Asynchrone upgrade		 Indien geselecteerd (waar), wordt de upgradebewerking als een asynchrone batchtaak uitgevoerd. Als u asynchroon selecteert, wordt er gepeild en gewacht tot MaxAsyncWaitTime is bereikt.
MaxAsyncWaitTime
Maximale wachttijd		 Maximale wachttijd in minuten voor de asynchrone bewerking; standaard is 60 min (1 uur), hetzelfde als Azure DevOps-standaard voor taken.

Notitie

Variabelen zijn een handige manier om belangrijke stukjes gegevens in verschillende delen van uw pijplijn te introduceren. Zie Vooraf gedefinieerde variabelen gebuiken voor een uitgebreide lijst. U kunt informatie over verbindingsverwijzingen en omgevingsvariabelen vooraf invullen voor de doelomgeving terwijl u een oplossing importeert met behulp van een bestand met implementatie-instellingen.

Meer informatie: Verbindingsverwijzingen en omgevingsvariabelen vooraf invullen voor geautomatiseerde implementaties

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)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt waarin u de oplossing wilt upgraden (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt waarin u de oplossing wilt upgraden (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
SolutionName
Oplossingsnaam		 (Vereist) De naam van de te exporteren oplossing. Gebruik altijd de Naam van de oplossing, niet de Weergavenaam.
SolutionOutputFile
Uitvoerbestand voor oplossing		 (Vereist) Het pad en de bestandsnaam van het bestand solution.zip om naar de doelomgeving te exporteren (bijvoorbeeld $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Opmerking: variabelen zijn een handige manier om belangrijke stukjes gegevens in verschillende delen van uw pijplijn te introduceren. Zie Vooraf gedefinieerde variabelen gebuiken voor een uitgebreide lijst.
AsyncOperation
Asynchrone export		 Indien geselecteerd (waar), wordt de exportbewerking als een asynchrone batchtaak uitgevoerd. Als u asynchroon selecteert, wordt er gepeild en gewacht tot MaxAsyncWaitTime is bereikt.
MaxAsyncWaitTime
Maximale wachttijd		 Maximale wachttijd in minuten voor de asynchrone bewerking; standaard is 60 min (1 uur), hetzelfde als Azure DevOps-standaard voor taken.
Managed
Exporteren als beheerd		 Indien geselecteerd (waar), exporteer de oplossing dan als een beheerde oplossing; exporteer anders als een onbeheerde oplossing.
ExportAutoNumberingSettings
Instellingen voor automatische nummering exporteren		 Instellingen voor automatische nummering exporteren (waar|onwaar).
ExportCalendarSettings
Agendainstellingen exporteren		 Agenda-instellingen exporteren (waar|onwaar).
ExportCustomizationSettings
Aanpassingsinstellingen exporteren		 Aanpassingsinstellingen exporteren (waar|onwaar).
ExportEmailTrackingSettings
Instellingen voor e-mailtracering exporteren		 Instellingen voor e-mailtracering exporteren (waar|onwaar).
ExportGeneralSettings
Algemene instellingen exporteren		 Algemene instellingen exporteren (waar|onwaar).
ExportIsvConfig
ISV-configuratie exporteren		 ISV-configuratie exporteren (waar|onwaar).
ExportMarketingSettings
Marketinginstellingen exporteren		 Marketinginstellingen exporteren (waar|onwaar).
ExportOutlookSynchronizationSettings
Instellingen voor Outlook-synchronisatie exporteren		 Instellingen voor Outlook-synchronisatie exporteren (waar|onwaar).
ExportRelationshipRoles
Relatierollen exporteren		 Relatierollen exporteren (waar|onwaar).
ExportSales
Verkoop exporteren		 Verkoop exporteren (waar|onwaar).

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)

Parameters Beschrijving
SolutionInputFile
Invoerbestand voor oplossing		 (Vereist) Het pad en de bestandsnaam van het bestand solution.zip dat u wilt uitpakken.
SolutionTargetFolder
Doelmap waarin u de oplossing wilt uitpakken		 (Vereist) Het pad en de doelmap waarin u de oplossing wilt uitpakken.
SolutionType
Type oplossing		 (Vereist) Het type oplossing dat u wilt uitpakken. Opties zijn onder meer: Onbeheerd (aanbevolen), Beheerd en Beide.

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)

Parameters Beschrijving
SolutionOutputFile
Uitvoerbestand voor oplossing		 (Vereist) Het pad en de bestandsnaam van het bestand solution.zip waarin de oplossing moet worden verpakt.
SolutionSourceFolder
Bronmap van de in te pakken oplossing		 (Vereist) Het pad en de bronmap van de in te pakken oplossing.
SolutionType
Type oplossing		 (Vereist) Het type oplossing dat u wilt verpakken. Opties zijn Beheerd (aanbevolen), Onbeheerd en Beide.

Verwijderoplossing van Power Platform

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)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt waaruit u de oplossing wilt verwijderen (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt waaruit u de oplossing wilt verwijderen (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
SolutionName
Oplossingsnaam		 (Vereist) De naam van de oplossing die moet worden verwijderd. Gebruik altijd de Naam van de oplossing, niet de Weergavenaam.

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)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt waarin u de aanpassingen wilt publiceren (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt waarin u de aanpassingen wilt publiceren (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken

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)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt waarin u de oplossingsversie wilt instellen (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt waarin u de oplossingsversie wilt instellen (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
SolutionName
Oplossingsnaam		 (Vereist) De naam van de oplossing waarvoor u de versie wilt instellen. Gebruik altijd de Naam van de oplossing, niet de Weergavenaam.
SolutionVersionNumber
Versienummer van oplossing		 (Vereist) Versienummer dat u wilt instellen.

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 Verbindingsvariabelen instellen

Stelt BuildTools.*-variabelen in om aangepaste scripttaken toegang te geven om de serviceverbinding als enige bron van waarheid te gebruiken.

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

Parameters (SetConnectionVariables)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt waarvoor u de verbindingsvariabelen wilt instellen. Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
timeoutInMinutes
Timeout		 Specificeert de maximale tijd, in minuten, die een taak mag uitvoeren voordat deze door de server wordt geannuleerd. Een nulwaarde duidt op een oneindige time-out.
retryCountOnTaskFailure
Aantal nieuwe pogingen als taak mislukt		 Specificeert het aantal nieuwe pogingen voor deze taak dat zal plaatsvinden als de taak mislukt. Niet ondersteund voor taken zonder agenten.
ApplicationId
Toepassings-id van aanmelding		 (Vereist voor gebruikersnaam/wachtwoord) Toepassings-id die moet worden gebruikt voor aanmelding (zie aanvullende opmerking hieronder).
RedirectUri
Omleidings-URI van de specifieke app		 (Vereist voor gebruikersnaam/wachtwoord) Omleidings-URI van de opgegeven app. Nodig bij het opgeven van een app-id. (Zie aanvullende opmerking hieronder).

Opmerking

Wanneer u het verificatietype gebruikersnaam/wachtwoord gebruikt, zijn de toepassings-id en de omleidings-URI vereist. Dit authenticate oauth-document bevat een uitleg waarom u een app-registratie moet maken voor verificatie met Dataverse. Wanneer u verbinding maakt met gebruikersnaam-/wachtwoordverificatie, gedraagt de verbinding zich als een teoapssing waarmee namens een gebruiker verbinding wordt gemaakt met Dataverse.

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)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt waarin u het pakket wilt implementeren (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt waarin u het pakket wilt implementeren (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform. Meer informatie: zie BuildTools.EnvironmentUrl onder Power Platform Omgeving maken
PackageFile
Pakketbestand		 (Vereist) Het pad en de bestandsnaam van de pakketbestandsassembly (.dll).
MaxAsyncWaitTime
Maximale wachttijd		 Maximale wachttijd in minuten voor de asynchrone bewerking; standaard is 60 min (1 uur), hetzelfde als Azure DevOps-standaard voor taken.

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.

Belangrijk

Wanneer ingesteld, zal BuildTools.EnvironmentUrl worden gebruikt als de standaardserviceverbinding voor volgende taken in de pipeline. Elke taak die in dit artikel wordt beschreven, gebruikt alleen het eindpunt van de serviceverbinding wanneer BuildTools.EnvironmentUrl is niet ingesteld.

Een nieuwe omgeving kan alleen worden ingericht als uw licentie of capaciteit het maken van extra omgevingen toestaat. Zie voor meer informatie over het bekijken van capaciteit Details van de pagina Capaciteit.

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)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt waarin u de omgeving wilt maken (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt waarin u de omgeving wilt maken (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
DisplayName
Weergavenaam		 (Vereist) De weergavenaam van de gemaakte omgeving.
LocationName
Implementatieregio		 (Vereist) De regio waarin de omgeving moet worden gemaakt.
EnvironmentSku
Type omgeving		 (Vereist) Het type exemplaar dat moet worden geïmplementeerd. Opties zijn: Sandbox, Productie, Proefversie en SubscriptionBasedTrial.
AppsTemplate
Apps		 Voor een niet-proefomgevingstype zijn de ondersteunde apps D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation en D365_Sales.
CurrencyName
Valuta		 (Vereist) Basisvaluta voor de gemaakte omgeving. De valuta kan niet worden bijgewerkt nadat de omgeving is gemaakt.
LanguageName
Language		 (Vereist) De basistaal in de omgeving.
DomainName
Domeinnaam		 (Vereist) Dit is de omgevingsspecifieke tekenreeks die deel uitmaakt van de URL. Voor bijvoorbeeld een omgeving met de volgende URL: https://powerappsbuildtasks.crm.dynamics.com/ zou de domeinnaam powerappsbuildtasks zijn.

Opmerking: als u een domeinnaam invoert die al in gebruik is, voegt de taak een numerieke waarde toe aan de domeinnaam, beginnend met 0. Voor het bovenstaande voorbeeld zou de URL https://powerappsbuildtasks0.crm.dynamics.com/ worden.

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)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt waaruit u de omgeving wilt verwijderen (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt waaruit u de omgeving wilt verwijderen (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.

Power Platform - gebruiker toewijzen

Wijs een gebruiker toe aan een doelomgeving met opgegeven beveiligingsrol.

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

Parameters (AssignUser-env)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt voor de omgeving waar u de gebruiker aan wilt toewijzen (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
User
Power Platform-gebruikersnaam		 Object-id of User Principal Name van Microsoft Entra voor toewijzing aan de doelomgeving.
Role
Naam of id van beveiligingsrol		 Naam of id van beveiligingsrol die aan de gebruiker moet worden toegewezen.
ApplicationUser
Power Platform-toepassingsgebruikersnaam		 Geeft op of de invoergebruiker een toepassingsgebruiker is (true|false).

Power Platform-omgeving opnieuw instellen

Hiermee wordt een omgeving opnieuw ingesteld.

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

Parameters (Reset-env)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt waarin u de omgeving in wilt herstellen (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt waarin u de omgeving in wilt herstellen (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.

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)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt waarin u een back-up van de omgeving wilt maken (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt waarin u een back-up van de omgeving wilt maken (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
BackupLabel
Back-uplabel		 (Vereist) Het label dat aan de back-up moet worden toegewezen.

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)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt voor de bronomgeving waaruit u wilt kopiëren (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt voor de bronomgeving waaruit u wilt kopiëren (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
TargetEnvironmentUrl
URL van doelomgeving		 (Vereist) De URL voor de doelomgeving waarnaar u wilt kopiëren.
CopyType
Type kopie		 Het type kopie dat u wilt uitvoeren: FullCopy of MinimalCopy
OverrideFriendlyName
Beschrijvende naam overschrijven		 Wijzig de beschrijvende naam van de doelomgeving in een andere naam (waar|onwaar).
FriendlyName
Beschrijvende naam		 De beschrijvende naam van de doelomgeving.
DisableAdminMode
Beheermodus uitschakelen		 Of de beheermodus moet worden uitgeschakeld (waar|onwaar).

Power Platform-omgeving herstellen

Hiermee wordt een omgeving hersteld aan de hand van een specifieke back-up.

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

Parameters (Restore-env)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformEnvironment
Power Platform-omgevings-URL		 Het service-eindpunt voor de bronomgeving waaruit u wilt herstellen (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt voor de bronomgeving waaruit u wilt herstellen (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
RestoreLatestBackup
Nieuwste back-up om terug te zetten		 Of de laatste back-up moet worden hersteld of RestoreTimeStamp (true|false) moet worden opgegeven.
RestoreTimeStamp
Datum/tijd van de back-up		 Datum/tijd van de back-up in notatie 'mm/dd/jjjj uu: mm' OF tekenreeks 'meest recente'.
TargetEnvironmentUrl
URL van doelomgeving		 (Vereist) De URL voor de doelomgeving die u wilt herstellen.
FriendlyName
Naam van de herstelde omgeving		 (Optioneel) Naam van de herstelde omgeving.
DisableAdminMode
Beheermodus uitschakelen		 Of de beheermodus moet worden uitgeschakeld (waar|onwaar).

Dataverse-gegevens exporteren

Exporteer gegevens uit een omgeving met het opgegeven schema.

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

Parameters (exportdata-env)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt voor de omgeving waaruit u de gegevens wilt exporteren (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
SchemaFile
XML-bestandsnaam van schema		 XML-bestandsnaam van schema. Deze kan worden gemaakt met het hulpprogramma voor configuratiemigratie.
DataFile
Naam van gegevensbestand		 Bestandsnaam voor gegevens die moeten worden geëxporteerd (zip-bestand).
Overwrite
Inhoud overschrijven		 Website-inhoud van Power Pages die moet worden overschreven (true|false).

Dataverse-gegevens importeren

Importeer gegevens naar een omgeving.

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

Parameters (importdata-env)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt voor de omgeving waar u gegevens naar wilt importeren (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
DataFile
Naam van gegevensbestand		 Bestandsnaam voor gecomprimeerd zip-gegevensbestand dat moet worden geïmporteerd, of de map met data-schema.xml en data.xml die moet worden geïmporteerd.

Power Pages-beheertaken

Taken om te werken met een website van Power Pages.

Power Platform PAPortal downloaden

Inhoud van Power Pages-website downloaden vanuit de huidige Dataverse-omgeving.

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

Parameters (download-paportal)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt voor de omgeving waaruit u content wilt downloaden (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
WebsiteId
Id van portalwebsite		 Id van Power Pages-website om te downloaden.
Overwrite
Inhoud overschrijven		 Website-inhoud van Power Pages die moet worden overschreven (true|false).
ModelVersion
Gegevensmodel van site		 Geeft aan of de te uploaden sitegegevens het standaard (1) of verbeterde gegevensmodel (2) gebruiken. De standaardwaarde is ′1′.

Power Platform PAPortal uploaden

Upload de inhoud van de Power Pages-website naar de huidige Dataverse-omgeving.

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

Parameters (upload-paportal)

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt voor de omgeving waarnaar u content wilt uploaden (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
UploadPath
Inhoudpad voor uploaden		 Pad van waar de inhoud van de Power Pages-website wordt geüpload.
ModelVersion
Gegevensmodel van site		 Geeft aan of de te uploaden sitegegevens het standaard (1) of verbeterde gegevensmodel (2) gebruiken. De standaardwaarde is ′1′.

Catalogus voor Power Platform-taken (preview)

Deze taken voeren acties uit voor de catalogus in Power Platform en omvatten het volgende.

Notitie

Momenteel maken catalogustaken voor Power Platform deel uit van een preview-versie.

Catalogusitem installeren

Installeer een Catalog-item in de doelomgeving.

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt voor de omgeving waarnaar u content wilt uploaden (bijvoorbeeld https://powerappsbuildtools.crm.dynamics.com). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
Environment
URL van doelomgeving		 (Vereist) Omgevings-URL waarop deze taak is gericht.
CatalogItemId
Catalogusitem-id die moet worden geïnstalleerd		 (Vereist) Catalogusitem dat in de doelomgeving moet worden geïnstalleerd.
TargetEnvironmentUrl
URL van doelomgeving		 (Vereist) De URL van de doelomgeving waarin catalogusitems moeten worden geïnstalleerd (bijvoorbeeld "https://YourOrg.crm.dynamics.com").
PollStatus
Status van peiling controleren		 (Optioneel) Voer een peiling uit om de status van uw aanvraag te controleren (true|false).

Parameters (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

Catalogusgoedkeuring indienen

Dien de Catalog-goedkeuringsaanvraag in.

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt voor de omgeving waarnaar u content wilt uploaden (bijvoorbeeld "https://powerappsbuildtools.crm.dynamics.com"). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
Environment
URL van doelomgeving		 (Vereist) Omgevings-URL waarop deze taak is gericht.
CatalogSubmissionFile
Catalogusindieningsbestand		 (Vereist) Geef het pad en de bestandsnaam op van het catalogusindieningsbestand.
UsePackageSolutionZipFile
Bestandstype		 Bestandstype: zip-bestand van pakket of oplossing.
SolutionZipFile
Bestandsnaam voor ZIP-bestand voor oplossing		 Geef het pad en de bestandsnaam op van het ZIP-bestand voor de oplossing.
PollStatus
Status van peiling controleren		 (Optioneel) Voer een peiling uit om de status van uw aanvraag te controleren (true|false).

Parameters (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

Catalogusaanvraagstatus

Haal de status op van de aanvraag voor het installeren/indienen van de catalogus.

Parameters Beschrijving
authenticationType
Type verificatie		 (Vereist voor SPN) Geef een van beide op: PowerPlatformEnvironment voor een verbinding van gebruikersnaam/wachtwoord of PowerPlatformSPN voor een verbinding van service principal/clientgeheim.
PowerPlatformSPN
Power Platform Service Principal		 Het service-eindpunt voor de omgeving waarnaar u content wilt uploaden (bijvoorbeeld "https://powerappsbuildtools.crm.dynamics.com"). Gedefinieerd onder Serviceverbindingen in Projectinstellingen met verbindingstype Power Platform.
Environment
URL van doelomgeving		 (Vereist) Omgevings-URL waarop deze taak is gericht.
TrackingId
Tracerings-id aanvraag		 (Vereist) Tracerings-id aanvraag.
RequestType
Aanvraagtype		 (Vereist) Aanvraagtype. (Waarden: Install | Submit).

Parameters (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

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 Pipelines: Azure Pipelines gebruiken

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.

Een oplossing exporteren vanuit een ontwikkelomgeving (DEV).

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.

Een beheerde oplossing bouwen.

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.

Implementeren naar een productieomgeving (PROD).

Zie ook

Microsoft Power Platform Build Tools voor Azure DevOps