Compartilhar via

Tarefas de ferramenta de compilação do Microsoft Power Platform

  • Artigo

As tarefas de build disponíveis são descritas nas seções a seguir. Depois, vamos demonstrar alguns exemplos de como o Azure Pipelines está usando essas tarefas. Para obter informações sobre as ferramentas de construção e como baixá-las, consulte Build Tools do Microsoft Power Platform para Azure Pipelines.

Tarefa auxiliar

As tarefas auxiliares disponíveis são descritas a seguir.

Instalador de Ferramentas do Power Platform

Esta tarefa deve ser adicionada uma vez antes de qualquer outra tarefa do Power Platform Build Tools em pipelines de build e lançamento. Esta tarefa instala um conjunto de ferramentas específicas do Power Platform exigidas pelo agente para executar as tarefas de build do Microsoft Power Platform. Essa tarefa não requer mais configuração adicional quando adicionado. Esta tarefa contém parâmetros para as versões específicas de cada uma das ferramentas que estão sendo instaladas.

Para manter-se atualizado em relação às versões das ferramentas ao longo do tempo, verifique se esses parâmetros correspondem às versões das ferramentas necessárias para o pipeline funcionar corretamente.

Trecho do YAML (instalador)

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

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

Parâmetros (instalador)

Parâmetros Descrição
DefaultVersion
Usar versões de ferramenta padrão		 Defina como verdadeiro para usar a versão padrão de todas as ferramentas; caso contrário, falso. Obrigatório (e falso) quando qualquer versão da ferramenta for especificada.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Versão da ferramenta		 A versão específica da ferramenta a ser usada.

Power Platform WhoAmI

Verifica uma conexão de serviço com um ambiente do Power Platform conectando-se e fazendo uma solicitação WhoAmI. Pode ser útil incluir esta tarefa no início do pipeline, para verificar a conectividade antes de começar o processamento.

Trecho do 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 Descrição
authenticationType
Tipo de autenticação		 (Opcional) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço para o ambiente se conectar. Definido em Conexões de Serviço em Configurações do Projeto. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o ambiente se conectar. Definido em Conexões de Serviço em Configurações do Projeto.

Verificação de qualidade

Na próxima seção, estão as tarefas disponíveis para verificar a qualidade de uma solução.

Power Platform Checker

Esta tarefa executa uma verificação de análise estática nas soluções em relação a um conjunto de regras de práticas recomendadas para identificar eventuais padrões problemáticos que você possa ter introduzido inadvertidamente ao criar a solução.

Trecho do YAML (verificador)

# 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 (verificador)

Parâmetros Descrição
PowerPlatformSPN
Conexão de serviço		 (Obrigatório) Uma conexão com um ambiente Microsoft Power Platform precisa usar o verificador do Power Platform. As conexões de serviço são definidas em Conexões de serviço em Configurações do projeto usando o tipo de conexão Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Power Platform Criar Ambiente

Observação: a Entidade de Serviço e os métodos de autenticação de nome de usuário/senha estão disponíveis para tarefa do verificador. Para obter mais informações sobre como configurar entidades de serviço a serem usadas com esta tarefa, consulte Configurar conexões principais de serviço para ambientes do Power Platform.
UseDefaultPACheckerEndpoint
Usar o ponto de extremidade de verificação padrão da Power Platform		 Por padrão (verdadeiro), a localização geográfica do serviço de verificação usará a mesma geografia do ambiente ao qual você se conecta.
CustomPACheckerEndpoint
Ponto de extremidade da verificação de PAC personalizado		 Obrigatório quando UseDefaultPACheckerEndpoint é falso. Você pode especificar outra geografia a ser usada, por exemplo https://japan.api.advisor.powerapps.com.. Para obter uma lista de geografias disponíveis, consulte Usar a API do Verificador do Power Platform.
FileLocation
Local de arquivos a serem analisados		 Obrigatório ao fazer referência a um arquivo de uma URL de assinatura de acesso compartilhado (SAS) sasUriFile.

Observação: é importante fazer referência a um arquivo de solução exportado e não aos arquivos de origem descompactados em seu repositório. Os arquivos de solução gerenciada e não gerenciada podem ser analisados.
FilesToAnalyzeSasUri
Arquivos SAS para analisar		 Obrigatório quando FileLocation está definido como sasUriFile. Insira a URI do SAS. Você pode adicionar mais de um URI da SAS através de uma lista separada por vírgula (,) ou ponto-e-vírgula (;).
FilesToAnalyze
Arquivos locais para analisar		 Obrigatório quando os arquivos SAS não são analisados. Especifique o caminho e o nome dos arquivos zip a serem analisados. Curingas podem ser usados. Por exemplo, insira **\*.zip para todos os arquivos zip em todas as subpastas.
FilesToExclude
Arquivos locais para excluir		 Especifique os nomes dos arquivos a serem excluídos da análise. Se houver mais de um, forneça-o por meio de uma lista separada por vírgula (,) ou ponto e vírgula (;). Esta lista pode incluir um nome de arquivo completo ou um nome com curingas à esquerda ou à direita, como *jquery ou form.js
RulesToOverride
Regras a serem substituídas		 Uma matriz JSON contendo regras e níveis a serem substituídos. Os valores aceitos para OverrideLevel são: crítico, alto, médio, baixo, informativo. Exemplo: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Conjunto de regras		 (Obrigatório) Especifique qual conjunto de regras será aplicado. Os dois conjuntos de regras a seguir estão disponíveis:
  • Verificador de solução: este conjunto de regras é o mesmo executado no Power Apps Maker Portal.
  • AppSource: o conjunto de regras estendido usado para certificar um aplicativo para que ele possa ser publicado no AppSource.
ErrorLevel
Nível de Erro		 Combinado com o parâmetro Limite de erros, define a gravidade dos erros e os avisos permitidos. Os valores de limite com suporte são <nível>IssueCount onde nível = crítico, alto, médio, baixo e informativo.
ErrorThreshold
Limite de erros		 Define o número de erros (>=0) de um nível especificado que são permitidos para o verificador passar nas soluções que estão sendo verificadas.
FailOnPowerAppsCheckerAnalysisError
Falha por erro		 Quando verdadeiro, há falha se a análise do verificador do Power Apps for retornada como Failed ou FinishedWithErrors.
ArtifactDestinationName
Nome do artefato do DevOps		 Especifique o nome do Azure Artifacts para o arquivo .sarif do verificador.

Tarefas de solução

Este conjunto de tarefas pode automatizar ações de solução. As tarefas de ambiente descritas posteriormente nesta seção que criam, copiam ou restauram um ambiente substituirão as conexões de serviço com os ambientes recém-criados. Essas tarefas possibilitam a realização das tarefas de solução em ambientes criados sob demanda.

Importar Solução do Power Platform

Importa uma solução para um ambiente de destino.

Trecho do YAML (importação)

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

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

Parâmetros (importação)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço para o qual você deseja importar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o qual você deseja importar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
SolutionInputFile
Arquivo de entrada da solução		 (Obrigatório) O caminho e o nome do arquivo solution.zip a ser importado para o ambiente de destino (por exemplo, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Observação: as variáveis oferecem uma maneira conveniente de inserir partes importantes de dados em várias partes do seu pipeline. Consulte Usar variáveis predefinidas para obter uma lista abrangente.
HoldingSolution
Importar como solução de retenção		 Um parâmetro avançado (verdadeiro|falso) usado quando uma solução precisa ser atualizada. Este parâmetro hospeda a solução no Dataverse, mas não atualiza a solução até que a tarefa Aplicar Atualização da Solução seja executada.
OverwriteUnmanagedCustomizations
Substituir personalizações não gerenciadas		 Especifique se deseja substituir as personalizações não gerenciadas (verdadeiro|falso).
SkipProductUpdateDependencies
Ignorar dependências de atualização do produto		 Especifique se a aplicação de dependências relacionadas às atualizações do produto deve ser ignorada (verdadeiro|falso).
ConvertToManaged
Converter em gerenciado		 Especifique se deseja importar como uma solução gerenciada (verdadeiro|falso).
AsyncOperation
Importação assíncrona		 Se selecionado (verdadeiro), a operação de importação será realizada de forma assíncrona. Isso é recomendado para soluções maiores, pois essa tarefa atingirá o tempo limite automaticamente após 4 minutos. A seleção de assíncrono pesquisará e aguardará até que MaxAsyncWaitTime seja atingido (true|false).
MaxAsyncWaitTime
Tempo máximo de espera		 Tempo máximo de espera em minutos para a operação assíncrona; o padrão é 60 min (1 hora), o mesmo que o padrão do Azure DevOps para tarefas.
PublishWorkflows
Ativar processos após importação		 Especifique se algum processo (fluxo de trabalho) na solução deve ser ativado após a importação (verdadeiro|falso).
UseDeploymentSettingsFile
Usar arquivo de configurações de implantação		 As referências de conexão e os valores das variáveis de ambiente podem ser configurados usando um arquivo de configurações de implantação (verdadeiro|falso).
DeploymentSettingsFile
Arquivo de configurações de implantação		 (Obrigatório quando UseDeploymentSettingsFile=verdadeiro) O caminho e o nome do arquivo de configurações de implantação.

Adicionar Componente da Solução do Power Platform

Adiciona um componente da solução a uma solução não gerenciada.

Trecho do YAML (Adicionar)

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 (Adicionar)

Parâmetros Descrição
ComponentId
ID do componente da solução		 O nome do esquema ou a ID do componente para adicionar à solução de destino.
ComponentType
URL do ambiente do Power Platform		 O valor que representa o componente da solução que você está adicionando. Consulte Usar tipos de componentes predefinidos para obter uma lista abrangente de valores do componente.
SolutionUniqueName
Nome do fornecedor da solução		 O nome exclusivo da solução.
AddRequiredComponents
Quaisquer componentes necessários de outra solução dependente do componente da solução		 (Opcional) Indica se outros componentes da solução necessários para o componente da solução que você está adicionando também devem ser adicionados à solução não gerenciada.
Environment
URL ou ID do Ambiente		 (Opcional) URL ou ID do ambiente de destino.

Tarefa Aplicar Atualização da Solução do Power Platform

Atualiza uma solução que foi importada como uma solução de retenção.

Trecho do YAML (atualização)

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 (atualização)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço para o qual você deseja atualizar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o qual você deseja atualizar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
SolutionName
Nome da solução:		 (Obrigatório) O nome da solução para aplicar a atualização. Sempre use a solução Nome, não seu Nome de Exibição.
AsyncOperation
Atualização assíncrona		 Se selecionado (verdadeiro), a operação de atualização será realizada como um trabalho em lote assíncrono. A seleção de assíncrono pesquisará e aguardará até que MaxAsyncWaitTime seja atingido.
MaxAsyncWaitTime
Tempo máximo de espera		 Tempo máximo de espera em minutos para a operação assíncrona; o padrão é 60 min (1 hora), o mesmo que o padrão do Azure DevOps para tarefas.

Nota

As variáveis oferecem uma maneira conveniente de colocar os principais bits de dados em várias partes do seu pipeline. Consulte Usar variáveis predefinidas para obter uma lista abrangente. Você pode preencher previamente a referência de conexão e as informações de variáveis de ambiente para o ambiente de destino ao importar uma solução usando um arquivo de configurações de implantação.

Mais informações: Preencher referências de conexão e variáveis de ambiente para implantações automatizadas

Exportar Solução do Power Platform

Exporta uma solução de um ambiente de origem.

Trecho do YAML (exportação)

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 (exportação)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço para o qual você deseja atualizar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o qual você deseja atualizar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
SolutionName
Nome da solução:		 (Obrigatório) O nome da solução a ser exportada. Sempre use a solução Nome, não seu Nome de Exibição.
SolutionOutputFile
Arquivo de saída da solução		 (Obrigatório) O caminho e o nome do arquivo solution.zip a ser exportado para o ambiente de origem (por exemplo, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Observação: as variáveis oferecem uma maneira conveniente de inserir partes importantes de dados em várias partes do seu pipeline. Consulte Usar variáveis predefinidas para obter uma lista abrangente.
AsyncOperation
Exportação assíncrona		 Se selecionado (verdadeiro), a operação de exportação será realizada como um trabalho em lote assíncrono. A seleção de assíncrono pesquisará e aguardará até que MaxAsyncWaitTime seja atingido.
MaxAsyncWaitTime
Tempo máximo de espera		 Tempo máximo de espera em minutos para a operação assíncrona; o padrão é 60 min (1 hora), o mesmo que o padrão do Azure DevOps para tarefas.
Managed
Exportar como gerenciada		 Se selecionado (verdadeiro), exporte a solução como uma solução gerenciada; caso contrário, exporte como uma solução não gerenciada.
ExportAutoNumberingSettings
Exportar configurações de numeração automática		 Exporte configurações de numeração automática (verdadeiro|falso).
ExportCalendarSettings
Exportar configurações de calendário		 Exporte configurações de calendário (verdadeiro|falso).
ExportCustomizationSettings
Exportar configurações de personalização		 Exporte configurações de personalização (verdadeiro|falso).
ExportEmailTrackingSettings
Exportar configurações de acompanhamento de email		 Exporte configurações de acompanhamento de email (verdadeiro|falso).
ExportGeneralSettings
Exportar configurações gerais		 Exporte configurações gerais (verdadeiro|falso).
ExportIsvConfig
Exportar configuração ISV		 Exporte configuração ISV (verdadeiro|falso).
ExportMarketingSettings
Exportar configurações de marketing		 Exporte configurações de marketing (verdadeiro|falso).
ExportOutlookSynchronizationSettings
Exportar configurações de sincronização do Outlook		 Exporte configurações de sincronização do Outlook (verdadeiro|falso).
ExportRelationshipRoles
Exportar papéis de relacionamento		 Exporte papéis de relacionamento (verdadeiro|falso).
ExportSales
Exportar vendas		 Exportar vendas (verdadeiro|falso).

Descompactar Solução do Power Platform

Obtém um arquivo de solução compactado e o decompõe em vários arquivos XML para que esses arquivos possam ser mais facilmente lidos e gerenciados por um sistema de controle de fonte.

Trecho do YAML (descompactar)

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 (descompactar)

Parâmetros Descrição
SolutionInputFile
Arquivo de entrada da solução		 (Obrigatório) O caminho e o nome do arquivo solution.zip a ser descompactado.
SolutionTargetFolder
Pasta de destino para descompactar a solução		 (Obrigatório) A pasta de caminho e destino na qual você deseja descompactar a solução.
SolutionType
Tipo de solução		 (Obrigatório) O tipo de solução que você deseja descompactar. As opções incluem: Não gerenciado (recomendado), Gerenciado e Ambos.

Compactar Solução do Power Platform

Empacota uma solução representada no controle de origem em um arquivo solution.zip que pode ser importado para outro ambiente.

Trecho do YAML (empacotar)

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 (empacotar)

Parâmetros Descrição
SolutionOutputFile
Arquivo de saída da solução		 (Obrigatório) O caminho e o nome do arquivo solution.zip para o qual a solução será compactada.
SolutionSourceFolder
Pasta de origem da solução a ser compactada		 (Obrigatório) O caminho e a pasta de origem da solução a ser empacotada.
SolutionType
Tipo de solução		 (Obrigatório) O tipo de solução que você deseja compactar. As opções incluem: Gerenciado (recomendado), Não gerenciado e Ambos.

Tarefa Excluir Solução do Power Platform

Exclui uma solução no ambiente de destino.

Trecho do YAML (excluir)

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 (excluir)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço que você deseja excluir da solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço que você deseja excluir da solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
SolutionName
Nome da solução:		 (Obrigatório) O nome da solução a ser excluída. Sempre use a solução Nome, não seu Nome de Exibição.

Publicar Personalizações do Power Platform

Publica todas as personalizações em um ambiente.

Trecho do 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 Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço em que você deseja publicar as personalizações (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço em que você deseja publicar as personalizações (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform

Definir Versão de Solução do Power Platform

Atualiza a versão de uma solução.

Trecho do YAML (versão)

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 (versão)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço para o qual você deseja definir a versão da solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o qual você deseja definir a versão da solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
SolutionName
Nome da solução:		 (Obrigatório) O nome da solução para a qual definir a versão. Sempre use a solução Nome, não seu Nome de Exibição.
SolutionVersionNumber
Número da versão da solução		 (Obrigatório) Número da versão que você deseja definir.

Embora o número da versão possa ser codificado no pipeline, é recomendável usar uma variável de pipeline do Azure DevOps como BuildId. Isso fornece opções para definir a forma exata do número da versão na guia "Opções", por exemplo: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Esta definição pode ser usada na tarefa Definir versão da solução, definindo a propriedade Número da versão com: $(Build.BuildId) em vez de hard-coding 20200824.0.0.2.

Como alternativa, uma saída de script de tarefa em linha do PowerShell $(Get-Date -Format yyyy.MM.dd.HHmm) definida para uma variável vazia chamada SolutionVersion como Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Definir Versão da Solução como $(SolutionVersion).

Definir Variáveis de Conexão do Power Platform

Define variáveis BuildTools.* para fornecer acesso a tarefas de script customizadas para usar a conexão de serviço como uma única fonte de verdade.

Snippet 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 Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o qual você deseja definir variáveis de conexão. Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
timeoutInMinutes
Timeout		 Especifica o tempo máximo, em minutos, que uma tarefa pode ser executada antes de ser cancelada pelo servidor. Um valor zero indica um tempo limite infinito.
retryCountOnTaskFailure
Número de tentativas, se a tarefa falhar		 Especifica o número de novas tentativas para esta tarefa que ocorrerão em caso de falha da tarefa. Não há suporte para tarefas sem agente.
ApplicationId
ID do Aplicativo para login		 (Obrigatório para nome de usuário/senha) ID do aplicativo a ser usado para login (veja observação adicional abaixo).
RedirectUri
Redirecionar URI do aplicativo específico		 (Obrigatório para nome de usuário/senha) Redirecionar URI do aplicativo especificado. Necessário ao especificar um ID de aplicativo. (Veja observação adicional abaixo).

Observação

Ao usar o tipo de autenticação nome de usuário/senha, o ID do aplicativo e o Uri de Redirecionamento serão necessários. Esse documento autenticar oauth tem uma explicação de por que você precisa criar um registro de aplicativo para autenticar o Dataverse. Quando você se conecta usando autenticação de nome de usuário/senha, a conexão se comporta como um aplicativo que se conecta em nome de um usuário ao Dataverse.

Implantar Pacote do Power Platform

Implanta um pacote em um ambiente. A implantação de um pacote, em vez de um único arquivo de solução, oferece a opção de implantar várias soluções, dados e códigos em um ambiente.

Trecho do YAML (implantar)

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 (implantar)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço em que você deseja implantar o pacote (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço em que você deseja implantar o pacote (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente da Power Platform
PackageFile
Arquivo de pacote		 (Obrigatório) O caminho e o nome do arquivo do assembly de arquivos do pacote (.dll).
MaxAsyncWaitTime
Tempo máximo de espera		 Tempo máximo de espera em minutos para a operação assíncrona; o padrão é 60 min (1 hora), o mesmo que o padrão do Azure DevOps para tarefas.

Tarefas de gerenciamento de ambiente

Automatize tarefas comuns de Gerenciamento do Ciclo de Vida do Ambiente (ELM).

Criar Ambiente do Power Platform

Cria um novo ambiente. A criação de um ambiente também cria automaticamente BuildTools.EnvironmentUrl.

Importante

Quando definido, BuildTools.EnvironmentUrl será usado como a conexão de serviço padrão para tarefas subsequentes no pipeline. Cada tarefa descrita neste artigo usa apenas o ponto de extremidade da conexão de serviço quandoBuildTools.EnvironmentUrl não está definido.

Um novo ambiente só pode ser provisionado se sua licença ou capacidade permitir a criação de ambientes adicionais. Para obter mais informações sobre como visualizar a capacidade, consulte Detalhes da página de capacidade.

Trecho do 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 Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço em que você deseja criar o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço em que você deseja criar o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
DisplayName
Nome de exibição		 (Obrigatório) O nome para exibição do ambiente criado.
LocationName
Região da implantação		 (Obrigatório) A região na qual o ambiente deve ser criado.
EnvironmentSku
Tipo de ambiente		 (Obrigatório) O tipo de instância a ser implantada. As opções são Área restrita, Produção, Avaliação e SubscriptionBasedTrial.
AppsTemplate
Aplicativos		 Para um tipo de ambiente que não seja de avaliação, os aplicativos compatíveis são D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation e D365_Sales.
CurrencyName
Currency		 (Obrigatório) Moeda base para o ambiente criado. A moeda não pode ser atualizada após a criação do ambiente.
LanguageName
Linguagem		 (Obrigatório) O idioma base no ambiente.
DomainName
Nome do Domínio		 (Obrigatório) Essa é a cadeia de caracteres específica do ambiente que faz parte da URL. Por exemplo, para um ambiente com a seguinte URL: https://powerappsbuildtasks.crm.dynamics.com/, o nome do domínio seria 'powerappsbuildtasks'.

Observação: se você inserir um nome de domínio que já esteja em uso, o tarefa anexará um valor numérico ao nome de domínio, começando com 0. Para o exemplo acima, a URL pode passar a ser https://powerappsbuildtasks0.crm.dynamics.com/.

Excluir Ambiente do Power Platform

Exclui um ambiente.

Trecho do 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 Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço em que você deseja excluir o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço em que você deseja excluir o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.

Atribuir usuários do Power Platform

Atribua um usuário a um ambiente de destino com o direito de acesso especificado.

Trecho 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 (AssignUser-env)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o ambiente ao qual você deseja atribuir o usuário (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
User
Nome de usuário do Power Platform		 ID do objeto ou nome UPN no Microsoft Entra a ser atribuído ao ambiente de destino.
Role
Nome ou ID do direito de acesso		 Nome ou ID do direito de acesso a ser atribuído ao usuário.
ApplicationUser
Nome de usuário do aplicativo do Power Platform		 Especifica se o usuário de entrada é um usuário do aplicativo (true|false).

Redefinir Ambiente do Power Platform

Redefine um ambiente.

Trecho do 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 (Reset-env)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço em que você deseja redefinir o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço em que você deseja redefinir o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.

Fazer Backup de um Ambiente do Power Platform

Faz backup de um ambiente.

Trecho do 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 Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço em que você deseja fazer backup do ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço em que você deseja fazer backup do ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
BackupLabel
Rótulo do backup		 (Obrigatório) O rótulo a ser atribuído ao backup.

Copiar Ambiente do Power Platform

Copia um ambiente para um ambiente de destino. Dois tipos de cópias estão disponíveis: completa e mínima. Uma cópia Completa inclui metadados de dados e solução (personalizações), enquanto uma cópia mínima inclui apenas metadados da solução e não os dados reais.

Trecho do YAML (Copy-env)

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

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

Parâmetros (Copy-env)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço para o ambiente de origem do qual você deseja copiar (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o ambiente de origem do qual você deseja copiar (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
TargetEnvironmentUrl
URL do ambiente de destino		 (Obrigatório) A URL do ambiente de destino para o qual você deseja copiar.
CopyType
Tipo de cópia		 O tipo de cópia a ser executada: FullCopy ou MinimalCopy
OverrideFriendlyName
Substituir nome amigável		 Altere o nome amigável do ambiente de destino para outro nome (verdadeiro|falso).
FriendlyName
Nome amigável		 O nome amigável do ambiente de destino.
DisableAdminMode
Desabilitar modo de administração		 Indica se o modo de administração deve ser desativado (verdadeiro|falso).

Restaurar Ambiente do Power Platform

Restaura um ambiente para um backup determinado.

Trecho do 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 (Restore-env)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformEnvironment
URL do ambiente do Power Platform		 O ponto de extremidade de serviço para o ambiente de origem do qual você deseja restaurar (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o ambiente de origem do qual você deseja restaurar (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
RestoreLatestBackup
Último backup a ser restaurado		 Se deve restaurar o backup mais recente ou fornecer RestoreTimeStamp (true|false).
RestoreTimeStamp
DateTime do backup		 DateTime do backup no formato "mm/dd/aaaa hh:mm" OU cadeia de caracteres "latest".
TargetEnvironmentUrl
URL do ambiente de destino		 (Obrigatório) A URL do ambiente de destino para o qual você deseja restaurar.
FriendlyName
Nome do ambiente restaurado		 (Opcional) Nome do ambiente restaurado.
DisableAdminMode
Desabilitar modo de administração		 Indica se o modo de administração deve ser desativado (verdadeiro|falso).

Exportar Dados do Dataverse

Exporte dados de um ambiente com o esquema fornecido.

Trecho 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 Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o ambiente do qual você deseja exportar dados (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
SchemaFile
Nome do arquivo XML de esquema		 Nome do arquivo XML de esquema. Pode ser criado usando a ferramenta Migração de Configuração.
DataFile
Nome do arquivo de dados		 Nome do arquivo para dados a serem exportados (arquivo zip).
Overwrite
Substituição de conteúdo		 Conteúdo do site do Power Pages para substituição (true|false).

Importar dados do Dataverse

Importe dados para um ambiente.

Trecho 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 Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o ambiente do qual você deseja importar dados (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
DataFile
Nome do arquivo de dados		 Nome do arquivo de dados compactado (zip) a ser importado ou a pasta com data-schema.xml e data.xml a ser importada.

Tarefas de gerenciamento do Power Pages

Tarefas para trabalhar com um site do Power Pages.

Baixar PAPortal do Power Platform

Baixe conteúdo do site do Power Pages pelo ambiente do Dataverse atual.

Trecho YAML (download-paportal)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.download-paportal.PowerPlatformDownloadPaportal@2
  displayName: 'Power Platform Download PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DownloadPath: 'C:\portals'
    WebsiteId: 'f88b70cc-580b-4f1a-87c3-41debefeb902'
    Overwrite: true

Parâmetros (download-paportal)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o ambiente do qual você deseja baixar conteúdo (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
WebsiteId
ID do site do portal		 ID do site do Power Pages a ser baixado.
Overwrite
Substituição de conteúdo		 Conteúdo do site do Power Pages para substituição (true|false).
ModelVersion
Modelo de dados do site		 Indica se os dados do site a serem carregados vão usar o modelo de dados (1) ou avançado (2). O valor padrão é "1".

Carregar PAPortal do Power Platform

Carregue o conteúdo do site do Power Pages no ambiente atual do Dataverse.

Trecho YAML (upload-paportal)

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

Parâmetros (upload-paportal)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o ambiente para o qual você deseja carregar conteúdo (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
UploadPath
Carregar caminho do conteúdo		 Caminho de onde o conteúdo do site do Power Pages será carregado.
ModelVersion
Modelo de dados do site		 Indica se os dados do site a serem carregados vão usar o modelo de dados (1) ou avançado (2). O valor padrão é "1".

Catálogo para tarefas do Power Platform (versão preliminar)

Essas tarefas executam ações relacionadas ao catálogo no Power Platform incluem o seguinte.

Observação

Atualmente, as tarefas do catálogo do Power Platform estão em uma versão preliminar.

Instalar item do catálogo

Instale um item do catalog no ambiente de destino.

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o ambiente para o qual você deseja carregar conteúdo (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
Environment
URL do ambiente de destino		 (Obrigatório) URL do ambiente de destino desta tarefa.
CatalogItemId
ID do item do catálogo a ser instalado		 (Obrigatório) O item do catálogo a ser instalado no ambiente de destino.
TargetEnvironmentUrl
URL do ambiente de destino		 (Obrigatório) A URL do ambiente de destino para instalação do item do catálogo (por exemplo, "https://YourOrg.crm.dynamics.com").
PollStatus
Verificar status da votação		 (Opcional) Vote para verificar o status da sua solicitação (true|false).

Parâmetros (instalação 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 Aprovação do catálogo

Envie a solicitação de aprovação do catalog.

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o ambiente para o qual você deseja carregar conteúdo (por exemplo, "https://powerappsbuildtools.crm.dynamics.com"). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
Environment
URL do ambiente de destino		 (Obrigatório) URL do ambiente de destino desta tarefa.
CatalogSubmissionFile
Arquivo de envio do catálogo		 (Obrigatório) Especifique o caminho e o nome do arquivo de envio do catálogo.
UsePackageSolutionZipFile
Tipo de arquivo		 Tipo de arquivo: pacote ou arquivo zip de solução.
SolutionZipFile
Nome do arquivo zip de solução		 Especifique o caminho e o nome do arquivo zip de solução.
PollStatus
Verificar status da votação		 (Opcional) Vote para verificar o status da sua solicitação (true|false).

Parâmetros (envio 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

Status da solicitação de catálogo

Obtenha o status da solicitação de instalação/envio do catálogo.

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para o SPN) Especifique PowerPlatformEnvironment para uma conexão de nome de usuário/senha ou PowerPlatformSPN para uma entidade de serviço/conexão do segredo do cliente.
PowerPlatformSPN
Entidade de serviço da Power Platform		 O ponto de extremidade de serviço para o ambiente para o qual você deseja carregar conteúdo (por exemplo, "https://powerappsbuildtools.crm.dynamics.com"). Definido em Conexões de serviço em Configurações do Projeto usando o tipo de conexão da Power Platform.
Environment
URL do ambiente de destino		 (Obrigatório) URL do ambiente de destino desta tarefa.
TrackingId
Solicitar ID de rastreamento		 (Obrigatório) Solicite a ID de rastreamento.
RequestType
Tipo de solicitação		 (Obrigatório) Tipo de solicitação. (Valores: Instalar | Enviar).

Parâmetros (status 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

Criar e liberar pipelines

Agora que identificamos o que pode ser feito usando as ferramentas de build, vamos ver como você pode aplicar essas ferramentas aos seus pipelines de build e versão. Uma visão geral conceitual é mostrada abaixo. Vamos ver alguns detalhes da implementação do pipeline usando as tarefas da ferramenta de compilação nas subseções a seguir.

Para saber mais sobre a criação desses pipelines e realmente fazer a criação prática de pipeline usando as build tools Microsoft Power Platform, conclua os laboratórios de build tools, que você pode baixar do GitHub.

Mais informações sobre Azure Pipelines: Usar Azure Pipelines

Pipeline de build: exportar de um ambiente de desenvolvimento (DEV)

A figura a seguir mostra as tarefas da ferramenta de build que você pode adicionar a um pipeline que exporta uma solução de um ambiente de desenvolvimento.

Exporte uma solução a partir de um DEV (ambiente de desenvolvimento).

Pipeline de build: compilar um solução gerenciada

A figura a seguir mostra as tarefas da ferramenta de build que você pode adicionar a um pipeline que compila uma solução gerenciada.

Compile uma solução gerenciada.

Pipeline de versão: implantar em um ambiente de produção (PROD)

A figura a seguir mostra as tarefas da ferramenta de build que você pode adicionar a um pipeline que implanta em um ambiente de produção.

Implante em um PROD (ambiente de produção).

Consulte Também

Microsoft Power Platform Ferramentas de construção para Azure DevOps