Sarcini ale uneltelor de build Microsoft Power Platform

Secțiunile următoare descriu activitățile de compilare disponibile. După aceea, vom prezenta câteva exemple de Azure Pipelines care utilizează aceste activități. Pentru informații despre uneltele de build și cum să le descarci, vezi Microsoft Power Platform Build Tools pentru Azure Pipelines.

Sarcină asistent

Secțiunile următoare descriu activitățile de ajutor disponibile.

Utilitar de instalare a instrumentului Power Platform

Adăugați această activitate o dată înainte de orice alte activități instrumente de generare a platformei Power Platform în versiunile și versiunile de canale de lansare. Această sarcină instalează un set de unelte specifice Power Platform, necesare agentului pentru a rula sarcinile de build Microsoft Power Platform. Această sarcină nu necesită nicio altă configurare după adăugare. Această activitate conține parametri pentru versiunile specifice ale fiecăruia dintre instrumentele pe care le instalează.

Pentru a rămâne la curent cu versiunile instrumentului, asigurați-vă că acești parametri corespund versiunilor instrumentelor necesare pentru ca conductele să ruleze corect.

Fragment YAML (instalator)

# 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

Parametri (instalator)

Parametri Descriere
DefaultVersion
Utilizați versiunile implicite de instrumente		 Setat la adevărat pentru a utiliza versiunea implicită a tuturor instrumentelor, în caz contrar, fals. Obligatoriu (și fals) atunci când specificați orice versiune de instrument.
AddToolsToPath
Adăugați instrumente la cale		 Adaugă pac CLI la variabila de PATH mediu. Puteți utiliza pac CLI din activitățile script fără a fi necesar să configurați manual calea.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Versiunea instrumentului		 Versiunea specifică a instrumentului de utilizat.

Platforma de Putere WhoAmI

Verifică o conexiune a serviciului de mediu Power Platform prin conectarea și efectuarea unei cereri WhoAmI. Această sarcină poate fi utilă pentru a include timpuriu în conductă, pentru a verifica conectivitatea înainte de începerea procesării.

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

Parametri (WhoAmI)

Parametri Descriere
authenticationType
Tipul de autentificare		 (Opțional) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client. Pentru mai multe informații, consultați BuildTools.EnvironmentUrl sub Crearea mediului de platformă Power
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final al serviciului pentru mediul la care doriți să conectați. Definit sub Conexiuni de servicii în Setări proiect. Pentru mai multe informații, consultați BuildTools.EnvironmentUrl sub Crearea mediului de platformă Power
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final al serviciului pentru mediul la care doriți să conectați. Definit sub Conexiuni de servicii în Setări proiect.

Verificarea calității

În secțiunea următoare sunt prezentate sarcinile disponibile pentru verificarea calității unei soluții.

Verificator Power Platform

Această activitate rulează o verificare de analiză statică a soluțiilor dvs. în raport cu un set de reguli de bună practică, pentru a identifica orice modele problematice pe care le puteți introduce din greșeală atunci când construiți soluția.

Fragment YAML (verificator)

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

Parametri (verificator)

Parametri Descriere
PowerPlatformSPN
Conexiune de serviciu		 (Obligatoriu) Pentru a utiliza verificatorul Power Platform, aveți nevoie de o conexiune la un mediu Microsoft Power Platform cu licență. Definiți conexiunile de serviciu în Conexiuni serviciu sub Project Setări utilizând tipul de conexiune Power Platform. Pentru mai multe informații, consultați BuildTools.EnvironmentUrl sub Creare mediu de platformă Power.

Notă: activitatea verificatorului acceptă metode de autentificare principal de serviciu și nume de utilizator/parolă. Pentru mai multe informații despre configurarea principalelor de serviciu pentru această activitate, consultați Configurarea conexiunilor principale de serviciu pentru mediile Power Platform.
UseDefaultPACheckerEndpoint
Utilizați punct finalul implicit al verificatorului Power Platform		 În mod implicit (true), locația geografică a serviciului de verificare utilizează aceeași zonă geografică ca și mediul la care vă conectați.
CustomPACheckerEndpoint
Particularizați punctul final al verificatorului PAC		 Obligatoriu când UseDefaultPACheckerEndpoint este fals. Specificați o altă geografie de utilizat, de exemplu https://japan.api.advisor.powerapps.com. Pentru o listă de geografii disponibile, consultați Utilizarea API-ului Power Platform Checker.
FileLocation
Locația fișierelor de analizat		 Obligatoriu atunci când faceți referire la un fișier de la un URL sasUriFilede semnătură de acces partajat (SAS).

Notă: Se face referire la un fișier soluție exportat și nu la fișierele sursă neambalate din depozit. Puteți analiza atât fișierele de soluții gestionate, cât și cele negestionate.
FilesToAnalyzeSasUri
Fișiere SAS de analizat		 Obligatoriu când FileLocation este setat la sasUriFile. Introduceți adresa URI a SAS. Puteți adăuga mai multe uri SAS prin virgulă (,) sau punct și virgulă (;) listă separată.
FilesToAnalyze
Fișiere locale de analizat		 Necesar când fișierele SAS nu sunt analizate. Specificați calea și numele fișierului pentru fișierele zip de analizat. Puteți utiliza caractere wildcard. De exemplu, introduceți **\*.zip pentru toate fișierele zip din toate subfolderele.
FilesToExclude
Fișiere locale de exclus		 Specificați numele fișierelor de exclus din analiză. Dacă specificați mai multe fișiere, utilizați virgula (,) sau punct și virgulă (;) listă separată. Această listă poate include un nume complet de fișier sau un nume cu caractere wildcard inițiale sau la sfârșit, cum ar fi *jquery sau form.js.
RulesToOverride
Reguli de înlocuire		 O matrice JSON care conține reguli și niveluri de înlocuire. Valorile acceptate pentru OverrideLevel sunt: Critic, Maxim, Mediu, Minim, Informativ. Exemplu: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Set de reguli		 (Necesar) Specificați ce regulă trebuie să se aplice. Sunt disponibile următoarele două seturi de reguli:
  • Verificator de soluții: acest set de reguli este același set care rulează din portalul creatorului de Power Apps.
  • Marketplace: Setul extins de reguli folosit pentru a certifica o aplicație înainte ca aceasta să poată fi publicată pe Marketplace.
ErrorLevel
Nivel de eroare		 Combinată cu parametrul pragului de eroare, această valoare definește severitatea erorilor și avertismentele permise. Valorile de prag acceptate sunt <level>IssueCount unde level=Critic, Ridicat, Mediu, Scăzut, Informativ.
ErrorThreshold
Prag de eroare		 Definește numărul de erori (>=0) dintr-un anumit nivel care sunt permise ca verificatorul să accepte soluțiile verificate.
FailOnPowerAppsCheckerAnalysisError
Eroare legată de eșuare		 Când este adevărat, dacă analiza verificatorului Power Apps returnează ca Nereușit sau FinishedWithErrors.
ArtifactDestinationName
Numele artefactului DevOps		 Specifică numele Azure Artifacts pentru fișierul checker .sarif.

Sarcini soluție

Acest set de activități automatizează acțiunile soluției. Sarcinile de mediu descrise mai târziu în această secțiune, care creează, copiază sau restaurează un mediu, suprascriu conexiunile de serviciu cu mediile nou create. Utilizând aceste activități, puteți efectua activități soluție în mediile pe care le creați la cerere.

Import soluție Power Platform

Importă o soluție într-un mediu țintă.

Fragment YAML (import)

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

Parametri (import)

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final de serviciu în care doriți să importați soluția (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu în care doriți să importați soluția (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
SolutionInputFile
Fișier de intrare al soluției		 (Obligatoriu) Calea și numele fișierului .zip al soluției care va fi importat în mediul țintă (de exemplu, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Notă: Variabilele vă oferă o modalitate convenabilă de a introduce date cheie în diferite părți ale canalului dvs. de lucru. Consultați Utilizați variabile predefinite pentru o listă cuprinzătoare.
HoldingSolution
Importați ca soluție de reținere		 Un parametru avansat (adevărat|fals) utilizat atunci când o soluție necesită upgrade. Acest parametru găzduiește soluția în Dataverse dar nu face upgrade la soluție până când nu rulează activitatea Aplicați upgrade soluție.
OverwriteUnmanagedCustomizations
Înlocuiți particularizările negestionate		 Specificați dacă particularizările negestionate vor fi înlocuite (adevărat|fals).
SkipProductUpdateDependencies
Omiteți dependențele de actualizare a produsului		 Specificați dacă aplicarea dependențelor legate de actualizările produselor ar trebui să fie omisă (adevărat|fals).
ConvertToManaged
Convertiți la gestionate		 Învechit. Sistemul va converti componentele soluției negestionate în gestionate atunci când importați o soluție gestionată.
AsyncOperation
Import asincron		 Dacă este selectată opțiunea (adevărat), operația de import va fi efectuată asincron. Acest lucru este recomandat pentru soluții mai mari, deoarece această sarcină va fi suspendată automat după 4 minute. Selectarea modului asincron va sonda și va aștepta până când MaxAsyncWaitTime a fost atins (adevărat|fals).
MaxAsyncWaitTime
Timp maxim de așteptare		 Timpul maxim de așteptare în minute pentru operațiunea asincronă; implicit este 60 min (1 oră), la fel ca implicit Azure DevOps pentru task-uri.
PublishWorkflows
Activați procesele după import		 Specificați dacă orice procese (fluxuri de lucru) din soluție ar trebui să fie activate după import (adevărat|fals).
UseDeploymentSettingsFile
Utilizați fișierul de setări de implementare		 Referințele conexiunii și valorile variabilelor de mediu pot fi configurate utilizând un fișier de setări de implementare (adevărat|fals).
DeploymentSettingsFile
Fișierul cu setări de implementare		 (Obligatoriu când UseDeploymentSettingsFile=adevărat) Calea și numele fișierului cu setările de implementare.

Power Platform Adăugați o componentă a soluției

Adaugă o componentă de soluție la o soluție negestionată.

Fragment YAML (Adăugare)

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 (Adăugare)

Parametri Descriere
ComponentId
ID-ul componentei soluției		 Numele schemei sau ID-ul componentei de adăugat la soluția țintă.
ComponentType
Power Platform adresă URL pentru mediu		 Valoarea care reprezintă componenta soluției pe care o adăugați. Consultați secțiunea *Utilizarea tipurilor de componente predefinite* pentru o listă completă a valorilor componentelor. ...
SolutionUniqueName
Numele soluției		 Numele unic al soluției.
AddRequiredComponents
Orice componente necesare dintr-o altă soluție care depind de componenta soluției		 (Opțional) Indică dacă alte componente ale soluției necesare pentru componenta soluției pe care o adăugați ar trebui adăugate și la soluția negestionată.
Environment
URL sau ID de mediu		 (Opțional) Adresa URL a mediului sau ID-ul mediului țintă.

Aplicați upgrade la soluția Power Platform

Face upgrade la o soluție care a fost importată ca soluție de reținere.

Fragment YAML (upgrade)

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

Parametri (upgrade)

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final de serviciu la care doriți să faceți upgrade soluției (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu la care doriți să faceți upgrade soluției (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
SolutionName
Nume Soluție		 (Obligatoriu) Numele soluției la care se aplică un upgrade. Utilizați întotdeauna Numele soluției și nu Numele afișat al acesteia.
AsyncOperation
Upgrade asincron		 Dacă este selectată opțiunea (adevărat), operația de upgrade va fi efectuată ca lucrare cu loturi asincrone. Selectarea modului asincron va sonda și va aștepta până când MaxAsyncWaitTime a fost atins.
MaxAsyncWaitTime
Timp maxim de așteptare		 Timpul maxim de așteptare în minute pentru operațiunea asincronă; implicit este 60 min (1 oră), la fel ca implicit Azure DevOps pentru task-uri.

Notă

Variabilele vă oferă un mod convenabil de a introduce biți cheie de date în diferite părți ale canalului. Consultați Utilizați variabile predefinite pentru o listă cuprinzătoare. Puteți completa în prealabil referințele de conexiune și informații despre variabilele de mediu pentru mediul țintă în timp ce importați o soluție utilizând un fișier de setări de implementare.

Mai multe informații: Prepopulați referințele de conexiune și variabilele de mediu. pentru implementări automate

Export soluție Power Platform

Exportă o soluție dintr-un mediu sursă.

Fragment YAML (export)

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

Parametri (export)

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final de serviciu la care doriți să faceți upgrade soluției (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu la care doriți să faceți upgrade soluției (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
SolutionName
Nume Soluție		 (Necesar) Denumirea soluției de exportat. Utilizați întotdeauna Numele soluției și nu Numele afișat al acesteia.
SolutionOutputFile
Fișier de ieșire al soluției		 (Obligatoriu) Calea și numele fișierului solution.zip în care se va exporta mediul sursă (de exemplu, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Notă: Variabilele vă oferă o modalitate convenabilă de a introduce date cheie în diferite părți ale canalului dvs. de lucru. Consultați Utilizați variabile predefinite pentru o listă cuprinzătoare.
AsyncOperation
Export asincron		 Dacă este selectată opțiunea (adevărat), operația de export va fi efectuată ca lucrare cu loturi asincrone. Selectarea modului asincron va sonda și va aștepta până când MaxAsyncWaitTime a fost atins.
MaxAsyncWaitTime
Timp maxim de așteptare		 Timpul maxim de așteptare în minute pentru operațiunea asincronă; implicit este 60 min (1 oră), la fel ca implicit Azure DevOps pentru task-uri.
Managed
Export ca gestionat		 Dacă este selectat (adevărat), exportați soluția ca soluție gestionată; în caz contrar, exportați ca soluție negestionată.
ExportAutoNumberingSettings
Exportați setările de numerotare automată		 Exportați setările de numerotare automată (adevărat|fals).
ExportCalendarSettings
Exportați setările calendarului		 Exportați setările calendarului (adevărat|fals).
ExportCustomizationSettings
Exportați setările de particularizare		 Exportați setările de particularizare (adevărat|fals).
ExportEmailTrackingSettings
Exportați setările de urmărire a e-mailurilor		 Exportați setările de urmărire a e-mailului (adevărat|fals).
ExportGeneralSettings
Exportați setările generale		 Exportați setările generale (adevărat|fals).
ExportIsvConfig
Exportați configurația ISV		 Exportați configurația ISV (adevărat|fals).
ExportMarketingSettings
Exportați setările pentru marketing		 Exportați setările pentru marketing (adevărat|fals).
ExportOutlookSynchronizationSettings
Setări de sincronizare Outlook export		 Exportă setările de sincronizare Outlook (adevărat|fals).
ExportRelationshipRoles
Exportați rolurile de relație		 Exportați rolurile de relație (adevărat|fals).
ExportSales
Exportă vânzări		 Exportă vânzări (adevărat|fals).

Despachetare soluție Power Platform

Preia o soluție comprimată și o descompune în mai multe fișiere XML astfel încât aceste fișiere să poată fi citite și gestionate mai ușor de un sistem de control sursă.

Fragment YAML (despachetare)

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

Parametri (despachetare)

Parametri Descriere
SolutionInputFile
Fișier de intrare al soluției		 (Necesar) Calea și numele fișierului pentru fișierul solution.zip de despachetat.
SolutionTargetFolder
Folderul țintă pentru a despacheta soluția		 (Necesar) Calea și folderul țintă în care doriți să despachetați soluția.
SolutionType
Tipul soluției		 (Necesar) Tipul de soluție pe care doriți să o despachetați. Opțiunile includ: Negestionat (recomandat), Gestionat, și Ambele.

Împachetare soluție Power Platform

Împachetează o soluție reprezentată în controlul sursei într-un fișier solution.zip care poate fi importat într-un alt mediu.

Fragment YAML (împachetare)

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

Parametri (împachetare)

Parametri Descriere
SolutionOutputFile
Fișier de ieșire al soluției		 (Necesar) Calea și numele fișierului pentru fișierul solution.zip în care se va împacheta soluția.
SolutionSourceFolder
Folderul sursă al soluției de împachetat		 (Necesar) Calea și folderul sursă al soluției de împachetat.
SolutionType
Tipul soluției		 (Necesar) Tipul de soluție pe care doriți să o împachetați. Opțiunile includ: Gestionat (recomandat), Negestionat, și Ambele.

Ștergeți soluția Power Platform

Șterge o soluție din mediul țintă.

Fragment YAML (ștergere)

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'

Parametri (ștergere)

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final de serviciu de la care doriți să ștergeți soluția (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu de la care doriți să ștergeți soluția (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
SolutionName
Nume Soluție		 (Obligatoriu) Numele soluției care trebuie ștearsă. Utilizați întotdeauna Numele soluției și nu Numele afișat al acesteia.

Publicarea particularizărilor Power Platform

Publică toate particularizările într-un mediu.

Fragment YAML (publicare)

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

Parametri (publicare)

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final de serviciu în care doriți să publicați personalizările (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu în care doriți să publicați personalizările (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu

Setare versiune soluție Power Platform

Actualizează versiunea unei soluții.

Fragment YAML (versiunea)

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

Parametri (versiunea)

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final de serviciu pentru care doriți să setați versiunea soluției (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu pentru care doriți să setați versiunea soluției (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
SolutionName
Nume Soluție		 (Obligatoriu) Numele soluției pentru care se configurează versiunea. Utilizați întotdeauna Numele soluției și nu Numele afișat al acesteia.
SolutionVersionNumber
Număr versiune soluție		 (Necesar) Numărul versiunii pe care doriți să îl setați.

Deși numărul de versiune poate fi codificat fix în pipeline, se recomandă utilizarea unei variabile Azure DevOps pipeline, cum ar fi BuildId. Aceasta oferă opțiuni pentru a defini forma exactă a numărului de versiune în fila "Opțiuni", de exemplu: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Această definiție poate fi apoi utilizată în sarcina Setare versiune soluție setând proprietatea Number de versiune cu: $(Build.BuildId) în loc de codarea pe hard 20200824.0.0.2.

Alternativ, o ieșire a unui script de activitate Powershell inline $(Get-Date -Format yyyy.MM.dd.HHmm) setat la o variabilă goală numită SolutionVersion ca Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), configurați versiunea soluției ca $(SolutionVersion).

Power Platform Setați variabilele de conexiune

Setează PowerPlatformSetConnectionVariables.BuildTools.* variabile pentru a oferi acces la sarcini de script personalizate pentru a utiliza conexiunea de serviciu ca sursă unică de adevăr.

Sunt setate următoarele variabile:

  • PowerPlatformSetConnectionVariables.BuildTools.TenantId
  • PowerPlatformSetConnectionVariables.BuildTools.ApplicationId
  • PowerPlatformSetConnectionVariables.BuildTools.ClientSecret
  • PowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString

Fragment 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 Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final al serviciului pentru care doriți să setați variabile de conexiune. Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
timeoutInMinutes
Perioadă de expirare		 Specifică timpul maxim, în minute, în care o sarcină poate fi executată înainte de a fi anulată de server. O valoare zero indică o expirare infinită.
retryCountOnTaskFailure
Numărul de reîncercări dacă sarcina a eșuat		 Specifică numărul de reîncercări pentru această sarcină care vor avea loc în cazul eșecului sarcinii. Nu este acceptat pentru sarcini fără agent.
ApplicationId
ID-ul aplicației pentru autentificare		 (Obligatoriu pentru nume de utilizator/parolă) ID-ul aplicației de utilizat pentru autentificare (consultați nota suplimentară de mai jos).
RedirectUri
URI-ul de redirecționare al aplicației specificate		 (Obligatoriu pentru nume de utilizator/parolă) URI-ul de redirecționare al aplicației specificate. Necesar la specificarea unui ID de aplicație. (Consultați nota suplimentară de mai jos).

Notă

Când se utilizează tipul de autentificare nume de utilizator/parolă, vor fi necesare ID-ul aplicației și Uri-ul de redirecționare. Acest document *authenticate oauth* conține o explicație a motivului pentru care trebuie să creați o înregistrare a aplicației pentru a vă autentifica . Dataverse Când vă conectați utilizând autentificarea cu nume de utilizator/parolă, conexiunea se comportă ca o aplicație care se conectează în numele unui utilizator Dataverse.

Implementare pachet Power Platform

Implementează un pachet într-un mediu. Implementarea unui pachet spre deosebire de un singur fișier de soluție vă asigură opțiunea de a implementa mai multe soluții, date și cod într-un mediu.

Fragment YAML (implementare)

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

Parametri (implementare)

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final de serviciu în care doriți să implementați pachetul (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu în care doriți să implementați pachetul (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
PackageFile
Fișier pachet		 (Obligatoriu) Calea și numele fișierului ansamblului de fișiere al pachetului (.dll).
MaxAsyncWaitTime
Timp maxim de așteptare		 Timpul maxim de așteptare în minute pentru operațiunea asincronă; implicit este 60 min (1 oră), la fel ca implicit Azure DevOps pentru task-uri.

Sarcini pentru gestionarea mediului

Automatizarea sarcinilor comune de gestionare a ciclului de viață a mediului (ELM).

Crearea unui mediu Power Platform

Crearea unui mediu nou. Crearea unui mediu nou creează, de asemenea, automat BuildTools.EnvironmentUrl.

Important

Când opțiunea este setată, BuildTools.EnvironmentUrl se va folosi drept conexiune de serviciu implicită pentru activitățile ulterioare în canal. Fiecare activitate descrisă în acest articol utilizează punctul final de la conexiunea de serviciu numai atunci când BuildTools.EnvironmentUrl nu este setat.

Un mediu nou poate fi configurat doar dacă licența sau capacitatea dvs. permite crearea de medii suplimentare. Pentru mai multe informații despre modul de vizualizare a capacității, consultați Detalii despre pagina de capacitate.

Fragment YAML (creare mediu)

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

Parametri (creare mediu)

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final de serviciu pentru care doriți să creați mediul (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu pentru care doriți să creați mediul (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
DisplayName
Nume afișat		 (Obligatoriu) Numele afișat al mediului creat.
LocationName
Regiune de implementare		 (Obligatoriu) Regiunea în care mediul ar trebui să fie creat.
EnvironmentSku
Tip de mediu		 (Obligatoriu) Tipul de instanță de implementat. Opțiunile sunt Sandbox, Producție, Încercare și SubscriptionBasedTrial.
AppsTemplate
Aplicații		 Pentru un tip de mediu fără încercare, aplicațiile acceptate sunt D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation și D365_Sales.
CurrencyName
Moneda		 (Obligatoriu) Moneda de bază pentru mediul creat. Moneda nu poate fi actualizată după crearea mediului.
LanguageName
Limbă		 (Obligatoriu) Limba de bază în mediu.
DomainName
Nume domeniu		 (Obligatoriu) Acesta este șirul specific mediului care face parte din adresa URL. De exemplu, pentru un mediu cu următoarea adresă URL: https://powerappsbuildtasks.crm.dynamics.com/, numele de domeniu ar fi „powerappsbuildtasks”.

Notă: Dacă introduceți un nume de domeniu care este deja utilizat, sarcina adaugă o valoare numerică la numele de domeniu, începând cu 0. Pentru exemplul de mai sus, URL-ul ar putea deveni https://powerappsbuildtasks0.crm.dynamics.com/.

Ștergerea unui mediu Power Platform

Șterge un mediu.

Fragment YAML (ștergere mediu)

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

Parametri (ștergere mediu)

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final de serviciu pentru care doriți să ștergeți mediul (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu pentru care doriți să ștergeți mediul (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.

Power Platform Atribuire utilizator

Atribuiți un utilizator unui mediu țintă cu un rol de securitate specificat.

Fragment 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 Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu pentru mediul căruia doriți să îi atribuiți utilizatorul (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
User
Power Platform nume de utilizator		 ID-ul obiectului Microsoft Entra sau numele principal al utilizatorului pentru a fi atribuit mediului țintă.
Role
Numele sau ID-ul rolului de securitate		 Numele sau ID-ul rolului de securitate care va fi atribuit utilizatorului.
ApplicationUser
Power Platform nume de utilizator al aplicației		 Specifică dacă utilizatorul introdus este un utilizator al aplicației (true|false).

Power Platform Resetare mediu

Resetează un mediu.

Fragment 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 Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final de serviciu pentru care doriți să resetați mediul (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu pentru care doriți să resetați mediul (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.

Mediu de backup Power Platform

Salvează un mediu.

Fragment YAML (backup mediu)

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

Parametri (backup mediu)

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final de serviciu pentru care doriți să creați o copie de rezervă a mediului (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu pentru care doriți să creați o copie de rezervă a mediului (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
BackupLabel
Eticheta backupului		 (Obligatoriu) Eticheta care trebuie atribuită copiei de rezervă.

Copiere mediu Power Platform

Copiază un mediu într-un mediu țintă. Două tipuri de copii sunt disponibile: complete și minime. O copie Completă include atât date cât și metadate ale soluției (particularizări), în timp ce o copie minimă include doar metadatele soluției și nu datele reale.

Fragment YAML (copiere mediu)

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

Parametri (copiere mediu)

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final de serviciu pentru mediul sursă din care doriți să copiați (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu pentru mediul sursă din care doriți să copiați (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
TargetEnvironmentUrl
URL al mediului țintă		 (Obligatoriu) Adresa URL pentru mediul țintă în care doriți să copiați.
CopyType
Tip copiere		 Tipul de copiere de realizat: FullCopy sau MinimalCopy
OverrideFriendlyName
Înlocuiți numele prietenos		 Schimbați numele prietenos al mediului țintă cu un alt nume (adevărat|fals).
FriendlyName
Nume prietenos		 Nume prietenos al mediului țintă.
SkipAuditData
Sari peste date de audit		 Dacă se vor omite datele de audit în timpul operațiunii de copiere. (adevărat|fals).
MaxAsyncWaitTime
Timp maxim de așteptare		 Timpul maxim de așteptare în minute pentru operațiunea asincronă; implicit este 60 min (1 oră), la fel ca implicit Azure DevOps pentru task-uri.

Power Platform Restaurați mediul

Restabilește un mediu la o copie backup dată.

Fragment 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 Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformEnvironment
Power Platform adresă URL pentru mediu		 Punctul final de serviciu pentru mediul sursă din care doriți să restaurați (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu pentru mediul sursă din care doriți să restaurați (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
RestoreLatestBackup
Cea mai recentă copie de rezervă de restaurat		 Indiferent dacă se restaurează cea mai recentă copie de rezervă sau se furnizează RestoreTimeStamp (true|false).
RestoreTimeStamp
Data și ora copiei de rezervă		 Data și ora copiei backup în format „ll/zz/aaaa hh: mm” SAU șirul „latest”.
TargetEnvironmentUrl
URL al mediului țintă		 (Obligatoriu) Adresa URL pentru mediul țintă pe care doriți să îl restaurați.
FriendlyName
Numele mediului restaurat		 (Opțional) Numele mediului restaurat.
DisableAdminMode
Dezactivați modul de administrare		 Dacă dezactivați sau nu modul de administrare (adevărat|fals).

Exportați date Dataverse

Exportați date dintr-un mediu cu schema furnizată.

Fragment 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 Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu pentru mediul din care doriți să exportați date (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
SchemaFile
Numele fișierului XML al schemei		 Numele fișierului XML al schemei. Poate fi creat folosind instrumentul Configuration Migration.
DataFile
Numele fișierului de date		 Numele fișierului pentru datele de exportat (fișier zip).
Overwrite
Suprascrierea conținutului		 Conținutul site-ului Power Pages pentru suprascriere (adevărat|fals).

Importați date Dataverse

Importați date într-un mediu.

Fragment 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 Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu pentru mediul în care doriți să importați date (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
DataFile
Numele fișierului de date		 Numele fișierului pentru fișierul de date comprimat (zip) care va fi importat sau folderul cu data-schema.xml și data.xml care va fi importat.

Sarcini de gestionare Power Pages

Sarcini pentru lucrul cu un site Power Pages.

Power Platform Descărcare PAPortal

Descărcați conținutul site-ului web Power Pages din mediul Dataverse curent.

Fragment 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 Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu pentru mediul din care doriți să descărcați conținut (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
WebsiteId
ID-ul site-ului web al portalului		 ID site-ul Power Pages pentru descărcare.
Overwrite
Suprascrierea conținutului		 Conținutul site-ului Power Pages pentru suprascriere (adevărat|fals).
ModelVersion
Modelul de date al site-ului		 Indică dacă datele de pe site care vor fi încărcate vor utiliza modelul de date standard (1) sau modelul de date îmbunătățit ( ) ( ).2 Valoarea implicită este „1”.

Power Platform Încărcare PAPortal

Încarcă conținutul site-ului Power Pages în mediul Dataverse actual.

Fragment 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 Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu pentru mediul în care doriți să încărcați conținut (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
UploadPath
Calea de încărcare a conținutului		 Traseul de unde va fi încărcat conținutul site-ului Power Pages.
ModelVersion
Modelul de date al site-ului		 Indică dacă datele de pe site care vor fi încărcate vor utiliza modelul de date standard (1) sau modelul de date îmbunătățit ( ) ( ).2 Valoarea implicită este „1”.

Catalog pentru sarcini (previzualizare) Power Platform

Aceste sarcini efectuează acțiuni asupra catalogului în Power Platform și includ următoarele.

Notă

În prezent, activitățile de catalog pentru Power Platform sunt o versiune de previzualizare .

Instalați elementul din catalog

Instalați un element de catalog în mediul țintă.

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final de serviciu pentru mediul în care doriți să încărcați conținut (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
Environment
URL al mediului țintă		 (Obligatoriu) URL-ul mediului vizat de această sarcină.
CatalogItemId
ID-ul articolului din catalog care va fi instalat		 (Obligatoriu) Element de catalog care va fi instalat în mediul țintă.
TargetEnvironmentUrl
URL al mediului țintă		 (Obligatoriu) URL-ul mediului țintă pentru instalarea elementelor din catalog (de exemplu, „https://YourOrg.crm.dynamics.com”).
PollStatus
Verificați starea sondajului		 (Opțional) Sondaj pentru a verifica starea solicitării dvs. (adevărat|fals).

Parametri (instalare catalog)

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

Trimiteți aprobarea catalogului

Trimiteți solicitarea de aprobare pentru catalog.

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final al serviciului pentru mediul în care doriți să încărcați conținut (de exemplu, „https://powerappsbuildtools.crm.dynamics.com”). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
Environment
URL al mediului țintă		 (Obligatoriu) URL-ul mediului vizat de această sarcină.
CatalogSubmissionFile
Fișier de trimitere a catalogului		 (Obligatoriu) Specificați calea și numele fișierului de trimitere a catalogului.
UsePackageSolutionZipFile
Tipul fișierului		 Tip fișier: fișier zip pachet sau soluție.
SolutionZipFile
Numele fișierului zip al soluției		 Specificați calea și numele fișierului zip al soluției.
PollStatus
Verificați starea sondajului		 (Opțional) Sondaj pentru a verifica starea solicitării dvs. (adevărat|fals).

Parametri (trimitere catalog)

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

Starea solicitării de catalog

Obțineți starea solicitării de instalare/trimitere a catalogului.

Parametri Descriere
authenticationType
Tipul de autentificare		 (Obligatoriu pentur SPN) Specificați fie PowerPlatformEnvironment pentru o conexiune cu nume de utilizator/parolă sau PowerPlatformSPN pentru o conexiune cu secret entitate principală de serviciu/client.
PowerPlatformSPN
Entitate principală de serviciu Power Platform		 Punctul final al serviciului pentru mediul în care doriți să încărcați conținut (de exemplu, „https://powerappsbuildtools.crm.dynamics.com”). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
Environment
URL al mediului țintă		 (Obligatoriu) URL-ul mediului vizat de această sarcină.
TrackingId
Solicitați ID-ul de urmărire		 (Obligatoriu) Solicitați ID de urmărire.
RequestType
Tip solicitare		 (Obligatoriu) Tipul solicitării. (Valori: Instalare | Trimitere).

Parametri (starea catalogului)

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

Construiți și lansați canale

Acum că am identificat ce se poate face folosind instrumentele de implementare, să vedem cum ați putea să aplicați aceste instrumente la canalele dvs. de implementare și lansare. O imagine de ansamblu conceptuală este prezentată mai jos. Să vedem câteva detalii despre implementarea canalelor folosind sarcinile instrumentului de implementare din sub-secțiunile care urmează.

Pentru a afla mai multe despre crearea acestor pipeline-uri și pentru a face efectiv authoring practic de pipeline folosind Microsoft Power Platform Build Tools, completează laboratoarele build tools, pe care le poți descărca de pe GitHub.

Mai multe informații despre Azure Pipelines: Folosește Azure Pipelines

Construiți canale: Exportați o soluție dintr-un mediu de dezvoltare (DEV)

Figura următoare arată sarcinile instrumentului de implementare pe care îl puteți adăuga la un canal care exportă o soluție dintr-un mediu de dezvoltare.

Exportați o soluție dintr-un mediu de dezvoltare (DEV).

Construiți canalul: construiți o soluție gestionată

Figura următoare arată sarcinile instrumentului de implementare pe care îl puteți adăuga la un canal care implementează o soluție gestionată.

Construiți o soluție gestionată.

Canal de lansare: implementați către un mediu de producție (PROD)

Figura următoare arată sarcinile instrumentului de implementare pe care îl puteți adăuga la un canal care lansează către un mediu de protecție.

Implementați într-un mediu de producție (PROD).

Consultați și

Microsoft Power Platform Build Tools pentru Azure DevOps

  • Last updated on