Sarcini ale uneltelor de build Microsoft Power Platform

Sarcinile de implementare disponibile sunt descrise în secțiunile următoare. Ulterior, prezentăm câteva exemple de Azure Pipelines care utilizează aceste sarcini. Pentru informații despre uneltele de build și cum să le descarci, vezi Microsoft Power Platform Build Tools pentru Azure Pipelines.

Sarcină asistent

Sarcinile auxiliare disponibile sunt descrise în continuare.

Utilitar de instalare a instrumentului Power Platform

Această sarcină trebuie adăugată o dată înaintea oricărei alte sarcini Power Platform Build Tools în construirea și eliberarea conductelor. 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ă sarcină conține parametri pentru versiunile specifice ale fiecăruia dintre instrumentele care sunt instalate.

Pentru a fi la curent cu versiunile instrumentului în timp, asigurați-vă că acești parametri corespund versiunilor instrumentelor care sunt necesare pentru ca conducta să funcționeze 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. Necesar (și fals) când sunt specificate orice versiuni de instrumente.
AddToolsToPath
Adăugați instrumente la cale		 Adaugă cli-ul pac la variabila PATH de mediu. Vă permite să utilizați pac cli din sarcinile de script fără a fi nevoie 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. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
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. Mai multe informații: consultați BuildTools.EnvironmentUrl din Power Platform Creați un mediu
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ă sarcină execută o verificare statică a soluțiilor dvs. în raport cu un set de reguli de bune practici pentru a identifica orice tipare problematice pe care le-ați putea introduce în mod accidental la construirea soluției.

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) Este necesară o conexiune la un mediu licențiat Microsoft Power Platform pentru a folosi verificătorul Power Platform. Conexiunile de serviciu sunt definite în Conexiuni de serviciu sub Setări proiect folosind tipul conexiunii ca Power Platform. Mai multe informații: consultați BuildTools.EnvironmentUrl sub Power Platform Creați un mediu

. Notă: Pentru sarcina de verificare sunt disponibile metode de autentificare principală a serviciului și nume de utilizator/parolă. Pentru mai multe informații despre modul de configurare a coordonatorilor de servicii astfel încât să poată fi utilizați cu această activitate, consultați Configurați conexiunile coordonatorilor 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. Puteți specifica o altă zonă geografică de utilizat, de exemplu https://japan.api.advisor.powerapps.com. Pentru o listă a zonelor geografice disponibile, consultați Utilizarea Power Platform API-ului Checker.
FileLocation
Locația fișierelor de analizat		 Obligatoriu atunci când se face referire la un fișier dintr-o adresă URL cu semnătură cu acces partajat (SAS) sasUriFile.

Notă: Este important să se facă referire la un fișier de soluție exportat și nu la fișierele sursă despachetate din depozit. Atât fișierele soluție gestionate cât și cele negestionate pot fi analizate.
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 mult de un SAS URI printr-o listă separată cu virgulă (,) sau cu punct și virgulă (;).
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. Se pot folosi metacaractere. De exemplu, introduceți **\*.zip pentru toate fișierele zip din toate subfolderele.
FilesToExclude
Fișiere locale de exclus		 Specificați numele fișierelor care vor fi excluse din analiză. Dacă sunt mai multe, furnizați o listă separată prin virgulă (,) sau punct și virgulă (;). Această listă poate include un nume complet de fișier sau un nume cu metacaractere de început sau de final, 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 ÎnlocuireLevel sunt: Critic, Maxim, Mediu, Minim, Informație. 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 care rulează de pe portalul Power Apps maker.
  • 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 de prag, eroare, definește gravitatea erorilor și avertismentelor 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 adevărat, eșuează dacă analiza Power Apps Checker este returnată ca Failed sau FinishedWithErrors.
ArtifactDestinationName
Numele artefactului DevOps		 Specifică numele Azure Artifacts pentru fișierul checker .sarif.

Sarcini soluție

Acest set de sarcini poate automatiza 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. Aceste sarcini fac posibilă efectuarea de sarcini de soluție în medii create 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