Del via

Microsoft Power Platform Build Tools-opgaver

  • Artikel

De tilgængelige build-opgaver er beskrevet i følgende afsnit. Herefter vises nogle eksempler på Azure-pipelines, der gør brug af disse opgaver. Du kan finde oplysninger om Build Tools, og hvordan du downloader dem, under Microsoft Power Platform Build Tools til Azure Pipelines.

Opgave i hjælp

De tilgængelige hjælpeopgaver er beskrevet herefter.

Power Platform-værktøjsinstallationsprogram

Denne opgave skal nødvendigvis tilføjes én gang inden alle andre Power Platform Build Tools-opgaver i build- og release-pipelines. Denne opgave installerer et sæt specifikke Power Platform-værktøjer, som helpdesk-medarbejderen skal bruge til at køre Microsoft Power Platform-build-opgaverne. Denne opgave kræver ingen yderligere konfiguration, når den tilføjes. Denne opgave indeholder parametre til de specifikke versioner af hvert af de værktøjer, der installeres.

Hvis du vil holde dig ajour med værktøjets versioner over tid, skal du sørge for, at disse parametre stemmer overens med de versioner af værktøjer, der skal bruges, for at pipelinen kan køre korrekt.

YAML-kodestykke (installationsprogram)

# 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

Parametre (installationsprogram)

Parametre Beskrivelse
DefaultVersion
Bruge standardværktøjsversioner		 Angiv til sand for at bruge standardversionen af alle værktøjer, ellers falsk. Påkrævet (og falsk), når enhver værktøjsversion angives.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Værktøjsversion		 Den specifikke version af værktøjet, der skal bruges.

Power Platform WhoAmI

Kontrollerer en tjenesteforbindelse i Power Platform-miljøer ved at oprette og lave en WhoAmI-anmodning. Det kan være nyttigt at inkludere denne opgave tidligt i pipelinen for at kontrollere forbindelsen, før processen starter.

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

Parametre (WhoAmI)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Valgfrit) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
PowerPlatformEnvironment
Power Platform-miljø-URL		 Tjenesteslutpunktet for det miljø, du vil oprette forbindelse til. Defineret under Tjenesteforbindelser under Projektindstillinger. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Tjenesteslutpunktet for det miljø, du vil oprette forbindelse til. Defineret under Tjenesteforbindelser under Projektindstillinger.

Kvalitetskontrol

I næste sektion kan du se de tilgængelige opgaver til kontrol af kvaliteten af en løsning.

Power Platform Checker

Denne opgave kører en statisk analysekontrol af løsningerne på baggrund af et sæt best practice-regler med henblik på at identificere problematiske mønstre, som kan opstå ved et uheld, når du bygger din løsning.

YAML-kodestykke (kontrol)

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

Parametre (kontrol)

Parametre Beskrivelse
PowerPlatformSPN
Tjenesteforbindelse		 (Påkrævet) En forbindelse til et Microsoft Power Platform-miljø med licens kræves for at bruge Power Platform-kontrol. Tjenesteforbindelser defineres i Tjenesteforbindelser under Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Power Platform Opret miljø

Bemærk: Godkendelsesmetoder til tjenesteprincipal og brugernavn/adgangskode er tilgængelige for kontrolopgaven. Du kan finde flere oplysninger om, hvordan du konfigurerer tjenesteprincipaler, der skal bruges sammen med denne opgave, under Konfigurere forbindelser til tjenesteprincipaler for Power Platform-miljøer.
UseDefaultPACheckerEndpoint
Brug Power Platform-kontrollens standardslutpunkt		 Som standard (sand) bruger den geografiske placering af kontroltjenesten den samme geografi som det miljø, du opretter forbindelse til.
CustomPACheckerEndpoint
Brugerdefineret PAC-kontrolslutpunkt		 Påkrævet, når UseDefaultPACheckerEndpoint er falsk. Du kan angive en anden geografisk placering, du vil bruge, f.eks. https://japan.api.advisor.powerapps.com.. Hvis du vil have vist en liste over tilgængelige geografiske områder, skal du se Bruge Power Platform-kontrol-API'en.
FileLocation
Placering af filer, der skal analyseres		 Påkrævet, når der henvises til en fil fra en SAS-URL sasUriFile

(Shared Access Signature).Bemærk!: Det er vigtigt at referere til en eksporteret løsningsfil og ikke til de udpakkede kildefiler i dit lager. Både administrerede og ikke-administrerede løsningsfiler kan analyseres.
FilesToAnalyzeSasUri
SAS-filer til analyse		 Kræves, når FileLocation er angivet til sasUriFile. Angiv SAS-URI'en. Du kan tilføje mere end én SAS-URI via en komma- (,) eller semikolonsepareret liste (;).
FilesToAnalyze
Lokale filer til analyse		 Kræves, når SAS-filer ikke analyseres. Angiv stien til og filnavnet på de zip-filer, der skal analyseres. Jokertegn kan bruges. Du kan f.eks. skrive **\*.zip for alle zip-filer i alle undermapper.
FilesToExclude
Lokale filer til udeladelse		 Angiv navnene på de filer, der skal udelades i analysen. Hvis du har mere end én, skal du angive en komma- (,) eller semikolonsepareret (;) liste. Denne liste kan indeholde et komplet filnavn eller et navn med foranstillede eller efterstillede jokertegn, f.eks. *jquery eller form.js
RulesToOverride
Regler, der skal tilsidesættes		 En JSON-matrix, der indeholder regler og niveauer, som skal tilsidesættes. Accepterede værdier for OverrideLevel er: Kritisk, Høj, Mellem, Lav, Oplysninger. Eksempel: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Mellem"},{"Id":"kort-undgå-specialiseret-opdatering-ops","OverrideLevel":"Mellem"}]
RuleSet
Regelsæt		 (Påkrævet) Angiv, hvilket regelsæt der skal anvendes. Følgende to regelsæt er tilgængelige
  • Løsningskontrol: Dette regelsæt er det samme, der køres fra Power Apps Maker Portal.
  • AppSource: Det udvidede regelsæt, der bruges til at certificere et program, før det kan publiceres til AppSource.
ErrorLevel
Fejlniveau		 I kombination med fejltærskelparameteren definerer fejlniveauet den alvorsgrad for fejl og advarsler, som er tilladt. Understøttede tærskelværdier er <level>IssueCount, hvor niveau=Kritisk, Høj, Mellem, Lav og Oplysninger.
ErrorThreshold
Fejltærskel		 Definerer antallet af fejl (>=0) på et angivet niveau, som er tilladt, for at kontrollen kan overføre de løsninger, der kontrolleres.
FailOnPowerAppsCheckerAnalysisError
Mislykkes ved fejl		 Når den er sand, mislykkes det, hvis Power Apps-kontrolanalysen returneres som Failed eller FinishedWithErrors.
ArtifactDestinationName
DevOps-artefaktnavn		 Angiv Azure-artefaktnavnet for kontrollens .sarif-fil.

Løsningsopgaver

Dette sæt opgaver kan automatisere løsningshandlinger. De miljøopgaver, der beskrives senere i dette afsnit, og som opretter, kopierer eller gendanner et miljø, overskriver tjenesteforbindelserne med de miljøer, du netop har oprettet. Disse opgaver gør det muligt at udføre løsningsopgaver i miljøer, der oprettes efter behov.

Power Platform Importér løsning

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

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

Parametre (import)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformEnvironment
Power Platform-miljø-URL		 Det tjenesteslutpunkt, du vil importere løsningen til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Det tjenesteslutpunkt, du vil importere løsningen til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
SolutionInputFile
Løsningsinputfil		 (Påkrævet) Stien til og filnavnet på den løsning.zip-fil, der skal importeres til målmiljøet (f.eks. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Bemærk!: Variabler giver dig en praktisk måde at få vigtige data ind i forskellige dele af din pipeline. Se Brug af foruddefinerede variabler for at få vist en komplet liste.
HoldingSolution
Importere som en løsning i venteposition		 En avanceret parameter (sand|falsk), der bruges, når en løsning skal opgraderes. Denne parameter er vært for løsningen i Dataverse, men den opgraderer først løsningen, når opgaven Anvend løsningsopgradering er kørt.
OverwriteUnmanagedCustomizations
Overskrive ikke-administrerede tilpasninger		 Angiv, om ikke-administrerede tilpasninger skal overskrives (sand|falsk).
SkipProductUpdateDependencies
Springe afhængigheder ved produktopdatering over		 Angiv, om håndhævelsen af afhængigheder vedrørende produktopdateringer skal springes over (sand|falsk).
ConvertToManaged
Konvertér til administreret		 Angiv, om den skal importeres som administreret løsning (sand|falsk).
AsyncOperation
Asynkron import		 Hvis indstillingen er valgt (sand), udføres importhandlingen asynkront. Det anbefales til større løsninger, da denne opgave automatisk får timeout efter fire minutter. Valg af asynkron handling vil hente og vente, indtil MaxAsyncWaitTime er nået (sand|falsk).
MaxAsyncWaitTime
Maksimal ventetid		 Maksimal ventetid i minutter for den asynkrone handling. Standard er 60 minutter (1 time), samme som Azure DevOps-standard for opgaver.
PublishWorkflows
Aktivere processer efter import		 Angiv, om processer (arbejdsprocesser) i løsningen skal aktiveres efter importen (sand|falsk).
UseDeploymentSettingsFile
Bruge indstillingsfilen for udrulning		 Forbindelsesreferencer og miljøvariablers værdier kan angives med en fil til udrulningsindstillinger (sand|falsk).
DeploymentSettingsFile
Udrulningsindstillingsfil		 (Kræves, når UseDeploymentSettingsFile=sand) Stien til og filnavnet på filen med udrulningsindstillinger.

Power Platform Tilføj løsningskomponent

Føjer en løsningskomponent til en ikke-administreret løsning.

YAML-kodestykke (tilføj)

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

Parametre (Tilføj)

Parametre Beskrivelse
ComponentId
Id for løsningskomponenten		 Skemanavn eller -id for den komponent, der skal føjes til målløsningen.
ComponentType
Power Platform-miljø-URL		 Den værdi, der repræsenterer den løsningskomponent, du tilføjer. Du kan se en omfattende liste over komponentværdier under Brug foruddefinerede komponenttyper.
SolutionUniqueName
Navnet på løsningen		 Entydigt navn for løsningen.
AddRequiredComponents
Eventuelle komponenter, der kræves fra en anden løsning, og som er afhængige af løsningskomponenten		 (Valgfrit) Angiver, om der også skal føjes andre løsningskomponenter, som kræves af den løsningskomponent, du er ved at tilføje, til den ikke-administrerede løsning.
Environment
Miljø-URL eller -ID		 (Valgfrit) URL-adresse til miljø eller id for destinationsmiljøet.

Anvend løsningsopgradering i Power Platform

Opgraderer en løsning, der er importeret som en løsning i venteposition.

YAML kodestykke (opgradering)

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

Parametre (opgradering)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformEnvironment
Power Platform-miljø-URL		 Det tjenesteslutpunkt, du vil opgradere løsningen til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Det tjenesteslutpunkt, du vil opgradere løsningen til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
SolutionName
Navn på løsning		 (Påkrævet) Navnet på den løsning, hvor opgraderingen skal anvendes. Brug altid løsningens navn, ikke dens viste navn.
AsyncOperation
Asynkron opgradering		 Hvis indstillingen er valgt (sand), udføres opgraderingshandlingen som et asynkront batchjob. Valg af asynkront batchjob vil hente og vente, indtil MaxAsyncWaitTime er nået.
MaxAsyncWaitTime
Maksimal ventetid		 Maksimal ventetid i minutter for den asynkrone handling. Standard er 60 minutter (1 time), samme som Azure DevOps-standard for opgaver.

Bemærk

Variabler giver dig en god måde at få oplyst nøglebit af data på i forskellige dele af din pipeline. Se Brug af foruddefinerede variabler for at få vist en komplet liste. Du kan udfylde oplysninger om forbindelsesreference og miljøvariabler på forhånd for destinationsmiljøet, mens du importerer en løsning ved hjælp af en fil med installationsindstillinger.

Flere oplysninger: Udfyld forbindelsesreferencer og miljøvariabler på forhånd for automatiserede installationer

Power Platform Eksportér løsning

Eksporterer en løsning fra et kildemiljø.

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

Parametre (eksport)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformEnvironment
Power Platform-miljø-URL		 Det tjenesteslutpunkt, du vil opgradere løsningen til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Det tjenesteslutpunkt, du vil opgradere løsningen til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
SolutionName
Navn på løsning		 (Påkrævet) Navnet på den løsning, der skal eksporteres. Brug altid løsningens navn, ikke dens viste navn.
SolutionOutputFile
Løsningsoutputfil		 (Påkrævet) Stien til og filnavnet på den løsning.zip-fil, som kildemiljøet skal eksporteres til (f.eks. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Bemærk!: Variabler giver dig en praktisk måde at få vigtige data ind i forskellige dele af din pipeline. Se Brug af foruddefinerede variabler for at få vist en komplet liste.
AsyncOperation
Asynkron eksport		 Hvis indstillingen er valgt (sand), udføres eksporthandlingen som et asynkront batchjob. Valg af asynkront batchjob vil hente og vente, indtil MaxAsyncWaitTime er nået.
MaxAsyncWaitTime
Maksimal ventetid		 Maksimal ventetid i minutter for den asynkrone handling. Standard er 60 minutter (1 time), samme som Azure DevOps-standard for opgaver.
Managed
Eksportere som administreret		 Hvis indstillingen er valgt (sand), kan du eksportere løsningen som en administreret løsning. Ellers eksporteres den som en ikke-administreret løsning.
ExportAutoNumberingSettings
Eksportere indstillinger for automatisk nummerering		 Du kan eksportere indstillinger for automatisk nummerering (sand|falsk).
ExportCalendarSettings
Eksportere kalenderindstillinger		 Eksportere kalenderindstillinger (sand|falsk).
ExportCustomizationSettings
Eksportere tilpasningsindstillinger		 Eksportere tilpasningsindstillinger (sand|falsk).
ExportEmailTrackingSettings
Eksportere indstillinger til sporing af mail		 Eksportere indstillinger til sporing af mail (sand|falsk).
ExportGeneralSettings
Eksportere generelle indstillinger		 Eksportere generelle indstillinger (sand|falsk).
ExportIsvConfig
Eksportere ISV-konfiguration		 Eksportere ISV-konfiguration (sand|falsk).
ExportMarketingSettings
Eksportere marketingindstillinger		 Eksportere marketingindstillinger (sand|falsk).
ExportOutlookSynchronizationSettings
Eksportere indstillinger for Outlook-synkronisering		 Eksportere indstillinger for Outlook-synkronisering (sand|falsk).
ExportRelationshipRoles
Eksportere relationsroller		 Eksportere relationsroller (sand|falsk).
ExportSales
Eksportere salg		 Eksportere salg (sand|falsk).

Power Platform Udpak løsning

Tager en komprimeret løsningsfil og opdeler den i flere XML-filer, så disse filer nemmere kan læses og styres af et kildekontrolsystem.

YAML-kodestykke (pak ud)

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

Parametre (pak ud)

Parametre Beskrivelse
SolutionInputFile
Løsningsinputfil		 (Påkrævet) Stien til og filnavnet på den løsnings-zip-fil, der skal udpakkes.
SolutionTargetFolder
Destinationsmappe, hvori løsningen skal udpakkes		 (Påkrævet) Den sti og destinationsmappe, du vil pakke løsningen ud i.
SolutionType
Type af løsning		 (Påkrævet) Den type løsning, du vil pakke ud. Indstillingerne omfatter: Ikke-administreret (anbefales), Administreret og Begge.

Power Platform Pak løsning

Pakker en løsning, der er repræsenteret i kildekontrollen, i en løsning.zip-fil, der kan importeres i et andet miljø.

YAML-kodestykke (pak)

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

Parametre (pak)

Parametre Beskrivelse
SolutionOutputFile
Løsningsoutputfil		 (Påkrævet) Stien til og filnavnet på den løsning.zip-fil, som løsningen skal pakkes ind i.
SolutionSourceFolder
Kildemappe til løsning, der skal pakkes		 (Påkrævet) Stien og kildemappen for den løsning, der skal pakkes.
SolutionType
Type af løsning		 (Påkrævet) Den type løsning, du vil pakke. Indstillingerne omfatter: Administreret (anbefales), Ikke-administreret og Begge.

Slet løsning i Power Platform

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

YAML-kodestykke (slet)

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'

Parametre (slet)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformEnvironment
Power Platform-miljø-URL		 Det tjenesteslutpunkt, hvor du vil slette løsningen (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Det tjenesteslutpunkt, hvor du vil slette løsningen (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
SolutionName
Navn på løsning		 (Påkrævet) Navnet på den løsning, der skal slettes. Brug altid løsningens navn, ikke dens viste navn.

Power Platform Publicer tilpasninger

Publicerer alle tilpasninger i et miljø.

YAML-kodestykke (publicer)

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

Parametre (publicer)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformEnvironment
Power Platform-miljø-URL		 Det tjenesteslutpunkt, du vil publicere tilpasningerne til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Det tjenesteslutpunkt, du vil publicere tilpasningerne til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø

Power Platform Angiv løsningsversion

Opdaterer versionen af en løsning.

YAML-kodestykke (version)

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

Parametre (version)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformEnvironment
Power Platform-miljø-URL		 Det tjenesteslutpunkt, hvor du vil angive løsningens version (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Det tjenesteslutpunkt, hvor du vil angive løsningens version (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
SolutionName
Navn på løsning		 (Påkrævet) Navnet på den løsning, som versionen skal angives for. Brug altid løsningens navn, ikke dens viste navn.
SolutionVersionNumber
Versionsnummer på løsning		 (Påkrævet) Det versionsnummer, du vil angive.

Mens versionsnummer kan hardcodes i pipelinen, anbefales det, at du bruger en Azure DevOps-pipelinevariabel som BuildId. Her kan du se indstillinger, hvor du kan definere den nøjagtige form for versionsnummer under fanen "Indstillinger", for eksempel $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Denne definition kan derefter bruges i opgaven Angiv løsningsversion ved at angive egenskaben Versionsnummer med: $(Build.BuildId) i stedet for hardcoding 20200824.0.0.2.

Du kan også bruge et powershell-integreret opgavescript $(Get-Date -Format yyyy.MM.dd.HHmm) som output til tom variabel med navnet SolutionVersion som Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Angiv løsningsversion som $(SolutionVersion).

Power Platform Angiv forbindelsesvariabler

Angiver BuildTools.*-variabler for at give brugerdefinerede scriptopgaver adgang til at bruge tjenesteforbindelsen som en enkelt kilde til sandheden.

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

Parametre (SetConnectionVariables)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Det tjenesteslutpunkt, hvor du vil angive forbindelsesvariabler for. Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
timeoutInMinutes
Timeout		 Angiver den maksimale tid i minutter, en opgave må udføre, før den annulleres af serveren. En nulværdi indikerer en uendelig timeout.
retryCountOnTaskFailure
Antal nye poster, hvis opgaven mislykkedes		 Angiver antallet af nye poster for denne opgave, der skal ske i tilfælde af opgavefejl. Understøttes ikke i forbindelse med opgaver, der er mindre end agent.
ApplicationId
Login for applikations-id		 (Kræves til brugernavn/adgangskode) Program-id, der skal bruges til logon (Se yderligere note nedenfor).
RedirectUri
Omdirigere URI'er for den specifikke app		 (Kræves til brugernavn/adgangskode) Omdirigere URI'er for den angivne app. Nødvendigt, når du angiver et app-id. (Se yderligere note nedenfor).

Bemærk!

Når du bruger godkendelsestypen brugernavn eller adgangskode, kræves program-id'et og Redirect Uri. Dette oauth-godkendelsesdokument indeholder en forklaring på, hvorfor du skal oprette en apptilmelding, der skal godkendes med Dataverse. Når du opretter forbindelse ved hjælp af brugernavn/adgangskodegodkendelse, fungerer forbindelsen som et program, der opretter forbindelse på vegne af en bruger til Dataverse.

Power Platform Installer pakke

Udruller en pakke i et miljø. Hvis du udruller en pakke i modsætning til en enkelt løsningsfil, får du mulighed for at udrulle flere løsninger, data og kode i et miljø.

YAML-kodestykke (udrul)

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

Parametre (udrul)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformEnvironment
Power Platform-miljø-URL		 Det tjenesteslutpunkt, du vil udrulle pakken til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Det tjenesteslutpunkt, du vil udrulle pakken til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform. Flere oplysninger: Se BuildTools.EnvironmentUrl under Oprette Power Platform-miljø
PackageFile
Pakkefil		 (Påkrævet) Stien til og filnavnet på pakkefil-assembly (.dll).
MaxAsyncWaitTime
Maksimal ventetid		 Maksimal ventetid i minutter for den asynkrone handling. Standard er 60 minutter (1 time), samme som Azure DevOps-standard for opgaver.

Miljøstyringsopgaver

Automatiser opgaver til generel administration af miljøers livscyklus (ELM).

Power Platform Opret miljø

Opretter et nyt miljø. Når du opretter et nyt miljø, oprettes der også automatisk BuildTools.EnvironmentUrl.

Vigtigt

Når den angives, bruges BuildTools.EnvironmentUrl som standardtjenesteforbindelse til efterfølgende opgaver i pipelinen. De enkelte opgaver, der beskrives i denne artikel, bruger slutpunktet fra tjenesteforbindelsen, når BuildTools.EnvironmentUrl ikke er angivet.

Et nyt miljø kan kun klargøres, hvis din licens eller kapacitet giver mulighed for at oprette yderligere miljøer. Du kan finde flere oplysninger om, hvordan du får vist kapacitet, under Sidedetaljer om kapacitet.

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

Parametre (Create-env)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformEnvironment
Power Platform-miljø-URL		 Det tjenesteslutpunkt, hvor du vil oprette miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Det tjenesteslutpunkt, hvor du vil oprette miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
DisplayName
Vis navn		 (Påkrævet) Visningsnavnet for miljøet er oprettet.
LocationName
Installationsområde		 (Påkrævet) Det område, som miljøet skal oprettes i.
EnvironmentSku
Miljøtype		 (Påkrævet) Den type af forekomst, der skal installeres. Indstillingerne er Sandkasse, Produktion, Prøve og SubscriptionBasedTrial.
AppsTemplate
Apps		 For miljøtyper, der ikke er prøveversioner, er de understøttede apps D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation og D365_Sales.
CurrencyName
Valuta		 (Påkrævet) Grundvalutaen for det oprettede miljø. Valutaen kan ikke opdateres, når miljøet er oprettet.
LanguageName
Language		 (Påkrævet) Udgangssproget i miljøet.
DomainName
Domænenavn		 (Påkrævet) Det er den miljøspecifikke streng, der udgør en del af URL-adressen. For et miljø med URL-adressen https://powerappsbuildtasks.crm.dynamics.com/ er domænenavnet f.eks. 'powerappsbuildtasks'.

Bemærk!: Hvis du indtaster et domænenavn, der allerede er i brug, føjer opgaven en numerisk værdi til domænenavnet, der starter med 0. I det foregående eksempel kan URL-adressen blive https://powerappsbuildtasks0.crm.dynamics.com/.

Power Platform Slet miljø

Sletter et miljø.

YAML-kodestykke (Delete-env)

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

Parametre (Delete-env)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformEnvironment
Power Platform-miljø-URL		 Det tjenesteslutpunkt, hvor du vil slette miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Det tjenesteslutpunkt, hvor du vil slette miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.

Power Platform Tildele brugere

Tildel en bruger til et destinationsmiljø med den angivne sikkerhedsrolle.

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

Parametre (AssignUser-env)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Tjenesteslutpunktet for det miljø, hvor du vil tildele brugeren (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
User
Power Platform-brugernavn		 Microsoft Entra-objekt-id eller brugerens hovednavn, der skal tildeles til destinationsmiljøet.
Role
Navn på eller id for sikkerhedsrolle		 Navn på eller id for sikkerhedsrolle, der skal tildeles til brugeren.
ApplicationUser
Power Platform-programbrugernavn		 Angiver, om inputbrugeren er programbruger (true|false).

Power Platform Nulstil miljø

Nulstiller et miljø.

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

Parametre (Reset-env)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformEnvironment
Power Platform-miljø-URL		 Det tjenesteslutpunkt, hvor du vil nulstille miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Det tjenesteslutpunkt, hvor du vil nulstille miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.

Power Platform Miljøsikkerhedskopiering

Sikkerhedskopierer et miljø.

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

Parametre (Backup-env)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformEnvironment
Power Platform-miljø-URL		 Det tjenesteslutpunkt, hvor du vil sikkerhedskopiere miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Det tjenesteslutpunkt, hvor du vil sikkerhedskopiere miljøet (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
BackupLabel
Navn til sikkerhedskopi		 (Påkrævet) Det navn, der skal tildeles sikkerhedskopien.

Power Platform Kopiér miljø

Kopierer et miljø til et målmiljø. Der findes to typer kopiering: fuld og minimal. En Fuldstændig kopi indeholder både data- og løsningsmetadata (tilpasninger), mens en Minimal kopiering kun indeholder løsningsmetadata og ikke de faktiske data.

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

Parametre (Copy-env)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformEnvironment
Power Platform-miljø-URL		 Tjenesteslutpunktet for det kildemiljø, du vil kopiere fra (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Tjenesteslutpunktet for det kildemiljø, du vil kopiere fra (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
TargetEnvironmentUrl
Målmiljøets URL-adresse		 (Påkrævet) URL-adressen for det målmiljø, du vil kopiere til.
CopyType
Kopitype		 Den type af kopiering, der skal udføres: FullCopy eller MinimalCopy
OverrideFriendlyName
Tilsidesætte fuldt navn		 Ret destinationsmiljøets fulde navn til et andet navn (sand|falsk).
FriendlyName
Fuldt navn		 Det fulde navn på destinationsmiljøet.
DisableAdminMode
Deaktivere administratortilstand		 Om administrationstilstanden skal deaktiveres (sand|falsk).

Power Platform Gendan miljø

Gendanner et miljø til en given sikkerhedskopi.

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

Parametre (Restore-env)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformEnvironment
Power Platform-miljø-URL		 Tjenesteslutpunktet for det kildemiljø, du vil gendanne fra (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Tjenesteslutpunktet for det kildemiljø, du vil gendanne fra (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
RestoreLatestBackup
Seneste backup, der skal gendannes		 Om du vil gendanne den seneste backup eller gendanne RestoreTimeStamp (true|false).
RestoreTimeStamp
Dato og klokkeslæt for backup		 Dato og klokkeslæt for sikkerhedskopien i "dd/mm/åååå tt:mm"-format ELLER strengen "seneste".
TargetEnvironmentUrl
Målmiljøets URL-adresse		 (Påkrævet) URL-adressen for det målmiljø, du vil gendanne.
FriendlyName
Navn for det gendannede miljø		 (Valgfrit) navn for det gendannede miljø.
DisableAdminMode
Deaktivere administratortilstand		 Om administrationstilstanden skal deaktiveres (sand|falsk).

Eksporter Dataverse-data

Eksportér data fra et miljø med det medfølgende skema.

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

Parametre (exportdata-env)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Tjenesteslutpunktet for det miljø, du vil eksportere data fra (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
SchemaFile
Navn på XML-skemafil		 Navn på XML-skemafil. Det kan oprettes ved hjælp af værktøjet til konfigurationsoverførsel.
DataFile
Navn på datafil		 Filnavn på data, der skal eksporteres (zip-fil).
Overwrite
Overskriv indhold		 Power Pages-webstedsindhold, der skal overskrives (true|false).

Importere Dataverse-data

Importér data til et miljø.

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

Parametre (importdata-env)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Tjenesteslutpunktet for det miljø, hvor du vil importere data (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
DataFile
Navn på datafil		 Filnavn for den komprimerede zip-datafil, der skal importeres, eller den mappe med data-schema.xml og data.xml, der skal importeres.

Power Pages-administrationsopgaver

Opgaver til at arbejde med et Power Pages-websted.

Power Platform Hent PAPortal

Download Power Pages-webstedsindhold fra det aktuelle Dataverse-miljø.

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

Parametre (download-paportal)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Tjenesteslutpunktet for det miljø, du vil downloade indhold fra (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
WebsiteId
Id for portalwebsted		 Id for Power Pages-websted, der skal downloades.
Overwrite
Overskriv indhold		 Power Pages-webstedsindhold, der skal overskrives (true|false).
ModelVersion
Datamodel for websted		 Angiver, om de webstedsdata, der skal overføres, bruger standarddatamodellen (1) eller den udvidede datamodel (2). Standardværdi er '1'.

Power Platform Overfør PAPortal

Upload Power Pages-webstedets indhold til det aktuelle Dataverse-miljø.

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

Parametre (upload-paportal)

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Tjenesteslutpunktet for det miljø, du vil uploade indhold til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
UploadPath
Sti for overførsel af indhold		 Sti, hvorfra Power Pages-webstedets indhold skal uploades.
ModelVersion
Datamodel for websted		 Angiver, om de webstedsdata, der skal overføres, bruger standarddatamodellen (1) eller den udvidede datamodel (2). Standardværdi er '1'.

Katalog over Power Platform-opgaver (forhåndsversion)

Disse opgaver udfører handlinger i forhold til kataloget i Power Platform og omfatter følgende.

Bemærk

Katalogopgaver til Power Platform er i øjeblikket en forhåndsversion.

Installere katalogelement

Installer et catalog-element i destinationsmiljøet.

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Tjenesteslutpunktet for det miljø, du vil uploade indhold til (f.eks. https://powerappsbuildtools.crm.dynamics.com). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
Environment
Målmiljøets URL-adresse		 (Påkrævet) Miljø-URL til denne opgave.
CatalogItemId
Katalogelement-id, der skal installeres		 (Påkrævet) Katalogelement, der skal installeres i destinationsmiljøet.
TargetEnvironmentUrl
Målmiljøets URL-adresse		 (Påkrævet) URL-adressen til destinationsmiljøet for installation af katalogelement (f.eks. "https://YourOrg.crm.dynamics.com").
PollStatus
Kontrollere polling-status		 (Valgfrit) Polling for at kontrollere status for din anmodning (true|false).

Parametre (kataloginstallation)

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

Afsende kataloggodkendelse

Send anmodning om catalog-godkendelse.

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Tjenesteslutpunktet for det miljø, du vil uploade indhold til (f.eks. "https://powerappsbuildtools.crm.dynamics.com"). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
Environment
Målmiljøets URL-adresse		 (Påkrævet) Miljø-URL til denne opgave.
CatalogSubmissionFile
Fil til katalogindsendelse		 (Påkrævet) Angiv stien til og filnavnet på filen til katalogindsendelse.
UsePackageSolutionZipFile
Filtype		 Filtype: pakke- eller løsnings-zip-fil.
SolutionZipFile
Navn på zip-fil med løsning		 Angiv stien til og filnavnet på løsnings-zip-filen.
PollStatus
Kontrollere polling-status		 (Valgfrit) Polling for at kontrollere status for din anmodning (true|false).

Parametre (katalogindsendelse)

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 kataloganmodning

Få statussen for anmodningen om installation/indsendelse af kataloget.

Parametre Beskrivelse
authenticationType
Godkendelsestype		 (Påkrævet for SPN) Angiv enten PowerPlatformEnvironment for en brugernavn-/adgangskodeforbindelse eller PowerPlatformSPN for en forbindelse med tjenesteprincipal/klienthemmelighed.
PowerPlatformSPN
Power Platform-tjenesteprincipal		 Tjenesteslutpunktet for det miljø, du vil uploade indhold til (f.eks. "https://powerappsbuildtools.crm.dynamics.com"). Defineret under Tjenesteforbindelser i Projektindstillinger ved hjælp af forbindelsestypen Power Platform.
Environment
Målmiljøets URL-adresse		 (Påkrævet) Miljø-URL til denne opgave.
TrackingId
Anmode om sporings-id		 (Påkrævet) Anmod om sporings-id.
RequestType
Anmodningstype		 (Påkrævet) Anmodningstype. (Værdier: Installer | Indsend).

Parametre (katalogstatus)

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

Build og release-pipelines

Nu, hvor vi har identificeret, hvad der kan gøres ved hjælp af værktøjerne i build-værktøjerne, så lad os se på, hvordan du kan anvende disse værktøjer i dine build-og release-pipelines. Der vises en konceptuel oversigt nedenfor. Lad os se på nogle detaljer om pipeline-implementeringen ved hjælp af build-tool-opgaverne i de følgende underafsnit.

Hvis du vil vide mere om, hvordan du opretter disse pipelines, og hvordan du rent faktisk opretter pipelines ved hjælp af Microsoft Power Platform Build Tools, skal du fuldføre de Build Tools-labs, som du kan hente fra GitHub.

Flere oplysninger om Azure Pipelines: Brug Azure-pipelines

Build-pipeline: Eksporter en løsning fra et udviklingsmiljø (DEV)

I følgende illustration vises de build-værktøjsopgaver, du kan føje til en pipeline, der eksporterer en løsning fra et udviklingsmiljø.

Eksporter en løsning fra et udviklingsmiljø (DEV).

Build-pipeline: Byg en administreret løsning

I følgende illustration vises de build-værktøjsopgaver, du kan føje til en pipeline, der bygger en administreret løsning.

Byg en administreret løsning.

Frigiv pipeline: Udrul i et produktionsmiljø (PROD)

I følgende illustration vises de build-værktøjsopgaver, du kan føje til en pipeline, der installerer et produktionsmiljø.

Udrul i et produktionsmiljø (PROD).

Se også

Microsoft Power Platform Byg værktøjer til Azure DevOps