Compartir por

Tarefas de Microsoft Power Platform Build Tools

  • Artigo

As tarefas de compilación dispoñibles descríbense nas seguintes seccións. Despois, mostramos algúns exemplos de Azure Pipelines facendo uso destas tarefas. Para obter información sobre as ferramentas de compilación e como descargalas, consulte Microsoft Power Platform Ferramentas de compilación para Azure Pipelines.

Tarefa de axuda

A continuación descríbense as tarefas de axuda dispoñibles.

Instalador Power Platform Tool

Esta tarefa é necesario engadila unha vez antes de que outras tarefas de Power Platform Build Tools en canles de creación e publicación. Esta tarefa instala un conxunto de ferramentas específicas de Power Platform requiridas polo axente para executar as tarefas de compilación de Microsoft Power Platform. Esta tarefa non require máis configuración cando se engade. Esta tarefa contén parámetros para as versións específicas de cada unha das ferramentas que se están instalando.

Para estar ao día coas versións da ferramenta ao longo do tempo, asegúrese de que estes parámetros se correspondan coas versións das ferramentas necesarias para que a canle funcione correctamente.

Fragmento YAML (instalador)

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

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

Parámetros (instalador)

Parámetros Descripción
DefaultVersion
Usar as versións predeterminadas da ferramenta		 Establecer en verdadeiro para utilizar a versión predeterminada de todas as ferramentas, do contrario, falso. Obrigatorio (e falso) cando se especifica algunha versión da ferramenta.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Versión da ferramenta		 A versión específica da ferramenta a utilizar.

Power Platform WhoAmI

Verifica unha conexión de servizo de ambiente de Power Platform conectando e realizando unha solicitude WhoAmI. Esta tarefa pode ser útil para incluír no inicio da canle para verificar a conectividade antes de que comece o procesamento.

Fragmento YAML (WhoAmI)

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

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

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

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

Parámetros (WhoAmI)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Opcional) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O extremo do servizo para o contorno ao que desexa conectarse. Defínese en Conexións de servizo en Configuración do proxecto. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
PowerPlatformSPN
Director do servizo Power Platform		 O extremo do servizo para o contorno ao que desexa conectarse. Defínese en Conexións de servizo en Configuración do proxecto.

Comprobación de calidade

Na seguinte sección están as tarefas dispoñibles para comprobar a calidade dunha solución.

Power Platform Checker

Esta tarefa realiza unha comprobación de análise estática das túas solucións contra un conxunto de regras de boas prácticas para identificar os patróns problemáticos que puideses introducir inadvertidamente ao crear a túa solución.

Fragmento YAML (comprobador)

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    UseDefaultPACheckerEndpoint: false
    CustomPACheckerEndpoint: 'https://japan.api.advisor.powerapps.com/'
    FileLocation: sasUriFile
    FilesToAnalyzeSasUri: 'SAS URI'
    FilesToAnalyze: '**\*.zip'
    FilesToExclude: '**\*.tzip'
    RulesToOverride: 'JSON array'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

Parámetros (Comprobador)

Parámetros Descripción
PowerPlatformSPN
Conexión do servizo		 (Necesario) Requírese unha conexión a un contorno de Microsoft Power Platform con licenza para empregar o comprobador de Power Platform. As conexións de servizo están definidas en Conexións de servizo en Configuración do proxecto usando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear ambiente

Nota: os métodos de autenticación de nome de usuario/contrasinal e principal do servizo están dispoñibles para a tarefa de verificación. Para obter máis información sobre como configurar as entidades de servizo para ser empregadas con esta tarefa, consulte Configurar as conexións da entidade de servizo para ambientes de Power Platform.
UseDefaultPACheckerEndpoint
Usar punto final de verificador Power Platform por defecto		 De forma predeterminada (true), a localización xeográfica do servizo de verificación usa a mesma xeografía que o ambiente ao que te conectas.
CustomPACheckerEndpoint
Punto final do comprobador de PAC personalizado		 Obrigatorio cando UseDefaultPACheckerEndpoint é falso. Podes especificar outra xeografía para usar, por exemplo https://japan.api.advisor.powerapps.com. Para obter unha lista das zonas xeográficas dispoñibles, consulta Utilizar a Power Platform API Checker.
FileLocation
Localización dos ficheiros a analizar		 Necesario cando se fai referencia a un ficheiro desde un URL de sinatura de acceso compartido (SAS) sasUriFile.

Nota: é importante facer referencia a un ficheiro de solución exportado e non aos ficheiros fonte descomprimidos do repositorio. Pódense analizar tanto os ficheiros de solucións xestionados como os non administrados.
FilesToAnalyzeSasUri
Ficheiros SAS para analizar		 Obrigatorio cando FileLocation está configurado en sasUriFile. Inserir o URI de SAS. Pode engadir máis dun SAS URI a través dunha lista separada por comas (,) ou punto e comas (;).
FilesToAnalyze
Ficheiros locais para analizar		 Necesario cando os ficheiros SAS non se analizan. Especifique a ruta e o nome do ficheiro de arquivos zip para analizar. Pódense empregar comodíns. Por exemplo, introduza **\*.zip para todos os ficheiros zip de todos os subcartafoles.
FilesToExclude
Ficheiros locais para excluír		 Especifique os nomes dos ficheiros que se queren excluír da análise. Se hai máis de un, proporcione unha lista separada por comas (,) ou puntos e comas (;). Esta lista pode incluír un nome de ficheiro completo ou un nome con comodíns ao principio ou ao final, como *jquery ou form.js
RulesToOverride
Regras para anular		 Unha matriz JSON que contén regras e niveis para anular. Os valores aceptados para OverrideLevel son: Critical, High, Medium, Low, Informational. Exemplo: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Conxunto de regras		 (Obrigatorio) Especifique que conxunto de regras se aplica. Están dispoñibles os dous conxuntos de regras seguintes:
  • Comprobador de solucións: este conxunto de regras é o mesmo que se executa desde o Power Apps portal do fabricante.
  • AppSource: o conxunto de regras estendido que se utiliza para certificar unha aplicación antes de que poida publicarse en AppSource.
ErrorLevel
Nivel de erro		 Combinado co erro, o parámetro threshold define a gravidade dos erros e avisos que se permiten. Os valores límite admitidos son <level>IssueCount onde nivel=Critical, High, Medium, Low e Informational.
ErrorThreshold
Limiar de erro		 Define o número de erros (>=0) dun nivel especificado que se permiten para que o verificador pase as solucións que se están a comprobar.
FailOnPowerAppsCheckerAnalysisError
Erro ao ocorrer un erro		 Cando sexa verdadeiro, suspende se a análise do verificador de Power Apps devólvese como Failed ou FinishedWithErrors.
ArtifactDestinationName
Nome do artefacto DevOps		 Especifique o nome de Azure Artifacts para o ficheiro .sarif de verificador.

Tarefas da solución

Este conxunto de tarefas pode automatizar as accións da solución. As tarefas do contorno descritas máis adiante nesta sección que crean, copian ou restauran un ambiente sobrescriben as conexións de servizo cos contornos recentemente creados. Estas tarefas permiten realizar tarefas de solución contra contornas que se crean baixo demanda.

Solución de importación de Power Platform

Importa unha solución a un contorno obxectivo.

Fragmento YAML (importación)

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

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

Parámetros (importación)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O punto final do servizo ao que quere importar a solución (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo ao que quere importar a solución (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
SolutionInputFile
Ficheiro de entrada da solución		 (Obrigatorio) A ruta e o nome do ficheiro do ficheiro .zip da solución para importar ao contorno de destino (por exemplo, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Nota: As variables dan un xeito cómodo de obter anacos clave de datos en varias partes da súa canle. Consulte Usar variables predefinidas para ver unha lista completa.
HoldingSolution
Importar como unha solución de retención		 Un parámetro avanzado (verdadeiro|falso) empregado cando hai que actualizar unha solución. Este parámetro aloxa a solución en Dataverse, pero non actualiza a solución ata que se execute a tarefa Aplicar actualización de solución.
OverwriteUnmanagedCustomizations
Sobrescribir personalizacións non administradas		 Especifique se se sobrescriben as personalizacións non xestionadas (verdadeiro|falso).
SkipProductUpdateDependencies
Omitir dependencias de actualización do produto		 Especifique se se debe omitir a aplicación das dependencias relacionadas coas actualizacións de produtos (verdadeiro|falso).
ConvertToManaged
Converter en xestionado		 Especifique se desexa importar como solución administrada (verdadeiro|falso).
AsyncOperation
Importación asíncrona		 Se se selecciona (verdadeiro), a operación de importación realizarase de forma asíncrona. Isto é recomendable para solucións máis grandes, xa que esta tarefa alcanzará o tempo de espera automaticamente despois de 4 minutos en caso contrario. Se selecciona asíncrono, realizarase unha enquisa e agardarase ata que se alcance (verdadeiro|falso).
MaxAsyncWaitTime
Tempo máximo de espera		 Tempo de espera máximo en minutos para a operación asíncrona; o valor predeterminado é 60 min (1 h), igual que Azure DevOps por defecto para tarefas.
PublishWorkflows
Activar os procesos despois da importación		 Especifique se se debe activar algún proceso (fluxos de traballo) na solución despois da importación (verdadeiro|falso).
UseDeploymentSettingsFile
Usar ficheiro de configuración do despregamento		 As referencias de conexión e valores de variable de ambiente poden establecerse empregando un ficheiro de configuración de implementación (verdadeiro|falso).
DeploymentSettingsFile
Ficheiro de configuración do despregamento		 (Obrigatorio cando UseDeploymentSettingsFile=verdadeiro) A ruta e o nome do ficheiro de configuración de implementación.

Power Platform Engadir compoñente da solución

Engade un compoñente de solución a unha solución non xestionada.

YAML fragmento (Engadir)

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ámetros (Engadir)

Parámetros Descripción
ComponentId
ID do compoñente da solución		 O nome do esquema ou ID do compoñente que se vai engadir á solución de destino.
ComponentType
URL do ambiente de Power Platform		 O valor que representa o compoñente da solución que está a engadir. Consulte Utilizar tipos de compoñentes predefinidos para obter unha lista completa de valores de compoñentes.
SolutionUniqueName
Nome da solución		 Nome único da solución.
AddRequiredComponents
Calquera compoñente necesario doutra solución depende do compoñente da solución		 (Opcional) Indica se outros compoñentes da solución que son requiridos polo compoñente da solución que está a engadir tamén se deben engadir á solución non xestionada.
Environment
URL ou ID do entorno		 (Opcional) URL do contorno ou ID do contorno de destino.

Power Platform: Aplicar actualización da solución

Actualiza unha solución que se importou como solución de reserva.

Fragmento YAML (actualizar)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    AsyncOperation: false

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

Parámetros (Actualización)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O punto final do servizo no que desexa actualizar a solución (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo no que desexa actualizar a solución (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
SolutionName
Nome da solución		 (Obrigatorio) O nome da solución para aplicar a actualización. Use sempre o Nome da solución, non o seu Nome de visualización.
AsyncOperation
Actualización asíncrona		 Se se selecciona (verdadeiro), a operación de actualización realizarase como un traballo por lotes asíncrono. Se selecciona asíncrono, realizarase unha enquisa e agardarase ata que se alcance MaxAsyncWaitTime.
MaxAsyncWaitTime
Tempo máximo de espera		 Tempo de espera máximo en minutos para a operación asíncrona; o valor predeterminado é 60 min (1 h), igual que Azure DevOps por defecto para tarefas.

Nota

As variables dan un xeito cómodo de obter anacos clave de datos en varias partes da súa canle. Consulte Usar variables predefinidas para ver unha lista completa. Pode encher previamente a información de referencia de conexión e de variables de ambiente para o ambiente de destino mentres importa unha solución mediante un ficheiro de configuración de implementación.

Máis información: Encha previamente as referencias de conexión e as variables de ambiente para implantacións automatizadas

Solución de exportación de Power Platform

Exporta unha solución desde un contorno de orixe.

Fragmento YAML (exportación)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  displayName: 'Power Platform Export Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  displayName: 'Power Platform Export Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120
    ExportAutoNumberingSettings: true
    ExportCalendarSettings: true
    ExportCustomizationSettings: true
    ExportEmailTrackingSettings: true
    ExportGeneralSettings: true
    ExportIsvConfig: true
    ExportMarketingSettings: true
    ExportOutlookSynchronizationSettings: true
    ExportRelationshipRoles: true
    ExportSales: true

Parámetros (exportación)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O punto final do servizo no que desexa actualizar a solución (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo no que desexa actualizar a solución (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
SolutionName
Nome da solución		 (Obrigatorio) O nome da solución para exportar. Use sempre o Nome da solución, non o seu Nome de visualización.
SolutionOutputFile
Ficheiro de saída da solución		 (Obrigatorio) A ruta e o nome do ficheiro do ficheiro solution.zip ao que exportar o ambiente de orixe (por exemplo, $(Build.ArtifactStagingDirectory)$(SolutionName).zip ).

Nota: As variables dan un xeito cómodo de obter anacos clave de datos en varias partes da súa canle. Consulte Usar variables predefinidas para ver unha lista completa.
AsyncOperation
Exportación asíncrona		 Se se selecciona (verdadeiro), a operación de exportación realizarase como un traballo por lotes asíncrono. Se selecciona asíncrono, realizarase unha enquisa e agardarase ata que se alcance MaxAsyncWaitTime.
MaxAsyncWaitTime
Tempo máximo de espera		 Tempo de espera máximo en minutos para a operación asíncrona; o valor predeterminado é 60 min (1 h), igual que Azure DevOps por defecto para tarefas.
Managed
Exportar como xestionado		 Si se selecciona (verdadeiro), exporte a solución como solución administrada; en caso contrario, exportar como solución non xestionada.
ExportAutoNumberingSettings
Exportar a configuración de numeración automática		 Exportar a configuración de numeración automática (verdadeiro|falso).
ExportCalendarSettings
Exportar configuración de calendario		 Exportar configuración de calendario (verdadeiro|falso).
ExportCustomizationSettings
Exportar configuración de personalización		 Exportar configuración de personalización (verdadeiro|falso).
ExportEmailTrackingSettings
Exportar configuración de rastrexo de correo electrónico		 Exportar a configuración de seguimento de correo electrónico (verdadeiro|falso).
ExportGeneralSettings
Exportar configuración xeral		 Exportar configuración xeral (verdadeiro|falso).
ExportIsvConfig
Exportar configuración ISV		 Exportar configuración ISV (verdadeiro|falso).
ExportMarketingSettings
Exportar configuración de márketing		 Exportar configuración de márketing (verdadeiro|falso).
ExportOutlookSynchronizationSettings
Exportar a configuración da sincronización de Outlook		 Exportar a configuración da sincronización de Outlook (verdadeiro|falso).
ExportRelationshipRoles
Exportar roles de relación		 Exportar roles de relación (verdadeiro|falso).
ExportSales
Vendas de exportacións		 Vendas de exportación (verdadeiro|falso).

Solución de desempaquetar de Power Platform

Colle un ficheiro de solucións comprimido e descompono en varios ficheiros XML e outros ficheiros para que estes ficheiros poidan ser xestionados e lidos máis facilmente por un sistema de control de fonte.

Fragmento YAML (descomprimir)

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

Parámetros (descomprimir)

Parámetros Descripción
SolutionInputFile
Ficheiro de entrada da solución		 (Obrigatorio) Ruta e nome de ficheiro do ficheiro solución.zip para desempaquetar.
SolutionTargetFolder
Cartafol de destino para desempaquetar a solución		 (Obrigatorio) O camiño e o cartafol de destino no que desexa desempaquetar a solución.
SolutionType
Tipo de solución		 (Obrigatorio) Escolla o tipo de solución que desexa desempaquetar. Opcións: Non administrado (recomendado), Xestionado e Ámbolos dous.

Solución de empaquetar de Power Platform

Empaqueta unha solución representada no control de fonte nun ficheiro solución.zip que se pode importar noutro ambiente.

Fragmento YAML (comprimir)

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

Parámetros (comprimir)

Parámetros Descripción
SolutionOutputFile
Ficheiro de saída da solución		 (Obrigatorio) A ruta e o nome de ficheiro do ficheiro solución.zip no que empaquetar a solución.
SolutionSourceFolder
Cartafol fonte da solución para empaquetar		 (Obrigatorio) A ruta e o cartafol fonte da solución para empaquetar.
SolutionType
Tipo de solución		 (Obrigatorio) Escolla o tipo de solución que desexa empaquetar. Opcións: Administrado (recomendado), Non xestionado e Ámbolos dous.

Power Platform: Eliminar solución

Elimina unha solución no ambiente de destino.

Fragmento YAML (eliminar)

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

Parámetros (eliminación)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O punto final do servizo que quere eliminar a solución (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo que quere eliminar a solución (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
SolutionName
Nome da solución		 (Obrigatorio) O nome da solución que se vai eliminar. Use sempre o Nome da solución, non o seu Nome de visualización.

Personalizacións de publicacións de Power Platform

Publica todas as personalizacións nun contorno.

Fragmento YAML (publicar)

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

Parámetros (publicar)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O punto final do servizo no que quere publicar as personalizacións (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo no que quere publicar as personalizacións (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno

Versión de solución de establecemento de Power Platform

Actualiza a versión dunha solución.

Fragmento YAML (versión)

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

Parámetros (versión)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O punto final do servizo que quere establecer a versión da solución (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo que quere establecer a versión da solución (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
SolutionName
Nome da solución		 (Obrigatorio) O nome da solución para a que axustar a versión. Use sempre o Nome da solución, non o seu Nome de visualización.
SolutionVersionNumber
Número de versión da solución		 (Obrigatorio) Número de versión que desexa definir.

Aínda que o número de versión pode estar codificado na canle, recoméndase usar unha variable da canle de Azure DevOps como BuildId. Isto ofrece opcións para definir a forma exacta do número de versión na pestana "Opcións", por exemplo: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Esta definición pode usarse na tarefa Establecer versión de solución configurando a propiedade Número de versión con: $(Build.BuildId) no canto do código 20200824.0.0.2.

Ademais, un script de tarefas en liña de PowerShell $(Get-Date -Format yyyy.MM.dd.HHmm) de saída definido como variable baleira chamada SolutionVersion como Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), establecer versión da solución como $(SolutionVersion).

Power Platform Establecer variables de conexión

Establece as variables BuildTools.* para proporcionar acceso a tarefas de script personalizadas para usar a conexión de servizo como fonte única de verdade.

YAML fragmento (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ámetros (SetConnectionVariables)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo para o que queres establecer as variables de conexión. Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
timeoutInMinutes
Tempo de espera		 Especifica o tempo máximo, en minutos, que se permite executar unha tarefa antes de ser cancelada polo servidor. Un valor cero indica un tempo de espera infinito.
retryCountOnTaskFailure
Número de reintentos se a tarefa fallou		 Especifica o número de reintentos para esta tarefa que se producirán en caso de falla da tarefa. Non é compatible con tarefas sen axentes.
ApplicationId
ID da aplicación para iniciar sesión		 (Requirido para o nome de usuario/contrasinal) Id. de aplicación para usar para iniciar sesión (Consulte a nota adicional a continuación).
RedirectUri
URI de redirección da aplicación especificada		 (Requirido para o nome de usuario/contrasinal) URI de redirección da aplicación especificada. Necesario ao especificar un ID de aplicación. (Ver nota adicional a continuación).

Nota

Cando se utiliza o tipo de autenticación de nome de usuario/contrasinal, será necesario o ID da aplicación e o URI de redirección. Este documento autenticación oauth explica por que cómpre crear un rexistro de aplicación para autenticarse Dataverse. Cando se conecta mediante a autenticación de nome de usuario/contrasinal, a conexión compórtase como unha aplicación á que se está conectando en nome dun usuario Dataverse.

Paquete de implementación de Power Platform

Implementa un paquete nun ambiente. Despregar un paquete fronte a un único ficheiro de solución dálle unha opción de implementar varias solucións, datos e código nun ambiente.

Fragmento YAML (implementar)

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

Parámetros (implementar)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O punto final do servizo no que quere implementar o paquete (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo no que quere implementar o paquete (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform. Máis información: consulte BuildTools.EnvironmentUrl en Power Platform Crear contorno
PackageFile
Ficheiro de paquete		 (Obrigatorio) O camiño e o nome do ficheiro do conxunto de ficheiros do paquete (.dll).
MaxAsyncWaitTime
Tempo máximo de espera		 Tempo de espera máximo en minutos para a operación asíncrona; o valor predeterminado é 60 min (1 h), igual que Azure DevOps por defecto para tarefas.

Tarefas de xestión de ambientes

Automatice tarefas comúns de xestión do ciclo de vida do ambiente (ELM).

Ambiente de creación de Power Platform

Crea un novo ambiente. Ao crear un novo ambiente tamén se crea automaticamente BuildTools.EnvironmentUrl.

Importante

Cando se configure, BuildTools.EnvironmentUrl empregarase como conexión de servizo predeterminada para tarefas posteriores na canle. Cada tarefa descrita neste artigo só usa o extremo da conexión do servizo cando BuildTools.EnvironmentUrl non está configurado.

Un novo contorno só se pode proporcionar se a súa licenza ou capacidade permite a creación de contornos adicionais. Para obter máis información sobre como ver a capacidade, consulte Detalles da páxina de capacidade.

Fragmento YAML (Create-env)

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

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

Parámetros (Create-env)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O punto final do servizo que quere crear o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo que quere crear o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
DisplayName
Nome para mostrar		 (Necesario) O nome para mostrar do ambiente creado.
LocationName
Rexión de despregamento		 (Necesario) A rexión na que se debe crear o ambiente.
EnvironmentSku
Tipo de ambiente		 (Necesario) O tipo de instancia para aplicar. As opcións son Illamento de procesos, Produción, Proba e SubscriptionBasedTrial.
AppsTemplate
Aplicacións		 Para un tipo de ambiente que non sexa de proba, as aplicacións compatibles son D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation e D365_Sales.
CurrencyName
Moeda		 (Necesario) Moeda base para o ambiente creado. A moeda non se pode actualizar despois de crear o ambiente.
LanguageName
Idioma		 (Necesario) O idioma base do ambiente.
DomainName
Nome do dominio		 (Necesario) Esta é a cadea específica do ambiente que forma parte do URL. Por exemplo, para un ambiente co seguinte URL:https://powerappsbuildtasks.crm.dynamics.com/, o nome de dominio sería "powerappsbuildtasks".

Nota: Se introduce un nome de dominio que xa está en uso, a tarefa engade un valor numérico ao nome de dominio, comezando por 0. No exemplo anterior, o URL pode converterse enhttps://powerappsbuildtasks0.crm.dynamics.com/.

Ambiente de eliminación de Power Platform

Elimina un ambiente.

Fragmento YAML (Delete-env)

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

Parámetros (Delete-env)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O punto final do servizo que quere eliminar o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo que quere eliminar o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.

Power Platform Asignar usuario

Asigne un usuario a un entorno de destino co rol de seguranza especificado.

YAML fragmento (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ámetros (AssignUser-env)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final de servizo para o contorno ao que desexa asignar o usuario (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
User
Power Platform nome de usuario		 Microsoft Entra ID de obxecto ou nome principal do usuario para asignar ao contorno de destino.
Role
Rol de seguranza nome ou ID		 Rol de seguranza nome ou ID que se asignará ao usuario.
ApplicationUser
Power Platform nome de usuario da aplicación		 Especifica se o usuario de entrada é un usuario da aplicación (true|false).

Power Platform Restablecer o entorno

Restablece un ambiente.

YAML fragmento (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ámetros (Reset-env)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O punto final do servizo que quere restablecer o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo que quere restablecer o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.

Facer copia de seguranza do ambiente de Power Platform

Fai unha copia de seguranza dun ambiente.

Fragmento YAML (Backup-env)

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

Parámetros (Backup-env)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O punto final do servizo do que quere facer unha copia de seguranza do ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo do que quere facer unha copia de seguranza do ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
BackupLabel
Etiqueta da copia de seguranza		 (Obrigatorio) A etiqueta que se asignará á copia de seguridade.

Ambiente de copia de Power Platform

Copia un ambiente a un ambiente de destino. Hai dous tipos de copias dispoñibles: completa e mínima. A copia Completa inclúe tanto datos como metadatos da solución (personalizacións), mentres que a copia mínima inclúe só metadatos da solución e non datos reais.

Fragmento YAML (Copy-env)

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

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

Parámetros (Copy-env)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O punto final do servizo para o contorno de orixe do que quere copiar (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo para o contorno de orixe do que quere copiar (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
TargetEnvironmentUrl
URL de ambiente de destino		 (Obrigatorio) O URL do contorno de destino no que desexa copiar.
CopyType
Tipo de copia		 Tipo de copia a realizar: FullCopy ou MinimalCopy
OverrideFriendlyName
Anular nome descritivo		 Cambie o nome descritivo do ambiente de destino por outro nome (verdadeiro|falso).
FriendlyName
Nome descritivo		 Nome descritivo do ambiente de destino.
DisableAdminMode
Desactivar o modo de administración		 Indica se se desactiva o modo de administración (verdadeiro|falso).

Power Platform Restaurar o entorno

Restaura un ambiente a unha determinada copia de seguranza.

YAML fragmento (Restaurar-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ámetros (Restore-env)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformEnvironment
URL do ambiente de Power Platform		 O punto final do servizo para o contorno de orixe desde o que quere restaurar (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo para o contorno de orixe desde o que quere restaurar (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
RestoreLatestBackup
Copia de seguranza máis recente para restaurar		 Indica se restaurar a copia de seguranza máis recente ou proporcionar RestoreTimeStamp (true|false).
RestoreTimeStamp
DataHora da copia de seguridade		 DataHora da copia de seguranza en formato "mm/dd/aaaa hh:mm" OU cadea "máis recente".
TargetEnvironmentUrl
URL de ambiente de destino		 (Obrigatorio) O URL do contorno de destino que quere restaurar.
FriendlyName
Nome do entorno restaurado		 (Opcional) Nome do entorno restaurado.
DisableAdminMode
Desactivar o modo de administración		 Indica se se desactiva o modo de administración (verdadeiro|falso).

Exportar Dataverse datos

Exportar datos dun ambiente co esquema proporcionado.

YAML fragmento (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ámetros (exportdata-env)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo para o contorno do que quere exportar datos (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
SchemaFile
Nome do ficheiro XML do esquema		 Nome do ficheiro XML do esquema. Pódese crear usando a ferramenta de migración da configuración.
DataFile
Nome do ficheiro de datos		 Nome do ficheiro para os datos a exportar (ficheiro zip).
Overwrite
Sobrescritura de contido		 Power Pages contido do sitio web para sobrescribir (verdadeiro|falso).

Importar Dataverse datos

Importar datos a un entorno.

YAML fragmento (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ámetros (importdata-env)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo para o contorno que quere importar datos (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
DataFile
Nome do ficheiro de datos		 Nome do ficheiro para o ficheiro de datos comprimido zip) para importar ou o cartafol con data-schema.xml e data.xml que se vai importar.

Power Pages tarefas de xestión

Tarefas para traballar cun Power Pages sitio web.

Power Platform Download PAPortal

Descargue o contido do sitio web de Power Pages do ambiente de Dataverse actual.

YAML fragmento (descarga-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ámetros (descarga-paportal)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo para o contorno do que quere descargar contido (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
WebsiteId
ID do sitio web do portal		 Power Pages ID do sitio web para descargar.
Overwrite
Sobrescritura de contido		 Power Pages contido do sitio web para sobrescribir (verdadeiro|falso).
ModelVersion
Modelo de datos do sitio		 Indica se os datos do sitio que se van cargar utilizarán o estándar (1) ou o modelo de datos mellorado (2). O valor predeterminado é "1".

Power Platform Upload PAPortal

Carga Power Pages contido do sitio web ao Dataverse entorno actual.

YAML fragmento (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ámetros (upload-paportal)

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo para o contorno no que queres cargar contido (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
UploadPath
Cargar o camiño do contido		 Ruta desde onde se cargará o Power Pages contido do sitio web.
ModelVersion
Modelo de datos do sitio		 Indica se os datos do sitio que se van cargar utilizarán o estándar (1) ou o modelo de datos mellorado (2). O valor predeterminado é "1".

Catálogo de Power Platform tarefas (vista previa)

Estas tarefas realizan accións contra o catálogo en Power Platform e inclúen as seguintes.

Nota

Actualmente, as tarefas de catálogo para Power Platform son unha versión previa .

Instalar elemento do catálogo

Instalar un elemento do catálogo no ambiente de destino.

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo para o contorno no que queres cargar contido (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
Environment
URL de ambiente de destino		 (Obrigatorio) URL do contorno que se dirixe a esta tarefa.
CatalogItemId
ID do elemento do catálogo que se vai instalar		 (Obrigatorio) Elemento de catálogo que se instalará no ambiente de destino.
TargetEnvironmentUrl
URL de ambiente de destino		 (Obrigatorio) O URL do entorno de destino para a instalación do elemento de catálogo (por exemplo, "https://YourOrg.crm.dynamics.com").
PollStatus
Comproba o estado da enquisa		 (Opcional) Enquisa para comprobar o estado da túa solicitude (verdadeiro|falso).

Parámetros (catalog-install)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.install-catalog.PowerPlatformInstallCatalog@2
  displayName: 'Power Platform Install Catalog '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    CatalogItemId: '00000000-0000-0000-0000-000000000001'
    TargetEnvironmentUrl: 'https://test.crm.dynamics.com/'
    PollStatus: true

Enviar aprobación do catálogo

Enviar solicitude de aprobación do catálogo.

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo para o contorno no que queres cargar contido (por exemplo, "https://powerappsbuildtools.crm.dynamics.com"). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
Environment
URL de ambiente de destino		 (Obrigatorio) URL do contorno que se dirixe a esta tarefa.
CatalogSubmissionFile
Ficheiro de envío do catálogo		 (Obrigatorio) Especifique a ruta e o nome do ficheiro de envío do catálogo.
UsePackageSolutionZipFile
Tipo de ficheiro		 Tipo de ficheiro: ficheiro zip de paquete ou solución.
SolutionZipFile
Nome do ficheiro zip da solución		 Especifique o camiño e o nome do ficheiro zip da solución.
PollStatus
Comproba o estado da enquisa		 (Opcional) Enquisa para comprobar o estado da túa solicitude (verdadeiro|falso).

Parámetros (envío de catálogo)

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

Estado da solicitude de catálogo

Obter o estado da solicitude de instalación/envío do catálogo.

Parámetros Descripción
authenticationType
Tipo de autenticación		 (Obrigatorio para SPN) Especifique PowerPlatformEnvironment para unha conexión de nome de usuario/contrasinal ou PowerPlatformSPN para unha conexión secreta principal/cliente de servizo.
PowerPlatformSPN
Director do servizo Power Platform		 O punto final do servizo para o contorno no que queres cargar contido (por exemplo, "https://powerappsbuildtools.crm.dynamics.com"). Definido en Conexións de servizo en Configuración do proxecto utilizando o tipo de conexión Power Platform.
Environment
URL de ambiente de destino		 (Obrigatorio) URL do contorno que se dirixe a esta tarefa.
TrackingId
Solicitar ID de seguimento		 (Obrigatorio) Solicitar ID de seguimento.
RequestType
Tipo de solicitude		 (Obrigatorio) Tipo de solicitude. (Valores: Instalar | Enviar).

Parámetros (estado do catálogo)

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

Compilar e liberar canles

Agora que identificamos o que se pode facer usando as ferramentas de compilación, vexamos como pode aplicar estas ferramentas ás súas canles de compilación e liberación. A continuación móstrase unha visión xeral conceptual. Vexamos algúns detalles da implementación de canles empregando as tarefas das ferramentas de compilación nas subseccións que seguen.

Para saber máis sobre como crear estas canles e crear na práctica unha canle usando Microsoft Power Platform Build Tools, complete as formacións de Build Tools, que pode descargar desde GitHub.

Máis información sobre Azure Pipelines: Use Azure Pipelines

Construír canle: exportar unha solución desde un ambiente de desenvolvemento (DEV)

Na seguinte figura móstranse as tarefas de ferramentas de compilación que pode engadir a unha canle que exporta unha solución desde un ambiente de desenvolvemento.

Exportar unha solución desde un entorno de desenvolvemento (DEV).

Construír pipeline: construír unha solución administrada

Na seguinte figura móstranse as tarefas de ferramentas de compilación que pode engadir a unha canle que crea unha solución administrada.

Crea un solución administrada.

Lanzar canle: implementar nun ambiente de produción (PROD)

Na seguinte figura móstranse as tarefas de ferramentas de compilación que pode engadir a unha canle que implementa nun ambiente de produción.

Implementación nun contorno de produción (PROD).

Consulte tamén

Microsoft Power Platform Build Tools para Azure DevOps