Partajați prin

Activități Microsoft Power Platform Build Tools

  • Articol

Sarcinile de implementare disponibile sunt descrise în secțiunile următoare. Apoi, prezentăm câteva exemple de Azure Pipelines care utilizează aceste sarcini. Pentru informații despre instrumentele de compilare și despre cum să le descărcați, consultați Microsoft Power Platform Instrumente de compilare pentru Azure Pipelines.

Sarcină asistent

Sarcinile de ajutor 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 instrumente specifice Power Platform cerute de agent pentru a rula sarcinile de implementare Microsoft Power Platform. Această sarcină nu necesită o configurare suplimentară atunci când este adăugată. Această sarcină conține parametri pentru versiunile specifice ale fiecăreia 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@0
  displayName: 'Power Platform Tool Installer'

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

Parametri (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.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Versiunea instrumentului		 Versiunea specifică a instrumentului de utilizat.

Power Platform 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@0
  displayName: 'Power Platform WhoAmI'

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

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

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

Parametri (WhoAmI)

Parametri 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 sarcinile disponibile pentru verificarea calității unei soluții.

Power Platform Checker

Această sarcină execută o verificare de analiză 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 din greșeală la construirea soluției.

Fragment YAML (verificator)

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

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

Parametri (verificator)

Parametri Descriere
PowerPlatformSPN
Conexiune de serviciu		 (Obligatoriu) O conexiune la un mediu licențiat Microsoft Power Platform este necesară pentru utilizarea verificatorului 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 Crearea mediului

Notă: Principalul serviciu și metodele de autentificare a numelui de utilizator/parolă sunt disponibile pentru sarcina de verificare. 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-ul Checker.
FileLocation
Locația fișierelor de analizat		 Obligatoriu atunci când faceți referire la un fișier dintr-o adresă URL a semnăturii de acces partajat (SAS) sasUriFile.

Notă: este important să faceți referire la un fișier de soluție exportat și nu la fișierele sursă dezambalate din arhivă. 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 atunci 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 OverrideLevel sunt: Critic, Ridicat, Mediu, Scăzut, 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 care rulează de pe Power Apps portalul de producție.
  • AppSource: setul de reguli extins care este utilizat pentru a certifica o aplicație înainte de a putea fi publicată în AppSource.
ErrorLevel
Nivel de eroare		 Combinat cu eroarea, parametrul prag definește severitatea erorilor și avertismentelor care sunt 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 opțiunea este setată la adevărat, eșuează dacă analiza verificatorului Power Apps este returnată ca Eșuat sau FinishedWithErrors.
ArtifactDestinationName
Numele artefactului DevOps		 Specificați numele Azure Artefacts pentru fișierul verificator .sarif.

Sarcini soluție

Acest set de sarcini poate automatiza acțiunile soluției. Sarcinile de mediu prezentate 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 împotriva mediilor care sunt 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@0
  displayName: 'Power Platform Import Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    HoldingSolution: true
    OverwriteUnmanagedCustomizations: true
    SkipProductUpdateDependencies: true
    ConvertToManaged: true

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

Parametri (import)

Parametri 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 al serviciului î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 al serviciului î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 soluției .zip de importat în mediul țintă (de exemplu, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

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.
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		 Specificați dacă să importați ca soluție gestionată (adevărat|fals).
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 funcționarea asincronă; implicit este 60 min (1 oră), la fel ca valoarea implicită Azure DevOps pentru activități.
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 componenta soluție

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

YAML fragment (Adăugați)

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ăugați)

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 Utilizați tipurile de componente predefinite pentru o listă cuprinzătoare a valorilor componentelor.
SolutionUniqueName
Numele soluției		 Denumirea unică a soluției.
AddRequiredComponents
Orice componente necesare altei soluții depind de componenta soluției		 (Opțional) Indică dacă alte componente ale soluției care sunt cerute de componenta soluției pe care o adăugați ar trebui adăugate și la soluția negestionată.
Environment
Adresa URL sau ID-ul mediului		 (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@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    AsyncOperation: false

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

Parametri (upgrade)

Parametri 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 al serviciului în care doriți să actualizaț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 al serviciului în care doriți să actualizaț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 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 funcționarea asincronă; implicit este 60 min (1 oră), la fel ca valoarea implicită Azure DevOps pentru activități.

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@0
  displayName: 'Power Platform Export Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120

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

Parametri (export)

Parametri 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 al serviciului în care doriți să actualizaț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 al serviciului în care doriți să actualizaț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		 (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 soluție.zip în care să exportați mediul sursă (de exemplu, $(Build.ArtifactStagingDirectory)$(SolutionName).zip ).

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.
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 funcționarea asincronă; implicit este 60 min (1 oră), la fel ca valoarea implicită Azure DevOps pentru activități.
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
Exportați setările de sincronizare Outlook		 Exportați 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@0
  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@0
  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@0
  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 al serviciului pe care doriți să îl ș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 al serviciului pe care doriți să îl ș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@0
  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 al serviciului pe 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 al serviciului pe 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@0
  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 al serviciului pe care doriți să îl 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 al serviciului pe care doriți să îl 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 versiunii poate fi cu codare impusă în canal, se recomandă utilizarea unei variabile de canal Azure DevOps, 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ă variabilele BuildTools.* pentru a oferi acces la sarcini de script personalizate pentru a utiliza conexiunea de serviciu ca o singură sursă de adevăr.

YAML fragment (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ă un timeout infinit.
retryCountOnTaskFailure
Numărul de încercări dacă sarcina a eșuat		 Specifică numărul de reîncercări pentru această sarcină care va avea loc în cazul eșecului sarcinii. Nu este acceptat pentru sarcini fără agent.
ApplicationId
Id-ul aplicației pentru autentificare		 (Necesar pentru numele de utilizator/parola) Id-ul aplicației de utilizat pentru autentificare (Consultați nota suplimentară de mai jos).
RedirectUri
URI de redirecționare al aplicației specificate		 (Necesar pentru numele de utilizator/parola) URI de redirecționare al aplicației specificate. Este necesar la specificarea unui ID de aplicație. (Vezi nota suplimentară de mai jos).

Notă

Când utilizați tipul de autentificare cu nume de utilizator/parolă, vor fi necesare ID-ul aplicației și Uri de redirecționare. Acest document autentificare oauth are 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 folosind autentificarea nume de utilizator/parolă, conexiunea se comportă ca o aplicație la 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@0
  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 al serviciului î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 al serviciului î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 funcționarea asincronă; implicit este 60 min (1 oră), la fel ca valoarea implicită Azure DevOps pentru activități.

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 nou mediu poate fi furnizat numai dacă licența sau capacitatea dvs. permit 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@0
  displayName: 'Power Platform Create Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    DisplayName: 'First Coffee test'
    DomainName: firstcoffee

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

Parametri (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 al serviciului pe care doriți să îl 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 al serviciului pe care doriți să îl 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
Monedă		 (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ă numelui 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@0
  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 al serviciului pe care doriți să îl ș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 al serviciului pe care doriți să îl ș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 Atribuiți utilizator

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

YAML fragment (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 al serviciului 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		 Microsoft Entra ID-ul obiectului sau numele principal al utilizatorului de atribuit mediului țintă.
Role
Rol de securitate nume sau ID		 Rol de securitate numele sau ID-ul care urmează să fie atribuit utilizatorului.
ApplicationUser
Power Platform numele de utilizator al aplicației		 Specifică dacă utilizatorul de intrare este un utilizator de aplicație (adevărat|fals).

Power Platform Resetați mediul

Resetează un mediu.

YAML fragment (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 al serviciului pe 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 al serviciului pe 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@0
  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 al serviciului pentru care doriți să faceți backup pentru mediu (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 al serviciului pentru care doriți să faceți backup pentru mediu (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@0
  displayName: 'Power Platform Copy Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'

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

Parametri (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 al serviciului 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 al serviciului 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ă.
DisableAdminMode
Dezactivați modul de administrare		 Dacă dezactivați sau nu modul de administrare (adevărat|fals).

Power Platform Restaurați mediul

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

YAML fragment (Restaurare-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 al serviciului 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 al serviciului 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
Ultimul backup de restaurat		 Dacă trebuie să restaurați cea mai recentă copie de rezervă sau să furnizați RestoreTimeStamp (adevărat|fals).
RestoreTimeStamp
DateTime 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 Dataverse date

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

YAML fragment (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 al serviciului 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 cu schemă		 Numele fișierului XML cu schemă. Poate fi creat folosind instrumentul de migrare a configurației.
DataFile
Nume fișier de date		 Numele fișierului pentru datele de exportat (fișier zip).
Overwrite
Suprascrie conținut		 Power Pages conținutul site-ului web de suprascris (adevărat|fals).

Importați Dataverse date

Importați date într-un mediu.

YAML fragment (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 al serviciului pentru mediul pe care doriți să îl importați (de exemplu, https://powerappsbuildtools.crm.dynamics.com). Definit sub Conexiuni servicii în Setările proiectului folosind tipul de conexiune Power Platform.
DataFile
Nume fișier de date		 Numele fișierului pentru fișierul de date comprimat zip) de importat sau folderul cu data-schema.xml și data.xml de importat.

Power Pages sarcini de management

Sarcini pentru lucrul cu un Power Pages site web.

Power Platform Descărcare PAPortal

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

YAML fragment (descărcare-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 (descărcare-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 al serviciului 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 portalului		 Power Pages ID-ul site-ului de descărcat.
Overwrite
Suprascrie conținut		 Power Pages conținutul site-ului web de suprascris (adevărat|fals).
ModelVersion
Model de date ale site-ului		 Indică dacă datele site-ului care urmează să fie încărcate vor folosi standardul (1) sau modelul de date îmbunătățit (2). Valoarea implicită este „1”.

Power Platform Încărcare PAPortal

Încărcați Power Pages conținutul site-ului web în mediul Dataverse actual.

YAML fragment (încărcare-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 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.
UploadPath
Încărcați calea conținutului		 Calea de unde va fi încărcat Power Pages conținutul site-ului web.
ModelVersion
Model de date ale site-ului		 Indică dacă datele site-ului care urmează să fie încărcate vor folosi standardul (1) sau modelul de date îmbunătățit (2). Valoarea implicită este „1”.

Catalog pentru Power Platform sarcini (previzualizare)

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

Notă

În prezent, sarcinile de catalog pentru Power Platform sunt o versiune previzualizare .

Instalați elementul de 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 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) Adresa URL de mediu vizează această sarcină.
CatalogItemId
ID-ul articolului de catalog care urmează să fie instalat		 (Obligatoriu) Element de catalog care urmează să fie instalat în mediul țintă.
TargetEnvironmentUrl
URL al mediului țintă		 (Obligatoriu) Adresa URL a mediului țintă pentru instalarea articolului de catalog în (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 (catalog-install)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.install-catalog.PowerPlatformInstallCatalog@2
  displayName: 'Power Platform Install Catalog '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    CatalogItemId: '00000000-0000-0000-0000-000000000001'
    TargetEnvironmentUrl: 'https://test.crm.dynamics.com/'
    PollStatus: true

Trimiteți aprobarea pentru catalog

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) Adresa URL de mediu vizează această sarcină.
CatalogSubmissionFile
Fișier de trimitere a catalogului		 (Obligatoriu) Specificați calea și numele fișierului de trimitere a catalogului.
UsePackageSolutionZipFile
Tip fișier		 Tip de 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 (catalog-submit)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.submit-catalog.PowerPlatformSubmitCatalog@2
  displayName: 'Power Platform Submit Catalog '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    CatalogSubmissionFile: submission.json
    UsePackageSolutionZipFile: true
    FileType: SolutionZipFile
    SolutionZipFile: solution.zip
    PollStatus: true

Starea cererii de catalog

Obțineți starea cererii 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) Adresa URL de mediu vizează această sarcină.
TrackingId
Solicitați ID de urmărire		 (Obligatoriu) Solicitați ID de urmărire.
RequestType
Tip solicitare		 (Obligatoriu) Tip cerere. (Valori: Instalați | Trimiteți).

Parametri (catalog-status)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.catalog-status.PowerPlatforCatalogStatus@2
  displayName: 'Power Platform Catalog Status '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    TrackingId: '00000000-0000-0000-0000-000000000002'
    RequestType: Submit

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 canale și pentru a efectua o autorizarea directă a canalelor folosind instrumentele de implementare Microsoft Power Platform Build Tools, completați laboratoarele pentru instrumentele de implementare, pe care le puteți descărca de pe GitHub.

Mai multe informații despre Azure Pipelines: Utilizați 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ă.

Creați un 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).

Vedeți și

Microsoft Power Platform Build Tools pentru Azure DevOps