Úlohy Microsoft Power Platform Build Tools

Dostupné úlohy vytvárania sú opísané v nasledujúcich častiach. Následne predstavíme niekoľko príkladov Azure Pipelines využívajúcich tieto úlohy. Pre informácie o nástrojoch na zostavenie a ich stiahnutí pozri Microsoft Power Platform Build Tools pre Azure Pipelines.

Úloha pomocníka

Dostupné pomocné úlohy sú opí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 inštaluje súbor nástrojov špecifických pre Power Platform, ktoré agent potrebuje na spustenie úloh zostavenia Microsoft Power Platform. Táto úloha po pridaní nevyžaduje žiadnu ďalšiu konfiguráciu. Táto úloha obsahuje parametre pre konkrétne verzie každého z inštalovaných nástrojov.

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 default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    AddToolsToPath: true

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

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.
AddToolsToPath
Pridanie nástrojov do cesty		 Pridá pac cli do PATH premennej prostredia. Umožňuje používať pac cli z úloh skriptu bez toho, aby ste museli manuálne nastavovať cestu.
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ú uvedené dostupné úlohy na kontrolu kvality riešenia.

Kontrola Power Platform

Táto úloha spustí statickú analýzu vašich riešení oproti súboru pravidiel osvedčených postupov s cieľom identifikovať akékoľvek problematické vzorce, ktoré ste mohli neúmyselne zaviesť pri vytváraní 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é) Na použitie kontrolóra Power Platform je potrebné pripojenie k licencovanému Microsoft Power Platform prostrediu. Servisné pripojenia sú definované v Servisné pripojenia pod Nastavenia projektu pomocou typu pripojenia Power Platform. Viac informácií: pozri BuildTools.EnvironmentUrl v časti Power Platform Vytvoriť prostredie

Poznámka: Pre úlohu kontroly sú k dispozícii metódy overovania principálu 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		 Predvolene (true) používa geografická poloha kontrolnej služby 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ú oblasť, napríklad https://japan.api.advisor.powerapps.com. Zoznam dostupných geografických oblastí nájdete v časti Použitie rozhrania Power Platform Checker API.
FileLocation
Umiestnenie súborov na analýzu		 Povinné 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 repozitári. 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. Napríklad zadajte **\*.zip pre všetky zip súbory 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šení: Táto sada pravidiel je rovnaká ako tá, ktorá sa spúšťa z portálu Power Apps maker.
  • Marketplace: Rozšírený súbor pravidiel, ktorý sa používa na certifikáciu žiadosti pred jej zverejnením na Marketplace.
ErrorLevel
Úroveň chyby		 V kombinácii s chybou parameter prahovej hodnoty definuje závažnosť chýb a povolených varovaní. 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ď true, zlyhaj, ak je analýza Power Apps Checker vrátená ako Failed alebo FinishedWithErrors.
ArtifactDestinationName
Názov artefaktu DevOps		 Špecifikujte názov Azure Artifacts pre .sarif súbor checker.

Úlohy riešenia

Táto súprava úloh môže automatizovať akcie riešenia. Úlohy prostredia uvedené ďalej v tejto časti, ktoré vytvárajú, kopírujú alebo obnovujú prostredie, prepíšu pripojenia služieb novovytvorenými prostrediami. Tieto úlohy umožňujú vykonávať úlohy riešenia v prostrediach, 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

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é údaje 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é		 Zastarané. Systém pri importe spravovaného riešenia prevedie nespravované komponenty riešenia na spravované.
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álna čakacia doba v minútach pre asynchrónnu prevádzku; Predvolené je 60 minút (1 hodina), rovnako ako 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 Pridať komponent riešenia

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

Úryvok 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 Popis
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žitie 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ávislé od komponentu riešenia		 (Voliteľné) Označuje, či sa majú do nespravovaného riešenia pridať aj ďalšie komponenty riešenia, ktoré vyžaduje komponent riešenia, ktorý pridávate.
Environment
URL alebo ID prostredia		 (Voliteľné) URL adresa 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, do ktorého 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, do ktorého 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álna čakacia doba v minútach pre asynchrónnu prevádzku; Predvolené je 60 minút (1 hodina), rovnako ako predvolené Azure DevOps pre úlohy.

Poznámka

Premenné vám poskytujú pohodlný spôsob, ako získať kľúčové kúsky údajov do rôznych častí vášho kanála. Komplexný zoznam je uvedený v článku Použitie vopred definovaných premenných. Pri importovaní riešenia pomocou súboru nastavení nasadenia môžete vopred vyplniť referencie na pripojenie a informácie o premenných prostredia pre cieľové prostredie.

Ďalšie informácie: Vyplnenie odkazov na pripojenie a premenných prostredia vopred pre automatizované nasadenia

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, do ktorého 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, do ktorého 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é údaje 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álna čakacia doba v minútach pre asynchrónnu prevádzku; Predvolené je 60 minút (1 hodina), rovnako ako 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 Outlook		 Exportovať nastavenia synchronizácie Outlook (true|false).
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, pre ktorý chcete publikovať 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, pre ktorý chcete publikovať 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ť.

Hoci je možné v pipeline zadať číslo verzie napevno, odporúča sa použiť Azure DevOps premennú pipeline 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 Nastavenie premenných pripojenia

Nastaví PowerPlatformSetConnectionVariables.BuildTools.* premenné tak, aby poskytovali prístup k vlastným úlohám skriptov na použitie pripojenia služby ako jediného zdroja pravdy.

Nastavujú sa nasledujúce premenné:

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

Úryvok 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 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.
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ť predtým, ako ju server zruší. Nulová hodnota označuje nekonečný časový limit.
retryCountOnTaskFailure
Počet opakovaní, ak úloha zlyhala		 Určuje počet opakovaní tejto úlohy, ktoré sa uskutočnia v prípade jej zlyhania. Nie je podporované pre úlohy bez agenta.
ApplicationId
ID aplikácie pre prihlásenie		 (Povinné 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
Presmerovací URI konkrétnej aplikácie		 (Povinné pre používateľské meno/heslo) URI presmerovania zadanej aplikácie. Vyžaduje sa pri zadávaní ID aplikácie. (Pozri dodatočnú poznámku nižšie).

Poznámka

Pri použití typu overovania používateľským menom/heslom bude potrebné ID aplikácie a URI presmerovania. Tento dokument authenticate oauth vysvetľuje, prečo je potrebné vytvoriť registráciu aplikácie na overenie Dataverse. Keď sa pripájate pomocou overenia používateľským menom/heslom, pripojenie sa správa ako aplikácia, ktorá sa pripája v mene používateľa Dataverse.

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álna čakacia doba v minútach pre asynchrónnu prevádzku; Predvolené je 60 minút (1 hodina), rovnako ako 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.

Dôležité

Po nastavení sa BuildTools.EnvironmentUrl bude používať ako predvolené servisné pripojenie pre ďalšie úlohy v kanáli. Každá úloha opísaná v tomto článku používa koncový bod z pripojenia služby iba vtedy, keď nie je nastavená hodnota BuildTools.EnvironmentUrl.

Nové prostredie je možné zriadiť iba v prípade, že vaša licencia alebo kapacita umožňuje vytvorenie ďalších prostredí. Viac informácií o zobrazení kapacity nájdete na stránke Podrobnosti o stránke kapacity.

Ú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 k názvu domény pridá číselnú hodnotu, ktorá začína 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 používateľa cieľovému prostrediu so zadanou bezpečnostnou rolou.

Úryvok 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 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.
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 používateľské meno		 Microsoft Entra ID objektu alebo hlavné meno používateľa na priradenie cieľovému prostrediu.
Role
Názov alebo ID bezpečnostnej roly		 Názov alebo ID bezpečnostnej roly, ktorá sa má priradiť používateľovi.
ApplicationUser
Power Platform používateľské meno aplikácie		 Určuje, či je vstupný používateľ používateľom aplikácie (true|false).

Power Platform Obnoviť prostredie

Obnoví prostredie.

Úryvok 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 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 obnoviť nastavenia prostredia (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 obnoviť nastavenia prostredia (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, pre 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, pre 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
    MaxAsyncWaitTime: 60

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
PreskočiťAuditData		 Či sa majú počas kopírovania preskočiť údaje auditu. (pravda|nepravda).
MaxAsyncWaitTime
Maximálny čas čakania		 Maximálna čakacia doba v minútach pre asynchrónnu prevádzku; Predvolené je 60 minút (1 hodina), rovnako ako predvolené Azure DevOps pre úlohy.

Power Platform Obnoviť prostredie

Obnoví prostredie do danej zálohy.

Úryvok 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 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 vykonať obnovu (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 vykonať obnovu (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 sa má obnoviť najnovšia záloha alebo sa má 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 adresa cieľového prostredia, 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ť údaje Dataverse

Exportovať údaje z prostredia s poskytnutou schémou.

Úryvok 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 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.
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 schémy XML		 Názov súboru schémy XML. Dá sa vytvoriť pomocou nástroja na migráciu konfigurácie.
DataFile
Názov dátového súboru		 Názov súboru pre export údajov (zip súbor).
Overwrite
Prepísanie obsahu		 Power Pages obsah webu na prepísanie (pravda|nepravda).

Importovať údaje Dataverse

Importovať údaje do prostredia.

Úryvok 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 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.
PowerPlatformSPN
Objekt služby Power Platform		 Koncový bod služby pre prostredie, z 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 zip (súbor s údajmi), ktorý sa má importovať, alebo priečinok so súbormi data-schema.xml a data.xml, ktoré sa majú importovať.

Úlohy správy Power Pages

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

Power Platform Stiahnutie PAPortal

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

Úryvok YAML (download-paportal)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.download-paportal.PowerPlatformDownloadPaportal@2
  displayName: 'Power Platform Download PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DownloadPath: 'C:\portals'
    WebsiteId: 'f88b70cc-580b-4f1a-87c3-41debefeb902'
    Overwrite: true

Parametre (download-paportal)

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.
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		 ID webu Power Pages na stiahnutie.
Overwrite
Prepísanie obsahu		 Power Pages obsah webu na prepísanie (pravda|nepravda).
ModelVersion
Dátový model lokality		 Označuje, či sa na nahrávanie údajov lokality použije štandardný (1) alebo rozšírený dátový model (2). Predvolená hodnota je „1“.

Power Platform Nahranie PAPortal

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

Úryvok YAML (upload-paportal)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.upload-paportal.PowerPlatformUploadPaportal@2
  displayName: 'Power Platform Upload PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    UploadPath: 'C:\portals\starter-portal'

Parametre (upload-paportal)

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.
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
Cesta k nahranému obsahu		 Cesta, odkiaľ bude obsah webu Power Pages nahrávaný.
ModelVersion
Dátový model lokality		 Označuje, či sa na nahrávanie údajov lokality použije štandardný (1) alebo rozšírený dátový model (2). Predvolená hodnota je „1“.

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

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

Poznámka

Katalógové úlohy pre Power Platform sú momentálne v ukážkovej verzii.

Inštalácia položky katalógu

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

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.
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é) URL adresa prostredia, na ktoré je táto úloha zameraná.
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é) URL cieľového prostredia pre inštaláciu položky katalógu (napríklad „https://YourOrg.crm.dynamics.com“).
PollStatus
Skontrolovať stav ankety		 (Voliteľné) Anketa na overenie stavu vašej žiadosti (pravda|nepravda).

Parametre (inštalácia z katalógu)

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 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.
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é) URL adresa prostredia, na ktoré je táto úloha zameraná.
CatalogSubmissionFile
Súbor na odoslanie do katalógu		 (Povinné) Zadajte cestu a názov súboru odoslaného do katalógu.
UsePackageSolutionZipFile
Typ súboru		 Typ súboru: zip súbor balíka alebo riešenia.
SolutionZipFile
Názov zip súboru riešenia		 Zadajte cestu a názov súboru zip s riešením.
PollStatus
Skontrolovať stav ankety		 (Voliteľné) Anketa na overenie stavu vašej žiadosti (pravda|nepravda).

Parametre (odoslanie do 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 žiadosti o inštaláciu/odoslanie katalógu.

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.
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é) URL adresa prostredia, na ktoré je táto úloha zameraná.
TrackingId
Vyžiadať ID sledovania		 (Povinné) Vyžiadať ID sledovania.
RequestType
Typ žiadosti		 (Povinné) Typ požiadavky. (Hodnoty: Inštalovať | Odoslať).

Parametre (katalógový stav)

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 tvorbe týchto pipeline a skutočne robiť ich tvorbu pomocou Microsoft Power Platform Build Tools, absolvujte build tools labs, ktoré si môžete stiahnuť z GitHub.

Viac informácií o Azure Pipelines: Použite 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.

Export riešenia z vývojového prostredia (DEV).

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.

Vytvorte 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.

Nasadiť do produkčného prostredia (PROD).

Pozrite tiež

Microsoft Power Platform Nástroje na zostavenie pre Azure DevOps

  • Last updated on