Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 compilaçã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 compilação e lançamento. Esta tarefa instala um conjunto de ferramentas específicas do Power Platform exigidas pelo agente para executar as tarefas de compilação 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 default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
displayName: 'Power Platform Tool Installer'
inputs:
AddToolsToPath: true
# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
displayName: 'Power Platform Tool Installer'
inputs:
DefaultVersion: false
XrmToolingPackageDeploymentVersion: 3.3.0.928
Parâmetros (instalador)
| Parâmetros | Descrição |
|---|---|
DefaultVersionUsar 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. |
AddToolsToPathAdicionar Ferramentas ao Caminho |
Adiciona o pac cli à variável de ambiente PATH. Permite que você use o pac cli em tarefas de script sem a necessidade de configurar o caminho manualmente. |
PowerAppsAdminVersionXrmToolingPackageDeploymentVersionMicrosoftPowerAppsCheckerVersionCrmSdkCoreToolsVersionVersão da ferramenta |
A versão específica da ferramenta a ser usada. |
Plataforma de Poder QuemSouEu
Verifica uma conexão de serviço do 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 |
|---|---|
authenticationTypeTipo 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. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
PowerPlatformEnvironmentURL 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. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
PowerPlatformSPNEntidade de Serviço 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. |
Verificação de qualidade
Na próxima seção, estão 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 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 |
|---|---|
PowerPlatformSPNConexão de serviço |
(Obrigatório) Uma conexão com um ambiente licenciado do Microsoft Power Platform precisa usar o verificador do Power Platform. As conexões de serviço são definidas nas Conexões de Serviço em Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Criação do Ambiente do Power PlatformObservaçã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 da entidade de serviço para ambientes do Power Platform. |
UseDefaultPACheckerEndpointUsar o ponto de extremidade do Verificador do Power Platform padrão |
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. |
CustomPACheckerEndpointPonto de extremidade da verificação de PAC personalizado |
Obrigatório quando UseDefaultPACheckerEndpoint é falso. Você pode especificar outra área geográfica ser usada, por exemplo https://japan.api.advisor.powerapps.com. Para obter uma lista das geografias disponíveis, consulte, consulte Usar a API do Verificador do Power Platform. |
FileLocationLocal 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. |
FilesToAnalyzeSasUriArquivos 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 (;). |
FilesToAnalyzeArquivos 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. |
FilesToExcludeArquivos 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 |
RulesToOverrideRegras 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"}] |
RuleSetConjunto de regras |
(Obrigatório) Especifique qual conjunto de regras será aplicado. Os dois conjuntos de regras a seguir estão disponíveis:
|
ErrorLevelNí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. |
ErrorThresholdLimite 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. |
FailOnPowerAppsCheckerAnalysisErrorFalha por erro |
Quando verdadeiro, há falha se a análise do verificador do Power Apps for retornada como Failed ou FinishedWithErrors. |
ArtifactDestinationNameNome 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.
Solução de Importaçã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
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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
PowerPlatformSPNEntidade de Serviço 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
SolutionInputFileArquivo de entrada da solução |
(Obrigatório) O caminho e o nome do arquivo zip da solução para importar no ambiente de destino (por exemplo, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).
Observação: 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. |
HoldingSolutionImportar 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. |
OverwriteUnmanagedCustomizationsSubstituir personalizações não gerenciadas |
Especifique se deseja substituir as personalizações não gerenciadas (verdadeiro|falso). |
SkipProductUpdateDependenciesIgnorar 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). |
ConvertToManagedConverter em gerenciado |
Obsoleto. O sistema converterá componentes de solução não gerenciada em gerenciada quando você importar uma solução gerenciada. |
AsyncOperationImportaçã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). |
MaxAsyncWaitTimeTempo 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. |
PublishWorkflowsAtivar 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). |
UseDeploymentSettingsFileUsar 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). |
DeploymentSettingsFileArquivo 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 |
|---|---|
ComponentIdID do componente da solução |
O nome do esquema ou a ID do componente para adicionar à solução de destino. |
ComponentTypeURL 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. |
SolutionUniqueNameNome do fornecedor da solução |
O nome exclusivo da solução. |
AddRequiredComponentsQuaisquer 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. |
EnvironmentURL 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 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
PowerPlatformSPNEntidade de Serviço 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
SolutionNameSolução nome |
(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. |
AsyncOperationAtualizaçã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. |
MaxAsyncWaitTimeTempo 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
Solução de Exportaçã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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
PowerPlatformSPNEntidade de Serviço 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
SolutionNameSolução nome |
(Obrigatório) O nome da solução a ser exportada. Sempre use a solução Nome, não seu Nome de Exibição. |
SolutionOutputFileArquivo 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 colocar os principais bits de dados em várias partes do seu pipeline. Consulte Usar variáveis predefinidas para obter uma lista abrangente. |
AsyncOperationExportaçã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. |
MaxAsyncWaitTimeTempo 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. |
ManagedExportar 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. |
ExportAutoNumberingSettingsExportar configurações de numeração automática |
Exporte configurações de numeração automática (verdadeiro|falso). |
ExportCalendarSettingsExportar configurações de calendário |
Exporte configurações de calendário (verdadeiro|falso). |
ExportCustomizationSettingsExportar configurações de personalização |
Exporte configurações de personalização (verdadeiro|falso). |
ExportEmailTrackingSettingsExportar configurações de acompanhamento de email |
Exporte configurações de acompanhamento de email (verdadeiro|falso). |
ExportGeneralSettingsExportar configurações gerais |
Exporte configurações gerais (verdadeiro|falso). |
ExportIsvConfigExportar configuração ISV |
Exporte configuração ISV (verdadeiro|falso). |
ExportMarketingSettingsExportar configurações de marketing |
Exporte configurações de marketing (verdadeiro|falso). |
ExportOutlookSynchronizationSettingsExportar configurações de sincronização do Outlook |
Exporte configurações de sincronização do Outlook (verdadeiro|falso). |
ExportRelationshipRolesExportar papéis de relacionamento |
Exporte papéis de relacionamento (verdadeiro|falso). |
ExportSalesExportar 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 |
|---|---|
SolutionInputFileArquivo de entrada da solução |
(Obrigatório) O caminho e o nome do arquivo solution.zip a ser descompactado. |
SolutionTargetFolderPasta de destino para descompactar a solução |
(Obrigatório) A pasta de caminho e destino na qual você deseja descompactar a solução. |
SolutionTypeTipo 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 |
|---|---|
SolutionOutputFileArquivo 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. |
SolutionSourceFolderPasta de origem da solução a ser compactada |
(Obrigatório) O caminho e a pasta de origem da solução a ser empacotada. |
SolutionTypeTipo 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. |
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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
PowerPlatformSPNEntidade de Serviço 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
SolutionNameSolução nome |
(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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
PowerPlatformSPNEntidade de Serviço 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
PowerPlatformSPNEntidade de Serviço 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
SolutionNameSolução nome |
(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. |
SolutionVersionNumberNú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 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 codificar 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 as variáveis PowerPlatformSetConnectionVariables.BuildTools.* para permitir que tarefas de script personalizadas acessem a conexão de serviço como uma fonte única de verificação.
As seguintes variáveis são definidas:
PowerPlatformSetConnectionVariables.BuildTools.TenantIdPowerPlatformSetConnectionVariables.BuildTools.ApplicationIdPowerPlatformSetConnectionVariables.BuildTools.ClientSecretPowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString
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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNEntidade de Serviço do 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
timeoutInMinutesTimeout |
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. |
retryCountOnTaskFailureNú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. |
ApplicationIdID 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). |
RedirectUriRedirecionar 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
PowerPlatformSPNEntidade de Serviço 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Ambiente de Criação do Power Platform |
PackageFileArquivo de pacote |
(Obrigatório) O caminho e o nome do arquivo do assembly de arquivos do pacote (.dll). |
MaxAsyncWaitTimeTempo 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ó poderá 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
PowerPlatformSPNEntidade de Serviço 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
DisplayNameDisplay name |
(Obrigatório) O nome para exibição do ambiente criado. |
LocationNameRegião da implantação |
(Obrigatório) A região na qual o ambiente deve ser criado. |
EnvironmentSkuTipo 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. |
AppsTemplateAplicativos |
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. |
CurrencyNameCurrency |
(Obrigatório) Moeda base para o ambiente criado. A moeda não pode ser atualizada após a criação do ambiente. |
LanguageNameLinguagem |
(Obrigatório) O idioma base no ambiente. |
DomainNameNome 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, a tarefa anexará um valor numérico ao nome do domínio, começando com 0. Para o exemplo acima, a URL pode passar a ser |
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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
PowerPlatformSPNEntidade de Serviço 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
Atribuir Usuário 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNEntidade de Serviço do 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
UserNome de usuário do Power Platform |
ID do objeto ou nome da entidade do usuário do Microsoft Entra a ser atribuído ao ambiente de destino. |
RoleNome ou ID do direito de acesso |
Nome ou ID do direito de acesso a ser atribuído ao usuário. |
ApplicationUserNome de usuário do aplicativo 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
PowerPlatformSPNEntidade de Serviço 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
Fazer Backup do 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
PowerPlatformSPNEntidade de Serviço 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
BackupLabelRó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'
SkipAuditData: true
MaxAsyncWaitTime: 60
Parâmetros (Copy-env)
| Parâmetros | Descrição |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
PowerPlatformSPNEntidade de Serviço 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
TargetEnvironmentUrlURL do ambiente de destino |
(Obrigatório) A URL do ambiente de destino para o qual você deseja copiar. |
CopyTypeTipo de cópia |
O tipo de cópia a ser executada: FullCopy ou MinimalCopy |
OverrideFriendlyNameSubstituir nome amigável |
Altere o nome amigável do ambiente de destino para outro nome (verdadeiro|falso). |
FriendlyNameNome amigável |
O nome amigável do ambiente de destino. |
SkipAuditDataSkipAuditData |
Se os dados de auditoria devem ser ignorados durante a operação de cópia. (verdadeiro|falso). |
MaxAsyncWaitTimeTempo 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. |
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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
PowerPlatformSPNEntidade de Serviço 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
RestoreLatestBackupÚltimo backup a ser restaurado |
Se deve restaurar o backup mais recente ou fornecer RestoreTimeStamp (true|false). |
RestoreTimeStampDateTime do backup |
DateTime do backup no formato "mm/dd/aaaa hh:mm" OU cadeia de caracteres "latest". |
TargetEnvironmentUrlURL do ambiente de destino |
(Obrigatório) A URL do ambiente de destino para o qual você deseja restaurar. |
FriendlyNameNome do ambiente restaurado |
(Opcional) Nome do ambiente restaurado. |
DisableAdminModeDesabilitar 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNEntidade de Serviço do 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
SchemaFileNome do arquivo XML de esquema |
Nome do arquivo XML de esquema. Pode ser criado usando a Configuration Migration Tool. |
DataFileNome do arquivo de dados |
Nome do arquivo para dados a serem exportados (arquivo zip). |
OverwriteSubstituiçã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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNEntidade de Serviço do 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
DataFileNome 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 do Power Pages Management
Tarefas para trabalhar com um site do Power Pages.
Baixar PAPortal do Power Platform
Baixar conteúdo do site do Power Pages do 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNEntidade de Serviço do 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
WebsiteIdID do site do portal |
ID do site do Power Pages a ser baixado. |
OverwriteSubstituição de conteúdo |
Conteúdo do site do Power Pages para substituição (true|false). |
ModelVersionModelo 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
Carregar 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNEntidade de Serviço do 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
UploadPathCarregar caminho do conteúdo |
Caminho de onde o conteúdo do site do Power Pages será carregado. |
ModelVersionModelo 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 e incluem o seguinte.
Nota
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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNEntidade de Serviço do 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
EnvironmentURL do ambiente de destino |
(Obrigatório) URL do ambiente de destino desta tarefa. |
CatalogItemIdID do item do catálogo a ser instalado |
(Obrigatório) O item do catálogo a ser instalado no ambiente de destino. |
TargetEnvironmentUrlURL 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"). |
PollStatusVerificar 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNEntidade de Serviço do 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
EnvironmentURL do ambiente de destino |
(Obrigatório) URL do ambiente de destino desta tarefa. |
CatalogSubmissionFileArquivo de envio do catálogo |
(Obrigatório) Especifique o caminho e o nome do arquivo de envio do catálogo. |
UsePackageSolutionZipFileTipo de arquivo |
Tipo de arquivo: pacote ou arquivo zip de solução. |
SolutionZipFileNome do arquivo zip de solução |
Especifique o caminho e o nome do arquivo zip de solução. |
PollStatusVerificar 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNEntidade de Serviço do 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 nas Configurações do Projeto usando o tipo de conexão do Power Platform. |
EnvironmentURL do ambiente de destino |
(Obrigatório) URL do ambiente de destino desta tarefa. |
TrackingIdSolicitar ID de rastreamento |
(Obrigatório) Solicite a ID de rastreamento. |
RequestTypeTipo 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 praticar a criação prática de pipeline usando as Build Tools do 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.
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.
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.