Comparteix a través de

Tasques del Microsoft Power Platform Build Tools

  • Article

Les tasques de compilació disponibles es descriuen a les seccions següents. A continuació, mostrem alguns exemples d'Azure Pipelines que fan ús d'aquestes tasques. Per obtenir informació sobre les eines de compilació i com baixar-les, vegeu Microsoft Power Platform Eines de compilació per a Azure Pipelines.

Tasca d'ajuda

A continuació es descriuen les tasques d'ajuda disponibles.

Instal·lador d'eines del Power Platform

Aquesta tasca s'ha d'afegir una vegada abans que qualsevol altra tasca del Power Platform Build Tools als pipelines de compilació i llançament. Aquesta tasca instal·la un conjunt d'eines específiques del Power Platform necessàries perquè l'agent executi les tasques de compilació del Microsoft Power Platform. Aquesta tasca no requereix més configuració quan s'afegeix. Aquesta tasca conté paràmetres per a les versions específiques de cadascuna de les eines que s'estan instal·lant.

Per mantenir-vos al dia amb les versions de l'eina al llarg del temps, assegureu-vos que aquests paràmetres corresponen a les versions de les eines necessàries perquè el pipeline s'executi correctament.

Fragment YAML (Installer)

# 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

Paràmetres (Installer)

Paràmetres Descripció
DefaultVersion
Utilitzar versions d'eines per defecte		 Definiu-lo com a cert per utilitzar la versió per defecte de totes les eines, altrament com a fals. Necessari (i fals) quan s'especifica qualsevol versió de l'eina.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Versió de l'eina		 Versió específica de l'eina que s'utilitzarà.

Power Platform WhoAmI

Per verificar una connexió d'un servei d'entorn del Power Platform, s'hi connecta i realitza una sol·licitud WhoAmI. Aquesta tasca pot ser útil per incloure-la d'inici al pipeline per tal de verificar la connectivitat abans que comenci el processament.

Fragment YAML (WhoAmI)

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@2
  displayName: 'Power Platform WhoAmI'

  inputs: 
#   Service Principal/client secret (supports MFA)
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'My service connection'

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@2
  displayName: 'Power Platform WhoAmI'

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

Paràmetres (WhoAmI)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Opcional) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 Extrem del servei de l'entorn al qual es connectarà. Es defineix a Connexions del servei a Configuració del projecte. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
PowerPlatformSPN
Entitat principal del Power Platform		 Extrem del servei de l'entorn al qual es connectarà. Es defineix a Connexions del servei a Configuració del projecte.

Comprovació de qualitat

A la següent secció es mostren les tasques disponibles per comprovar la qualitat d'una solució.

Power Platform Checker

Aquesta tasca executa una comprovació d'anàlisi estàtica de les solucions amb un conjunt de regles de pràctiques recomanades per identificar els patrons problemàtics que podeu introduir inadvertidament en crear la solució.

Fragment YAML (Checker)

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

Paràmetres (Checker)

Paràmetres Descripció
PowerPlatformSPN
Connexió de servei		 (obligatori) Cal una connexió amb un entorn amb llicència del Microsoft Power Platform per tal d'utilitzar el comprovador del Power Platform. Les connexions de servei es defineixen a Connexions de servei a Configuració del projecte mitjançant el tipus de connexió Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Power Platform Crea un entorn

Nota: Els mètodes d'autenticació de l'entitat de servei i el nom d'usuari/contrasenya estan disponibles per a la tasca de verificació. Per obtenir més informació sobre la manera de configurar les entitats de seguretat de servei que s'han d'utilitzar amb aquesta tasca, vegeu Configurar les connexions d'entitats de seguretat de servei per a entorns del Power Platform.
UseDefaultPACheckerEndpoint
Utilitza l'extrem Checker per defecte del Power Platform		 Per defecte (true), la ubicació geogràfica del servei de verificació utilitza la mateixa geografia que l'entorn al qual us connecteu.
CustomPACheckerEndpoint
Extrem del comprovador PAC personalitzat		 Necessari quan UseDefaultPACheckerEndpoint és fals. Podeu especificar una altra geografia per utilitzar, per exemple https://japan.api.advisor.powerapps.com. . Per obtenir una llista de geografies disponibles, vegeu Utilitzar l'API Power Platform de verificació.
FileLocation
Ubicació dels fitxers a analitzar		 Necessari quan es fa referència a un fitxer des d'una adreça URL sasUriFile de signatura d'accés compartit (SAS).

Nota: És important fer referència a un fitxer de solució exportat i no als fitxers d'origen desempaquetats del repositori. Es poden analitzar fitxers de solució administrada i no administrada.
FilesToAnalyzeSasUri
Fitxers SAS per a l'anàlisi		 Necessari quan FileLocation està definit com a sasUriFile. Introduïu l'adreça URI del SAS. Podeu afegir més d'un URI de SAS per mitjà d'una llista separa per comes (,) o punts i comes (;).
FilesToAnalyze
Fitxers locals per a l'anàlisi		 Obligatori quan no s'analitzen els fitxers SAS. Especifiqueu el camí i el nom de fitxer dels fitxers .zip que s'analitzaran. Es poden utilitzar comodins. Per exemple, introduïu **\*.zip per a tots els fitxers zip de totes les subcarpetes.
FilesToExclude
Fitxers locals que s'exclouran		 Especifiqueu els noms dels fitxers que s'exclouen de l'anàlisi. Si n'hi ha més d'un, proporcioneu-los mitjançant una llista separada per comes (,) o punts i coma (;). Aquesta llista pot incloure un nom de fitxer complet o un nom amb caràcters comodí a l'inici o al final, com ara *jquery o form.js.
RulesToOverride
Regles que s'ometran		 Una matriu JSON que conté regles i nivells que s'ometran. Els valors acceptats per a OverrideLevel són: Crític, Alt, Mitjà, Baix, Informació. Exemple: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Conjunt de regles		 (obligatori) Especifiqueu quin conjunt de regles s'aplicarà. Hi ha disponibles els següents dos conjunts de regles:
  • Verificador de solucions: aquest conjunt de regles és el mateix que s'executa des del portal Power Apps delcreador.
  • AppSource: el conjunt de regles ampliades que s'utilitza per certificar una aplicació abans de publicar-la AppSource.
ErrorLevel
Nivell d'error		 Combinat amb l'error, el paràmetre llindar defineix la gravetat dels errors i avisos que es permeten. Els valors llindars compatibles són <level>IssueCount on level=Critical, High, Medium, Low i Informational.
ErrorThreshold
Llindar d'errors		 Defineix el nombre d'errors (>=0) d'un nivell especificat que es permet al comprovador per passar les solucions que es comproven.
FailOnPowerAppsCheckerAnalysisError
Fallada en cas d'error		 Quan és cert, falla si l'anàlisi del comprovador del Power Apps es retorna com a Failed o FinishedWithErrors.
ArtifactDestinationName
Nom d'artefacte DevOps		 Especifiqueu el nom d'Azure Artifacts per al fitxer .sarif del verificador.

Tasques de solució

Aquest conjunt de tasques pot automatitzar accions de la solució. Les tasques d'entorn que es descriuen més endavant en aquesta secció que creen, copien o restauren un entorn sobreescriuen les connexions de servei amb els entorns acabats de crear. Aquestes tasques permeten realitzar tasques de solució en entorns creats sota demanda.

Importació de solucions del Power Platform

Importa una solució en un entorn de destinació.

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

Paràmetres (Import)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 L'extrem de servei al qual voleu importar la solució (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei al qual voleu importar la solució (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
SolutionInputFile
Fitxer d'entrada de la solució		 (Obligatori) El camí i el nom del fitxer de la solució .zip fitxer per importar a l'entorn de destinació (per exemple, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Nota: Les variables us ofereixen una manera còmoda d'obtenir dades clau en diverses parts del pipeline. Vegeu Utilitzar variables predefinides per veure una llista completa.
HoldingSolution
Importar com a solució de retenció		 Paràmetre d'avançament (cert|fals) utilitzat quan s'ha d'actualitzar una solució. Aquest paràmetre allotja la solució al Dataverse, però no actualitza la solució fins que s'executa la tasca Aplica l'actualització de la solució.
OverwriteUnmanagedCustomizations
Sobreescriu personalitzacions no administrades		 Especifiqueu si voleu sobreescriure les personalitzacions no administrades (cert|fals).
SkipProductUpdateDependencies
Ometre les dependències d'actualització de productes		 Especifiqueu si l'aplicació de les dependències relacionades amb les actualitzacions de productes s'ha d'ometre (cert|fals).
ConvertToManaged
Converteix en administrat		 Especifiqueu si voleu importar com a solució administrada (cert|fals).
AsyncOperation
Importació asíncrona		 Si se selecciona (cert), l'operació d'importació es durà a terme de manera asíncrona. Això es recomana per a les solucions més grans, ja que en aquesta tasca el temps d'espera finalitzarà automàticament després de 4 minuts. Seleccionar asíncrona farà que se sondeigi i esperi fins que s'arribi a MaxAsyncWaitTime (cert|fals).
MaxAsyncWaitTime
Temps d'espera màxim		 Temps d'espera màxim en minuts per a l'operació asíncrona; per defecte és de 60 min (1 h), el mateix que el valor per defecte de l'Azure DevOps per a les tasques.
PublishWorkflows
Activar processos després de la importació		 Especifiqueu si els processos (fluxos de treball) de la solució s'han d'activar després de la importació (cert|fals).
UseDeploymentSettingsFile
Utilitza un fitxer de configuració d'implementació		 Les referències de la connexió i els valors de variables d'entorn es poden definir amb un fitxer de configuració d'implementació (cert|fals).
DeploymentSettingsFile
Fitxer de configuració d'implementació		 (Oligatori quan UseDeploymentSettingsFile=cert) El camí i el nom de fitxer del fitxer de configuració de la implementació.

Power Platform Afegeix un component de solució

Afegeix un component de solució a una solució no administrada.

Fragment YAML (Afegeix)

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

Paràmetres (Afegir)

Paràmetres Descripció
ComponentId
ID del component de la solució		 Nom o ID d'esquema del component que s'ha d'afegir a la solució de destinació.
ComponentType
Adreça URL de l'entorn del Power Platform		 El valor que representa el component de la solució que esteu afegint. Vegeu Utilitzar tipus de components predefinits per obtenir una llista completa dels valors dels components.
SolutionUniqueName
Nom de la solució		 Nom únic de la solució.
AddRequiredComponents
Qualsevol component necessari d'una altra solució en funció del component de la solució		 (Opcional) Indica si altres components de la solució que requereix el component de la solució que esteu afegint també s'han d'afegir a la solució no administrada.
Environment
URL o identificador de l'entorn		 (Opcional) URL de l'entorn o ID de l'entorn de destinació.

Aplica l'actualització de la solució del Power Platform

Actualitza una solució que s'ha importat com a solució de retenció.

Fragment YAML (Upgrade)

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

Paràmetres (Upgrade)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 L'extrem de servei al qual voleu actualitzar la solució (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei al qual voleu actualitzar la solució (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
SolutionName
Nom de la solució		 (Obligatori) Nom de la solució per aplicar l'actualització. Utilitzeu sempre el Nom de la solució i no el Nom de visualització.
AsyncOperation
Actualització asíncrona		 Si se selecciona (cert), l'operació d'actualització es durà a terme com una feina per lots asíncrona. Seleccionar asíncrona farà que se sondeigi i esperi fins que s'arribi a MaxAsyncWaitTime.
MaxAsyncWaitTime
Temps d'espera màxim		 Temps d'espera màxim en minuts per a l'operació asíncrona; per defecte és de 60 min (1 h), el mateix que el valor per defecte de l'Azure DevOps per a les tasques.

Nota

Les variables us proporcionen una manera convenient d'obtenir bits clau de dades en diverses parts del pipeline. Vegeu Utilitzar variables predefinides per veure una llista completa. Podeu emplenar prèviament la informació de referència de connexió i d'entorn per a l'entorn de destinació mentre importeu una solució mitjançant un fitxer de configuració d'implementació.

Més informació: Emplenar prèviament referències de connexió i variables d'entorn per a implementacions automatitzades

Exportació de solucions del Power Platform

Exporta una solució d'un entorn d'origen.

Fragment YAML (Export)

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

Paràmetres (Export)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 L'extrem de servei al qual voleu actualitzar la solució (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei al qual voleu actualitzar la solució (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
SolutionName
Nom de la solució		 (obligatori) Nom de la solució que s'exportarà. Utilitzeu sempre el Nom de la solució i no el Nom de visualització.
SolutionOutputFile
Fitxer de sortida de la solució		 (Obligatori) El camí i el nom de fitxer del fitxer solution.zip a exportar l'entorn d'origen (per exemple, $(Build.ArtifactStagingDirectory)$(SolutionName).zip ).

Nota: Les variables us ofereixen una manera còmoda d'obtenir dades clau en diverses parts del pipeline. Vegeu Utilitzar variables predefinides per veure una llista completa.
AsyncOperation
Exportació asíncrona		 Si se selecciona (cert), l'operació d'exportació es durà a terme com una feina per lots asíncrona. Seleccionar asíncrona farà que se sondeigi i esperi fins que s'arribi a MaxAsyncWaitTime.
MaxAsyncWaitTime
Temps d'espera màxim		 Temps d'espera màxim en minuts per a l'operació asíncrona; per defecte és de 60 min (1 h), el mateix que el valor per defecte de l'Azure DevOps per a les tasques.
Managed
Exporta com a administrada		 Si se selecciona (cert), s'exportarà la solució com a solució administrada; altrament s'exportarà com a solució no administrada.
ExportAutoNumberingSettings
Exporta la configuració de numeració automàtica		 Exporta la configuració de numeració automàtica (cert|fals).
ExportCalendarSettings
Exporta la configuració de calendari		 Exporta la configuració de calendari (cert|fals).
ExportCustomizationSettings
Exporta la configuració de personalització		 Exporta la configuració de personalització (cert|fals).
ExportEmailTrackingSettings
Exporta la configuració del seguiment del correu electrònic		 Exporta la configuració de seguiment del correu electrònic (cert|fals).
ExportGeneralSettings
Exporta la configuració general		 Exporta la configuració general (cert|fals).
ExportIsvConfig
Exporta la configuració ISV		 Exporta la configuració ISV (cert|fals).
ExportMarketingSettings
Exporta la configuració de màrqueting		 Exporta la configuració de màrqueting (cert|fals).
ExportOutlookSynchronizationSettings
Exporta la configuració de sincronització de l'Outlook		 Exporta la configuració de sincronització de l'Outlook (cert|fals).
ExportRelationshipRoles
Exporta les funcions de relació		 Exporta les funcions de relació (cert|fals).
ExportSales
Exporta les vendes		 Exporta les vendes (cert|fals).

Desempaquetament de solucions del Power Platform

LPren un fitxer de solució comprimit i el descomprimeix en diversos fitxers XML de manera que aquests fitxers puguin llegir-se administrar-se més fàcilment mitjançant un sistema de control d'origen.

Fragment YAML (Unpack)

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

Paràmetres (Unpack)

Paràmetres Descripció
SolutionInputFile
Fitxer d'entrada de la solució		 (obligatori) Camí i nom de fitxer del fitxer solution.zip que es desempaquetarà.
SolutionTargetFolder
Carpeta de destinació a la qual es desempaquetarà la solució		 (obligatori) Camí i carpeta de destinació on voleu desempaquetar la solució.
SolutionType
Tipus de solució		 (obligatori) Tipus de solució que voleu desempaquetar. Les opcions inclouen: No administrada (recomanat), Administrada i Totes dues.

Empaquetament de solucions del Power Platform

Empaqueta una solució representada al control d'origen d'un fitxer solution.zip que es pot importar a un altre entorn.

Fragment YAML (Pack)

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

Paràmetres (Pack)

Paràmetres Descripció
SolutionOutputFile
Fitxer de sortida de la solució		 (obligatori) El camí i el nom del fitxer solution.zip al qual s'empaquetarà la solució.
SolutionSourceFolder
Carpeta d'origen de la solució que s'empaquetarà		 (obligatori) Carpeta de camí i d'origen de la solució que s'empaquetarà.
SolutionType
Tipus de solució		 (obligatori) Tipus de solució que voleu empaquetar. Les opcions inclouen: Administrada (recomanat), No administrada i Totes dues.

Suprimir la solució del Power Platform

Suprimeix una solució a l’entorn de destinació.

Fragment YAML (Delete)

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'

Paràmetres (Delete)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 L'extrem de servei que voleu suprimir la solució (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei que voleu suprimir la solució (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
SolutionName
Nom de la solució		 (Obligatori) El nom de la solució que s'ha de suprimir. Utilitzeu sempre el Nom de la solució i no el Nom de visualització.

Publicació de personalitzacions del Power Platform

Publica totes les personalitzacions d'un entorn.

Fragment YAML (Publish)

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

Paràmetres (Publish)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 L'extrem de servei que voleu publicar les personalitzacions (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei que voleu publicar les personalitzacions (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform

Definició de la versió de la solució del Power Platform

Actualitza la versió d'una solució.

Fragment YAML (Version)

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

Paràmetres (Version)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 L'extrem de servei que voleu definir la versió de la solució (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei que voleu definir la versió de la solució (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
SolutionName
Nom de la solució		 (Obligatori) Nom de la solució per definir la versió. Utilitzeu sempre el Nom de la solució i no el Nom de visualització.
SolutionVersionNumber
Número de versió de la solució		 (obligatori) Número de versió que voleu definir.

Tot i que el número de versió es pot codificar al pipeline, es recomana utilitzar una variable de pipeline de l'Azure DevOps com ara BuildId. Això proporciona opcions per definir la forma exacta del número de versió a la pestanya "Opcions", per exemple: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Aquesta definició es pot utilitzar a la tasca de versió de la solució definida establint la propietat Número de versió amb: $(Build.BuildId) en lloc de codificar de forma rígida com a 20200824.0.0.2.

O bé una sortida de script de tasca en línia del PowerShell $(Get-Date -Format yyyy.MM.dd.HHmm) definit com a variable buida SolutionVersion com a Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Set Solution Version com a $(SolutionVersion).

Power Platform Defineix les variables de connexió

Defineix les variables BuildTools.* per proporcionar accés a tasques de script personalitzades per utilitzar la connexió de servei com a única font de veritat.

Fragment YAML (SetConnectionVariables)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-connection-variables.PowerPlatformSetConnectionVariables@2
  displayName: 'Power Platform Set Connection Variables '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
  timeoutInMinutes: 2
  retryCountOnTaskFailure: 5

Paràmetres (SetConnectionVariables)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei per al qual voleu definir les variables de connexió. Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
timeoutInMinutes
Temps d'espera		 Especifica el temps màxim, en minuts, que es permet executar una tasca abans de ser cancel·lada pel servidor. Un valor zero indica un temps d'espera infinit.
retryCountOnTaskFailure
Nombre de reintents si la tasca ha fallat		 Especifica el nombre de reintents d'aquesta tasca que es produiran en cas d'error de la tasca. No s'admet per a tasques sense agent.
ApplicationId
Identificador de l'aplicació per iniciar sessió		 (Obligatori per a nom d'usuari/contrasenya) Identificador de l'aplicació per utilitzar per iniciar la sessió (vegeu la nota addicional a continuació).
RedirectUri
URI de redirecció de l'aplicació específica		 (Obligatori per a nom d'usuari/contrasenya) Redirigeix l'URI de l'aplicació especificada. Necessari quan s'especifica un identificador d'aplicació.

Nota

Quan utilitzeu el tipus d'autenticació de nom d'usuari/contrasenya, caldrà l'identificador d'aplicació i l'URI de redirecció. Aquest document d'autenticació d'oauth té una explicació de per què heu de crear un registre d'aplicació per autenticar-vos Dataverse. Quan us connecteu mitjançant l'autenticació de nom d'usuari/contrasenya, la connexió es comporta com una aplicació a la qual es connecta en nom d'un usuari Dataverse.

Implementació de paquets del Power Platform

Implementa un paquet a un entorn. La implementació d'un paquet en contraposició a un sol fitxer de solució us dona l'opció d'implementar diverses solucions, dades i codi en un entorn.

Ofertes fragment YAML (Deploy)

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

Paràmetres (Deploy)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 L'extrem de servei on voleu implementar el paquet (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei on voleu implementar el paquet (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform. Més informació: vegeu BuildTools.EnvironmentUrl a Crear un entorn del Power Platform
PackageFile
Fitxer de paquet		 (Obligatori) Camí i nom de fitxer de l'assemblatge del fitxer de paquet (.dll).
MaxAsyncWaitTime
Temps d'espera màxim		 Temps d'espera màxim en minuts per a l'operació asíncrona; per defecte és de 60 min (1 h), el mateix que el valor per defecte de l'Azure DevOps per a les tasques.

Tasques d'administració d'entorns

Automatitzeu les tasques de gestió de cicle de vida d'entorn habituals (ELM).

Creació d'entorns del Power Platform

Crea un entorn nou. En crear un entorn nou també es crea automàticament BuildTools.EnvironmentUrl.

Important

Quan es defineix, BuildTools.EnvironmentUrl s'utilitzarà com a connexió de servei per defecte per a les tasques posteriors al pipeline. Cada tasca descrita en aquest article només utilitza l'extrem de la connexió de servei quan BuildTools.EnvironmentUrl no es defineix.

Només es pot proveir un entorn nou si la vostra llicència o capacitat permet la creació d'entorns addicionals. Per obtenir més informació sobre la manera de veure la capacitat, vegeu els detalls de la pàgina Capacitat.

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

Paràmetres (Create-env)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 L'extrem de servei que voleu crear l'entorn (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei que voleu crear l'entorn (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
DisplayName
Nom de visualització		 (Obligatori) Nom de visualització de l'entorn creat.
LocationName
Regió d'implementació		 (Obligatori) Regió a la qual s'ha de crear l'entorn.
EnvironmentSku
Tipus d’entorn		 (Obligatori) Tipus d'instància que s'implementarà. Les opcions són Espai aïllat, Producció, Prova i ProvaBasadaEnSubscripció.
AppsTemplate
Aplicacions		 Per a un tipus d'entorn que no és de prova, les aplicacions admeses són D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation i D365_Sales.
CurrencyName
Moneda		 (Obligatori) Moneda base per a l'entorn creat. La moneda no es pot actualitzar un cop creat l'entorn.
LanguageName
Language		 (Obligatori) Llengua de base de l'entorn.
DomainName
Nom de domini		 (Obligatori) Aquesta és la cadena específica de l'entorn que forma part de l'adreça URL. Per exemple, per a un entorn que tingui l'adreça URL següent: https://powerappsbuildtasks.crm.dynamics.com/, el nom del domini seria "powerappsbuildtasks".

Nota: Si introduïu un nom de domini que ja s'està utilitzant, la tasca afegeix un valor numèric al nom de domini, començant per 0. Per a l'exemple anterior, l'adreça URL es podria convertir enhttps://powerappsbuildtasks0.crm.dynamics.com/.

Supressió d'entorns del Power Platform

Suprimeix un entorn.

Fragment YAML (Delete-env)

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

Paràmetres (Delete-env)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 L'extrem de servei que voleu suprimir l'entorn (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei que voleu suprimir l'entorn (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.

Power Platform Assigna usuari

Assigneu un usuari a un entorn de destinació amb una funció de seguretat especificada.

Fragment YAML (AssignUser-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.assign-user.PowerPlatformAssignUser@2
  displayName: 'Power Platform Assign User '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    User: EnvironmentUsername
    Role: 'Environment Maker'
    ApplicationUser: true

Paràmetres (AssignUser-env)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei de l'entorn al qual voleu assignar l'usuari (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
User
Power Platform Nom d'usuari		 Microsoft Entra ID d'objecte o nom principal de l'usuari per assignar a l'entorn de destinació.
Role
Nom o identificador de la funció de seguretat		 Nom o identificador de la funció de seguretat que s'assignarà a l'usuari.
ApplicationUser
Power Platform Nom d'usuari de l'aplicació		 Especifica si l'usuari d'entrada és un usuari de l'aplicació (true|false).

Power Platform Restableix l'entorn

Restableix un entorn.

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

Paràmetres (Reset-env)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 L'extrem de servei que voleu restablir l'entorn (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei que voleu restablir l'entorn (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.

Còpia de seguretat d'entorns del Power Platform

Fa una còpia de seguretat d'un entorn.

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

Paràmetres (Backup-env)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 L'extrem de servei del qual voleu fer una còpia de seguretat de l'entorn (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei del qual voleu fer una còpia de seguretat de l'entorn (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
BackupLabel
Etiqueta de còpia de seguretat		 (Obligatori) L'etiqueta que s'assignarà a la còpia de seguretat.

Còpia d'entorns del Power Platform

Copia un entorn en un entorn de destinació. Hi ha dos tipus de còpies disponibles: completes i mínimes. Una còpia completa inclou dades i metadades de la solució (personalitzacions), mentre que una còpia mínima només inclou metadades de la solució i no les dades reals.

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

Paràmetres (Copy-env)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 L'extrem de servei de l'entorn d'origen des del qual voleu copiar (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei de l'entorn d'origen des del qual voleu copiar (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
TargetEnvironmentUrl
Adreça URL de l’entorn de destinació		 (Obligatori) L'adreça URL de l'entorn de destinació que voleu copiar.
CopyType
Tipus de còpia		 Tipus de còpia que es farà: FullCopy o MinimalCopy
OverrideFriendlyName
Nom descriptiu de substituir		 Canvia el nom descriptiu de l'entorn de destinació per un altre nom (cert|fals).
FriendlyName
Nom descriptiu		 El nom descriptiu de l'entorn de destinació.
DisableAdminMode
Desactivar el mode d'administració		 Si voleu inhabilitar el mode d'administració (cert|fals).

Power Platform Restaura l'entorn

Restaura un entorn en una còpia de seguretat determinada.

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

Paràmetres (Restore-env)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformEnvironment
Adreça URL de l'entorn del Power Platform		 L'extrem de servei de l'entorn d'origen des del qual voleu restaurar (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei de l'entorn d'origen des del qual voleu restaurar (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
RestoreLatestBackup
Última còpia de seguretat per restaurar		 Si voleu restaurar la darrera còpia de seguretat o proporcionar RestoreTimeStamp (true|false).
RestoreTimeStamp
DateTime de la còpia de seguretat		 Data i hora de la còpia de seguretat en format "mm/dd/aaaa hh:mm" O BÉ la cadena "més recent".
TargetEnvironmentUrl
Adreça URL de l’entorn de destinació		 (Obligatori) L'adreça URL de l'entorn de destinació que voleu restaurar.
FriendlyName
Nom de l'entorn restaurat		 (Opcional) Nom de l'entorn restaurat.
DisableAdminMode
Desactivar el mode d'administració		 Si voleu inhabilitar el mode d'administració (cert|fals).

Exporta Dataverse dades

Exporteu dades des d'un entorn amb l'esquema proporcionat.

Fragment YAML (exportdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-data.PowerPlatformExportData@2
  displayName: 'Power Platform Export Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    SchemaFile: 'C:\tempschema.xml'
    DataFile: exportdata.zip
    Overwrite: true

Paràmetres (exportdata-env)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei de l'entorn des del qual voleu exportar dades (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
SchemaFile
Nom del fitxer XML de l'esquema		 Nom del fitxer XML de l'esquema. Es pot crear mitjançant l'eina de migració de configuració.
DataFile
Nom del fitxer de dades		 Nom del fitxer per a les dades a exportar (fitxer zip).
Overwrite
Sobreescriptura de contingut		 Power Pages Contingut del lloc web per sobreescriure (true|false).

Importa Dataverse dades

Importar dades a un entorn.

Fragment YAML (importdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-data.PowerPlatformImportData@2
  displayName: 'Power Platform Import Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DataFile: 'C:\Data\Import.zip'

Paràmetres (importdata-env)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei de l'entorn en què voleu importar dades (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
DataFile
Nom del fitxer de dades		 Nom del fitxer per al fitxer de dades zip comprimit) a importar, o la carpeta amb data-schema.xml i data.xml que s'ha d'importar.

Power Pages Tasques de gestió

Tasques per treballar amb un Power Pages lloc web.

Power Platform Baixar PAPortal

Baixa el contingut del lloc web del Power Pages de l'entorn del Dataverse actual.

Fragment YAML (descarregar-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

Paràmetres (download-paportal)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei de l'entorn des del qual voleu baixar contingut (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
WebsiteId
ID del lloc web del portal		 Power Pages ID del lloc web per descarregar.
Overwrite
Sobreescriptura de contingut		 Power Pages Contingut del lloc web per sobreescriure (true|false).
ModelVersion
Model de dades del lloc		 Indica si les dades del lloc que s'han de penjar utilitzaran l'estàndard (1) o el model de dades millorat(2). El valor per defecte és "1".

Power Platform Carregar PAPortal

Pengeu Power Pages el contingut del lloc web a l'entorn actual Dataverse .

Fragment YAML (upload-paportal)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.upload-paportal.PowerPlatformUploadPaportal@2
  displayName: 'Power Platform Upload PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    UploadPath: 'C:\portals\starter-portal'

Paràmetres (upload-paportal)

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei de l'entorn on voleu penjar contingut (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
UploadPath
Pujar el camí de contingut		 Camí des d'on es penjarà el contingut del Power Pages lloc web.
ModelVersion
Model de dades del lloc		 Indica si les dades del lloc que s'han de penjar utilitzaran l'estàndard (1) o el model de dades millorat(2). El valor per defecte és "1".

Catàleg de Power Platform tasques (versió preliminar)

Aquestes tasques realitzen accions contra el catàleg i Power Platform inclouen el següent.

Nota

Actualment, les tasques de catàleg per Power Platform a són una versió preliminar .

Instal·la l'element del catàleg

Instal·leu un element del catàleg a l'entorn de destinació.

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei de l'entorn on voleu penjar contingut (per exemple, https://powerappsbuildtools.crm.dynamics.com). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
Environment
Adreça URL de l’entorn de destinació		 (Obligatori) URL de l'entorn a la qual s'adreça aquesta tasca.
CatalogItemId
Identificador de l'element del catàleg que s'ha d'instal·lar		 (Obligatori) Element del catàleg que s'ha d'instal·lar a l'entorn de destinació.
TargetEnvironmentUrl
Adreça URL de l’entorn de destinació		 (Obligatori) L'adreça URL de l'entorn de destinació per a la instal·lació d'elements de catàleg (per exemple, "https://YourOrg.crm.dynamics.com").
PollStatus
Comprovar l'estat de l'enquesta		 (Opcional) Enquesta per comprovar l'estat de la vostra sol·licitud (cert|fals).

Paràmetres (catàleg-instal·lar)

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

Envia l'aprovació del catàleg

Envia sol·licitud d'aprovació del catàleg.

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei de l'entorn on voleu penjar contingut (per exemple, "https://powerappsbuildtools.crm.dynamics.com"). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
Environment
Adreça URL de l’entorn de destinació		 (Obligatori) URL de l'entorn a la qual s'adreça aquesta tasca.
CatalogSubmissionFile
Fitxer d'enviament de catàlegs		 (Obligatori) Especifiqueu el camí i el nom del fitxer d'enviament del catàleg.
UsePackageSolutionZipFile
Tipus de fitxer		 Tipus de fitxer: fitxer zip de paquet o solució.
SolutionZipFile
Nom del fitxer zip de la solució		 Especifiqueu el camí i el nom del fitxer zip de la solució.
PollStatus
Comprovar l'estat de l'enquesta		 (Opcional) Enquesta per comprovar l'estat de la vostra sol·licitud (cert|fals).

Paràmetres (catàleg-enviament)

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

Estat de la sol·licitud de catàleg

Obteniu l'estat de la sol·licitud d'instal·lació/enviament del catàleg.

Paràmetres Descripció
authenticationType
Tipus d’autenticació		 (Obligatori per a SPN) Especifiqueu PowerPlatformEnvironment per a una connexió d'usuari/contrasenya o PowerPlatformSPN per a una connexió d'entitat principal/secret del client.
PowerPlatformSPN
Entitat principal del Power Platform		 L'extrem de servei de l'entorn on voleu penjar contingut (per exemple, "https://powerappsbuildtools.crm.dynamics.com"). Definit a Connexions de servei a Configuració del projecte utilitzant el tipus de connexió del Power Platform.
Environment
Adreça URL de l’entorn de destinació		 (Obligatori) URL de l'entorn a la qual s'adreça aquesta tasca.
TrackingId
Sol·licitar l'identificador de seguiment		 (Obligatori) Sol·liciteu l'identificador de seguiment.
RequestType
Tipus de sol·licitud		 (Obligatori) Tipus Reqeust. (Valors: Instal·la | Envia).

Paràmetres (catàleg-status)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.catalog-status.PowerPlatforCatalogStatus@2
  displayName: 'Power Platform Catalog Status '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    TrackingId: '00000000-0000-0000-0000-000000000002'
    RequestType: Submit

Pipelines de compilació i publicació

Ara que hem identificat què es pot fer mitjançant les eines de compilació, vegem com podríeu aplicar aquestes eines als pipelines de compilació i publicació. A continuació es mostra un resum conceptual. Vegem alguns detalls de la implementació del pipeline mitjançant les tasques de les eines de compilació a les subseccions següents.

Per obtenir més informació sobre la creació de pipelines i crear un pipeline de pràctica amb el Microsoft Power Platform Build Tools, completeu els Laboratoris del Build Tools, que podeu baixar des del GitHub.

Més informació sobre Azure Pipelines: Ús d'Azure Pipelines

Pipeline de compilació: exportar una solució des d'un entorn de desenvolupament

A la imatge següent es mostren les tasques de les eines de compilació que podríeu afegir a un pipeline que exporta una solució d'un entorn de desenvolupament.

Exportar una solució des d'un entorn de desenvolupament (DEV).

Pipeline de compilació: compilar una solució administrada

A la imatge següent es mostren les tasques de les eines de compilació que podríeu afegir a un pipeline que compila una solució administrada.

Crear una solució administrada.

Pipeline de publicació: Implementar a un entorn de producció

A la imatge següent es mostren les tasques de les eines de compilació que podríeu afegir a un pipeline que implementa a un entorn de producció.

Implementació en un entorn de producció (PROD).

Vegeu també

Microsoft Power Platform Eines de construcció per a Azure DevOps