Tarefas das ferramentas de construción de Microsoft Power Platform

As tarefas de compilación dispoñibles descríbense nas seguintes seccións. A continuación, amosamos algúns exemplos de Azure Pipelines que fan uso destas tarefas. Para información sobre as ferramentas de compilación e como descargalas, consulta Microsoft Power Platform Ferramentas de compilación para Azure Pipelines.

Tarefa de axuda

As tarefas auxiliares dispoñibles descríbense a continuación.

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 necesarias polo axente para executar as tarefas de compilación de Microsoft Power Platform. Esta tarefa non require máis configuración ao engadila. Esta tarefa contén parámetros para as versións específicas de cada unha das ferramentas que se están a instalar.

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@2
  displayName: 'Power Platform Tool Installer'

# Installs default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    AddToolsToPath: true

# 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á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.
AddToolsToPath
Engadir ferramentas á ruta		 Engade a CLI pac á PATH variable de ambiente. Permite usar pac cli desde tarefas de script sen necesidade de configurar a ruta manualmente.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Versión da ferramenta		 A versión específica da ferramenta a utilizar.

Plataforma de enerxía 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@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á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.

Control de calidade

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

Comprobador de Power Platform

Esta tarefa executa unha análise estática das túas solucións fronte a un conxunto de regras de prácticas recomendadas para identificar calquera patrón problemático 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@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ámetros (Comprobador)

Parámetros Descripción
PowerPlatformSPN
Conexión do servizo		 (Obrigatorio) É necesaria unha conexión a un entorno licenciado de Microsoft Power Platform para usar o comprobador 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 principal de servizo e nome de usuario/contrasinal 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		 Por defecto (true), a localización xeográfica do servizo de verificación usa a mesma xeografía que o entorno ao que te conectas.
CustomPACheckerEndpoint
Punto final do comprobador de PAC personalizado		 Obrigatorio cando UseDefaultPACheckerEndpoint é falso. Podes especificar outra xeográfica para usar, por exemplo https://japan.api.advisor.powerapps.com. Para obter unha lista das xeográficas dispoñibles, consulta Usar a Power Platform API de Checker.
FileLocation
Localización dos ficheiros a analizar		 Obrigatorio ao facer 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		 Obrigatorio cando non se analizan os ficheiros SAS. 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 todas as 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 portal Power Apps maker.
  • Marketplace: O conxunto ampliado de regras que se usa para certificar unha aplicación antes de que poida ser publicada no Marketplace.
ErrorLevel
Nivel de erro		 Combinado co parámetro de erro e limiar, define a gravidade dos erros e avisos permitidos. 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 verdadeiro, falla se a análise do Power Apps Checker se devolve como Failed ou FinishedWithErrors.
ArtifactDestinationName
Nome do artefacto DevOps		 Especifica o nome Azure Artifacts para o ficheiro checker .sarif.

Tarefas da solución

Este conxunto de tarefas pode automatizar as accións da solución. As tarefas de ambiente descritas máis adiante nesta sección que crean, copian ou restauran un ambiente sobrescriben as conexións de servizo cos ambientes recentemente creados. Estas tarefas permiten realizar tarefas de solucións en entornos creados 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@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

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á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 no que queres 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 no que queres 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 .zip da solución que se importará no ambiente de destino (por exemplo, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Nota: As variables ofrécenche unha forma cómoda de introducir datos clave en varias partes da tú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		 Obsoleto. O sistema converterá os compoñentes da solución non xestionada en xestionados ao importar unha solución xestionada.
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 máximo de espera en minutos para a operación asincrónica; O predeterminado é 60 min (1 hora), igual que o predeterminado de Azure DevOps 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.

Fragmento de código YAML (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ás a engadir. Consulta Usar tipos de compoñentes predefinidos para obter unha lista completa dos valores dos compoñentes.
SolutionUniqueName
Nome da solución		 Nome único da solución.
AddRequiredComponents
Calquera compoñente requirido doutra solución dependente do compoñente da solución		 (Opcional) Indica se outros compoñentes da solución que require o compoñente da solución que está a engadir tamén se deben engadir á solución non xestionada.
Environment
URL ou ID do ambiente		 (Opcional) URL ou ID do ambiente 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@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á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 ao que queres 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 ao que queres 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 máximo de espera en minutos para a operación asincrónica; O predeterminado é 60 min (1 hora), igual que o predeterminado de Azure DevOps 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@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á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 ao que queres 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 ao que queres 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 solution.zip ao que se exportará o entorno de orixe (por exemplo, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Nota: As variables ofrécenche unha forma cómoda de introducir datos clave en varias partes da tú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 máximo de espera en minutos para a operación asincrónica; O predeterminado é 60 min (1 hora), igual que o predeterminado de Azure DevOps 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
Configuración de sincronización de Outlook para exportar		 Exportar configuración de 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@2
  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@2
  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@2
  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 desde o que desexa 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 desde o que desexa 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@2
  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 queres 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 queres 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@2
  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 para o que desexa definir 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 para o que desexa definir 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 codificarse fixamente no pipeline, recoméndase usar unha variable de pipeline 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 Definir variables de conexión

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

Establécense as seguintes variables:

  • PowerPlatformSetConnectionVariables.BuildTools.TenantId
  • PowerPlatformSetConnectionVariables.BuildTools.ApplicationId
  • PowerPlatformSetConnectionVariables.BuildTools.ClientSecret
  • PowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString

Fragmento de código 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á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 definir 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 que o servidor a cancele. Un valor cero indica un tempo de espera infinito.
retryCountOnTaskFailure
Número de intentos se a tarefa fallou		 Especifica o número de intentos que se realizarán para esta tarefa en caso de fallo da tarefa. Non compatible con tarefas sen axente.
ApplicationId
ID da aplicación para iniciar sesión		 (Obrigatorio para o nome de usuario/contrasinal) ID da aplicación que se usará para iniciar sesión (consulta a nota adicional a continuación).
RedirectUri
URI de redirección da aplicación específica		 (Obrigatorio para o nome de usuario/contrasinal) URI de redirección da aplicación especificada. Necesario ao especificar un ID de aplicación. (Consulta a nota adicional a continuación).

Nota

Ao usar o tipo de autenticación de nome de usuario/contrasinal, requirirase o ID da aplicación e o URI de redireccionamento. Este documento de *autenticación con oauth* explica por que cómpre crear un rexistro de aplicación para autenticarse . Dataverse Cando te conectas usando a autenticación de nome de usuario/contrasinal, a conexión compórtase como unha aplicación que se conecta 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@2
  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 queres despregar 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 queres despregar 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 máximo de espera en minutos para a operación asincrónica; O predeterminado é 60 min (1 hora), igual que o predeterminado de Azure DevOps 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.

Só se pode aprovisionar un novo ambiente se a súa licenza ou capacidade permite a creación de ambientes 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@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á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 no que queres 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 no que queres 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 introduces 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@2
  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 do que queres 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 do que queres 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

Asignar un usuario a un ambiente de destino cun rol de seguranza especificado.

Fragmento de código 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ámetros (Asignar entorno de usuario)

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 ambiente ao que queres 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		 ID de obxecto Microsoft Entra ou nome principal do usuario para asignar ao entorno obxectivo.
Role
Nome ou ID do rol de seguranza		 Nome ou ID do rol de seguranza que se lle 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 ambiente

Reinicia un ambiente.

Fragmento de código 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ámetros (Reiniciar entorno)

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 cuxo ambiente queres restablecer (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 cuxo ambiente queres restablecer (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@2
  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 extremo de servizo do que queres facer unha copia de seguridade 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 extremo de servizo do que queres facer unha copia de seguridade 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@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'
    SkipAuditData: true
    MaxAsyncWaitTime: 60

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 ambiente de orixe do que queres 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 ambiente de orixe do que queres 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.
SkipAuditData
OmitirDatosDeAuditoría		 Se se deben omitir os datos de auditoría durante a operación de copia. (verdadeiro|falso).
MaxAsyncWaitTime
Tempo máximo de espera		 Tempo máximo de espera en minutos para a operación asincrónica; O predeterminado é 60 min (1 hora), igual que o predeterminado de Azure DevOps para tarefas.

Power Platform Restaurar o ambiente

Restaura un ambiente a unha determinada copia de seguranza.

Fragmento de código 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ámetros (Restaurar-entorno)

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 de servizo para o ambiente 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 de servizo para o ambiente 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
Última copia de seguridade para restaurar		 Indica se se restaura a copia de seguridade máis recente ou se se proporciona RestoreTimeStamp (true|false).
RestoreTimeStamp
Data e hora 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 ambiente de destino que queres restaurar.
FriendlyName
Nome do entorno restaurado		 (Opcional) Nome do ambiente restaurado.
DisableAdminMode
Desactivar o modo de administración		 Indica se se desactiva o modo de administración (verdadeiro|falso).

Exportar datos Dataverse

Exportar datos dun ambiente co esquema proporcionado.

Fragmento de código 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á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 ambiente desde o que queres exportar os 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 de esquema		 Nome do ficheiro XML de esquema. Pódese crear coa ferramenta Migración de configuración.
DataFile
Nome do ficheiro de datos		 Nome do ficheiro para os datos que se exportarán (ficheiro zip).
Overwrite
Sobrescritura de contido		 Power Pages para que o contido do sitio web sobrescriba (verdadeiro|falso).

Importar datos Dataverse

Importar datos a un entorno.

Fragmento de código 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á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 ambiente no que queres 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) que se vai importar ou o cartafol que contén data-schema.xml e data.xml que se vai importar.

Tarefas de xestión de Power Pages

Tarefas para traballar cun sitio web de Power Pages.

Power Platform Descargar PAPortal

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

Fragmento de código YAML (portal de descargas)

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 (portal de descarga)

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 ambiente desde o que queres 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		 ID do sitio web de Power Pages para descargar.
Overwrite
Sobrescritura de contido		 Power Pages para que o contido do sitio web sobrescriba (verdadeiro|falso).
ModelVersion
Modelo de datos do sitio		 Indica se os datos do sitio que se van cargar usarán o modelo de datos estándar (1) ou mellorado (2). O valor predeterminado é '1'.

Power Platform Upload PAPortal

Sube o contido do sitio web de Power Pages ao entorno actual de Dataverse.

Fragmento de código YAML (subir-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 (subir-portal)

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 ambiente 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
Ruta de carga de contido		 Ruta desde onde se subirá o contido do sitio web de Power Pages.
ModelVersion
Modelo de datos do sitio		 Indica se os datos do sitio que se van cargar usarán o modelo de datos estándar (1) ou mellorado (2). O valor predeterminado é '1'.

Catálogo para tarefas (vista previa) Power Platform

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

Nota

Actualmente, as tarefas de catálogo para Power Platform son unha versión de vista 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 ambiente 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 de ambiente ao que se dirixe esta tarefa.
CatalogItemId
ID do elemento do catálogo que se vai instalar		 (Obrigatorio) Elemento de catálogo que se instalará no entorno de destino.
TargetEnvironmentUrl
URL de ambiente de destino		 (Obrigatorio) O URL do ambiente de destino no que se instalarán os elementos do catálogo (por exemplo, "https://YourOrg.crm.dynamics.com").
PollStatus
Comprobar o estado da enquisa		 (Opcional) Enquisa para comprobar o estado da túa solicitude (verdadeiro|falso).

Parámetros (instalación de catálogo)

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 ambiente 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 de ambiente ao que se dirixe esta tarefa.
CatalogSubmissionFile
Ficheiro de envío do catálogo		 (Obrigatorio) Especifique a ruta e o nome do ficheiro 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 a ruta e o nome do ficheiro do ficheiro zip da solución.
PollStatus
Comprobar 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 ambiente 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 de ambiente ao que se dirixe esta tarefa.
TrackingId
Solicitar o ID de seguimento		 (Obrigatorio) Solicitar o 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 aprender máis sobre como crear estes pipelines e realmente facer autoría práctica de pipelines usando as Microsoft Power Platform Build Tools, completa os laboratorios de ferramentas build, que podes descargar desde GitHub.

Máis información sobre Azure Pipelines: Usa 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.

Crear unha solución xestionada.

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.

Implementar nun entorno de produción (PROD).

Consulte tamén

Microsoft Power Platform Ferramentas de compilación para Azure DevOps

  • Last updated on