Attività degli strumenti Microsoft Power Platform Build Tools

  • Articolo

Le attività di compilazione disponibili sono descritte nelle sezioni seguenti. Successivamente, presenteremo alcuni esempi di Azure Pipelines che fanno uso di queste attività. Per informazioni sugli strumenti di creazione e su come scaricarli, vedi Microsoft Power Platform Build Tools per Azure Pipelines.

Attività Helper

Le attività helper disponibili sono descritte di seguito.

Installazione strumenti di Power Platform

Questa attività deve essere aggiunta una volta prima di qualsiasi altra attività Power Platform Build Tools nelle pipeline di creazione e rilascio. Questa attività installa un set di strumenti specifici di Power Platform richiesti dall'agente per eseguire le attività di compilazione di Microsoft Power Platform. Questa attività non richiede alcuna configurazione aggiuntiva. Questa attività contiene parametri per le versioni specifiche di ciascuno degli strumenti che vengono installati.

Per rimanere aggiornati con le versioni degli strumenti nel tempo, assicurati che questi parametri corrispondano alle versioni degli strumenti necessari per il corretto funzionamento della pipeline.

Frammento YAML (Installer)

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

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

Parametri (Installer)

Parametri Descrizione
DefaultVersion
Usa le versioni degli strumenti predefinite		 Impostare su true per usare la versione predefinita di tutti gli strumenti; in caso contrario, impostare su false. Obbligatorio (e false) quando sono specificate le versioni dello strumento.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Versione strumento		 Versione specifica dello strumento da usare.

Power Platform WhoAmI

Verifica la connessione del servizio all'ambiente Power Platform connettendosi ed effettuando una richiesta WhoAmI. Questa attività può essere utile da includere nelle prime fasi della pipeline, per verificare la connettività prima dell'inizio dell'elaborazione.

Frammento YAML (WhoAmI)

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

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

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

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

Parametri (WhoAmI)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Facoltativo) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
PowerPlatformEnvironment
URL ambiente Power Platform		 L'endpoint servizio per l'ambiente da connettere. Definito in Connessioni servizio in Impostazioni progetto. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
PowerPlatformSPN
Entità servizio di Power Platform		 L'endpoint servizio per l'ambiente da connettere. Definito in Connessioni servizio in Impostazioni progetto.

Controllo qualità

Nella sezione seguente sono riportate le attività disponibili per verificare la qualità di una soluzione.

Power Platform Checker

Questa attività esegue un controllo di analisi statica sulle soluzioni rispetto a una serie di regole di procedure consigliate per identificare eventuali schemi problematici che potrebbero essere stati inavvertitamente introdotti durante la creazione della soluzione.

Frammento YAML (Checker)

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

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

Parametri (Checker)

Parametri Descrizione
PowerPlatformSPN
Connessione al servizio		 (Obbligatorio) Una connessione a un ambiente Microsoft Power Platform provvisto di licenza è obbligatoria per usare Verifica di Power Platform. Le connessioni di servizio sono definite in Connessioni di servizio sotto Impostazioni progetto usando il tipo di connessione Power Platform. Ulteriori informazioni: vedi BuildTools.EnvironmentUrl in Creazione ambiente di Power Platform

Nota: entità servizio e metodi di autenticazione nome utente/password sono gli unici metodi di autenticazione disponibili per l'attività di controllo. Per ulteriori informazioni su come configurare le entità di servizio da utilizzare con questa attività, consulta Configurare le connessioni delle entità di servizio per gli ambienti Power Platform.
UseDefaultPACheckerEndpoint
Usa l'endpoint di Verifica di Power Platform predefinito		 Per impostazione predefinita (true), la posizione geografica del servizio di verifica usa la stessa geografia dell'ambiente a cui ti connetti.
CustomPACheckerEndpoint
Endpoint di Verifica PAC personalizzato		 Obbligatorio quando UseDefaultPACheckerEndpoint è false. Puoi specificare un'altra area geografica da utilizzare, ad esempio https://japan.api.advisor.powerapps.com.Per un elenco delle aree geografiche disponibili, vedi Utilizzare l'APi di verifica Power Platform.
FileLocation
Posizione dei file da analizzare		 Obbligatorio quando si fa riferimento a un file da un URL di firma di accesso condiviso (SAS). sasUriFile .

Nota: è importante fare riferimento a un file di soluzione esportato e non ai file di origine decompressi nel repository. È possibile analizzare i file della soluzione gestita e non gestita.
FilesToAnalyzeSasUri
File SAS da analizzare		 Richiesti quando FileLocation è impostato su sasUriFile. Immettere l'URI SAS. È possibile aggiungere più di un URI SAS con un elenco separato da virgola (,) o punto e virgola (;).
FilesToAnalyze
File locali da analizzare		 Obbligatori quando i file SAS non vengono analizzati. Specifica il percorso e il nome dei file zip da analizzare. È possibile utilizzare caratteri jolly. Ad esempio, immetti **\*.zip per tutti i file zip in tutte le sottocartelle.
FilesToExclude
File locali da escludere		 Specificare i nomi dei file da escludere dall'analisi. Se sono più di uno, inserire un elenco separato da virgola (,) o punto e virgola (;). Questo elenco può includere un nome file completo o un nome con caratteri jolly iniziali o finali, ad esempio *jquery o form.js
RulesToOverride
Regole da sostituire		 Una matrice JSON contenente regole e livelli da sostituire. I valori accettati per OverrideLevel sono: Critical, High, Medium, Low, Informational. Esempio: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Set di regole		 (Obbligatorio) Specifica quale set di regole applicare. Sono disponibili i seguenti due set di regole:
  • Verifica della soluzione: si tratta dello stesso set di regole eseguito dal Power Apps Maker Portal.
  • AppSource: il set di regole esteso utilizzato per certificare un'applicazione prima che possa essere pubblicata in AppSource.
ErrorLevel
Livello di errore		 Combinato con il parametro di soglia di errore definisce la gravità degli errori e degli avvisi consentiti. I valori di soglia supportati sono <level>IssueCount dove level=Critical, High, Medium, Low e Informational.
ErrorThreshold
Soglia di errore		 Definisce il numero di errori (>=0) di un livello specificato che alla verifica è consentito superare nelle soluzioni da controllare.
FailOnPowerAppsCheckerAnalysisError
Interrompi in caso di errore		 Quando è true, ha esito negativo se l'analisi di Verifica di Power Apps viene restituita come Failed o FinishedWithErrors.
ArtifactDestinationName
Nome artefatto DevOps		 Specificare il nome Azure Artifacts per il file con estensione .sarif di controllo.

Attività relative alla soluzione

Questo insieme di attività può automatizzare le azioni della soluzione. Le attività di ambiente descritte più avanti in questa sezione che creano, copiano o ripristinano un ambiente sovrascriveranno le connessioni del servizio con gli ambienti appena creati. Queste attività rendono possibile eseguire attività di soluzione in ambienti creati su richiesta.

Importazione della soluzione Power Platform

Importa una soluzione in un ambiente di destinazione.

Frammento YAML (Import)

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

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

Parametri (Import)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformEnvironment
URL ambiente Power Platform		 Endpoint servizio in cui si desidera importare la soluzione (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio in cui si desidera importare la soluzione (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
SolutionInputFile
File di input della soluzione		 (Obbligatorio) Il percorso e il nome di file del file solution.zip da importare nell'ambiente di destinazione (ad esempio, $(Build.ArtifactStagingDirectory)$(SolutionName).zip ).

Nota: le variabili offrono un modo conveniente di ottenere bit di chiave dei dati in varie parti della pipeline. Vedi Usare le variabili predefinite per un elenco completo.
HoldingSolution
Importa come soluzione temporanea		 Un parametro avanzato (true|false) utilizzato quando è necessario aggiornare una soluzione. Questo parametro ospita la soluzione in Dataverse ma non aggiorna la soluzione finché non viene eseguita l'attività Applica un aggiornamento della soluzione.
OverwriteUnmanagedCustomizations
Sovrascrivi le personalizzazioni non gestite		 Specificare se sostituire le personalizzazioni non gestite (true|false).
SkipProductUpdateDependencies
Salta le dipendenze di aggiornamento del prodotto		 Specificare se saltare l'applicazione di dipendenze correlate agli aggiornamenti di prodotto (true|false).
ConvertToManaged
Converti a gestito		 Specificare se importare come soluzione gestita (true|false).
AsyncOperation
Importazione asincrona		 Se selezionato (true), l'operazione di importazione verrà eseguita in modo asincrono. Questa opzione è consigliata per soluzioni di dimensioni maggiori poiché questa attività altrimenti scadrà automaticamente dopo 4 minuti. La selezione di asincrono eseguirà il polling e attenderà il raggiungimento di MaxAsyncWaitTime (true|false).
MaxAsyncWaitTime
Tempo massimo di attesa		 Tempo massimo di attesa in minuti dell'operazione asincrona; l'impostazione predefinita è 60 min (1 ora), come l'impostazione predefinita di Azure DevOps per le attività.
PublishWorkflows
Attiva processi dopo importazione		 Specificare se eventuali processi (flussi di lavoro) nella soluzione devono essere attivati dopo l'importazione (true|false).
UseDeploymentSettingsFile
Usa file di impostazioni di distribuzione		 I riferimenti di connessione e i valori delle variabili di ambiente possono essere impostati usando un file di impostazioni di distribuzione (true|false).
DeploymentSettingsFile
File di impostazioni di distribuzione		 (Obbligatorio quando UseDeploymentSettingsFile=true) Percorso e nome del file delle impostazioni di distribuzione.

Power Platform Aggiungere i componenti di soluzione

Aggiunge un componente di soluzione a una soluzione non gestita.

Frammento YAML (Aggiungi)

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

Parametri (Aggiungi)

Parametri Descrizione
ComponentId
ID del componente di soluzione		 Nome dello schema o ID del componente da aggiungere alla soluzione di destinazione.
ComponentType
URL ambiente Power Platform		 Valore che rappresenta il componente di soluzione che stai aggiungendo. Per un elenco completo dei valori dei componenti, vedi Utilizzare tipi di componenti predefiniti.
SolutionUniqueName
Nome della soluzione.		 Nome univoco della soluzione.
AddRequiredComponents
Tutti i componenti richiesti da un'altra soluzione dipendono dal componente della soluzione		 (Facoltativo) Indica se anche altri componenti della soluzione necessari per il componente di soluzione da aggiungere devono essere aggiunti alla soluzione non gestita.
Environment
URL o ID dell'ambiente		 (Facoltativo) URL o ID dell'ambiente di destinazione.

Applica un aggiornamento della soluzione di Power Platform

Aggiorna una soluzione che è stata importata come soluzione temporanea.

Frammento YAML (Upgrade)

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

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

Parametri (Upgrade)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformEnvironment
URL ambiente Power Platform		 Endpoint servizio in cui si desidera aggiornare la soluzione (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio in cui si desidera aggiornare la soluzione (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
SolutionName
Nome soluzione		 (Obbligatorio) Nome della soluzione a cui applicare l'aggiornamento. Usa sempre il nome della soluzione e non il relativo nome visualizzato.
AsyncOperation
Aggiornamento asincrono		 Se selezionato (true), l'operazione di aggiornamento verrà eseguita come processo batch asincrono. La selezione di asincrono eseguirà il polling e attenderà il raggiungimento di MaxAsyncWaitTime.
MaxAsyncWaitTime
Tempo massimo di attesa		 Tempo massimo di attesa in minuti dell'operazione asincrona; l'impostazione predefinita è 60 min (1 ora), come l'impostazione predefinita di Azure DevOps per le attività.

Nota

Le variabili offrono un modo conveniente di ottenere bit di chiave dei dati in varie parti della pipeline. Vedi Usare le variabili predefinite per un elenco completo. È possibile precompilare il riferimento di connessione e le informazioni sulle variabili di ambiente per l'ambiente di destinazione durante l'importazione di una soluzione utilizzando un file delle impostazioni di distribuzione.

Maggiori informazioni:Precompilare i riferimenti di connessione e le variabili di ambiente per le distribuzioni automatizzate

Esportazione della soluzione Power Platform

Esporta una soluzione da un ambiente di origine.

Frammento YAML (Export)

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

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

Parametri (Export)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformEnvironment
URL ambiente Power Platform		 Endpoint servizio in cui si desidera aggiornare la soluzione (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio in cui si desidera aggiornare la soluzione (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
SolutionName
Nome soluzione		 (Obbligatorio) Il nome della soluzione da esportare. Usa sempre il nome della soluzione e non il relativo nome visualizzato.
SolutionOutputFile
File di input della soluzione		 (Obbligatorio) Il percorso e il nome di file del file solution.zip da esportare dall'ambiente di origine (ad esempio, $(Build.ArtifactStagingDirectory)$(SolutionName).zip ).

Nota: le variabili offrono un modo conveniente di ottenere bit di chiave dei dati in varie parti della pipeline. Vedi Usare le variabili predefinite per un elenco completo.
AsyncOperation
Esportazione asincrona		 Se selezionato (true), l'operazione di esportazione verrà eseguita come processo batch asincrono. La selezione di asincrono eseguirà il polling e attenderà il raggiungimento di MaxAsyncWaitTime.
MaxAsyncWaitTime
Tempo massimo di attesa		 Tempo massimo di attesa in minuti dell'operazione asincrona; l'impostazione predefinita è 60 min (1 ora), come l'impostazione predefinita di Azure DevOps per le attività.
Managed
Esporta come gestito		 Se selezionato (true), esporta la soluzione come soluzione gestita; in caso contrario, esporta come soluzione non gestita.
ExportAutoNumberingSettings
Esporta impostazioni di numerazione automatica		 Esporta le impostazioni di numerazione automatica (true|false).
ExportCalendarSettings
Esporta impostazioni di calendario		 Esporta le impostazioni del calendario (true|false).
ExportCustomizationSettings
Esporta impostazioni di personalizzazione		 Esporta le impostazioni di personalizzazione (true|false).
ExportEmailTrackingSettings
Esporta impostazioni di rilevamento posta elettronica		 Esporta le impostazioni di rilevamento della posta elettronica (true|false).
ExportGeneralSettings
Esporta impostazioni generali		 Esporta le impostazioni generali (true|false).
ExportIsvConfig
Esporta configurazione ISV		 Esporta la configurazione ISV (true|false).
ExportMarketingSettings
Esporta impostazioni di marketing		 Esporta le impostazioni di marketing (true|false).
ExportOutlookSynchronizationSettings
Esporta impostazioni di sincronizzazione di Outlook		 Esporta le impostazioni di sincronizzazione di Outlook (true|false).
ExportRelationshipRoles
Esporta ruoli relazione		 Esporta i ruoli relazione (true|false).
ExportSales
Esporta vendite		 Esporta le vendite (true|false).

Decompressione della soluzione Power Platform

Decomprime un file di soluzione in più file XML di modo che tali file siano più facilmente letti e gestiti da un sistema di controllo del codice sorgente.

Frammento YAML (Unpack)

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

Parametri (Unpack)

Parametri Descrizione
SolutionInputFile
File di input della soluzione		 (Obbligatorio) Il percorso e il nome di file del file zip da decomprimere.
SolutionTargetFolder
Cartella di destinazione per decomprimere la soluzione		 (Obbligatorio) Il percorso e la cartella di destinazione in cui desideri decomprimere la soluzione.
SolutionType
Tipo di soluzione		 (Obbligatorio) Il tipo di soluzione che desideri decomprimere. Le opzioni includono: Non gestita (consigliato), Gestita ed Entrambe.

Compressione della soluzione Power Platform

Comprime una soluzione rappresentata nel controllo del codice sorgente in un file solution.zip che può essere importato in un altro ambiente.

Frammento YAML (Pack)

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

Parametri (Pack)

Parametri Descrizione
SolutionOutputFile
File di input della soluzione		 (Obbligatorio) Il percorso e il nome di file del file solution.zip in cui comprimere la soluzione.
SolutionSourceFolder
Cartella di origine della soluzione da comprimere		 (Obbligatorio) Il percorso e la cartella di origine della soluzione da comprimere.
SolutionType
Tipo di soluzione		 (Obbligatorio) Il tipo di soluzione che desideri comprimere. Le opzioni includono: Gestito (scelta consigliata),Non gestito ed Entrambi.

Elimina soluzione di Power Platform

Elimina una soluzione nell'ambiente di destinazione.

Frammento YAML (Delete)

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

Parametri (Delete)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformEnvironment
URL ambiente Power Platform		 Endpoint servizio di cui si desidera eliminare la soluzione (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio di cui si desidera eliminare la soluzione (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
SolutionName
Nome soluzione		 (Obbligatorio) Nome della soluzione da eliminare. Usa sempre il nome della soluzione e non il relativo nome visualizzato.

Pubblicazione di personalizzazioni Power Platform

Pubblica tutte le personalizzazioni in un ambiente.

Frammento YAML (Publish)

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

Parametri (Publish)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformEnvironment
URL ambiente Power Platform		 Endpoint servizio di cui si desidera pubblicare le personalizzazioni (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio di cui si desidera pubblicare le personalizzazioni (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente

Impostazione della versione della soluzione Power Platform

Aggiorna la versione di una soluzione.

Frammento YAML (Version)

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

Parametri (Version)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformEnvironment
URL ambiente Power Platform		 Endpoint servizio di cui si desidera impostare la versione della soluzione (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio di cui si desidera impostare la versione della soluzione (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
SolutionName
Nome soluzione		 (Obbligatorio) Nome della soluzione per cui impostare la versione. Usa sempre il nome della soluzione e non il relativo nome visualizzato.
SolutionVersionNumber
Numero versione soluzione		 (Obbligatorio) Numero di versione che desideri impostare.

Sebbene il numero di versione possa essere codificato nella pipeline, si consiglia di utilizzare una variabile della pipeline Azure DevOps come BuildId. Ciò fornisce opzioni per definire la forma esatta del numero di versione nella scheda "Opzioni", ad esempio: $ (Anno:aaaa)-$ (Mese:MM)-$(Giorno:gg)-$(rev:rr)-3

Questa definizione può quindi essere utilizzata nell'attività Imposta versione soluzione impostando la proprietà Numero versione con $(Build.BuildId) anziché codificare 20200824.0.0.2.

In alternativa, l'output di uno script di attività inline di PowerShell $(Get-Date -Format aaaa.MM.gg.HHmm) impostato su variabile vuota denominata SolutionVersion come Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Imposta versione soluzione come $(SolutionVersion).

Power Platform: Impostare variabili di connessione

Imposta le variabili BuildTools.* per fornire l'accesso alle attività di script personalizzate per utilizzare la connessione al servizio come un'origine unica e attendibile.

Frammento 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

Parametri (SetConnectionVariables)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio per cui si desidera impostare le variabili per la connessione. Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
timeoutInMinutes
Timeout		 Specifica il tempo massimo, in minuti, durante il quale un'attività può essere eseguita prima di essere annullata dal server. Un valore zero indica un timeout infinito.
retryCountOnTaskFailure
Numero di tentativi se l'attività non è riuscita		 Specifica il numero di tentativi per questa attività che verranno eseguiti in caso di errore dell'attività. Non supportato per attività senza agente.
ApplicationId
ID applicazione per l'accesso		 (Obbligatorio per nome utente/password) ID applicazione da utilizzare per l'accesso (vedere la nota aggiuntiva di seguito).
RedirectUri
Reindirizzare l'URI dell'app specificata		 (Obbligatorio per nome utente/password) Reindirizza l'URI dell'app specificata. Necessario quando si specifica un ID app. Vedi nota aggiuntiva di seguito.

Nota

Quando si utilizza il tipo di autenticazione nome utente/password, saranno richiesti l'ID applicazione e l'URI di reindirizzamento. Questo documento di autenticazione Oauth contiene una spiegazione del motivo per cui è necessario creare la registrazione dell'app con cui eseguire l'autenticazione Dataverse. Quando ti connetti utilizzando l'autenticazione nome utente/password, la connessione si comporta come un'applicazione che si connette per conto di un utente Dataverse.

Distribuzione del pacchetto Power Platform

Distribuisce un pacchetto in un ambiente. La distribuzione di un pacchetto rispetto a un singolo file di soluzione offre la possibilità di distribuire più soluzioni, dati e codice in un ambiente.

Frammento YAML (Deploy)

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

Parametri (Deploy)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformEnvironment
URL ambiente Power Platform		 Endpoint servizio in cui si desidera distribuire il pacchetto (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio in cui si desidera distribuire il pacchetto (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform. Per altre informazioni, vedere BuildTools.EnvironmentUrl in Power Platform Crea ambiente
PackageFile
File del pacchetto		 (Obbligatorio) Percorso e nome file dell'assembly del file del pacchetto (con estensione dll).
MaxAsyncWaitTime
Tempo massimo di attesa		 Tempo massimo di attesa in minuti dell'operazione asincrona; l'impostazione predefinita è 60 min (1 ora), come l'impostazione predefinita di Azure DevOps per le attività.

Attività Gestione dell'ambiente

Automatizza le attività comuni di gestione del ciclo di vita dell'ambiente (ELM).

Creazione ambiente Power Platform

Crea un nuovo ambiente. Anche la creazione di un nuovo ambiente crea automaticamente BuildTools.EnvironmentUrl.

Importante

Quando impostato, BuildTools.EnvironmentUrl viene usato come la connessione al servizio predefinita per le attività che seguono nella pipeline. Ogni attività descritta in questo articolo usa solo l'endpoint della connessione al servizio quando BuildTools.EnvironmentUrl non è impostato.

Puoi eseguire il provisioning di un nuovo ambiente solo se la licenza o la capacità consentono la creazione di ambienti aggiuntivi. Per ulteriori informazioni su come visualizzare la capacità, consulta Dettagli della pagina Capacità.

Frammento YAML (Create-env)

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

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

Parametri (Create-env)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformEnvironment
URL ambiente Power Platform		 Endpoint servizio per cui si desidera creare l'ambiente (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio per cui si desidera creare l'ambiente (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
DisplayName
Nome visualizzato		 (Obbligatorio) Il nome visualizzato dell'ambiente creato.
LocationName
Area di distribuzione		 (Obbligatorio) L'area in cui deve essere creato l'ambiente.
EnvironmentSku
Tipo di ambiente		 (Obbligatorio) Il tipo di istanza da distribuire. Le opzioni sono Sandbox, Production, Trial e SubscriptionBasedTrial.
AppsTemplate
App		 Per un tipo di ambiente non di prova, le app supportate sono D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation e D365_Sales.
CurrencyName
Valuta		 (Obbligatorio) Valuta di base per l'ambiente creato. La valuta non può essere aggiornata dopo la creazione dell'ambiente.
LanguageName
Language		 (Obbligatorio) La lingua di base nell'ambiente.
DomainName
Nome dominio		 (Obbligatorio) Questa è la stringa specifica dell'ambiente che fa parte dell'URL. Ad esempio, per un ambiente con l'URL https://powerappsbuildtasks.crm.dynamics.com/, il nome di dominio sarebbe "powerappsbuildtasks".

Nota: se immetti un nome di dominio già in uso, l'attività aggiunge un valore numerico al nome di dominio, che inizia con 0. Per l'esempio sopra, l'URL potrebbe diventare https://powerappsbuildtasks0.crm.dynamics.com/.

Eliminazione ambiente Power Platform

Elimina un ambiente.

Frammento YAML (Delete-env)

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

Parametri (Delete-env)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformEnvironment
URL ambiente Power Platform		 Endpoint servizio per cui si desidera eliminare l'ambiente (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio per cui si desidera eliminare l'ambiente (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.

Assegna utenti Power Platform

Assegna un utente a un ambiente di destinazione con il ruolo di sicurezza specificato.

Frammento 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

Parametri (AssignUser-env)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformSPN
Entità servizio di Power Platform		 L'endpoint servizio per l'ambiente di destinazione a cui vuoi assegnare l'utente (ad esempio, https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
User
Nome utente Power Platform		 ID oggetto Microsoft Entra o nome principale dell'utente da assegnare all'ambiente di destinazione.
Role
Nome o ID ruolo di sicurezza		 Nome o ID del ruolo di sicurezza da assegnare all'utente.
ApplicationUser
Nome utente dell'applicazione Power Platform		 Specifica se l'utente di input è un utente dell'applicazione (vero|falso).

Reimpostare l'ambiente Power Platform

Reimpostare un ambiente.

Frammento 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'

Parametri (Reset-env)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformEnvironment
URL ambiente Power Platform		 Endpoint servizio per cui si desidera reimpostare l'ambiente (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio per cui si desidera reimpostare l'ambiente (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.

Backup ambiente Power Platform

Esegue il backup di un ambiente.

Frammento YAML (Backup-env)

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

Parametri (Backup-env)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformEnvironment
URL ambiente Power Platform		 Endpoint servizio per cui si desidera eseguire il backup dell'ambiente (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio per cui si desidera eseguire il backup dell'ambiente (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
BackupLabel
Etichetta backup		 (Obbligatorio) L'etichetta da assegnare al backup.

Copia ambiente Power Platform

Copia un ambiente in un ambiente di destinazione. Sono disponibili due tipi di copie: completa e minima. La copia Completa include sia i dati che i metadati della soluzione (personalizzazioni), mentre la copia minima include solo i metadati della soluzione e non i dati effettivi.

Frammento YAML (Copy-env)

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

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

Parametri (Copy-env)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformEnvironment
URL ambiente Power Platform		 Endpoint servizio per l'ambiente di origine da cui si desidera copiare (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio per l'ambiente di origine da cui si desidera copiare (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
TargetEnvironmentUrl
URL ambiente di destinazione		 (Obbligatorio) L'URL dell'ambiente di destinazione in cui si desidera effettuare la copia.
CopyType
Tipo di copia		 Tipo di copia da eseguire: FullCopy o MinimalCopy
OverrideFriendlyName
Sostituisci nome descrittivo		 Cambia il nome descrittivo dell'ambiente di destinazione con un altro nome (true|false).
FriendlyName
Nome descrittivo		 Nome descrittivo dell'ambiente di destinazione.
DisableAdminMode
Disabilita modalità di amministrazione		 Se disabilitare la modalità di amministrazione (true|false).

Ambiente di ripristino Power Platform

Ripristina un ambiente in un backup specificato.

Frammento 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'

Parametri (Restore-env)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformEnvironment
URL ambiente Power Platform		 Endpoint servizio per l'ambiente di origine da cui si desidera ripristinare (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio per l'ambiente di origine da cui si desidera ripristinare (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
RestoreLatestBackup
Ultimo backup da ripristinare		 Se ripristinare l'ultimo backup o fornire RestoreTimeStamp (true|false).
RestoreTimeStamp
DataOra del backup		 Datetime del backup nel formato "gg/mm/aaaa hh: mm" O stringa "più recente".
TargetEnvironmentUrl
URL ambiente di destinazione		 (Obbligatorio) L'URL dell'ambiente di destinazione in cui si desidera effettuare il ripristino.
FriendlyName
Nome dell'ambiente ripristinato		 (Facoltativo) Nome dell'ambiente ripristinato.
DisableAdminMode
Disabilita modalità di amministrazione		 Se disabilitare la modalità di amministrazione (true|false).

Esporta dati Dataverse

Esporta i dati da un ambiente con lo schema fornito.

Frammento 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

Parametri (exportdata-env)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformSPN
Entità servizio di Power Platform		 L'endpoint servizio per l'ambiente di origine da cui desideri esportare i dati (ad esempio, https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
SchemaFile
Nome file XML di schema		 Nome file XML di schema. Può essere creato tramite Strumento di migrazione configurazione.
DataFile
Nome file di dati		 Nome del file per i dati da esportare (file zip).
Overwrite
Sovrascrittura contenuto		 Contenuto del sito Web Power Pages da sovrascrivere (true|false).

Importare dati Dataverse

Importare dati in un ambiente.

Frammento 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'

Parametri (importdata-env)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformSPN
Entità servizio di Power Platform		 L'endpoint servizio per l'ambiente di origine in cui desideri importare i dati (ad esempio, https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
DataFile
Nome file di dati		 Nome del file per il file di dati compresso zip) da importare o la cartella con data-schema.xml e data.xml da importare.

Attività di gestione Power Pages

Attività per l'uso del sito Web Power Pages.

Power Platform Scarica PAPortal

Scarica il contenuto del sito Web di Power Pages dall'ambiente Dataverse corrente.

Frammento 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

Parametri (download-paportal)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio per l'ambiente da cui desideri scaricare contenuto (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
WebsiteId
ID del sito Web del portale		 ID sito Web di Power Pages da scaricare.
Overwrite
Sovrascrittura contenuto		 Contenuto del sito Web Power Pages da sovrascrivere (true|false).
ModelVersion
Modello di dati del sito		 Indica se i dati del sito da caricare utilizzeranno il modello di dati standard (1) o avanzato (2). Il valore predefinito è "1".

Power Platform Carica PAPortal

Carica il contenuto del sito Web Power Pages nell'ambiente Dataverse corrente.

Frammento 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'

Parametri (upload-paportal)

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio per l'ambiente in cui desideri caricare contenuto (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
UploadPath
Carica percorso dei contenuti		 Percorso da cui verrà caricato il contenuto del sito Web di Power Pages.
ModelVersion
Modello di dati del sito		 Indica se i dati del sito da caricare utilizzeranno il modello di dati standard (1) o avanzato (2). Il valore predefinito è "1".

Catalogo per attività Power Platform (anteprima)

Queste attività eseguono azioni rispetto al catalogo in Power Platform e includono quanto segue.

Nota

Attualmente, le attività catalogo per Power Platform sono una versione in anteprima.

Installa elemento del catalogo

Installa un elemento Catalog nell'ambiente di destinazione.

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio per l'ambiente in cui desideri caricare contenuto (ad esempio https://powerappsbuildtools.crm.dynamics.com). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
Environment
URL ambiente di destinazione		 (Obbligatorio) URL dell'ambiente a cui è indirizzata questa attività.
CatalogItemId
ID elemento del catalogo da installare		 (Obbligatorio) Elemento del catalogo da installare nell'ambiente di destinazione.
TargetEnvironmentUrl
URL ambiente di destinazione		 (Obbligatorio) L'URL dell'ambiente di destinazione in cui desideri installare l'elemento del catalogo (ad esempio, "https://YourOrg.crm.dynamics.com").
PollStatus
Controllare lo stato del sondaggio		 (Facoltativo) Sondaggio per controllare lo stato della tua richiesta (true|false).

Parametri (catalogo-installazione)

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

Invia l'approvazione del catalogo

Invia richiesta di approvazione Catalog.

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio per l'ambiente in cui desideri caricare contenuto (ad esempio "https://powerappsbuildtools.crm.dynamics.com"). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
Environment
URL ambiente di destinazione		 (Obbligatorio) URL dell'ambiente a cui è indirizzata questa attività.
CatalogSubmissionFile
File di invio del catalogo		 (Obbligatorio) Specifica il percorso e il nome del file di invio del catalogo.
UsePackageSolutionZipFile
Tipo di file		 Tipo di file: pacchetto o file zip della soluzione.
SolutionZipFile
Nome del file ZIP della soluzione		 Specifica il percorso e il nome di file del file zip.
PollStatus
Controllare lo stato del sondaggio		 (Facoltativo) Sondaggio per controllare lo stato della tua richiesta (true|false).

Parametri (catalogo-invio)

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

Stato della richiesta catalogo

Ottieni lo stato della richiesta di installazione/invio del catalogo.

Parametri Descrizione
authenticationType
Tipo di autenticazione		 (Obbligatorio per SPN) Specificare PowerPlatformEnvironment per una connessione nome utente/password o PowerPlatformSPN per una connessione Entità servizio/segreto client.
PowerPlatformSPN
Entità servizio di Power Platform		 Endpoint servizio per l'ambiente in cui desideri caricare contenuto (ad esempio "https://powerappsbuildtools.crm.dynamics.com"). Definito in Connessioni servizio in Impostazioni progetto usando il tipo di connessione Power Platform.
Environment
URL ambiente di destinazione		 (Obbligatorio) URL dell'ambiente a cui è indirizzata questa attività.
TrackingId
ID di traccia della richiesta		 (Obbligatorio) ID di tracciamento della richiesta.
RequestType
Tipo di richiesta		 (Obbligatorio) Tipo di richiesta. (Valori: Installa | Invia).

Parametri (catalogo-stato)

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

Pipeline di compilazione e versione

Ora che abbiamo identificato cosa si può fare con gli strumenti Power Apps build tools, vediamo come è possibile applicare questi strumenti alle pipeline di compilazione e versione. Di seguito è mostrata una panoramica concettuale. Vediamo alcuni dettagli dell'implementazione della pipeline usando le attività degli strumenti di creazione nelle sottosezioni seguenti.

Per saperne di più sulla creazione di queste pipeline e creare effettivamente pipeline usando gli strumenti Microsoft Power Platform Build Tools, completa i laboratori relativi agli strumenti di creazione, che puoi scaricare da GitHub.

Maggiori informazioni su Azure Pipelines: Usare Azure Pipelines

Pipeline di compilazione: esportare una soluzione da un ambiente di sviluppo (DEV)

La figura seguente mostra le attività degli strumenti di compilazione che potresti aggiungere a una pipeline che esporta una soluzione da un ambiente di sviluppo.

Esportare una soluzione da un ambiente di sviluppo (DEV).

Pipeline di compilazione: compilare un soluzione gestita

La figura seguente mostra le attività degli strumenti di compilazione che potresti aggiungere a una pipeline che compila una soluzione gestita.

Compilare una soluzione gestita.

Pipeline di versione: distribuire in un ambiente di produzione (PROD)

La figura seguente mostra le attività degli strumenti di compilazione che potresti aggiungere a una pipeline che distribuisce un ambiente di produzione.

Distribuire in un ambiente di produzione (PROD).

Vedere anche

Microsoft Power Platform Build Tools per Azure DevOps