Share via

Úlohy nástroja vytvárania Microsoft Power Platform

  • Článok

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

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

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

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

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

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

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í podľa súboru pravidiel osvedčených postupov, aby ste identifikovali akékoľvek problematické vzory, 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@0
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

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

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@0
  displayName: 'Power Platform Import Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    HoldingSolution: true
    OverwriteUnmanagedCustomizations: true
    SkipProductUpdateDependencies: true
    ConvertToManaged: true

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

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

YAML úryvok (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@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    AsyncOperation: false

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

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.

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

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

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 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.
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@0
  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@0
  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@0
  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@0
  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@0
  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.

YAML úryvok (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).

Poznámka

Pri použití typu overenia používateľského mena/hesla sa bude vyžadovať ID aplikácie a presmerovanie Uri. Tento dokument overenie overenia obsahuje vysvetlenie, prečo je potrebné vytvoriť registráciu aplikácie na overenie Dataverse. Keď sa pripájate pomocou overenia používateľského mena/hesla, 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@0
  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.

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é poskytnúť, iba ak 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@0
  displayName: 'Power Platform Create Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    DisplayName: 'First Coffee test'
    DomainName: firstcoffee

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

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 pripojí číselnú hodnotu, začínajúc 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@0
  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 k cieľovému prostrediu so zadaným rola zabezpečenia.

YAML úryvok (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
Rola zabezpečenia meno alebo ID		 Rola zabezpečenia meno alebo ID, ktoré sa má prideliť 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.

YAML úryvok (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@0
  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@0
  displayName: 'Power Platform Copy Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'

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

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.
DisableAdminMode
Zakázať režim správy		 Či sa má zakázať režim správy (pravda|nepravda).

Power Platform Obnoviť prostredie

Obnoví prostredie do danej zálohy.

YAML úryvok (Obnoviť-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.

YAML úryvok (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.

YAML úryvok (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.

YAML úryvok (paport 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.

YAML úryvok (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 webu.
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.

Poznámka

V súčasnosti sú katalógové úlohy pre Power Platform náhľad vydanie.

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.

Exportujte riešenie 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 si 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.

Nasadenie do produkčného prostredia (PROD).

Pozrite tiež

Microsoft Power Platform Build Tools pre Azure DevOps