Tarefas das Ferramentas de compilação do Microsoft Power Platform

  • Artigo

As tarefas de compilação disponíveis são descritas nas secções seguintes. Mais adiante, demonstramos alguns Pipelines do Azure que tiram partido destas tarefas. Para obter informações sobre as ferramentas de compilação e como transferi-las, consulte Ferramentas de Compilação para Pipelines do Azure do Microsoft Power Platform.

Tarefa auxiliar

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

Instalador de Ferramentas do Power Platform

Esta tarefa tem de ser adicionada uma vez antes de quaisquer outras ferramentas do Power Platform Build Tools em pipelines de compilação e lançamento. Esta tarefa instala um conjunto de ferramentas específicas do Power Platform obrigatórias para o agente executar as tarefas de compilação do Microsoft Power Platform. Esta tarefa não necessita de qualquer configuração adicional depois de adicionada. Esta tarefa contém parâmetros para as versões específicas de cada uma das ferramentas que estão a ser instaladas.

Para se manter atualizado com as versões das ferramentas ao longo do tempo, certifique-se de que estes parâmetros correspondem às versões das ferramentas obrigatórias para o pipeline ser executado corretamente.

Fragmento YAML (Instalador)

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

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

Parâmetros (Instalador)

Parâmetros Descrição
DefaultVersion
Utilize versões de ferramentas predefinidas		 Configurar para verdadeiro para utilizar a versão padrão de todas as ferramentas, caso contrário, falso. Obrigatório (e falso) quando forem especificadas versões da ferramenta.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Versão da ferramenta		 A versão específica da ferramenta a usar.

Power Platform WhoAmI

Verifica uma ligação ao serviço de ambiente do Power Platform ao ligar fazer um pedido WhoAmI. Esta tarefa pode ser útil para incluir no início do pipeline, para verificar a conectividade antes de o processamento começar.

Fragmento YAML (WhoAmI)

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

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

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

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

Parâmetros (WhoAmI)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Opcional) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
PowerPlatformEnvironment
Power Platform URL do ambiente		 O ponto final de serviço para o ambiente estabelecer ligação. Definido em Ligações de serviço em Definições do projeto. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o ambiente estabelecer ligação. Definido em Ligações de serviço em Definições do projeto.

Verificação de qualidade

Na secção abaixo, encontram-se as tarefas disponíveis para verificar a qualidade de uma solução.

Verificador do Power Platform

Esta tarefa executa uma verificação de análise estática nas suas soluções tendo em conta um conjunto de regras de melhores práticas para identificar quaisquer padrões problemáticos que possa ter introduzido inadvertidamente ao compilar a sua solução.

Fragmento YAML (Verificador)

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

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

Parâmetros (Verificador)

Parâmetros Descrição
PowerPlatformSPN
Ligação ao Serviço		 (Obrigatório) É obrigatória uma ligação a um ambiente licenciado do Microsoft Power Platform para utilizar o verificador do Power Platform. As ligações de serviço são definidas em Ligações de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Power Platform Criar Ambiente

Nota: o Principal de Serviço e métodos de autenticação de nome de utilizador/palavra-passe estão disponíveis para a tarefa do verificador. Para obter mais informações sobre como configurar os principais de serviço a utilizar com esta tarefa, consulte Configurar as ligações dos principais do serviço para ambientes do Power Platform.
UseDefaultPACheckerEndpoint
Utilize ponto final de verificação Power Platform predefinido		 Por predefinição (true), a localização geográfica do serviço do verificador utiliza a mesma localização geográfica que o ambiente a que se liga.
CustomPACheckerEndpoint
Ponto final de verificação de PAC personalizado		 Obrigatório quando UseDefaultPACheckerEndpoint é falso. Pode especificar uma outra área geográfica a utilizar, por exemplo https://japan.api.advisor.powerapps.com. Para obter uma lista das localizações geográficas disponíveis, consulte Utilizar a API do Verificador do Power Platform.
FileLocation
Localização dos ficheiros a analisar		 Necessário ao referenciar um ficheiro a partir de um URL de assinatura de acesso partilhado (SAS) sasUriFile.

Nota: É importante referenciar um ficheiro de solução exportado e não os ficheiros de origem não empacotados no repositório. Tanto os ficheiros de solução geridos como os não geridos podem ser analisados.
FilesToAnalyzeSasUri
Ficheiros SAS para analisar		 Obrigatório quando FileLocation estiver definido para sasUriFile. Introduza o URI do SAS. Pode adicionar mais de um URI da SAS através de uma lista separada por vírgula (,) ou por ponto e vírgula (;).
FilesToAnalyze
Ficheiros locais para analisar		 Obrigatório quando os ficheiros SAS não são analisados. Especifique o caminho e o nome do ficheiro zip a analisar. É possível utilizar curingas. Por exemplo, introduza **\*.zip para todos os ficheiros zip em todas as subpastas.
FilesToExclude
Ficheiros locais para excluir		 Especifique os nomes dos ficheiros a excluir da análise. Se for mais do que uma, forneça através de uma lista separada por vírgula (,) ou ponto e vírgula (;). Esta lista pode incluir um nome de ficheiro completo ou um nome com wildcards principais ou de fuga, tais como *jquery ou form.js
RulesToOverride
Regras para anular		 Uma matriz JSON contendo regras e níveis para anular. Valores aceites 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 o conjunto de regras a aplicar. Os seguintes conjuntos de duas regras estão disponíveis:
  • Verificador de soluções: este conjunto de regras é o mesmo que é executado a partir do Power Apps Maker Portal.
  • AppSource: o conjunto de regras ampliado que é utilizado para certificar uma aplicação antes de poder ser publicado no AppSource.
ErrorLevel
Nível de Erro		 Combinado com o erro, o parâmetro de limiar define a gravidade dos erros e avisos que são permitidos. Os valores de limiar suportados são <level>IssueCount onde o nível=Crítico, Alto, Médio, Baixo e Informativo.
ErrorThreshold
Limiar de erro		 Define o número de erros (>=0) de um nível especificado que é permitido ao verificador passar as soluções que estão a ser verificadas.
FailOnPowerAppsCheckerAnalysisError
Falha no erro		 Quando verdade, falha se a análise do Verificador Power Apps for devolvida como Failed ou FinishedWithErrors.
ArtifactDestinationName
Nome do artefacto de DevOps		 Especificar o nome dos Artefactos do Azure para o ficheiro .sarif do verificador.

Tarefas de solução

Este conjunto de tarefas pode automatizar ações de solução. As tarefas de ambiente delineadas posteriormente nesta secção que criam, copiam ou restauram um ambiente sobrepõem-se às ligações de serviço com os ambientes recém-criados. Estas tarefas permitem executar tarefas de solução contra ambientes criados a pedido.

Power Platform - Importar Solução

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

Fragmento YAML (Importação)

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

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

Parâmetros (importação)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformEnvironment
Power Platform URL do ambiente		 O ponto final de serviço para o qual pretende importar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o qual pretende importar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
SolutionInputFile
Ficheiro de entrada da solução		 (Obrigatório) O caminho e o nome de ficheiro do ficheiro solution.zip a importar para o ambiente de destino para (por exemplo, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Nota: As variáveis fornecem-lhe uma forma conveniente de obter os bits chave de dados em várias partes do seu pipeline. Consulte Utilizar variáveis predefinidas para obter uma lista completa.
HoldingSolution
Importar como solução para guardar		 Um parâmetro avançado (true|false) utilizado quando uma solução precisa de 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 geridas		 Especificar se deve substituir personalizações não geridas (true|false).
SkipProductUpdateDependencies
Ignore as dependências de atualização do produto		 Especificar se a aplicação das dependências relacionadas com as atualizações do produto deve ser ignorada (true|false).
ConvertToManaged
Converter em gerido		 Especificar se importa como solução gerida (true|false).
AsyncOperation
Importação assíncrona		 Se selecionada (verdadeira), a operação de importação será realizada de forma assíncrona. Isto é recomendado para soluções maiores, uma vez que esta tarefa irá, caso contrário, automaticamente atingir o tempo limite após 4 minutos. Selecionar assíncronos vai sondar e esperar até que MaxAsyncWaitTime seja alcançado (true|false).
MaxAsyncWaitTime
Tempo máximo de espera		 Tempo máximo de espera em minutos para a operação assíncrona; o padrão é de 60 min (1 hr), o mesmo que o padrão Azure DevOps para tarefas.
PublishWorkflows
Ativar processos após a importação		 Especificar se quaisquer processos (fluxos de trabalho) na solução devem ser ativados após a importação (true|false).
UseDeploymentSettingsFile
Usar ficheiro de implementação de definições		 Os valores de referências de ligação e da variável de ambiente podem ser definidos utilizando um ficheiro de definições de implementação (true|false).
DeploymentSettingsFile
Ficheiro de definições de implementação		 (Obrigatório quando UseDeploymentSettingsFile=verdadeiro) O nome do caminho e do ficheiro do ficheiro de definições de implementação.

Power Platform Adicionar Componente da Solução

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

Fragmento 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 ou ID do esquema do componente a adicionar à solução de destino.
ComponentType
Power Platform URL do ambiente		 O valor que representa o componente da solução que está a adicionar. Consulte Usar tipos de componentes predefinidos para uma lista abrangente dos valores dos componentes.
SolutionUniqueName
Nome da solução		 Nome exclusivo da solução.
AddRequiredComponents
Quaisquer componentes obrigatórios de outra solução dependentes do componente da solução		 (Opcional) Indica se os outros componentes da solução que são obrigatórios para o componente da solução que está a adicionar também devem ser adicionados à solução não gerida.
Environment
URL ou ID do ambiente		 (Opcional) URL ou ID do ambiente de destino.

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

Atualiza uma solução que foi importada como uma solução para guardar.

Fragmento YAML (Atualização)

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

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

Parâmetros (Atualização)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformEnvironment
Power Platform URL do ambiente		 O serviço ponto final para o qual pretende atualizar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
PowerPlatformSPN
Power Platform Principal do serviço		 O serviço ponto final para o qual pretende atualizar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
SolutionName
Nome da solução		 (Obrigatório) O nome da solução para aplicar a atualização. Utilize sempre o Nome da solução e não o Nome a apresentar.
AsyncOperation
Atualização assíncrona		 Se selecionada (verdadeira), a operação de atualização será realizada como uma tarefa de lote assíncrona. Selecionar assíncronos vai sondar e esperar até que MaxAsyncWaitTime seja alcançado.
MaxAsyncWaitTime
Tempo máximo de espera		 Tempo máximo de espera em minutos para a operação assíncrona; o padrão é de 60 min (1 hr), o mesmo que o padrão Azure DevOps para tarefas.

Nota

As variáveis fornecem-lhe uma forma conveniente de obter os bits chave de dados em várias partes do seu pipeline. Consulte Utilizar variáveis predefinidas para obter uma lista completa. Pode pré-preencher informações de referências de ligação e de variáveis de ambiente para o ambiente de destino enquanto importa uma solução utilizando um ficheiro de definições de implementação.

Mais informações: Pré-preencher referências de ligação e variáveis de ambiente para implementações automatizadas

Power Platform - Exportar Solução

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

Fragmento YAML (Exportação)

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

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

Parâmetros (Exportação)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformEnvironment
Power Platform URL do ambiente		 O serviço ponto final para o qual pretende atualizar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
PowerPlatformSPN
Power Platform Principal do serviço		 O serviço ponto final para o qual pretende atualizar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
SolutionName
Nome da solução		 (Obrigatório) O nome da solução a exportar. Utilize sempre o Nome da solução e não o Nome a apresentar.
SolutionOutputFile
Ficheiro de saída da solução		 (Obrigatório) O caminho e o nome de ficheiro do ficheiro solution.zip a exportar para o ambiente de origem para (por exemplo, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Nota: As variáveis fornecem-lhe uma forma conveniente de obter os bits chave de dados em várias partes do seu pipeline. Consulte Utilizar variáveis predefinidas para obter uma lista completa.
AsyncOperation
Exportação assíncrona		 Se selecionada (verdadeira), a operação de exportação será realizada como uma tarefa de lote assíncrona. Selecionar assíncronos vai sondar e esperar até que MaxAsyncWaitTime seja alcançado.
MaxAsyncWaitTime
Tempo máximo de espera		 Tempo máximo de espera em minutos para a operação assíncrona; o padrão é de 60 min (1 hr), o mesmo que o padrão Azure DevOps para tarefas.
Managed
Exportar como gerido		 Se for selecionada (verdadeira), exporte a solução como solução gerida; caso contrário exporte como solução não gerida.
ExportAutoNumberingSettings
Exportar definições de numeração automática		 Exportar definições de numeração automática (true|false).
ExportCalendarSettings
Exportar definições de calendário		 Exportar definições de calendário (true|false).
ExportCustomizationSettings
Exportar definições de personalização		 Exportar definições de personalização (true|false).
ExportEmailTrackingSettings
Exportar definições de deteção de movimentos de e-mail		 Exportar configurações de deteção de movimentos de e-mail (true|false).
ExportGeneralSettings
Exportar definições gerais		 Exportar definições gerais (true|false).
ExportIsvConfig
Exportar configuração ISV		 Exportar configuração ISV (true|false).
ExportMarketingSettings
Exportar definições de marketing		 Exportar definições de marketing (true|false).
ExportOutlookSynchronizationSettings
Exportar definições de sincronização do Outlook		 Exportar definições de sincronização do Outlook (true|false).
ExportRelationshipRoles
Exportar funções de relação		 Exportar funções de relação (true|false).
ExportSales
Exportar vendas		 Exportar vendas (true|false).

Power Platform - Desempacotar Solução

Leva um ficheiro de solução comprimido e decompõe-no em vários ficheiros XML, para que estes ficheiros possam ser lidos e geridos mais facilmente por um sistema de controlo de origem.

Fragmento YAML (Desembalar)

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

Parâmetros (Desembalar)

Parâmetros Descrição
SolutionInputFile
Ficheiro de entrada da solução		 (Obrigatório) O caminho e o nome do ficheiro solution.zip a descompactar.
SolutionTargetFolder
Pasta de destino para a solução desempacotar		 (Obrigatório) O caminho e a pasta de destino para as quais pretende descompactar a solução.
SolutionType
Tipo de solução		 (Obrigatório) O tipo de solução que pretende descompactar. As opções incluem: Não gerido (recomendado), Gerido e Ambos.

Power Platform - Empacotar Solução

Compacta uma solução representada no controlo de origem num ficheiro . zip de solução que pode ser importado para outro ambiente.

Fragmento YAML (Embalar)

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

Parâmetros (Embalar)

Parâmetros Descrição
SolutionOutputFile
Ficheiro de saída da solução		 (Obrigatório) O caminho e o nome de ficheiro do ficheiro solution.zip onde compactar a solução.
SolutionSourceFolder
Pasta de origem da solução a empacotar		 (Obrigatório) O caminho e a pasta de origem da solução a compactar.
SolutionType
Tipo de solução		 (Obrigatório) O tipo de solução que pretende compactar. As opções incluem: Gerido (recomendado), Não gerido e Ambos.

Eliminar a Solução do Power Platform

Elimina uma solução no ambiente de destino.

Fragmento YAML (Eliminar)

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

Parâmetros (Eliminar)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformEnvironment
Power Platform URL do ambiente		 O ponto final de serviço do qual pretende eliminar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço do qual pretende eliminar a solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
SolutionName
Nome da solução		 (Obrigatório) O nome da solução a eliminar. Utilize sempre o Nome da solução e não o Nome a apresentar.

Power Platform - Publicar Personalizações

Publica todas as personalizações num ambiente.

Fragmento YAML (Publicar)

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

Parâmetros (Publicar)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformEnvironment
Power Platform URL do ambiente		 O ponto final de serviço para o qual pretende publicar as personalizações (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o qual pretende publicar as personalizações (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform

Power Platform - Definir Versão da Solução

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

Fragmento YAML (Versão)

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

Parâmetros (versão)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformEnvironment
Power Platform URL do ambiente		 O ponto final de serviço que pretende que defina a versão da solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço que pretende que defina a versão da solução (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
SolutionName
Nome da solução		 (Obrigatório) O nome da solução para definir a versão. Utilize sempre o Nome da solução e não o Nome a apresentar.
SolutionVersionNumber
Número de versão da solução		 (Obrigatório) Número de versão que pretende definir.

Embora o número de versão possa ser codificado no pipeline, recomenda-se a utilização de uma variável de pipeline do Azure DevOps como BuildId. Isto fornece opções para definir a forma exata do número da versão no separador "Opções", por exemplo: $(Ano:aaaa)-$(Mês:MM)-$(Dia:dd)-$(rev:rr)-3

Esta definição pode então ser utilizada na tarefa Definir Versão de Solução, definindo a propriedade de Número de Versão com: $(Build.BuildId) em vez de codificar 20200824.0.0.2.

Alternativamente, um script de tarefas em linha powershell $(Get-Date -Format yyyy.MM.dd.HHmm) definido para 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 Ligação do Power Platform

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

Fragmento 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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o qual pretende definir as variáveis de ligação. Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
timeoutInMinutes
Limite de tempo excedido		 Especifica o tempo máximo, em minutos, que uma tarefa tem permissão para ser executada antes de ser cancelada pelo servidor. Um valor zero indica um tempo limite infinito.
retryCountOnTaskFailure
Número de repetições se a tarefa falhou		 Especifica o número de repetições para esta tarefa que irão ocorrer em caso de falha da tarefa. Não suportado para tarefas sem agente.
ApplicationId
ID da Aplicação para início de sessão		 (Obrigatório para nome de utilizador/palavra-passe) ID da Aplicação a utilizar para iniciar sessão (Consulte a nota adicional abaixo).
RedirectUri
URI de redirecionamento da aplicação especificada		 (Obrigatório para nome de utilizador/palavra-passe) URI de redirecionamento da aplicação especificada. Necessário ao especificar um ID de Aplicação. (Consulte a nota adicional abaixo).

Nota

Quando utilizar o tipo de autenticação de nome de utilizador/palavra-passe, o ID da Aplicação e o URI de Redirecionamento serão obrigatórios. Este documento de OAuth de autenticação tem uma explicação do motivo pelo qual necessita de criar um registo de aplicação para autenticação com o Dataverse. Quando liga através da autenticação de nome de utilizador/palavra-passe, a ligação comporta-se como uma aplicação que se liga em nome de um utilizador ao Dataverse.

Power Platform - Implementar Pacote

Implementa um pacote para um ambiente. A implementação de um pacote, em oposição a um único ficheiro de solução, fornece uma opção de implementar várias soluções, dados e código num ambiente.

Fragmento YAML (Implementação)

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

Parâmetros (Implementar)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformEnvironment
Power Platform URL do ambiente		 O ponto final de serviço para o qual pretende implementar o pacote (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o qual pretende implementar o pacote (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform. Para obter mais informações, consulte BuildTools.EnvironmentUrl em Criar ambiente Power Platform
PackageFile
Ficheiro do pacote		 (Obrigatório) O caminho e o nome do ficheiro da montagem do ficheiro 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 é de 60 min (1 hr), o mesmo que o padrão Azure DevOps para tarefas.

tarefas de gestão do ambiente

Automatize as tarefas comuns de Gestão do Ciclo de Vida do Ambiente (ELM).

Power Platform - Criar Ambiente

Cria um novo ambiente. Criar um novo ambiente também cria BuildTools.EnvironmentUrl automaticamente.

Importante

Quando definido, BuildTools.EnvironmentUrl será utilizado como a ligação de serviço predefinida para tarefas subsequentes no pipeline. Cada tarefa descrita neste artigo utiliza apenas o ponto final da ligação de serviço quando BuildTools.EnvironmentUrl não está definido.

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

Fragmento YAML (Create-env)

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

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

Parâmetros (Create-env)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformEnvironment
Power Platform URL do ambiente		 O ponto final de serviço que pretende que crie o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço que pretende que crie o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
DisplayName
Nome a apresentar		 (Obrigatório) O nome a apresentar do ambiente criado.
LocationName
Região de Implementação		 (Obrigatório) A região em que o ambiente deve ser criado.
EnvironmentSku
Tipo de ambiente		 (Obrigatório) O tipo de instância a implementar. As opções são Sandbox, Production, Trial e SubscriptionBasedTrial.
AppsTemplate
Aplicações		 Para um tipo de ambiente não experimental, as aplicações suportadas são D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation e D365_Sales.
CurrencyName
Moeda		 (Obrigatório) Moeda base para o ambiente criado. A moeda não pode ser atualizada após a criação do ambiente.
LanguageName
Language		 (Obrigatório) O idioma base no ambiente.
DomainName
Nome do Domínio		 (Obrigatório) Esta é a cadeia específica do ambiente que faz parte do URL. Por exemplo, para um ambiente com o seguinte URL: https://powerappsbuildtasks.crm.dynamics.com/, o nome do domínio seria "powerappsbuildtasks".

Nota: Se introduzir um nome de domínio que já esteja em utilização, a tarefa acrescentará um valor numérico ao nome do domínio, começando com 0. Para o exemplo acima, o URL poderá tornar-se https://powerappsbuildtasks0.crm.dynamics.com/.

Power Platform - Eliminar Ambiente

Elimina um ambiente.

Fragmento YAML (Delete-env)

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

Parâmetros (Delete-env)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformEnvironment
Power Platform URL do ambiente		 O ponto final de serviço que pretende que elimine o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço que pretende que elimine o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.

Atribuir Utilizador do Power Platform

Atribuir um utilizador a um ambiente de destino com o direito de acesso especificado.

Fragmento 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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o ambiente para o qual pretende atribuir o utilizador (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
User
Nome de utilizador do Power Platform		 ID do objeto do Microsoft Entra ou o nome principal do utilizador a atribuir ao ambiente de destino.
Role
Nome ou ID do direito de acesso		 Nome ou ID do direito de acesso a ser atribuído ao utilizador.
ApplicationUser
Nome de utilizador da aplicação do Power Platform		 Especifica se o utilizador de entrada é um utilizador de aplicação (true|false).

Repor Ambiente do Power Platform

Repõe um ambiente.

Fragmento 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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformEnvironment
Power Platform URL do ambiente		 O ponto final de serviço que pretende que reponha o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço que pretende que reponha o ambiente (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.

Power Platform - Fazer Cópia de Segurança do Ambiente

Faz uma cópia de segurança de um ambiente.

Fragmento YAML (Backup-env)

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

Parâmetros (Backup-env)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformEnvironment
Power Platform URL do ambiente		 O ponto final de serviço de cujo ambiente pretende efetuar uma cópia de segurança (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço de cujo ambiente pretende efetuar uma cópia de segurança (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
BackupLabel
Etiqueta de cópia de segurança		 (Obrigatório) A etiqueta a atribuir à cópia de segurança.

Power Platform - Copiar Ambiente

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

Fragmento YAML (Copy-env)

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

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

Parâmetros (Copy-env)

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformEnvironment
Power Platform URL do ambiente		 O ponto final de serviço para o ambiente de origem a partir do qual pretende copiar (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o ambiente de origem a partir do qual pretende copiar (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
TargetEnvironmentUrl
URL do ambiente de destino		 (Obrigatório) O URL para o ambiente de destino para onde pretende copiar.
CopyType
Tipo de cópia		 O tipo de cópia a realizar: FullCopy ou MinimalCopy
OverrideFriendlyName
Substituir nome amigável		 Alterar o nome amigável do ambiente de destino para outro nome (true|false).
FriendlyName
Nome amigável		 O nome amigável do ambiente alvo.
DisableAdminMode
Desativar modo de administração		 Desativar ou não o modo de administração (true|false).

Restaurar Ambiente do Power Platform

Restaura um ambiente para uma cópia de segurança indicada.

Fragmento 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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformEnvironment
Power Platform URL do ambiente		 O ponto final de serviço para o ambiente de origem a partir do qual pretende restaurar (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o ambiente de origem a partir do qual pretende restaurar (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
RestoreLatestBackup
Cópia de segurança mais recente a restaurar		 Se restaura a cópia de segurança mais recente ou fornece RestoreTimeStamp (true|false).
RestoreTimeStamp
DateTime da cópia de segurança		 DataTime da cópia de segurança no formato "mm/dd/aaaa hh:mm" ou cadeia "latest".
TargetEnvironmentUrl
URL do ambiente de destino		 (Obrigatório) O URL para o ambiente de destino para onde pretende restaurar.
FriendlyName
Nome do ambiente restaurado		 (Opcional) Nome do ambiente restaurado.
DisableAdminMode
Desativar modo de administração		 Desativar ou não o modo de administração (true|false).

Exportar Dados do Dataverse

Exportar dados de um ambiente com o esquema fornecido.

Fragmento 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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o ambiente a partir do qual pretende exportar dados (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
SchemaFile
Nome do ficheiro de esquema XML		 Nome do ficheiro de esquema XML. Pode ser criado utilizando a ferramenta de Migração de Configuração.
DataFile
Nome do ficheiro de dados		 Nome do ficheiro para dados a exportar (ficheiro zip).
Overwrite
Substituir conteúdo		 Conteúdo de site do Power Pages a substituir (true|false).

Importar Dados do Dataverse

Importar dados para um ambiente.

Fragmento 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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o ambiente a partir do qual pretende importar dados (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
DataFile
Nome do ficheiro de dados		 Nome do ficheiro do ficheiro de dados comprimidos zip a importar ou a pasta com data-schema.xml e data.xml a importar.

Tarefas de gestão do Power Pages

Tarefas para trabalhar com um site do Power Pages.

PAPortal de Transferência do Power Platform

Transferir conteúdo do site do Power Pages a partir do ambiente do Dataverse atual.

Fragmento snippet (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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o ambiente a partir do qual pretende transferir conteúdo (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
WebsiteId
ID do site do portal		 ID do site do Power Pages a transferir.
Overwrite
Substituir conteúdo		 Conteúdo de site do Power Pages a substituir (true|false).
ModelVersion
Modelo de Dados de Site		 Indica se os dados do site a carregar utilizarão o modelo de dados padrão (1) ou o modelo de dados avançado (2). O valor predefinido é "1".

PAPortal de Carregamento do Power Platform

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

Fragmento snippet (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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o ambiente para o qual pretende carregar conteúdo (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
UploadPath
Caminho do conteúdo a carregar		 Caminho a partir do qual o conteúdo do site do Power Pages será carregado.
ModelVersion
Modelo de Dados de Site		 Indica se os dados do site a carregar utilizarão o modelo de dados padrão (1) ou o modelo de dados avançado (2). O valor predefinido é "1".

Catálogo para tarefas do Power Platform (pré-visualização)

Estas tarefas executam ações contra o catálogo no Power Platform e incluem as seguintes.

Nota

Atualmente, as tarefas do catálogo para o Power Platform são uma versão de pré-visualização.

Instalar item do catálogo

Instalar um item do catalog no ambiente de destino.

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o ambiente para o qual pretende carregar conteúdo (por exemplo, https://powerappsbuildtools.crm.dynamics.com). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
Environment
URL do ambiente de destino		 (Obrigatório) URL do ambiente visado por esta tarefa.
CatalogItemId
ID do Item do Catálogo a instalar		 (Obrigatório) Item de catálogo a ser instalado no ambiente de destino.
TargetEnvironmentUrl
URL do ambiente de destino		 (Obrigatório) O URL do ambiente de destino para instalação de itens do catálogo (por exemplo, "https://YourOrg.crm.dynamics.com").
PollStatus
Verificar estado do inquérito		 (Opcional) Inquérito para verificar o estado do seu pedido (true|false).

Parâmetros (catalog-install)

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

Submeter aprovação do Catálogo

Submeter pedido de aprovação do catalog.

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o ambiente para o qual pretende carregar conteúdo (por exemplo, "https://powerappsbuildtools.crm.dynamics.com"). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
Environment
URL do ambiente de destino		 (Obrigatório) URL do ambiente visado por esta tarefa.
CatalogSubmissionFile
Ficheiro de submissão do catálogo		 (Obrigatório) Especifique o caminho e o nome do ficheiro do ficheiro de submissão do catálogo.
UsePackageSolutionZipFile
Tipo de ficheiro		 Tipo de ficheiro: ficheiro zip do pacote ou da solução.
SolutionZipFile
Nome do ficheiro zip da solução		 Especifique o caminho e o nome do ficheiro zip da solução.
PollStatus
Verificar estado do inquérito		 (Opcional) Inquérito para verificar o estado do seu pedido (true|false).

Parâmetros (catalog-submit)

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 do pedido do catálogo

Obter o estado do pedido de instalação/submissão do catálogo.

Parâmetros Descrição
authenticationType
Tipo de autenticação		 (Obrigatório para SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente.
PowerPlatformSPN
Power Platform Principal do serviço		 O ponto final de serviço para o ambiente para o qual pretende carregar conteúdo (por exemplo, "https://powerappsbuildtools.crm.dynamics.com"). Definido em Conexões de Serviço em Definições de Projeto utilizando o tipo de ligação Power Platform.
Environment
URL do ambiente de destino		 (Obrigatório) URL do ambiente visado por esta tarefa.
TrackingId
ID de monitorização do pedido		 (Obrigatório) ID de monitorização do pedido.
RequestType
Tipo de pedido		 (Obrigatório) Tipo de pedido. (Valores: Instalar | Submeter).

Parâmetros (catalog-status)

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

Compilar e publicar pipelines

Agora que identificámos o que pode ser feito através das ferramentas de compilação, veremos como poderá aplicar estas ferramentas aos seus pipelines de compilação e publicação. É apresentada uma descrição geral conceptual abaixo. Vejamos alguns detalhes da implementação de pipelines utilizando as tarefas da ferramenta de compilação nas subsecções seguintes.

Para obter mais informações sobre como criar estes pipelines e efetuar a criação de pipeline através das Ferramentas de Compilação do Microsoft Power Platform, conclua os laboratórios das ferramentas de compilação, que pode transferir do GitHub.

Mais informações sobre Pipelines do Azure: Utilizar Pipelines do Azure

Criar pipeline: exportar uma solução a partir de um ambiente de desenvolvimento (DEV)

A figura seguinte mostra as tarefas da ferramenta de compilação que poderá adicionar a um pipeline que exporta uma solução de um ambiente de desenvolvimento.

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

Pipeline de compilação: compilar uma solução gerida

A figura seguinte mostra as tarefas da ferramenta de compilação que poderá adicionar a um pipeline que compila uma solução gerida.

Compilar uma solução gerida.

Canal de lançamento: implementar num ambiente de produção (PROD)

A figura seguinte mostra as tarefas da ferramenta de compilação que poderá adicionar a um pipeline que implementa um ambiente de produção.

Implementar num ambiente de produção (PROD).

Consulte também

Microsoft Power Platform Build Tools para Azure DevOps