Úlohy nástroja vytvárania Microsoft Power Platform

Dostupné úlohy vytvárania sú opísané v nasledujúcich častiach. Potom ukážeme niekoľko príkladov Azure Pipelines, ktoré využívajú tieto úlohy. Informácie o nástrojoch na zostavovanie a ich stiahnutí nájdete v časti Microsoft Power Platform Nástroje na zostavovanie pre Azure Pipelines.

Úloha pomocníka

Dostupné pomocné úlohy sú popísané ďalej.

Inštalátor nástroja Power Platform

Táto úloha sa musí pridať ešte raz pred všetkými ostatnými úlohami pre nástroje na vytváranie v Power Platform pri vytváraní a vydávaní kanálov. Táto úloha nainštaluje množinu nástrojov špecifických pre Power Platform požadovaných agentom na spustenie úloh vytvárania Microsoft Power Platform. Táto úloha po pridaní nevyžaduje žiadnu ďalšiu konfiguráciu. Táto úloha obsahuje parametre pre špecifické verzie každého z nástrojov, ktoré sa inštalujú.

Ak chcete v priebehu času udržiavať aktuálne informácie o verziách nástrojov, uistite sa, že tieto parametre zodpovedajú verziám nástrojov, ktoré sú potrebné na správne fungovanie kanála.

Úryvok YAML (Inštalátor)

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

# 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

Parametre (Inštalátor)

Parametre	Popis
DefaultVersion Použite predvolené verzie nástrojov	Ak chcete použiť predvolenú verziu všetkých nástrojov, nastavte hodnotu true, inak nastavte hodnotu false. Povinné (a false), keď sú špecifikované verzie nástroja.
PowerAppsAdminVersion XrmToolingPackageDeploymentVersion MicrosoftPowerAppsCheckerVersion CrmSdkCoreToolsVersion Verzia nástroja	Konkrétna verzia nástroja, ktorý sa má použiť.

Power Platform WhoAmI

Overuje pripojenie služby prostredia Power Platform prostredníctvom pripojenia a odoslania žiadosti WhoAmI. Môže byť užitočné zahrnúť túto úlohu včas do kanála, aby sa pred začatím spracovania overilo pripojenie.

Úryvok 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'

Parametre (WhoAmI)

Parametre	Popis
authenticationType Typ overenia	(Voliteľné) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby pre prostredie, ku ktorému sa chcete pripojiť. Definované v časti Servisné pripojenia v Nastavenia projektu. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby pre prostredie, ku ktorému sa chcete pripojiť. Definované v časti Servisné pripojenia v Nastavenia projektu.

Kontrola kvality

V ďalšej časti sú dostupné úlohy na kontrolu kvality riešenia.

Power Platform Checker

Táto úloha spustí kontrolu statickej analýzy vašich riešení v porovnaní so súborom pravidiel osvedčených postupov na identifikáciu akýchkoľvek problematických vzorcov, ktoré ste mohli neúmyselne zaviesť pri vytváraní vášho riešenia.

Úryvok YAML (Checker)

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

Parametre (Checker)

Parametre	Popis
PowerPlatformSPN Servisné pripojenie	(Povinné) Pripojenie k licencovanému prostrediu Microsoft Power Platform je potrebné, aby sa mohol používať nástroj na kontrolu Power Platform. Servisné pripojenia sú definované v Servisné pripojenia pod Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Power Platform Vytvorenie prostredia Poznámka: Pre úlohu kontroly sú k dispozícii metódy overenia princípu služby a používateľského mena/hesla. Viac informácií o tom, ako nakonfigurovať hlavné služby, ktoré sa majú používať pri tejto úlohe, nájdete v časti Konfigurácia pripojení hlavných služieb pre prostredia Power Platform.
UseDefaultPACheckerEndpoint Použite predvolený koncový bod Power Platform Checker	V predvolenom nastavení (pravda) geografická poloha služby kontroly používa rovnakú geografiu ako prostredie, ku ktorému sa pripájate.
CustomPACheckerEndpoint Vlastný koncový bod kontroly PAC	Vyžaduje sa, keď má UseDefaultPACheckerEndpoint hodnotu false. Môžete zadať inú geografickú polohu, ktorú chcete použiť, napríklad https://japan.api.advisor.powerapps.com. Zoznam dostupných geografických oblastí nájdete v časti Použitie Power Platform Checker API.
FileLocation Umiestnenie súborov na analýzu	Vyžaduje sa pri odkazovaní na súbor z adresy URL zdieľaného prístupového podpisu (SAS) sasUriFile. Poznámka: Je dôležité odkazovať na exportovaný súbor riešenia a nie na rozbalené zdrojové súbory vo vašom archíve. Je možné analyzovať spravované aj nespravované súbory riešení.
FilesToAnalyzeSasUri Súbory SAS na analýzu	Vyžaduje sa, keď je FileLocation nastavené na sasUriFile. Zadajte URI adresu služby SAS. Môžete pridať viac ako jeden SAS URI prostredníctvom zoznamu oddelenému čiarkami (,) alebo bodkočiarkami (;).
FilesToAnalyze Lokálne súbory na analýzu	Vyžaduje sa, keď sa súbory SAS neanalyzujú. Zadajte cestu a názov súboru .zip súborov, ktoré sa majú analyzovať. Možno použiť zástupné znaky. Zadajte napríklad **\*.zip pre všetky súbory zip vo všetkých podpriečinkoch.
FilesToExclude Lokálne súbory na vylúčenie	Zadajte názvy súborov, ktoré sa majú vylúčiť z analýzy. Ak je ich viac ako jeden, uveďte zoznam oddelený čiarkou (,) alebo bodkočiarkou (;). Tento zoznam môže obsahovať celý názov súboru alebo názov s úvodnými alebo koncovými zástupnými znakmi, ako napríklad *jquery alebo form.js
RulesToOverride Pravidlá na prepísanie	Pole JSON obsahujúce pravidlá a úrovne na prepísanie. Akceptované hodnoty pre OverrideLevel sú: Kritické, vysoké, stredné, nízke, informačné. Príklad: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet Množina pravidiel	(Povinné) Zadajte, ktoré pravidlo sa má použiť. Dostupné sú dve množiny pravidiel: Kontrola riešenia: Táto sada pravidiel je rovnaká ako sada pravidiel, ktorá sa spúšťa z portálu Power Apps maker. AppSource: Rozšírená sada pravidiel, ktorá sa používa na certifikáciu aplikácie pred jej zverejnením na AppSource.
ErrorLevel Úroveň chyby	V kombinácii s chybou určuje parameter prah závažnosť chýb a varovaní, ktoré sú povolené. Podporované prahové hodnoty sú <level > IssueCount, kde úroveň = kritická, vysoká, stredná, nízka a informačná.
ErrorThreshold Prahová hodnota chyby	Definuje počet chýb (>=0) špecifikovanej úrovne, ktoré môže kontrolór prejsť cez kontrolované riešenia.
FailOnPowerAppsCheckerAnalysisError Zlyhanie v prípade chyby	Keď je nastavená hodnota true, zlyhá, ak sa analýza Power Apps Checker vráti ako Failed alebo FinishedWithErrors.
ArtifactDestinationName Názov artefaktu DevOps	Zadajte názov Azure Artifacts pre súbor checker .sarif.

Úlohy riešenia

Táto súprava úloh môže automatizovať akcie riešenia. Úlohy prostredia načrtnuté ďalej v tejto časti, ktoré vytvárajú, kopírujú alebo obnovujú prostredie, prepisujú pripojenia služby novovytvorenými prostrediami. Tieto úlohy umožňujú vykonávať úlohy riešenia voči prostrediam, ktoré sú vytvorené na požiadanie.

Import riešenia v Power Platform

Importuje riešenie do cieľového prostredia.

Úryvok 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
    ConvertToManaged: 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

Parametre (Import)

Parametre	Popis
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby, do ktorého chcete importovať riešenie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby, do ktorého chcete importovať riešenie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
SolutionInputFile Vstupný súbor riešenia	(Povinné) Cesta a názov súboru .zip riešenia, ktorý sa má importovať do cieľového prostredia (napríklad $(Build.ArtifactStagingDirectory)$(SolutionName) .zip). Poznámka: Premenné vám poskytujú pohodlný spôsob, ako dostať kľúčové časti údajov do rôznych častí vášho kanála. Komplexný zoznam je uvedený v článku Použitie vopred definovaných premenných.
HoldingSolution Import ako zadržiavacie riešenie	Parameter (pravda|nepravda) vopred používaný vtedy, keď je potrebné aktualizovať riešenie. Tento parameter je hostiteľom riešenia v Dataverse, ale neaktualizuje riešenie, kým sa nespustí úloha Použiť aktualizáciu riešenia.
OverwriteUnmanagedCustomizations Prepísať nespravované prispôsobenia	Zadajte, či sa majú prepísať nespravované prispôsobenia (pravda|nepravda).
SkipProductUpdateDependencies Preskočenie závislostí aktualizácie produktu	Zadajte, či sa má preskočiť presadzovanie závislostí súvisiacich s aktualizáciami produktu (pravda|nepravda).
ConvertToManaged Konvertovať na spravované	Zadajte, či chcete importovať ako spravované riešenie (pravda|nepravda).
AsyncOperation Asynchrónny import	Ak je vybraté (true), operácia importu sa vykoná asynchrónne. Toto sa odporúča pre väčšie riešenia, pretože inak táto úloha automaticky vyprší po 4 minútach. Výberom asynchrónnej možnosti sa bude dotazovať a čakať, kým sa nedosiahne MaxAsyncWaitTime (pravda|nepravda).
MaxAsyncWaitTime Maximálny čas čakania	Maximálny čas čakania v minútach pre asynchrónnu operáciu; predvolená hodnota je 60 minút (1 hodina), rovnako predvolené Azure DevOps pre úlohy.
PublishWorkflows Aktivujte procesy po importe	Zadajte, či sa majú niektoré procesy (pracovné postupy) v riešení aktivovať po importe (pravda|nepravda).
UseDeploymentSettingsFile Použitie súboru nastavení nasadenia	Odkazy na pripojenie a hodnoty premenných prostredia je možné nastaviť pomocou súboru nastavení nasadenia (pravda|nepravda).
DeploymentSettingsFile Súbor s nastaveniami nasadenia	(Vyžaduje sa, keď UseDeploymentSettingsFile=true) Cesta a názov súboru s nastaveniami nasadenia.

Power Platform Pridajte komponent roztoku

Pridá komponent riešenia do nespravovaného riešenia.

Útržok YAML (pridať)

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

Parametre (Pridať)

Parametre	Description
ComponentId ID komponentu riešenia	Názov schémy alebo ID súčasti, ktorá sa má pridať do cieľového riešenia.
ComponentType Adresa URL prostredia Power Platform	Hodnota, ktorá predstavuje komponent riešenia, ktorý pridávate. Úplný zoznam hodnôt komponentov nájdete v časti Používanie preddefinovaných typov komponentov .
SolutionUniqueName Názov riešenia	Jedinečný názov riešenia.
AddRequiredComponents Akékoľvek komponenty požadované z iného riešenia závisia od komponentu riešenia	(Voliteľné) Označuje, či by sa do nespravovaného riešenia mali pridať aj ďalšie komponenty riešenia, ktoré vyžaduje komponent riešenia, ktorý pridávate.
Environment Webová adresa alebo ID prostredia	(Voliteľné) URL prostredia alebo ID cieľového prostredia.

Power Platform Aplikovať inováciu riešenia

Aktualizuje riešenie, ktoré bolo importované ako udržiavacie riešenie.

Úryvok YAML (Inovácia)

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

Parametre (Inovácia)

Parametre	Popis
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby, na ktorý chcete inovovať riešenie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby, na ktorý chcete inovovať riešenie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
SolutionName Názov riešenia	(Povinné) Názov riešenia na použitie inovácie. Vždy používajte Názov riešenia, nie jeho Zobrazovací názov.
AsyncOperation Asynchrónne inovovanie	Ak je vybraté (true), operácia inovovania sa vykoná ako asynchrónna dávková úloha. Výberom asynchrónnej možnosti sa bude dotazovať a čakať, kým sa nedosiahne MaxAsyncWaitTime.
MaxAsyncWaitTime Maximálny čas čakania	Maximálny čas čakania v minútach pre asynchrónnu operáciu; predvolená hodnota je 60 minút (1 hodina), rovnako predvolené Azure DevOps pre úlohy.

Export riešenia v Power Platform

Exportuje riešenie zo zdrojového prostredia.

Úryvok 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

Parametre (Export)

Parametre	Popis
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby, na ktorý chcete inovovať riešenie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby, na ktorý chcete inovovať riešenie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
SolutionName Názov riešenia	(Povinné) Názov riešenia, ktoré sa má exportovať. Vždy používajte Názov riešenia, nie jeho Zobrazovací názov.
SolutionOutputFile Výstupný súbor riešenia	(Povinné) Cesta a názov súboru solution.zip, do ktorého sa má exportovať zdrojové prostredie (napríklad $(Build.ArtifactStagingDirectory)$(SolutionName).zip ). Poznámka: Premenné vám poskytujú pohodlný spôsob, ako dostať kľúčové časti údajov do rôznych častí vášho kanála. Komplexný zoznam je uvedený v článku Použitie vopred definovaných premenných.
AsyncOperation Asynchrónny export	Ak je vybraté (true), operácia exportu sa vykoná ako asynchrónna dávková úloha. Výberom asynchrónnej možnosti sa bude dotazovať a čakať, kým sa nedosiahne MaxAsyncWaitTime.
MaxAsyncWaitTime Maximálny čas čakania	Maximálny čas čakania v minútach pre asynchrónnu operáciu; predvolená hodnota je 60 minút (1 hodina), rovnako predvolené Azure DevOps pre úlohy.
Managed Exportovať ako spravované	Ak je vybraté (true), exportovať riešenie ako spravované riešenie; inak exportovať ako nespravované riešenie.
ExportAutoNumberingSettings Exportovať nastavenia automatického číslovania	Exportovať nastavenia automatického číslovania (pravda|nepravda).
ExportCalendarSettings Exportovať nastavenia kalendára	Exportovať nastavenia kalendára (pravda|nepravda).
ExportCustomizationSettings Exportovať nastavenia prispôsobenia	Exportovať nastavenia prispôsobenia (pravda|nepravda).
ExportEmailTrackingSettings Export nastavení sledovania e-mailov	Exportovať nastavenia sledovania e-mailov (pravda|nepravda).
ExportGeneralSettings Exportovať všeobecné nastavenia	Exportovať všeobecné nastavenia (pravda|nepravda).
ExportIsvConfig Exportovať konfiguráciu ISV	Exportovať konfiguráciu ISV (pravda|nepravda).
ExportMarketingSettings Exportovať marketingové nastavenia	Exportovať marketingové nastavenia (pravda|nepravda).
ExportOutlookSynchronizationSettings Exportovať nastavenia synchronizácie programu Outlook	Exportovať nastavenia synchronizácie programu Outlook (pravda|nepravda).
ExportRelationshipRoles Exportovať roly vzťahov	Exportovať roly vzťahov (pravda|nepravda).
ExportSales Exportovať predaje	Exportovať predaje (pravda|nepravda).

Rozbalenie riešenia v Power Platform

Vezme zbalený súbor riešenia a rozdelí ho na viaceré súbory XML a ďalšie súbory, vďaka čomu možno tieto súbory jednoduchšie čítať a spravovať zo strany zdrojového ovládacieho systému.

Úryvok YAML (Rozbaliť)

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

Parametre (rozbaliť)

Parametre	Popis
SolutionInputFile Vstupný súbor riešenia	(Povinné) Cesta a názov súboru riešenia.zip určeného na rozbalenie.
SolutionTargetFolder Cieľový priečinok na rozbalenie riešenia	(Povinné) Cesta a cieľový priečinok, do ktorého chcete rozbaliť riešenie.
SolutionType Typ riešenia	(Povinné) Typ riešenia, ktoré chcete rozbaliť. Možnosti zahŕňajú: Nespravované (odporúčané), Spravované a Oba.

Zbalenie riešenia v Power Platform

Zbalí riešenie predstavované v riadení zdroja do súboru solution.zip, ktorý sa dá importovať do ďalšieho prostredia.

Úryvok YAML (Zbaliť)

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

Parametre (Zbaliť)

Parametre	Popis
SolutionOutputFile Výstupný súbor riešenia	(Povinné) Cesta a názov súboru solution.zip, do ktorého sa má riešenie zbaliť.
SolutionSourceFolder Zdrojový priečinok riešenia na zabalenie	(Povinné) Cesta a zdrojový priečinok riešenia, ktoré sa má zabaliť.
SolutionType Typ riešenia	(Povinné) Typ riešenia, ktoré chcete zbaliť. Možnosti zahŕňajú: Spravované (odporúčané), Nespravované a Oba.

Power Platform Odstránenie riešenia

Odstráni riešenie z cieľového prostredia.

Úryvok YAML (Odstrániť)

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'

Parametre (Odstrániť)

Parametre	Popis
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby, z ktorého chcete odstrániť riešenie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby, z ktorého chcete odstrániť riešenie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
SolutionName Názov riešenia	(Požadované) Názov riešenia, ktoré sa má odstrániť. Vždy používajte Názov riešenia, nie jeho Zobrazovací názov.

Publikovanie prispôsobení v Power Platform

Publikuje všetky prispôsobenia v prostredí.

Úryvok YAML (Zverejniť)

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

Parametre (Publikovať)

Parametre	Popis
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby, v ktorom chcete zverejniť prispôsobenia (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby, v ktorom chcete zverejniť prispôsobenia (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform

Nastavenie verzie riešenia v Power Platform

Aktualizuje verziu riešenia.

Úryvok YAML (Verzia)

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

Parametre (Verzia)

Parametre	Popis
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby, pre ktorý chcete nastaviť verziu riešenia (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby, pre ktorý chcete nastaviť verziu riešenia (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
SolutionName Názov riešenia	(Povinné) Názov riešenia, pre ktoré chcete nastaviť verziu. Vždy používajte Názov riešenia, nie jeho Zobrazovací názov.
SolutionVersionNumber Číslo verzie riešenia	(Povinné) Číslo verzie, ktorú chcete nastaviť.

Napriek tomu, že číslo verzie môže byť v kanáli naprogramované napevno, odporúča sa použiť príponu premennej kanála Azure DevOps, ako BuildId. Poskytuje možnosti na definovanie presného tvaru čísla verzie na karte „Možnosti“, napríklad: $(rok:rrrr)-$(mesiac:MM)-$(deň: dd)-$(rev:rr)-3

Túto definíciu potom možno použiť v úlohe Nastaviť verziu riešenia nastavením vlastnosti Číslo verzie pomocou: $(Build.BuildId) namiesto pevného kódovania 20200824.0.0.2.

Alternatívne je výstup skriptu vloženej úlohy powershell $(Get-Date -Format yyyy.MM.dd.HHmm) nastavený na prázdnu premennú s názvom SolutionVersion ako Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Nastaviť verziu riešenia ako $(SolutionVersion).

Power Platform Nastavte premenné pripojenia

Nastaví premenné BuildTools.* na poskytnutie prístupu k úlohám vlastného skriptu, aby bolo možné použiť pripojenie k službe ako jediný zdroj pravdy.

Útržok 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

Parametre (SetConnectionVariables)

Parametre	Description
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby, pre ktorý chcete nastaviť premenné pripojenia. Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
timeoutInMinutes Timeout	Určuje maximálny čas v minútach, počas ktorého sa úloha môže vykonať, kým ju server zruší. Nulová hodnota označuje nekonečný časový limit.
retryCountOnTaskFailure Počet opakovaní, ak úloha zlyhala	Určuje počet opakovaní pre túto úlohu, ktoré sa vykonajú v prípade zlyhania úlohy. Nie je podporované pre úlohy bez agentov.
ApplicationId ID aplikácie na prihlásenie	(Vyžaduje sa pre používateľské meno/heslo) ID aplikácie, ktoré sa má použiť na prihlásenie (pozri dodatočnú poznámku nižšie).
RedirectUri URI presmerovania konkrétnej aplikácie	(Vyžaduje sa pre používateľské meno/heslo) URI presmerovania zadanej aplikácie. Potrebné pri zadávaní ID aplikácie. (Pozri dodatočnú poznámku nižšie).

Nasadenie balíka v Power Platform

Nasadenie balíka do prostredia. Nasadenie balíka na rozdiel od jedného súboru riešenia vám dáva možnosť nasadiť viacero riešení, údajov a kódov do prostredia.

Úryvok YAML (Nasadenie)

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

Parametre (Nasadenie)

Parametre	Popis
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby, do ktorého chcete nasadiť balík (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby, do ktorého chcete nasadiť balík (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform. Ďalšie informácie: pozri BuildTools.EnvironmentUrl v časti Vytvorenie prostredia Power Platform
PackageFile Súbor balíka	(Povinné) Cesta a názov súboru zostavy súboru balíka (.dll).
MaxAsyncWaitTime Maximálny čas čakania	Maximálny čas čakania v minútach pre asynchrónnu operáciu; predvolená hodnota je 60 minút (1 hodina), rovnako predvolené Azure DevOps pre úlohy.

Úlohy správy prostredia

Automatizujte úlohy správy životného cyklu životného prostredia (ELM).

Vytvorenie prostredia v Power Platform

Vytvorí nové prostredie. Vytvorením nového prostredia sa tiež automaticky vytvorí BuildTools.EnvironmentUrl.

Úryvok YAML (Create-env)

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

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

Parametre (Create-env)

Parametre	Popis
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby, pre ktorý chcete vytvoriť prostredie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby, pre ktorý chcete vytvoriť prostredie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
DisplayName Zobrazované meno	(Povinné) Zobrazovaný názov vytvoreného prostredia.
LocationName Oblasť nasadenia	(Povinné) Región, v ktorom by sa malo prostredie vytvoriť.
EnvironmentSku Typ prostredia	(Povinné) Typ inštancie na nasadenie. Možnosti sú Izolovaný priestor, Výroba, Skúšobná verzia a SubscriptionBasedTrial.
AppsTemplate Aplikácie	Pre typ prostredia bez skúšobnej verzie sú podporované aplikácie D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation a D365_Sales.
CurrencyName Mena	(Povinné) Základná mena pre vytvorené prostredie. Po vytvorení prostredia nemožno menu aktualizovať.
LanguageName Language	(Povinné) Základný jazyk v prostredí.
DomainName Názov domény	(Povinné) Toto je reťazec špecifický pre prostredie, ktorý je súčasťou adresy URL. Napríklad pre prostredie s nasledujúcou adresou URL:https://powerappsbuildtasks.crm.dynamics.com/, názov domény bude „powerappsbuildtasks“. Poznámka: Ak zadáte názov domény, ktorý sa už používa, úloha pripojí k názvu domény číselnú hodnotu začínajúcu 0. Vo vyššie uvedenom príklade sa môže stať adresa URL https://powerappsbuildtasks0.crm.dynamics.com/.

Odstránenie prostredia v Power Platform

Odstráni prostredie.

Úryvok YAML (Delete-env)

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

Parametre (Delete-env)

Parametre	Popis
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby, z ktorého chcete odstrániť prostredie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby, z ktorého chcete odstrániť prostredie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.

Power Platform Priradiť používateľa

Priraďte užívateľa k cieľovému prostrediu so špecifikovanou rolou zabezpečenia.

Útržok 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

Parametre (AssignUser-env)

Parametre	Description
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby pre prostredie, ku ktorému chcete priradiť používateľa (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
User Power Platform užívateľské meno	Microsoft Entra ID objektu alebo hlavné meno používateľa, ktoré sa má priradiť cieľovému prostrediu.
Role Názov alebo ID bezpečnostnej role	Názov bezpečnostnej roly alebo ID, ktoré sa má priradiť používateľovi.
ApplicationUser Power Platform užívateľské meno aplikácie	Určuje, či je vstupný užívateľ užívateľom aplikácie (true|false).

Power Platform Obnoviť prostredie

Resetuje prostredie.

Útržok 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'

Parametre (Reset-env)

Parametre	Description
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby, pre ktorý chcete resetovať prostredie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby, pre ktorý chcete resetovať prostredie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.

Zálohovanie prostredia v Power Platform

Zálohuje prostredie.

Úryvok YAML (Backup-env)

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

Parametre (Backup-env)

Parametre	Popis
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby, ktorý chcete zálohovať prostredie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby, ktorý chcete zálohovať prostredie (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
BackupLabel Označenie zálohy	(Povinné) Štítok, ktorý sa má priradiť zálohe.

Kopírovanie prostredia v Power Platform

Skopíruje prostredie do cieľového prostredia. K dispozícii sú dva typy kópií: úplná a minimálna. Úplná kópia obsahuje údaje aj metaúdaje riešenia (prispôsobenia), zatiaľ čo a minimálna kópia obsahuje iba metaúdaje riešenia, nie skutočné údaje.

Úryvok YAML (Copy-env)

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

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

Parametre (Copy-env)

Parametre	Popis
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby pre zdrojové prostredie, z ktorého chcete kopírovať (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby pre zdrojové prostredie, z ktorého chcete kopírovať (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
TargetEnvironmentUrl Adresa URL cieľového prostredia	(Povinné) Adresa URL cieľového prostredia, do ktorého chcete kopírovať.
CopyType Typ kópie	Typ kopírovania, ktoré sa má vykonať: FullCopy alebo MinimalCopy
OverrideFriendlyName Prepísať priateľský názov	Zmeňte priateľský názov cieľového prostredia na iný názov (pravda|nepravda).
FriendlyName Priateľské meno	Priateľský názov cieľového prostredia.
SkipAuditData SkipAuditData	Či sa majú preskočiť údaje auditu počas operácie kopírovania. (pravda|nepravda).

Power Platform Obnoviť prostredie

Obnoví prostredie do danej zálohy.

Útržok 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'

Parametre (Restore-env)

Parametre	Description
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformEnvironment Adresa URL prostredia Power Platform	Koncový bod služby pre zdrojové prostredie, z ktorého chcete obnoviť (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby pre zdrojové prostredie, z ktorého chcete obnoviť (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
RestoreLatestBackup Najnovšia záloha na obnovenie	Či obnoviť najnovšiu zálohu alebo poskytnúť RestoreTimeStamp (true|false).
RestoreTimeStamp Dátum a čas zálohy	Dátum a čas zálohy vo formáte mm/dd/rrrr hh:mm ALEBO reťazec „najnovšie“.
TargetEnvironmentUrl Adresa URL cieľového prostredia	(Povinné) URL pre cieľové prostredie, ktoré chcete obnoviť.
FriendlyName Názov obnoveného prostredia	(Voliteľné) Názov obnoveného prostredia.
DisableAdminMode Zakázať režim správy	Či sa má zakázať režim správy (pravda|nepravda).

Exportovať Dataverse údaje

Exportujte údaje z prostredia s poskytnutou schémou.

Útržok 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

Parametre (exportdata-env)

Parametre	Description
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby pre prostredie, z ktorého chcete exportovať údaje (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
SchemaFile Názov súboru XML schémy	Názov súboru XML schémy. Dá sa vytvoriť pomocou nástroja Configuration Migration Tool.
DataFile Názov dátového súboru	Názov súboru údajov na export (súbor zip).
Overwrite Prepísanie obsahu	Power Pages obsah webovej stránky prepísať (true|false).

Importovať Dataverse údaje

Importujte údaje do prostredia.

Útržok 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'

Parametre (importdata-env)

Parametre	Description
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby pre prostredie, do ktorého chcete importovať údaje (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
DataFile Názov dátového súboru	Názov súboru pre komprimovaný súbor s údajmi zip) na import alebo priečinok s data-schema.xml a data.xml, ktorý sa má importovať.

Power Pages úlohy riadenia

Úlohy pre prácu s Power Pages webovou stránkou.

Power Platform Stiahnutie PAPortal

Stiahnite si obsah webovej lokality Power Pages z aktuálneho prostredia Dataverse.

Útržok YAML (portál na stiahnutie)

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

Parametre (stiahnuť-paportál)

Parametre	Description
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby pre prostredie, z ktorého chcete stiahnuť obsah (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
WebsiteId ID webovej stránky portálu	Power Pages ID webovej stránky na stiahnutie.
Overwrite Prepísanie obsahu	Power Pages obsah webovej stránky prepísať (true|false).
ModelVersion Dátový model lokality	Označuje, či údaje lokality, ktoré sa majú nahrať, budú používať štandardný (1) alebo vylepšený dátový model (2). Predvolená hodnota je '1'.

Power Platform Nahranie PAPortal

Nahrajte Power Pages obsah webových stránok do aktuálneho Dataverse prostredia.

Útržok YAML (portál nahrávania)

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'

Parametre (nahrávací-paportál)

Parametre	Description
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby pre prostredie, do ktorého chcete nahrať obsah (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
UploadPath Nahrajte cestu k obsahu	Cesta, z ktorej bude nahraný Power Pages obsah webovej stránky.
ModelVersion Dátový model lokality	Označuje, či údaje lokality, ktoré sa majú nahrať, budú používať štandardný (1) alebo vylepšený dátový model (2). Predvolená hodnota je '1'.

Katalóg úloh Power Platform (ukážka)

Tieto úlohy vykonávajú akcie proti katalógu v Power Platform a zahŕňajú nasledujúce.

Nainštalujte položku katalógu

Nainštalujte položku katalógu do cieľového prostredia.

Parametre	Description
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby pre prostredie, do ktorého chcete nahrať obsah (napríklad https://powerappsbuildtools.crm.dynamics.com). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
Environment Adresa URL cieľového prostredia	(Povinné) Webová adresa prostredia, na ktorú je táto úloha zacielená.
CatalogItemId ID položky katalógu, ktorá sa má nainštalovať	(Povinné) Položka katalógu, ktorá sa má nainštalovať v cieľovom prostredí.
TargetEnvironmentUrl Adresa URL cieľového prostredia	(Povinné) Adresa URL cieľového prostredia pre inštaláciu položky katalógu do (napríklad "https://YourOrg.crm.dynamics.com").
PollStatus Skontrolujte stav ankety	(Voliteľné) Prieskum na kontrolu stavu vašej žiadosti (true|false).

Parametre (katalógová inštalácia)

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

Odoslať schválenie katalógu

Odošlite žiadosť o schválenie katalógu.

Parametre	Description
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby pre prostredie, do ktorého chcete nahrať obsah (napríklad "https://powerappsbuildtools.crm.dynamics.com"). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
Environment Adresa URL cieľového prostredia	(Povinné) Webová adresa prostredia, na ktorú je táto úloha zacielená.
CatalogSubmissionFile Súbor na odoslanie katalógu	(Povinné) Zadajte cestu a názov súboru na odoslanie katalógu.
UsePackageSolutionZipFile Typ súboru	Typ súboru: súbor zip balíka alebo riešenia.
SolutionZipFile Názov súboru zip riešenia	Zadajte cestu a názov súboru zip súboru riešenia.
PollStatus Skontrolujte stav ankety	(Voliteľné) Prieskum na kontrolu stavu vašej žiadosti (true|false).

Parametre (odoslanie katalógu)

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

Stav žiadosti o katalóg

Získajte stav požiadavky na inštaláciu/odoslanie katalógu.

Parametre	Description
authenticationType Typ overenia	(Vyžadované pre SPN) Zadajte buď PowerPlatformEnvironment pre spojenie používateľského mena/hesla alebo PowerPlatformSPN pre tajné spojenie objektu služby/klienta.
PowerPlatformSPN Objekt služby Power Platform	Koncový bod služby pre prostredie, do ktorého chcete nahrať obsah (napríklad "https://powerappsbuildtools.crm.dynamics.com"). Definované pod Servisné pripojenia v časti Nastavenia projektu pomocou typu pripojenia Power Platform.
Environment Adresa URL cieľového prostredia	(Povinné) Webová adresa prostredia, na ktorú je táto úloha zacielená.
TrackingId Vyžiadať ID sledovania	(Povinné) Vyžiadať ID sledovania.
RequestType Typ žiadosti	(Povinné) Typ požiadavky. (Hodnoty: Inštalovať | Odoslať).

Parametre (stav katalógu)

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

Zostavte a uvoľnite kanály

Teraz, keď sme zistili, čo sa dá urobiť pomocou nástrojov na zostavenie, pozrime sa, ako by ste tieto nástroje mohli použiť na vytváranie a uvoľňovanie vašich kanálov. Koncepčný prehľad je uvedený nižšie. Pozrime na niektoré podrobnosti implementácie kanála pomocou úloh nástroja na zostavenie v nasledujúcich častiach.

Ak sa chcete dozvedieť viac o vytváraní týchto kanálov a prakticky si vyskúšať tvorbu kanála pomocou Microsoft Power Platform Build Tools, dokončite laboratórne nástroje na vytváranie , ktoré si môžete stiahnuť z GitHub.

Ďalšie informácie o Azure Pipelines: Používajte Azure Pipelines

Vytvorenie kanála: Exportujte riešenie z vývojového prostredia (DEV)

Nasledujúci obrázok zobrazuje úlohy nástroja na vytváranie, ktoré môžete pridať do kanála, ktorý exportuje riešenie z vývojového prostredia.

Vytvorenie kanála: Zostavte spravované riešenie

Nasledujúci obrázok zobrazuje úlohy nástroja na vytváranie, ktoré môžete pridať do kanála, ktorý vytvára spravované riešenie.

Uvoľnenie kanála: Nasadenie do produkčného prostredia (PROD)

Nasledujúci obrázok zobrazuje úlohy nástroja na vytváranie, ktoré môžete pridať do kanála, ktorý sa nasadzuje do výrobného prostredia.

Pozrite tiež

Microsoft Power Platform Nástroje na zostavenie pre Azure DevOps