Del via

Microsoft Power Platform Build Tools-oppgaver

  • Artikkel

De tilgjengelige byggeoppgavene er beskrevet i avsnittene nedenfor. Etterpå skal vi vise noen eksempler på Azure Pipelines som gjør bruk av disse oppgavene. Hvis du vil ha informasjon om byggeverktøyene og hvordan de lastes ned, kan du se Microsoft Power Platform Build Tools for Azure-pileliner.

Hjelper-oppgave

De tilgjengelige hjelpeoppgavene er beskrevet nedenfor.

Installasjonsprogram for Power Platform-verktøy

Denne oppgaven må legges til én gang før noen andre Power Platform Build Tools-oppgaver i utgivelsespipeliner. Denne oppgaven installerer et sett med Power Platform-spesifikke verktøy som kreves av agenten, for å kjøre Microsoft Power Platform-byggeoppgavene. Denne oppgaven krever ikke mer konfigurasjon når den er lagt til. Denne oppgaven inneholder parametere for de spesifikke versjonene av hvert av verktøyene som installeres.

Hvis du vil holde deg oppdatert om verktøyversjonene over tid, må du kontrollere at disse parameterne samsvarer med versjonene av verktøyene som kreves for at pipelinen skal kjøres på riktig måte.

YAML-snutt (installasjonsprogram)

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

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

Parametere (installasjonsprogram)

Parametere Beskrivelse
DefaultVersion
Bruke standardverktøyversjoner		 Sett til sann for å bruke standardversjonen av alle verktøy, ellers usann. Obligatorisk (og usann) når verktøyversjoner er angitt.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Verktøyversjon		 Den bestemte versjonen av verktøyet som skal brukes.

Power Platform WhoAmI

Verifiserer en Power Platform-miljøtjenestetilkobling ved å koble til og utføre en WhoAmI-forespørsel. Denne oppgaven kan være nyttig for å ta med tidlig i pipelinen, for å kontrollere tilkoblingen før behandlingen begynner.

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

Parametere (WhoAmI)

Parametere Beskrivelse
authenticationType
Autentiseringstype		 (Valgfritt) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Endepunkt for tjeneste for miljøet du vil koble til. Defineres under Tjenestetilkoblinger i Prosjektinnstillinger. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Endepunkt for tjeneste for miljøet du vil koble til. Defineres under Tjenestetilkoblinger i Prosjektinnstillinger.

Kvalitetskontroll

I det neste avsnittet finner du tilgjengelige oppgaver for å kontrollere kvaliteten på en løsning.

Power Platform Checker

Denne oppgaven kjører en statisk analysekontroll på løsningene mot et sett med regler for anbefalte fremgangsmåter, for å identifisere eventuelle problematiske mønstre som du kan ha innført ved en feiltakelse under byggingen av løsningen.

YAML-snutt (kontroll)

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

Parametere (kontroll)

Parametere Beskrivelse
PowerPlatformSPN
Tjenestetilkoblinger		 (Oblitatorisk) En tilkobling til et lisensiert Microsoft Power Platform-miljø kreves for å bruke Power Platform-kontrollen. Tjenestetilkoblinger defineres i Tjenestetilkoblinger under Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: Se BuildTools.EnvironmentUrl under Opprette Power Platform-miljø

Merk: Godkjenningsmetodene Tjenestekontohaver og brukernavn/passord er tilgjengelige for kontrolloppgaven. Hvis du vil ha mer informasjon om hvordan du konfigurerer sikkerhetskontohavere for tjenester som skal brukes med denne oppgaven, kan du se Konfigurere sikkerhetskontohavere for tjenester for Power Platform-miljøer.
UseDefaultPACheckerEndpoint
Bruke Power Platform-kontrolls standardendepunkt		 Som standard (sann) bruker den geografiske plasseringen av kontrolltjenesten samme geografi som miljøet du kobler til.
CustomPACheckerEndpoint
Egendefinert endepunkt for PAC-kontroll		 Obligatorisk når UseDefaultPACheckerEndpoint er usann. Du kan angi et annet geografisk område som skal brukes, for eksempel https://japan.api.advisor.powerapps.com. Hvis du vil ha en liste over tilgjengelige geografiske områder, kan du se Bruk API-en for Power Platform-kontroll.
FileLocation
Plasseringen til filene som skal analyseres		 Obligatorisk ved referanse til en fil fra en URL-adresse for delt tilgangssignatur (SAS) sasUriFile.

Merk Det er viktig å referere til en eksportert løsningsfil og ikke de upakkede kildefilene i repositoriet. Både administrerte og uadministrerte løsningsfiler kan analyseres.
FilesToAnalyzeSasUri
SAS-filer til å analysere		 Obligatorisk når FileLocation angis til sasUriFile. Angi URI-adressen for SAS. Du kan legge til flere enn én SAS-URI fra en kommadelt (,) eller semikolondelt (;) liste.
FilesToAnalyze
Lokale filer til å analysere		 Kreves når SAS-filer ikke analyseres. Angi banen og fil navnet til zip-filene som skal analyseres. Jokertegn kan brukes. Skriv for eksempel inn **\*.zip for alle zip-filer i alle undermapper.
FilesToExclude
Lokale filer til å eksludere		 Angi navnene på filer som skal utelates fra analysen. Angi via en komma- (,) eller semikolondelt (;) liste. Denne listen kan inneholde et fullstendig filnavn eller et navn med foranstilte eller etterfølgende jokertegn, for eksempel *jquery eller form.js
RulesToOverride
Regler som skal overstyres		 En JSON-matrise som inneholder regler og nivåer som skal overstyres. Godtatte verdier for OverrideLevel er: Kritisk, Høy, Middels, Lav, Informasjon. Eksempel: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Regelsett		 (Obligatorisk) Angi hvilket regelsett som skal brukes. Følgende to regelsett er tilgjengelige:
  • Løsningskontroll: Dette regelsettet er det samme som kjøres fra Power Apps Maker Portal.
  • AppSource: Det utvidede regelsettet som brukes til å sertifisere en app før den kan publiseres til AppSource.
ErrorLevel
Feilnivå		 Kombinert med parameteren for feilterskel definerer det alvorsgraden for feil og advarsler som er tillatt. Støttede terskelverdier er <level>IssueCount, der nivå=Kritisk, Høy, Middels, Lav og Informasjon.
ErrorThreshold
Feilterskel		 Definerer antall feil (>=0) på et bestemt nivå som er tillatt for at kontrollen kan overføre løsninger som kan kontrolleres.
FailOnPowerAppsCheckerAnalysisError
Avbryt ved feil		 Når sann mislykkes hvis Power Apps-kontrollanalysen returneres som Mislykket eller FinishedWithErrors.
ArtifactDestinationName
Artefaktnavn for DevOps		 Angi navn på Azure-artefakter for kontrollfilen .sarif.

Løsningsoppgaver

Dette settet med oppgaver kan automatisere løsningshandlinger. Miljøoppgavene som beskrives senere i denne delen som oppretter, kopierer eller gjenoppretter et miljø, overskriver tjenestetilkoblingene til de nylig opprettede miljøene. Disse oppgavene gjør det mulig å utføre løsningsoppgaver mot miljøer som opprettes ved behov.

Power Platform-importløsning

Importerer en løsning til et målmiljø.

YAML-snutt (import)

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

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

Parametere (import)

Parametere Beskrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Tjenesteendepunktet du vil importere løsningen til (for eksempel https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Tjenesteendepunktet du vil importere løsningen til (for eksempel https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
SolutionInputFile
Løsningsinndatafil		 (Obligatorisk) Banen og filnavnet til zip-løsningsfilen som skal importeres til målmiljøet (f.eks. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Obs!: Variabler gir deg en praktisk måte å få viktige databiter inn i ulike deler av pipelinen. Se Bruke forhåndsdefinerte variabler for en omfattende liste.
HoldingSolution
Importer som en oppbevaringsløsning		 En avansert parameter (sann|usann) som brukes når en løsning må oppgraderes. Denne parameteren er vert for løsningen i Dataverse, men oppgraderer ikke løsningen før oppgaven Bruk løsningsoppgradering er kjørt.
OverwriteUnmanagedCustomizations
Overskrive uadministrerte tilpassinger		 Angi om det skal ikke-administrerte tilpassinger skal overskrives (sann|usann).
SkipProductUpdateDependencies
Hopp over avhengigheter for produktoppdateringer		 Angi om håndhevelse av avhengigheter som er relatert til produktoppdateringer, skal hoppes over (sann|usann).
ConvertToManaged
Konvertere til administrert		 Angi om det skal importeres til administrert løsning (sann|usann).
AsyncOperation
Asynkron import		 Hvis det er merket av for (sann), utføres importoperasjonen asynkront. Dette anbefales for større løsninger siden denne oppgaven ellers automatisk blir tidsavbrutt etter 4 minutter. Valg av asynkron vil avspørre og vente til MaxAsyncWaitTime er nådd (true|false).
MaxAsyncWaitTime
Maksimal ventetid		 Maksimal ventetid i minutter for den asynkrone operasjonen. Standard er 60 minutter (1 t), samme som Azure DevOps-standard for oppgaver.
PublishWorkflows
Aktivere prosesser etter import		 Angi om eventuelle prosesser (arbeidsflyter) i løsningen skal aktiveres etter import (sann|usann).
UseDeploymentSettingsFile
Bruke fil for distribusjonsinnstillinger		 Verdier for tilkoblingsreferanser og miljøvariabler kan angis ved hjelp av en fil for distribusjonsinnstillinger (sann|usann).
DeploymentSettingsFile
Fil for distribusjonsinnstillinger		 (Obligatorisk når UseDeploymentSettingsFile=sann) Banen for filnavnet for distribusjonsinnstillingsfilen.

Legg til løsningskomponent i Power Platform

Legger til en løsningskomponent i en uadministrert løsning.

YAML-snutt (Legg til)

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

Parametere (Legg til)

Parametere Bekrivelse
ComponentId
ID for løsningskomponenten		 Skjemanavnet eller ID-en for komponenten som skal legges til i målløsningen.
ComponentType
URL-adresse til Power Platform-miljø		 Verdien som representerer løsningskomponenten du legger til. Se Bruk forhåndsdefinerte komponenttyper for en omfattende liste over komponentverdier.
SolutionUniqueName
Navnet på løsningen		 Det unike navnet på løsningen.
AddRequiredComponents
Alle komponenter som kreves fra andre løsninger som er avhengige av løsningskomponenten		 (Valgfritt) Angir om andre løsningskomponenter som er nødvendige for løsningskomponenten du legger til, også skal legges til i den uadministrerte løsningen.
Environment
URL eller ID for miljø		 (Valgfritt) Miljønettadressen eller ID-en for målmiljøet.

Power Platform Bruk løsningsoppgradering

Oppgraderer en løsning som er importert som en oppbevaringsløsning.

YAML-snutt (oppgradering)

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

Parametere (oppgrader)

Parametere Beskrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Tjenesteendepunktet du vil oppgradere løsningen til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Tjenesteendepunktet du vil oppgradere løsningen til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
SolutionName
Navn på løsning		 (Obligatorisk) Navnet på løsningen som skal brukes i oppgraderingen. Bruk alltid Navn for løsningen, ikke Visningsnavn.
AsyncOperation
Asynkron oppgradering		 Hvis det er merket av for (sann), utføres oppgraderingsoperasjonen som en asynkron satsvis jobb. Valg av asynkron vil avspørre og vente til MaxAsyncWaitTime er nådd.
MaxAsyncWaitTime
Maksimal ventetid		 Maksimal ventetid i minutter for den asynkrone operasjonen. Standard er 60 minutter (1 t), samme som Azure DevOps-standard for oppgaver.

Merk

Variabler gir deg en nyttig måte å finne viktige databiter på, i ulike deler av pipelinen. Se Bruke forhåndsdefinerte variabler for en omfattende liste. Du kan forhåndsutfylle informasjon om tilkoblingsreferanser og miljøvariabler for målmiljøet når du importerer en løsning ved hjelp av en fil for distribusjonsinnstillinger.

Mer informasjon: Forhåndsutfyll tilkoblingsreferanser og miljøvariabler for automatiserte distribusjoner

Power Platform-eksportløsning

Eksporterer en løsning fra et kildemiljø.

YAML-snutt (eksport)

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

Parametere (eksport)

Parametere Beskrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Tjenesteendepunktet du vil oppgradere løsningen til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Tjenesteendepunktet du vil oppgradere løsningen til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
SolutionName
Navn på løsning		 (Obligatorisk) Navnet på løsningen som skal eksporteres. Bruk alltid Navn for løsningen, ikke Visningsnavn.
SolutionOutputFile
Løsningsutdatafil		 (Obligatorisk) Banen og filnavnet til zip-løsningsfilen som kildemiljøet skal eksporteres til (f.eks. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Obs!: Variabler gir deg en praktisk måte å få viktige databiter inn i ulike deler av pipelinen. Se Bruke forhåndsdefinerte variabler for en omfattende liste.
AsyncOperation
Asynkron eksport		 Hvis det er merket av for (sann), utføres eksportoperasjonen som en asynkron satsvis jobb. Valg av asynkron vil avspørre og vente til MaxAsyncWaitTime er nådd.
MaxAsyncWaitTime
Maksimal ventetid		 Maksimal ventetid i minutter for den asynkrone operasjonen. Standard er 60 minutter (1 t), samme som Azure DevOps-standard for oppgaver.
Managed
Eksporter som administrert		 Hvis valgt (sann), eksporterer du løsningen som en administrert løsning, ellers eksporterer du som en uadministrert løsning.
ExportAutoNumberingSettings
Eksportere innstillinger for automatisk nummerering		 Eksportere innstillinger for automatisk nummerering (sann|usann).
ExportCalendarSettings
Eksportere kalenderinnstillinger		 Eksportere kalenderinnstillinger (sann|usann).
ExportCustomizationSettings
Eksportere tilpasningsinnstillinger		 Eksportere tilpasningsinnstillinger (sann|usann).
ExportEmailTrackingSettings
Eksportere innstillinger for e-postsporing		 Eksporter innstillinger for e-postsporing (sann|usann).
ExportGeneralSettings
Eksportere generelle innstillinger		 Eksportere generelle innstillinger (sann|usann).
ExportIsvConfig
Eksportere ISV-konfigurasjon		 Eksportere ISV-konfigurasjon (sann|usann).
ExportMarketingSettings
Eksportere markedsføringsinnstillinger		 Eksportere markedsføringinnstillinger (sann|usann).
ExportOutlookSynchronizationSettings
Eksportere synkroniseringsinnstillinger for Outlook		 Eksportere synkroniseringsinnstillinger for Outlook (sann|usann).
ExportRelationshipRoles
Eksportere relasjonsroller		 Eksportere relasjonsroller (sann|usann).
ExportSales
Eksportere salg		 Eksporterer salg (sann|usann).

Power Platform-utpakkingsløsning

Tar en komprimert løsningsfil og bryter den opp i flere XML-filer, slik at disse filene kan håndteres og leses på en enklere måte av et kildekontrollsystem.

YAML-snutt (pakk ut)

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

Parametere (pakk ut)

Parametere Beskrivelse
SolutionInputFile
Løsningsinndatafil		 (Obligatorisk) Banen og filnavnet til løsningsfilen (zip-fil) som skal pakkes ut.
SolutionTargetFolder
Målmappen der løsningen skal pakkes ut		 (Obligatorisk) Banen og målmappen der du vil pakke ut løsningen.
SolutionType
Løsningstype		 (Oblikatorisk) Typen løsning du vil pakke ut. Alternativene inkluderer: Uadministrert (anbefales), Administrert og Begge.

Pakke Power Platform-løsning

Pakker en løsning som representeres i kildekontrollen, til en løsningsfil (zip-fil) som kan importeres til et annet miljø.

YAML-snutt (pakk ut)

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

Parametere (pakk ut)

Parametere Beskrivelse
SolutionOutputFile
Løsningsutdatafil		 (Obligatorisk) Banen og filnavnet til zip-filen med løsningen der løsningen skal pakkes.
SolutionSourceFolder
Kildemappe for løsning som skal pakkes		 (Obligatorisk) Banen og kildemappen for løsningen som skal pakkes.
SolutionType
Løsningstype		 (Obligatorisk) Typen løsning du vil pakke. Alternativene omfatter: Administrert (anbefalt), Uadministrert og Begge.

Power Platform Slette løsning

Sletter en løsning i målmiljøet.

YAML-snutt (slett)

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

Parameter (slett)

Parametere Beskrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Tjenesteendepunktet der du vil slette løsningen (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Tjenesteendepunktet der du vil slette løsningen (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
SolutionName
Navn på løsning		 (Obligatorisk) Navnet på løsningen som skal slettes. Bruk alltid Navn for løsningen, ikke Visningsnavn.

Publisere Power Platform-tilpassinger

Publiserer alle tilpassinger i et miljø.

YAML-snutt (publiser)

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

Parametere (publiser)

Parametere Beskrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Tjenesteendepunktet du vil publisere tilpasningene til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Tjenesteendepunktet du vil publisere tilpasningene til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø

Angi Power Platform-løsningsversjon

Oppdaterer versjonen av en løsning.

YAML-snutt (versjon)

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

Parametere (versjon)

Parametere Beskrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Tjenesteendepunktet du vil angi løsningsversjonen til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Tjenesteendepunktet du vil angi løsningsversjonen til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
SolutionName
Navn på løsning		 (Obligatorisk) Navnet på løsningen du vil angi versjonen for. Bruk alltid Navn for løsningen, ikke Visningsnavn.
SolutionVersionNumber
Løsningsversjonsnummer		 (Obligatorisk) Versjonsnummeret du vil angi.

Versjonsnummeret kan hardkodes i forløpet, men det anbefales å bruke en Azure DevOps-pipelinevariabel som BuildId. Her finner du alternativer for å definere den nøyaktig formen på versjonsnummeret i kategorien Alternativer, for eksempel $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Denne definisjonen kan deretter brukes i oppgaven angi løsnings versjon ved å angi egenskapen Versjonsnummer med $(Build.BuildId) i stedet for hardkoding 20200824.0.0.2.

Alternativt kan du bruke et powershell-integrert oppgaveskript $(Get-Date -Format yyyy.MM.dd.HHmm) som utdata til tom variabel med navnet SolutionVersion som Write-Host ("##vso[task.setvariable variable=SolutionVersion;] $version"), Angi løsningsversjon som $(SolutionVersion).

Power Platform Angi tilkoblingsvariabler

Angir BuildTools.*-variabler som gir egendefinerte skriptoppgaver tilgang til å bruke tjenestetilkoblingen som én enkelt sannhetskilde.

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

Parametere (SetConnectionVariables)

Parametere Description
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Tjenesteendepunktet du vil angi tilkoblingsvariabler for. Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
timeoutInMinutes
Timeout		 Angir maksimumstiden, i minutter, som en oppgave kan kjøre før den avbrytes av serveren. En nullverdi angir et ubestemt tidsavbrudd.
retryCountOnTaskFailure
Antall nye forsøk hvis oppgaven mislyktes		 Angir antall nye forsøk for denne oppgaven som vil skje i tilfelle oppgavefeil. Støttes ikke for oppgaver uten agent.
ApplicationId
Program-ID for pålogging		 (Obligatorisk for brukernavn/passord) Program-ID som skal brukes for pålogging (se ytterligere merknad nedenfor).
RedirectUri
Omdirigere URI for den bestemte appen		 (Obligatorisk for brukernavn/passord) Omdirigerings-URI for den angitte appen. Nødvendig ved angivelse av en app-ID. (Se ytterligere notat nedenfor).

Merk

Når du bruker godkjenningstypen brukernavn/passord, kreves program-IDen og omdirigerings-URI. Dette godkjenn oauth-dokumentet har en forklaring av hvorfor du må opprette en appregistrering for godkjenning med Dataverse. Når du kobler til med brukernavn-/passordgodkjenning, fungerer tilkoblingen som et program som kobler til på vegne av en bruker til Dataverse.

Distribuere Power Platform-pakke

Distribuerer en pakke til et miljø. Når du distribuerer en pakke i motsetning til én løsningsfil, får du muligheten til å distribuere flere løsninger, data og kode til et miljø.

YAML-snutt (distribuer)

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

Parameter (distribuer)

Parametere Beskrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Tjenesteendepunktet du vil distribuere pakken til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Tjenesteendepunktet du vil distribuere pakken til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen. Mer informasjon: se BuildTools.EnvironmentUrl under Power Platform Opprett miljø
PackageFile
Pakkefil		 (Obligatorisk) Banen og filnavnet til pakkefilsamlingen (DLL).
MaxAsyncWaitTime
Maksimal ventetid		 Maksimal ventetid i minutter for den asynkrone operasjonen. Standard er 60 minutter (1 t), samme som Azure DevOps-standard for oppgaver.

Oppgaver for å behandle miljøer

Automatiser vanlige ELM-oppgaver (Environment Lifecycle Management).

Opprette Power Platform-miljø

Oppretter et nytt miljø. Oppretting av et nytt miljø oppretter også automatisk BuildTools.EnvironmentUrl.

Viktig

Når dette er angitt, brukes BuildTools.EnvironmentUrl som standard tjenestetilkobling for påfølgende oppgaver i pipelinen. Hver oppgave som beskrives i denne artikkelen, bruker bare endepunkt fra tjenestetilkoblingen når BuildTools.EnvironmentUrl ikke er angitt.

Et nytt miljø kan bare klargjøres hvis lisensen eller kapasiteten tillater oppretting av flere miljøer. Hvis du vil ha mer informasjon om hvordan du viser kapasiteten, kan du se siden med detaljer for kapasitet.

YAML-snutt (Create-env)

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

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

Parametere (Create-env)

Parametere Beskrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Tjenesteendepunktet der du vil opprette miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Tjenesteendepunktet der du vil opprette miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
DisplayName
Visningsnavn		 (Obligatorisk) Visningsnavnet av miljøet som opprettes.
LocationName
Distribusjonsområde		 (Obligatorisk) Området som miljøet skal opprettes i.
EnvironmentSku
Miljøtype		 (Obligatorisk) Typen forekomst som skal distribueres. Alternativene er Sandkasse, Produksjon, Prøve og SubscriptionBasedTrial.
AppsTemplate
Apper		 For et miljøer som ikke er prøveversjoner, er de støttede appene D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation og D365_Sales.
CurrencyName
Valuta		 (Obligatorisk) Standard valuta for miljøet som opprettes. Valutaen kan ikke oppdateres etter at miljøet er opprettet.
LanguageName
Language		 (Obligatorisk) Originalspråket i miljøet.
DomainName
Domenenavn		 (Obligatorisk) Dette er den miljøspesifikke strengen som utgjør en del av URL-adressen. For et miljø med for eksempel følgende URL-adresse: https://powerappsbuildtasks.crm.dynamics.com/, vil domenenavnet være 'powerappsbuildtasks'.

Merk: Hvis du skriver inn et domenenavn som allerede er i bruk, legger oppgaven til en numerisk verdi til domenenavnet, som begynner med 0. URL-adressen i eksemplet ovenfor kan bli https://powerappsbuildtasks0.crm.dynamics.com/.

Slette Power Platform-miljø

Sletter et miljø.

YAML-snutt (Delete-env)

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

Parameter (Delete-env)

Parametere Beskrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Tjenesteendepunktet der du vil slette miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Tjenesteendepunktet der du vil slette miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.

Power Platform Tilordne bruker

Tildel en gruppe til et målmiljø med angitt sikkerhetsrolle.

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

Parametere (AssignUser-env)

Parametere Bekrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Endepunkt for tjeneste for målmiljøet du vil tildele brukeren til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
User
Power Platform-brukernavn		 Microsoft Entra-objekt-ID eller brukerens hovednavn som skal tilordnes målmiljøet.
Role
Sikkerhetsrollenavn eller -ID		 Navn eller ID for sikkerhetsrollen som skal tilorndes til brukeren.
ApplicationUser
Power Platform-programbrukernavnet		 Angir om inndatabrukeren er en programbruker (sann|usann).

Power Platform Tilbakestill miljø

Tilbakestiller et miljø.

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

Parametere (Reset-env)

Parametere Bekrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Tjenesteendepunktet der du vil tilbakestille miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Tjenesteendepunktet der du vil tilbakestille miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.

Sikkerhetskopiere Power Platform-miljø

Sikkerhetskopierer et miljø.

YAML-snutt (Backup-env)

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

Parametere (Backup-env)

Parametere Beskrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Tjenesteendepunktet der du vil sikkerhetskopiere miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Tjenesteendepunktet der du vil sikkerhetskopiere miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
BackupLabel
Etikett for sikkerhetskopi		 (Obligatorisk) Etiketten som skal tilordnes sikkerhetskopien.

Kopiere Power Platform-miljø

Kopier et miljø til et målmiljø. To typer kopier er tilgjengelig: fullstendig og minimal. En fullstendig kopi inkluderer både data- og løsningsmetadata (tilpassinger), mens en minimal kopi bare inkluderer løsningsmetadata og ikke de faktiske dataene.

YAML-snutt (Copy-env)

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

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

Parametere (Copy-env)

Parametere Beskrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Endepunkt for tjeneste for kildemiljøet du vil kopiere fra (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Endepunkt for tjeneste for kildemiljøet du vil kopiere fra (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
TargetEnvironmentUrl
URL-adresse for målmiljø		 (Obligatorisk) URL-adressen til målmiljøet du vil kopiere til.
CopyType
Kopieringstype		 Kopieringstypen som skal utføres: FullCopy eller MinimalCopy
OverrideFriendlyName
Overstyr egendefinert navn		 Endre det egendefinerte navnet for målmiljøet til et annet navn (sann|usann).
FriendlyName
Egendefinert navn		 Det egendefinerte navnet på målmiljøet.
DisableAdminMode
Deaktivere administratormodus		 Om administrasjonsmodus skal deaktiveres (sann|usann).

Power Platform Gjenopprett miljø

Gjenoppretter et miljø til en gitt sikkerhetskopi.

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

Parametere (Restore-env)

Parametere Bekrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformEnvironment
URL-adresse til Power Platform-miljø		 Endepunkt for tjeneste for kildemiljøet du vil gjenopprette fra (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Endepunkt for tjeneste for kildemiljøet du vil gjenopprette fra (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
RestoreLatestBackup
Siste sikkerhetskopi som skal gjenopprettes		 Om den nyeste sikkerhetskopien skal gjenopprettes eller gi RestoreTimeStamp (true|false)
RestoreTimeStamp
Dato/klokkeslett for sikkerhetskopien		 DateTime for sikkerhetskopien i formatet DD.MM.ÅÅÅÅ TT:MM ELLER strengen siste.
TargetEnvironmentUrl
URL-adresse for målmiljø		 (Obligatorisk) URL-adressen til målmiljøet du vil gjenopprette.
FriendlyName
Navn på det gjenopprettede miljøet		 (Valgfritt) Navn på det gjenopprettede miljøet.
DisableAdminMode
Deaktivere administratormodus		 Om administrasjonsmodus skal deaktiveres (sann|usann).

Eksporter Dataverse-data

Eksporter data fra et miljø med det angitte skjemaet.

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

Parametere (exportdata-env)

Parametere Bekrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Endepunkt for tjeneste for kildemiljøet du vil eksportere data fra (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
SchemaFile
XML-filnavn for skjema		 XML-filnavn for skjema. Det kan opprettes ved hjelp av Configuration Migration-verktøyet.
DataFile
Navn på datafil		 Filnavnet på data som skal eksporteres (zipfil).
Overwrite
Skriv over innhold		 Power Pages-nettstedsinnhold som skal overskrives (true|false).

Importer Dataverse-data

Immporter dasta til et miljø.

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

Parametere (importdata-env)

Parametere Bekrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Endepunkt for tjeneste for kildemiljøet du vil importere data til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
DataFile
Navn på datafil		 Filnavn for en komprimert zip-datafil som skal importeres, eller mappen med data-schema.xml og data.xml som skal importeres.

Power Pages-behandlingsoppgaver

Oppgaver for å arbeide med et Power Pages-nettsted.

Power Platform Last ned PAPortal

Last ned Power Pages-nettstedsinnhold fra nåværende Dataverse-miljø.

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

Parametere (download-paportal)

Parametere Bekrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Endepunkt for tjeneste for miljøet du vil laste ned innhold fra (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
WebsiteId
Portalnettsteds-ID		 Power Pages-nettsteds-ID som skal lastes ned.
Overwrite
Skriv over innhold		 Power Pages-nettstedsinnhold som skal overskrives (true|false).
ModelVersion
Datamodell for nettsted		 Angir om nettstedsdataene som skal lastes opp, bruker standard (1) eller forbedret datamodell (2). Standardverdien er 1.

Power Platform Last opp PAPortal

Last opp Power Pages-nettstedsinnhold på gjeldende Dataverse-miljø.

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

Parametere (upload-paportal)

Parametere Bekrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Endepunkt for tjeneste for miljøet du vil laste opp innhold til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
UploadPath
Bane til innhold som skal lastes opp		 Banen der Power Pages-nettstedsinnholdet blir lastet opp fra.
ModelVersion
Datamodell for nettsted		 Angir om nettstedsdataene som skal lastes opp, bruker standard (1) eller forbedret datamodell (2). Standardverdien er 1.

Katalog for Power Platform-oppgaver (forhåndsversjon)

Disse oppgavene utfører handlinger mot katalogen i Power Platform og inkluderer følgende.

Merk

Katalogoppgaver for Power Platform er for øyeblikket en forhåndsversjon.

Installer katalogelement

Installer et catalog-element i målmiljøet.

Parametere Bekrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Endepunkt for tjeneste for miljøet du vil laste opp innhold til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
Environment
URL-adresse for målmiljø		 (Obligatorisk) Miljønettadressen denne oppgaven er rettet mot.
CatalogItemId
Katalogelement-ID som skal installeres		 (Obligatorisk) Katalogelement som skal installeres i målmiljøet.
TargetEnvironmentUrl
URL-adresse for målmiljø		 (Obligatorisk) Nettadressen til målmiljøet for installasjon av katalogelement i (f.eks. https://YourOrg.crm.dynamics.com).
PollStatus
Kontroller avspørringsstatus		 (Valgfritt) Avspørring for å kontrollere statusen for forespørselen (true|false).

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

Send inn kataloggodkjenning

Send catalog-godkjenningsforespørsel.

Parametere Bekrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Endepunkt for tjeneste for miljøet du vil laste opp innhold til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
Environment
URL-adresse for målmiljø		 (Obligatorisk) Miljønettadressen denne oppgaven er rettet mot.
CatalogSubmissionFile
Fil for kataloginnsending		 (Obligatorisk) Angi banen og filnavnet til filen for kataloginnsending.
UsePackageSolutionZipFile
Filtype		 Filtype: ZIP-fil med pakke eller løsning.
SolutionZipFile
Navn på ZIP-fil med løsning		 Angi banen og filnavnet til ZIP-filen med løsning.
PollStatus
Kontroller avspørringsstatus		 (Valgfritt) Avspørring for å kontrollere statusen for forespørselen (true|false).

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

Status for katalogforespørsel

Få statusen for forespørselen om installasjon/sending av katalog.

Parametere Bekrivelse
authenticationType
Autentiseringstype		 (Kreves for SPN) Angi PowerPlatformEnvironment for en tilkobling med brukernavn/passord eller PowerPlatformSPN for en tjenestekontohaver/klienthemmelighet-tilkobling.
PowerPlatformSPN
Power Platform-tjenestekontohaver		 Endepunkt for tjeneste for miljøet du vil laste opp innhold til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Definert under Tjenestetilkoblinger i Prosjektinnstillinger ved hjelp av Power Platform-tilkoblingstypen.
Environment
URL-adresse for målmiljø		 (Obligatorisk) Miljønettadressen denne oppgaven er rettet mot.
TrackingId
Forespørselssporings-ID		 (Obligatorisk) Forespørselssporings-ID.
RequestType
Forespørselstype		 (Obligatorisk) Forespørselstype. (Verdier: Installer | Send inn).

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

Pipeliner for build og lansering

Nå som vi har identifisert hva som kan utføres med byggeverktøyene, kan vi se på hvordan du kan ta i bruk disse verktøyene i pipeliner for build og lansering. En begrepsforklarende oversikt vises nedenfor. La oss se noen detaljer om implementeringen av pipelinen ved hjelp av oppgavene for byggeverktøyet i underavsnittene nedenfor.

Hvis du vil vite mer om hvordan du oppretter disse pipelinene og faktisk utfører skriving av pipeliner ved hjelp av Microsoft Power Platform Build Tools, kan du gjennomføre leksjonene for build tools, som du kan laste ned fra GitHub.

Mer informasjon om Azure-pipeliner: Bruke Azure-pipeliner

Build-pipeline: Eksportere en løsning fra et utviklingsmiljø (DEV)

Følgende figur viser oppgavene i byggeverktøyet som du kan legge til i en pipeline som eksporterer en løsning fra et utviklingsmiljø.

Eksportere en løsning fra et utviklingsmiljø (DEV).

Kompileringskontroll: Bygge en administrert løsning

Følgende figur viser oppgavene i byggeverktøyet som du kan legge til i en pipeline som bygger en administrert løsning.

Bygge en administrert løsning.

Pipeline for lansering: Distribuere til et produksjonsmiljø (PROD)

Følgende figur viser oppgavene i byggeverktøyet som du kan legge til i en pipeline som distribuerrer til et produksjonsmiljø.

Distribuere til et produksjonsmiljø (PROD).

Se også

Microsoft Power Platform Bygg verktøy for Azure DevOps