Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 Microsoft Power Platform Build Tools para Pipelines do Azure.
Tarefa auxiliar
As tarefas do auxiliar disponíveis são descritas a seguir.
Programa de Instalação de Ferramentas do Power Platform
Esta tarefa deve ser adicionada uma vez antes de quaisquer outras tarefas do Power Platform Build Tools nos pipelines de compilação e lançamento. Esta tarefa instala um conjunto de ferramentas específicas do Power Platform necessárias ao agente para 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@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 |
|---|---|
DefaultVersionUtilize 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. |
AddToolsToPathAdicionar ferramentas ao PATH |
Adiciona a pac cli à PATH variável de ambiente. Permite que você use pac cli a partir de tarefas de script sem a necessidade de configurar o caminho manualmente. |
PowerAppsAdminVersionXrmToolingPackageDeploymentVersionMicrosoftPowerAppsCheckerVersionCrmSdkCoreToolsVersionVersão da ferramenta |
A versão específica da ferramenta a usar. |
Plataforma de energia WhoAmI
Verifica uma ligação ao serviço de ambiente do Power Platform ao ligar e 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@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 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 Criação de ambiente Power Platform |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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 Criação de ambiente Power Platform |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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@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 |
|---|---|
PowerPlatformSPNLigaçã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 do Power Platform. Mais informações: consulte BuildTools.EnvironmentUrl em Criação de ambiente Power PlatformNota: 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. |
UseDefaultPACheckerEndpointUtilizar ponto final do Verificador do 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. |
CustomPACheckerEndpointPonto 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. |
FileLocationLocalizaçã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. |
FilesToAnalyzeSasUriFicheiros 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 (;). |
FilesToAnalyzeFicheiros 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. |
FilesToExcludeFicheiros 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 |
RulesToOverrideRegras 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"}] |
RuleSetConjunto de regras |
(Obrigatório) Especifique o conjunto de regras a aplicar. Os seguintes conjuntos de duas regras estão disponíveis:
|
ErrorLevelNí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. |
ErrorThresholdLimiar 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. |
FailOnPowerAppsCheckerAnalysisErrorFalha no erro |
Quando verdade, falha se a análise do Verificador do Power Apps for devolvida como Failed ou FinishedWithErrors. |
ArtifactDestinationNameNome 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.
Solução de importação do Power Platform
Importa uma solução para um ambiente de destino.
Fragmento 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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente. |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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 Criação de ambiente Power Platform |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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 Criação de ambiente Power Platform |
SolutionInputFileFicheiro de entrada da solução |
(Obrigatório) O caminho e o nome de ficheiro do ficheiro zip. da solução a importar para o ambiente de destino (por exemplo, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).
Nota: As variáveis oferecem uma maneira conveniente de obter bits chave de dados em várias partes do seu pipeline. Consulte Utilizar variáveis predefinidas para obter uma lista completa. |
HoldingSolutionImportar 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. |
OverwriteUnmanagedCustomizationsSubstituir personalizações não geridas |
Especificar se deve substituir personalizações não geridas (true|false). |
SkipProductUpdateDependenciesIgnore 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). |
ConvertToManagedConverter em gerido |
Obsoleto. O sistema converterá componentes de solução não gerida em gerida quando importar uma solução gerida. |
AsyncOperationImportaçã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). |
MaxAsyncWaitTimeTempo máximo de espera |
Tempo máximo de espera em minutos para a operação assíncrona; a predefinição é de 60 min (1 hr), o mesmo que a predefinição de Azure DevOps para tarefas. |
PublishWorkflowsAtivar 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). |
UseDeploymentSettingsFileUsar 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). |
DeploymentSettingsFileFicheiro 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. |
Adicionar Componente da Solução do Power Platform
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 |
|---|---|
ComponentIdID do componente da solução |
O nome ou ID do esquema do componente a adicionar à solução de destino. |
ComponentTypeURL de ambiente do Power Platform |
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. |
SolutionUniqueNameNome da solução |
Nome exclusivo da solução. |
AddRequiredComponentsQuaisquer 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. |
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 para guardar.
Fragmento 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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente. |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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 Criação de ambiente Power Platform |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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 Criação de ambiente Power Platform |
SolutionNameNome 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. |
AsyncOperationAtualizaçã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. |
MaxAsyncWaitTimeTempo máximo de espera |
Tempo máximo de espera em minutos para a operação assíncrona; a predefinição é de 60 min (1 hr), o mesmo que a predefinição de 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
Solução de Exportação do Power Platform
Exporta uma solução de um ambiente de origem.
Fragmento 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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente. |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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 Criação de ambiente Power Platform |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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 Criação de ambiente Power Platform |
SolutionNameNome 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. |
SolutionOutputFileFicheiro de saída da solução |
(Obrigatório) O caminho e o nome de ficheiro do ficheiro zip. da solução para exportar o ambiente de origem (por exemplo, $(Build.ArtifactStagingDirectory)$(SolutionName).zip ).
Nota: As variáveis oferecem uma maneira conveniente de obter bits chave de dados em várias partes do seu pipeline. Consulte Utilizar variáveis predefinidas para obter uma lista completa. |
AsyncOperationExportaçã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. |
MaxAsyncWaitTimeTempo máximo de espera |
Tempo máximo de espera em minutos para a operação assíncrona; a predefinição é de 60 min (1 hr), o mesmo que a predefinição de Azure DevOps para tarefas. |
ManagedExportar como gerido |
Se for selecionada (verdadeira), exporte a solução como solução gerida; caso contrário exporte como solução não gerida. |
ExportAutoNumberingSettingsExportar definições de numeração automática |
Exportar definições de numeração automática (true|false). |
ExportCalendarSettingsExportar definições de calendário |
Exportar definições de calendário (true|false). |
ExportCustomizationSettingsExportar definições de personalização |
Exportar definições de personalização (true|false). |
ExportEmailTrackingSettingsExportar definições de deteção de movimentos de e-mail |
Exportar configurações de deteção de movimentos de e-mail (true|false). |
ExportGeneralSettingsExportar definições gerais |
Exportar definições gerais (true|false). |
ExportIsvConfigExportar configuração ISV |
Exportar configuração ISV (true|false). |
ExportMarketingSettingsExportar definições de marketing |
Exportar definições de marketing (true|false). |
ExportOutlookSynchronizationSettingsExportar definições de sincronização do Outlook |
Exportar definições de sincronização do Outlook (true|false). |
ExportRelationshipRolesExportar funções de relação |
Exportar funções de relação (true|false). |
ExportSalesExportar vendas |
Exportar vendas (true|false). |
Desempacotar Solução do Power Platform
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@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 (Desembalar)
| Parâmetros | Descrição |
|---|---|
SolutionInputFileFicheiro de entrada da solução |
(Obrigatório) O caminho e o nome do ficheiro solution.zip a descompactar. |
SolutionTargetFolderPasta de destino para a solução desempacotar |
(Obrigatório) O caminho e a pasta de destino para as quais pretende descompactar a solução. |
SolutionTypeTipo de solução |
(Obrigatório) O tipo de solução que pretende descompactar. As opções incluem: Não gerido (recomendado), Gerido e Ambos. |
Empacotar Solução do Power Platform
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@2
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 |
|---|---|
SolutionOutputFileFicheiro de saída da solução |
(Obrigatório) O caminho e o nome de ficheiro do ficheiro solution.zip onde compactar a solução. |
SolutionSourceFolderPasta de origem da solução a empacotar |
(Obrigatório) O caminho e a pasta de origem da solução a compactar. |
SolutionTypeTipo 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 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@2
displayName: 'Power Platform Delete Solution '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
Parâmetros (Eliminar)
| Parâmetros | Descrição |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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 Criação de ambiente Power Platform |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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 Criação de ambiente Power Platform |
SolutionNameNome 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. |
Publicar Personalizações do Power Platform
Publica todas as personalizações num ambiente.
Fragmento YAML (Publicar)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.publish-customizations.PowerPlatformPublishCustomizations@2
displayName: 'Power Platform Publish Customizations '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
Parâmetros (Publicar)
| Parâmetros | Descrição |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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 Criação de ambiente Power Platform |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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 Criação de ambiente Power Platform |
Definir Versão da Solução Power Platform
Atualiza a versão de uma solução.
Fragmento 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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente. |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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 Criação de ambiente Power Platform |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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 Criação de ambiente Power Platform |
SolutionNameNome 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. |
SolutionVersionNumberNú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 PowerPlatformSetConnectionVariables.BuildTools.* para fornecer acesso a tarefas de script personalizadas para usar ligação de serviço como uma única fonte de verdade.
As seguintes variáveis são definidas:
PowerPlatformSetConnectionVariables.BuildTools.TenantIdPowerPlatformSetConnectionVariables.BuildTools.ApplicationIdPowerPlatformSetConnectionVariables.BuildTools.ClientSecretPowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString
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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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 Criação de ambiente Power Platform |
timeoutInMinutesLimite 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. |
retryCountOnTaskFailureNú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. |
ApplicationIdID 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). |
RedirectUriURI 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.
Implementar Pacote do Power Platform
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@2
displayName: 'Power Platform Deploy Package '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
PackageFile: 'C:\Users\Public\package.dll'
MaxAsyncWaitTime: 120
Parâmetros (Implementar)
| Parâmetros | Descrição |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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 Criação de ambiente Power Platform |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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 Criação de ambiente Power Platform |
PackageFileFicheiro do pacote |
(Obrigatório) O caminho e o nome do ficheiro da montagem do ficheiro do pacote (.dll). |
MaxAsyncWaitTimeTempo máximo de espera |
Tempo máximo de espera em minutos para a operação assíncrona; a predefinição é de 60 min (1 hr), o mesmo que a predefinição de Azure DevOps para tarefas. |
tarefas de gestão do ambiente
Automatize as tarefas comuns de Gestão do Ciclo de Vida do Ambiente (ELM).
Criar Ambiente do Power Platform
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@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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente. |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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. |
DisplayNameNome a apresentar |
(Obrigatório) O nome a apresentar do ambiente criado. |
LocationNameRegião de Implementação |
(Obrigatório) A região em que o ambiente deve ser criado. |
EnvironmentSkuTipo de ambiente |
(Obrigatório) O tipo de instância a implementar. As opções são Sandbox, Production, Trial e SubscriptionBasedTrial. |
AppsTemplateAplicações |
Para um tipo de ambiente não experimental, as aplicações suportadas são D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation e D365_Sales. |
CurrencyNameMoeda |
(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) 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 |
Eliminar Ambiente do Power Platform
Elimina um ambiente.
Fragmento YAML (Delete-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@2
displayName: 'Power Platform Delete Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
Parâmetros (Delete-env)
| Parâmetros | Descrição |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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. |
UserNome de utilizador do Power Platform |
ID do objeto do Microsoft Entra ou o nome do principal do utilizador a atribuir ao ambiente de destino. |
RoleNome ou ID do direito de acesso |
Nome ou ID do direito de acesso a ser atribuído ao utilizador. |
ApplicationUserNome de utilizador da aplicação 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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. |
Fazer Cópia de Segurança do Ambiente do Power Platform
Faz uma cópia de segurança de um ambiente.
Fragmento YAML (Backup-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.backup-environment.PowerPlatformBackupEnvironment@2
displayName: 'Power Platform Backup Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
BackupLabel: 'Full backup - $(Build.BuildNumber)'
Parâmetros (Backup-env)
| Parâmetros | Descrição |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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. |
BackupLabelEtiqueta de cópia de segurança |
(Obrigatório) A etiqueta a atribuir à cópia de segurança. |
Copiar Ambiente do Power Platform
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@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 SPN) Especifique o PowerPlatformEnvironment para uma ligação username/password ou PowerPlatformSPN para uma ligação do serviço Principal/Segredo do Cliente. |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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. |
TargetEnvironmentUrlURL do ambiente de destino |
(Obrigatório) O URL para o ambiente de destino para onde pretende copiar. |
CopyTypeTipo de cópia |
O tipo de cópia a realizar: FullCopy ou MinimalCopy |
OverrideFriendlyNameSubstituir nome amigável |
Alterar o nome amigável do ambiente de destino para outro nome (true|false). |
FriendlyNameNome amigável |
O nome amigável do ambiente alvo. |
SkipAuditDataSkipAuditData |
Se os dados de auditoria devem ser ignorados durante a operação de cópia. (true|false). |
MaxAsyncWaitTimeTempo máximo de espera |
Tempo máximo de espera em minutos para a operação assíncrona; a predefinição é de 60 min (1 hr), o mesmo que a predefinição de Azure DevOps para tarefas. |
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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformEnvironmentURL de ambiente do Power Platform |
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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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. |
RestoreLatestBackupCópia de segurança mais recente a restaurar |
Se restaura a cópia de segurança mais recente ou fornece RestoreTimeStamp (true|false). |
RestoreTimeStampDateTime da cópia de segurança |
DataTime da cópia de segurança no formato "mm/dd/aaaa hh:mm" ou cadeia "latest". |
TargetEnvironmentUrlURL do ambiente de destino |
(Obrigatório) O URL para o ambiente de destino para onde pretende restaurar. |
FriendlyNameNome do ambiente restaurado |
(Opcional) Nome do ambiente restaurado. |
DisableAdminModeDesativar 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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. |
SchemaFileNome do ficheiro de esquema XML |
Nome do ficheiro de esquema XML. Pode ser criado utilizando a Configuration Migration Tool. |
DataFileNome do ficheiro de dados |
Nome do ficheiro para dados a exportar (ficheiro zip). |
OverwriteSubstituir 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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. |
DataFileNome do ficheiro de dados |
Nome do ficheiro de dados comprimidos zip a importar ou a pasta com data-schema.xml e data.xml a importar. |
Tarefas do Power Pages Management
Tarefas para trabalhar com um site do Power Pages.
Transferir PAPortal do Power Platform
Transfira conteúdo de site do Power Pages a partir do ambiente atual do Dataverse.
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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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. |
WebsiteIdID do site do portal |
ID do site do Power Pages a transferir. |
OverwriteSubstituir conteúdo |
Conteúdo de site do Power Pages a substituir (true|false). |
ModelVersionModelo 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". |
Carregar PAPortal 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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. |
UploadPathCaminho do conteúdo a carregar |
Caminho a partir do qual o conteúdo do site do Power Pages será carregado. |
ModelVersionModelo 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 no catálogo no Power Platform e incluem o seguinte.
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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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. |
EnvironmentURL do ambiente de destino |
(Obrigatório) URL do ambiente visado por esta tarefa. |
CatalogItemIdID do Item do Catálogo a instalar |
(Obrigatório) Item de catálogo a ser instalado no ambiente de destino. |
TargetEnvironmentUrlURL 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"). |
PollStatusVerificar 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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. |
EnvironmentURL do ambiente de destino |
(Obrigatório) URL do ambiente visado por esta tarefa. |
CatalogSubmissionFileFicheiro de submissão do catálogo |
(Obrigatório) Especifique o caminho e o nome do ficheiro de submissão do catálogo. |
UsePackageSolutionZipFileTipo de ficheiro |
Tipo de ficheiro: ficheiro zip do pacote ou da solução. |
SolutionZipFileNome do ficheiro zip da solução |
Especifique o caminho e o nome do ficheiro zip da solução. |
PollStatusVerificar 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 |
|---|---|
authenticationTypeTipo 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. |
PowerPlatformSPNPrincipal do serviço do Power Platform |
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. |
EnvironmentURL do ambiente de destino |
(Obrigatório) URL do ambiente visado por esta tarefa. |
TrackingIdID de monitorização do pedido |
(Obrigatório) ID de monitorização do pedido. |
RequestTypeTipo 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 de Microsoft Power Platform Build Tools, 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.
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.
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.