Sdílet prostřednictvím

Úlohy Microsoft Power Platform Build Tools

  • Článek

Dostupné úlohy sestavení jsou popsány v následujících částech. Poté ukážeme nějaký příklad kanálů Azure Pipelines využívající tyto úlohy. Informace o nástrojích sestavení a jejich stažení naleznete v tématu Microsoft Power Platform Build Tools pro Azure Pipelines.

Úkol asistenta

Dostupné pomocné úlohy jsou popsány dále.

Instalátor nástrojů Power Platform

Tuto úlohu je třeba přidat jednou před jakýmikoliv jinými úkoly Build Tools Power Platform v kanálech sestavení a uvolnění a vydaných verzí. Tento úkol nainstaluje specifické nástroje Power Platform vyžadované agentem pro spuštění úloh sestavení Microsoft Power Platform. Tato úloha nevyžaduje žádnou další konfiguraci při přidání. Tato úloha obsahuje parametry pro konkrétní verze každého z nástrojů, které se instalují.

Chcete-li v průběhu času udržovat aktuální informace o verzích nástrojů, ujistěte se, že tyto parametry odpovídají verzi nástrojů, které jsou potřebné pro správné fungování kanálu.

Fragment YAML (instalační program)

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

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

Parametry (instalační program)

Parametry Popis
DefaultVersion
Použít výchozí verze nástrojů		 Nastavte na true, chcete-li použít výchozí verzi všech nástrojů, jinak false. Povinné (a false), pokud jsou specifikovány verze nástrojů.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Verze nástroje		 Konkrétní verze souboru nástroje k použití.

Power Platform WhoAmI

Ověřuje připojení ke službě prostředí Power Platform připojením a provedením požadavku WhoAmI. Tento úkol může být užitečné zahrnout brzy do kanálu a ověřit připojení před zahájením zpracování.

Fragment YAML (WhoAmI)

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

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

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

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

Parametry (WhoAmI)

Parametry Popis
authenticationType
Typ ověřování		 (Volitelné) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Služba koncový bod pro prostředí, ke kterému se má připojit. Definován v části Připojení služeb v Nastavení projektu. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
PowerPlatformSPN
Power Platform Instanční objekt		 Služba koncový bod pro prostředí, ke kterému se má připojit. Definován v části Připojení služeb v Nastavení projektu.

Kontrola kvality

V další části jsou uvedeny dostupné úkoly pro kontrolu kvality řešení.

Power Platform Checker

Tato úloha provádí statickou analýzu vašich řešení na základě souboru osvědčených postupů, aby se identifikovaly jakékoli problematické vzorce, které byste mohli při neúmyslném zavádění při vytváření řešení zavést.

Fragment YAML (kontrola)

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

Parametry (kontrola)

Parametry Popis
PowerPlatformSPN
Připojení služby		 (Povinné) Pro použití kontroly Power Platform je nutné připojení k licencovanému prostředí Microsoft Power Platform. Připojení služby jsou definována v části Připojení služeb pod Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl v sekci Vytvoření prostředí Power Platform

Poznámka: Instanční objekt a metoda ověření uživatelského jména / hesla je dostupná pro úlohu kontroly. Další informace o tom, jak nakonfigurovat instanční objekty, které mají být použity v této úloze, viz Konfigurace připojení instančních objektů pro prostředí Power Platform.
UseDefaultPACheckerEndpoint
Použijte výchozí koncový bod kontroly Power Platform		 Ve výchozím stavu (true) používá geografická poloha kontrolní služby stejnou geografickou polohu jako prostředí, ke kterému se připojujete.
CustomPACheckerEndpoint
Vlastní koncový bod kontroly PAC		 Vyžadováno, pokud je UseDefaultPACheckerEndpoint false. Můžete určit jinou geografickou polohu, kterou chcete použít, například https://japan.api.advisor.powerapps.com. Seznam dostupných geografických oblastí naleznete v části Použití rozhraní API Power Platform Checker.
FileLocation
Umístění souborů k analýze		 Vyžadováno při odkazování na soubor z adresy URL sdíleného přístupového podpisu (SAS). sasUriFile.

Poznámka: Je důležité odkazovat na exportovaný soubor řešení a ne na rozbalené zdrojové soubory ve vašem úložišti. Lze analyzovat soubory spravovaných i nespravovaných řešení.
FilesToAnalyzeSasUri
Soubory SAS k analýze		 Vyžadováno, když je FileLocation nastaveno na sasUriFile. Zadejte identifikátor URI SAS. Můžete přidat více než jeden SAS URI ze seznamu oddělených čárkami (,) nebo středníkem (;).
FilesToAnalyze
Místní soubory k analýze		 Vyžadováno, když nejsou analyzovány soubory SAS. Zadejte cestu a název souboru ZIP, který chcete analyzovat. Lze použít zástupné znaky. Například zadejte **\*.zip pro všechny soubory ZIP ve všech podsložkách.
FilesToExclude
Místní soubory, které se mají vyloučit		 Zadejte názvy souborů, které mají být z analýzy vyloučeny. Pokud se jedná o více než jeden, uveďte seznam oddělený čárkou (,) nebo středníkem (;). Tento seznam může obsahovat celý název souboru nebo název se zástupnými znaky na začátku nebo na konci, jako je *jquery nebo form.js
RulesToOverride
Pravidla k přepsání		 Pole JSON obsahující pravidla a úrovně k přepsání. Akceptované hodnoty pro OverrideLevel jsou: Critical, High, Medium, Low, Informational. Příklad: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Sada pravidel		 (Povinné) Určete, které pravidlo se použije. K dispozici jsou následující dvě sady pravidel:
  • Nástroj pro kontrolu řešení: Tato sada pravidel je stejná jako ta, která se spouští z Power Apps Maker Portal.
  • AppSource: Rozšířená sada pravidel, která se používá k certifikaci aplikace před jejím zveřejněním v AppSource.
ErrorLevel
Úroveň chyb		 V kombinaci s parametrem prahová hodnota chyby definuje závažnost chyb a varování, která jsou povolena. Podporované prahové hodnoty jsou <level>IssueCount, kde level=Critical, High, Medium, Low a Informational.
ErrorThreshold
Prahová hodnota chyby		 Definuje počet chyb (>=0) zadané úrovně, které jsou povoleny pro kontrolu, aby prošel kontrolovanými řešeními.
FailOnPowerAppsCheckerAnalysisError
Selhat při chybě		 Pokud je true, selže, pokud je analýza kontroly Power Apps vrácena jako Failed nebo FinishedWithErrors.
ArtifactDestinationName
Název artefaktu DevOps		 Zadejte název artefaktů Azure Artifacts pro soubor kontroly .sarif.

Úkoly řešení

Tato sada úkolů může automatizovat akce řešení. Úlohy prostředí popsané dále v této části, které vytvoří, zkopírují nebo obnoví prostředí, přepíší připojení služby nově vytvořenými prostředími. Tyto úlohy umožňují provádět úlohy řešení v prostředích vytvořených na vyžádání.

Import řešení Power Platform

Importuje řešení do cílového prostředí.

Fragment YAML (Import)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
  displayName: 'Power Platform Import Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    HoldingSolution: true
    OverwriteUnmanagedCustomizations: true
    SkipProductUpdateDependencies: true
    ConvertToManaged: true

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

Parametry (import)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Koncový bod služby, do které chcete importovat řešení (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby, do které chcete importovat řešení (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
SolutionInputFile
Vstupní soubor řešení		 (Povinné) Cesta a název souboru řešení.zip, který se má importovat do cílového prostředí (např. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Poznámka: Proměnné vám poskytují pohodlný způsob, jak získat klíčové bity dat do různých částí vašeho kanálu. Viz Použití předdefinovaných proměnných pro úplný seznam.
HoldingSolution
Import jako řešení držení		 Parametr předem používaný (true|false) v případě, že je třeba upgradovat řešení. Tento parametr hostuje řešení v Dataverse, ale neaktualizuje řešení, dokud není spuštěna úloha Použít aktualizaci upgradu.
OverwriteUnmanagedCustomizations
Přepsat nespravovaná vlastní nastavení		 Určete, zda se mají přepsat nespravovaná vlastní nastavení (true|false).
SkipProductUpdateDependencies
Přeskočit závislosti aktualizace produktu		 Určete, zda má být vynucení závislostí souvisejících s aktualizacemi produktu přeskočeno (true|false).
ConvertToManaged
Převést na spravované		 Zadejte, zda chcete importovat jako spravované řešení (true|false).
AsyncOperation
Asynchronní import		 Pokud je vybráno (true), operace importu bude provedena asynchronně. Toto je doporučeno pro větší řešení, protože tato úloha automaticky jinak vyprší po 4 minutách. Pokud vyberete asynchronní, bude se dotazovat a čekat, dokud nebude dosaženo (true|false).
MaxAsyncWaitTime
Maximální doba čekání		 Maximální doba čekání v minutách pro asynchronní operaci; výchozí je 60 min (1 h), stejně jako výchozí Azure DevOps pro úkoly.
PublishWorkflows
Aktivujte procesy po importu		 Určete, zda se mají po importu aktivovat nějaké procesy (pracovní postupy) v řešení (true|false).
UseDeploymentSettingsFile
Použijte soubor s nastavením nasazení		 Odkazy připojení a proměnné prostředí lze nastavit pomocí souboru nastavení nasazení (true|false).
DeploymentSettingsFile
Soubor s nastavením nasazení		 (Vyžadováno, pokud UseDeploymentSettingsFile=true) Cesta a název souboru nastavení nasazení.

Přidání součástí řešení Power Platform

Přidá součást řešení do nespravovaného řešení.

Fragment YAML (Přidat)

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

Parametry (Přidat)

Parametry Popis
ComponentId
ID součásti řešení		 Název schématu nebo ID součásti, která se má přidat do cílového řešení.
ComponentType
Adresa URL prostředí Power Platform		 Hodnota, která představuje přidávanou součást řešení. Viz Použití předdefinovaných typů komponent pro úplný seznam hodnot komponent.
SolutionUniqueName
Název řešení		 Jedinečný název řešení.
AddRequiredComponents
Jakékoli komponenty požadované z jiného řešení závisí na komponentě řešení		 (Volitelné) Udává, jestli se do nespravovaného řešení mají přidat rovněž jiné součásti řešení, které vyžaduje přidávaná součást řešení.
Environment
Adresa URL nebo ID prostředí		 (Volitelné) Adresa URL nebo ID cílového prostředí

Nainstalovat upgrade řešení Power Platform

Upgraduje řešení, které bylo importováno jako pracovní řešení.

Fragment YAML (Upgrade)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@2
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    AsyncOperation: false

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

Parametry (Upgrade)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Koncový bod služby, do které chcete upgradovat řešení (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby, do které chcete upgradovat řešení (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
SolutionName
Název řešení		 (Vyžadováno) Název řešení pro použití upgradu. Vždy používejte název řešení, ne jeho zobrazovaný název.
AsyncOperation
Asynchronní upgrade		 Pokud je vybráno (true), operace upgradu bude provedena jako asynchronní dávková úloha. Pokud vyberete asynchronní, bude se dotazovat a čekat, dokud nebude dosaženo MaxAsyncWaitTime.
MaxAsyncWaitTime
Maximální doba čekání		 Maximální doba čekání v minutách pro asynchronní operaci; výchozí je 60 min (1 h), stejně jako výchozí Azure DevOps pro úkoly.

Poznámka:

Proměnné vám poskytují pohodlný způsob, jak získat klíčové bity dat do různých částí vašeho kanálu. Viz Použití předdefinovaných proměnných pro úplný seznam. Při importu řešení pomocí souboru nastavení nasazení můžete předem vyplnit informace o odkazech na připojení a proměnných prostředí pro cílové prostředí.

Více informací: Předem vyplňte odkazy na připojení a proměnné prostředí pro automatizovaná nasazení

Export řešení Power Platform

Exportuje řešení ze zdrojového prostředí.

Fragment YAML (Export)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@2
  displayName: 'Power Platform Export Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120

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

Parametry (Export)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Koncový bod služby, do které chcete upgradovat řešení (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby, do které chcete upgradovat řešení (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
SolutionName
Název řešení		 (Povinné) Název řešení, které má být exportováno. Vždy používejte název řešení, ne jeho zobrazovaný název.
SolutionOutputFile
Výstupní soubor řešení		 (Povinné) Cesta a název souboru řešení.zip, který se má exportovat do zdrojového prostředí (např. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Poznámka: Proměnné vám poskytují pohodlný způsob, jak získat klíčové bity dat do různých částí vašeho kanálu. Viz Použití předdefinovaných proměnných pro úplný seznam.
AsyncOperation
Asynchronní export		 Pokud je vybráno (true), operace exportu bude provedena jako asynchronní dávková úloha. Pokud vyberete asynchronní, bude se dotazovat a čekat, dokud nebude dosaženo MaxAsyncWaitTime.
MaxAsyncWaitTime
Maximální doba čekání		 Maximální doba čekání v minutách pro asynchronní operaci; výchozí je 60 min (1 h), stejně jako výchozí Azure DevOps pro úkoly.
Managed
Exportovat jako spravovaný		 Pokud je vybráno (true), exportujte řešení jako spravované řešení; jinak exportujte jako nespravované řešení.
ExportAutoNumberingSettings
Export nastavení automatického číslování		 Export nastavení automatického číslování (true|false).
ExportCalendarSettings
Nastavení kalendáře exportu		 Nastavení kalendáře exportu (true|false).
ExportCustomizationSettings
Export vlastního nastavení		 Nastavení vlastního nastavení (true|false).
ExportEmailTrackingSettings
Export nastavení sledování e-mailů		 Exportovat nastavení sledování e-mailů (true|false).
ExportGeneralSettings
Export obecného nastavení		 Export obecného nastavení (true|false).
ExportIsvConfig
Export konfigurace ISV		 Export konfigurace ISV (true|false).
ExportMarketingSettings
Export nastavení marketingu		 Export nastavení marketingu (true|false).
ExportOutlookSynchronizationSettings
Export nastavení synchronizace aplikace Outlook		 Export nastavení synchronizace aplikace Outlook (true|false).
ExportRelationshipRoles
Export rolí vztahů		 Export rolí vztahů (true|false).
ExportSales
Export prodeje		 Export prodeje (true|false).

Vybalení řešení Power Platform

Vezme komprimovaný soubor řešení a rozloží ho na více souborů XML, aby bylo možné tyto soubory jednodušeji číst a spravovat zdrojovým řídicím systémem.

Fragment YAML (Rozbalit)

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

Parametry (Rozbalit)

Parametry Popis
SolutionInputFile
Vstupní soubor řešení		 (Povinné) Cesta a název souboru ZIP, který chcete rozbalit.
SolutionTargetFolder
Cílová složka pro rozbalení řešení		 (Povinné) Cesta a cílová složka, do které chcete řešení rozbalit.
SolutionType
Typ řešení		 (Povinné) Typ řešení, které chcete rozbalit. Možnosti zahrnují: Nespravované (doporučeno), Spravované a Oboje.

Balíček řešení Power Platform

Sbalí řešení představované v řízení zdroje do souboru solution.zip, který lze importovat do jiného prostředí.

Fragment YAML (Zabalit)

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

Parametry (Zabalit)

Parametry Popis
SolutionOutputFile
Výstupní soubor řešení		 (Povinné) Cesta a název souboru solution.zip,do něhož se má řešení sbalit.
SolutionSourceFolder
Zdrojová složka řešení do balíčku		 (Povinné) Cesta a zdrojová složka řešení, které chcete zabalit.
SolutionType
Typ řešení		 (Povinné) Typ řešení, které chcete sbalit. Možnosti zahrnují: Spravované (doporučeno), Nespravované a Oboje.

Odstranění řešení Power Platform

Odstraní řešení v cílovém prostředí.

Fragment YAML (Odstranit)

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'

Parametry (Odstranit)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Koncový bod služby, ve které chcete odstranit řešení (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby, ve které chcete odstranit řešení (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
SolutionName
Název řešení		 (Povinné) Název proměnné řešení, které chcete odstranit. Vždy používejte název řešení, ne jeho zobrazovaný název.

Publikování vlastního nastavení Power Platform

Publikuje všechna vlastní nastavení v prostředí.

Fragment YAML (Publikovat)

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

Parametry (Publikovat)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Koncový bod služby, ve které chcete publikovat vlastní nastavení (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby, ve které chcete publikovat vlastní nastavení (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform

Nastavení verze řešení Power Platform

Aktualizuje verzi řešení.

Fragment YAML (Verze)

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

Parametry (Verze)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Koncový bod služby, ve které chcete nastavit verzi řešení (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby, ve které chcete nastavit verzi řešení (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
SolutionName
Název řešení		 (Vyžadováno) Název řešení pro nastavení verze. Vždy používejte název řešení, ne jeho zobrazovaný název.
SolutionVersionNumber
Číslo verze řešení		 (Povinné) Číslo verze, které chcete nastavit.

Zatímco číslo verze může být v kanálu pevně zakódováno, doporučujeme použít proměnnou kanálu Azure DevOps, například BuildId. To poskytuje možnosti pro definování přesného tvaru čísla verze na kartě „Možnosti“, například: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Tuto definici lze poté použít v úloze Nastavení verze řešení nastavením vlastnosti Číslo verze pomocí: $(Build.BuildId) místo pevného kódování 20200824.0.0.2.

Alternativně skript vložené úlohy Powershellu $(Get-Date-Format yyyy.MM.dd.HHmm) výstup nastaveni na prázdnou proměnnou s názvem SolutionVersion jako Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Nastavit verzi řešení jako $(SolutionVersion).

Nastavené proměnné připojení Power Platform

Nastaví proměnné BuildTools.*, aby poskytovaly přístup k vlastním úlohám skriptu, aby bylo možné používat připojení ke službě jako jediný správný zdroj.

Fragment YAML (SetConnectionVariables)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-connection-variables.PowerPlatformSetConnectionVariables@2
  displayName: 'Power Platform Set Connection Variables '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
  timeoutInMinutes: 2
  retryCountOnTaskFailure: 5

Parametry (SetConnectionVariables)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby, pro který chcete nastavit proměnné připojení. Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
timeoutInMinutes
Timeout		 Určuje maximální dobu v minutách, po kterou může být úloha provedena, než ji server zruší. Nulová hodnota označuje nekonečný časový limit.
retryCountOnTaskFailure
Počet opakování, pokud se úloha nezdařila		 Určuje počet opakování této úlohy, ke kterému dojde v případě selhání úlohy. Není podporováno pro úlohy bez agenta.
ApplicationId
ID aplikace pro přihlášení		 (Vyžadováno pro uživatelské jméno/heslo) ID aplikace, které se má použít pro přihlášení (viz další poznámka níže).
RedirectUri
Identifikátor URI pro přesměrování konkrétní aplikace		 (Vyžadováno pro uživatelské jméno / heslo) Identifikátor URI pro přesměrování zadané aplikace. Je potřeba při zadávání ID aplikace (viz dodatečná poznámka níže).

Poznámka

Při ověřování podle uživatelského jména / hesla bude vyžadováno ID aplikace a identifikátor URI pro přesměrování. Tento dokument o ověřování Oauth obsahuje vysvětlení, proč je třeba vytvořit registraci aplikace, se kterou se můžete ověřit u Dataverse. Když se připojujete pomocí ověřování uživatelského jména / hesla, připojení se chová jako aplikace, která se připojuje jménem uživatele k Dataverse.

Balíček pro nasazení Power Platform

Nasadí balíček do prostředí. Nasazení balíčku na rozdíl od jediného souboru řešení poskytuje možnost nasadit více řešení, dat a kódu do prostředí.

Fragment YAML (Nasadit)

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

Parametry (Nasadit)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Koncový bod služby, do které chcete nasadit balíček (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby, do které chcete nasadit balíček (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform. Další informace: BuildTools.EnvironmentUrl ve Vytvoření nového prostředí Power Platform
PackageFile
Soubor balíčku		 (Povinné) Cesta a název souboru sestavení souboru balíčku (.dll).
MaxAsyncWaitTime
Maximální doba čekání		 Maximální doba čekání v minutách pro asynchronní operaci; výchozí je 60 min (1 h), stejně jako výchozí Azure DevOps pro úkoly.

Úkoly správy prostředí

Automatizace úloh běžné správy životního cyklu prostředí (ELM).

Vytvoření prostředí Power Platform

Vytvoří nové prostředí. Vytvoření nového prostředí také automaticky vytvoří BuildTools.EnvironmentUrl.

Důležité

Po nastavení bude BuildTools.EnvironmentUrl použito jako výchozí servisní připojení pro další připravované úkoly. Každá úloha popsaná v tomto článku používá pouze koncový bod z připojení služby, pokud BuildTools.EnvironmentUrl není nastaveno.

Nové prostředí lze zřídit pouze v případě, že vaše licence nebo kapacita umožňuje vytvoření dalších prostředí. Pro více informací o tom, jak zobrazit kapacitu, viz Podrobnosti o stránce kapacity.

Fragment 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

Parametry (Create-env)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Koncový bod služby, ve které chcete vytvořit prostředí (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby, ve které chcete vytvořit prostředí (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
DisplayName
Zobrazované jméno		 (Povinné) Zobrazovaný název vytvořeného prostředí.
LocationName
Oblast nasazení		 (Povinné) Oblast, ve kterém by mělo být prostředí vytvořeno.
EnvironmentSku
Typ prostředí		 (Povinné) Typ instance, kterou chcete nasadit. Možnosti jsou Sandbox, Výroba, Zkušební verze a SubscriptionBasedTrial.
AppsTemplate
Aplikace		 Pro nezkušební typ prostředí jsou podporované aplikace D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation a D365_Sales.
CurrencyName
Měna		 (Požadováno) Základní měna pro vytvořené prostředí. Po vytvoření prostředí nelze měnu aktualizovat.
LanguageName
Language		 (Povinné) Základní jazyk v prostředí.
DomainName
Název domény		 (Povinné) Jedná se o řetězec specifický pro dané prostředí, který je součástí adresy URL. Například pro prostředí s adresou URL: https://powerappsbuildtasks.crm.dynamics.com/ bude název domény „powerappsbuildtasks“.

Poznámka: Pokud zadáte název domény, který se již používá, úloha připojí k názvu domény číselnou hodnotu začínající 0. Adresa URL by se pro výše uvedený příklad mohla změnit na https://powerappsbuildtasks0.crm.dynamics.com/.

Odstranění prostředí Power Platform

Odstraní prostředí.

Fragment YAML (Delete-env)

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

Parametry (Delete-env)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Koncový bod služby, ve které chcete odstranit prostředí (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby, ve které chcete odstranit prostředí (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.

Přiřazení uživatele Power Platform

Přiřaďte k cílovému prostředí uživatele se zadanou rolí zabezpečení.

Fragment kódu 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

Parametry (AssignUser-env)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformSPN
Power Platform Instanční objekt		 Služba koncového bodu pro prostředí, do kterého chcete uživatele přiřadit (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
User
Uživatelské jméno Power Platform		 ID objektu Microsoft Entra nebo hlavní jméno uživatele, kterého chcete přiřadit k cílovému prostředí.
Role
Název nebo ID role zabezpečení		 Název nebo ID role zabezpečení, která má být přiřazena uživateli.
ApplicationUser
Uživatelské jméno aplikace Power Platform		 Určuje, zda je vstupní uživatel uživatelem aplikace (true|false).

Obnovení prostředí Power Platform

Obnoví prostředí.

Fragment kódu 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'

Parametry (Reset-env)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Koncový bod služby, ve které chcete resetovat prostředí (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby, ve které chcete resetovat prostředí (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.

Prostředí zálohy Power Platform

Zálohuje prostředí.

Fragment 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)'

Parametry (Backup-env)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Koncový bod služby, ve které chcete zálohovat prostředí (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby, ve které chcete zálohovat prostředí (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
BackupLabel
Popisek zálohy		 (Povinné) Štítek, který se má přiřadit záloze.

Kopírovat prostředí Power Platform

Zkopíruje prostředí do cílového prostředí. K dispozici jsou dva typy kopií: úplná a minimální. Úplná kopie obsahuje jak data, tak metadata řešení (přizpůsobení), zatímco a minimální kopie obsahuje pouze metadata řešení, nikoli samotná data.

Fragment 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'
    DisableAdminMode: false

Parametry (Copy-env)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Služba koncového bodu pro zdrojového prostředí, ze kterého chcete kopírovat (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
PowerPlatformSPN
Power Platform Instanční objekt		 Služba koncového bodu pro zdrojového prostředí, ze kterého chcete kopírovat (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
TargetEnvironmentUrl
Adresa URL cílového prostředí		 (Povinné) Adresa URL pro cílové prostředí, do kterého chcete kopírovat.
CopyType
Typ kopie		 Typ kopie, která se má provést: FullCopy nebo MinimalCopy
OverrideFriendlyName
Přepsat popisný název		 Změňte popisný název cílového prostředí na jiný název (true|false).
FriendlyName
Popisný název		 Popisný název cílového prostředí.
DisableAdminMode
Zakázat režim správce		 Zda zakázat režim správy (true|false).

Obnovení prostředí Power Platform

Obnoví prostředí ze zadané zálohy.

Fragment YAML (Restore-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.restore-environment.PowerPlatformRestoreEnvironment@2
  displayName: 'Power Platform Restore Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    RestoreLatestBackup: false
    RestoreTimeStamp: '12/01/2022 09:00'
    FriendlyName: 'Contoso Test'

Parametry (Restore-env)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformEnvironment
Adresa URL prostředí Power Platform		 Služba koncového bodu pro zdrojového prostředí, ze kterého chcete obnovit (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
PowerPlatformSPN
Power Platform Instanční objekt		 Služba koncového bodu pro zdrojového prostředí, ze kterého chcete obnovit (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
RestoreLatestBackup
Nejnovější záloha pro obnovení		 Zda obnovit nejnovější zálohu nebo poskytnout RestoreTimeStamp (true|false).
RestoreTimeStamp
Datum a čas zálohy		 Datum a čas zálohy ve formátu „mm/dd/rrrr hh:mm“ NEBO řetězec „latest“
TargetEnvironmentUrl
Adresa URL cílového prostředí		 (Povinné) Adresa URL pro cílové prostředí, do kterého chcete obnovit.
FriendlyName
Název obnoveného prostředí		 (Volitelně) Název obnoveného prostředí
DisableAdminMode
Zakázat režim správce		 Zda zakázat režim správy (true|false).

Export dat Dataverse

Export dat z prostředí s poskytnutým schématem.

Fragment kódu 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

Parametry (exportdata-env)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformSPN
Power Platform Instanční objekt		 Služba koncového bodu pro zdrojového prostředí, ze kterého chcete exportovat data (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
SchemaFile
Název souboru XML schématu		 Název souboru XML schématu. Lze jej vytvořit nástrojem Configuration Migration.
DataFile
Název datového souboru		 Název datového souboru pro export (soubor zip).
Overwrite
Přepsání obsahu		 Obsah obsahu webu Power Pages, který se má přepsat (true|false).

Import dat Dataverse

Import dat do prostředí.

Fragment kódu 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'

Parametry (importdata-env)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformSPN
Power Platform Instanční objekt		 Služba koncového bodu pro zdrojového prostředí, do kterého chcete importovat data (např. https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
DataFile
Název datového souboru		 Název komprimovaného datového souboru zip, který chcete importovat, nebo složka se soubory data-schema.xml a data.xml, která se má importovat.

Úkoly související se správou Power Pages

Úkoly pro práci s webem Power Pages.

Stažení Power Platform PAPortal

Stažení obsahu webu Power Pages z aktuálního prostředí Dataverse.

Fragment kódu 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

Parametry (download-paportal)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby prostředí, ze kterého chcete stahovat obsah (například https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
WebsiteId
ID webu portálu		 ID webu Power Pages, které se má stáhnout.
Overwrite
Přepsání obsahu		 Obsah obsahu webu Power Pages, který se má přepsat (true|false).
ModelVersion
Datový model webu		 Označuje, zda data webu, která mají být nahrána, budou používat standardní (1), nebo rozšířený datový model (2). Výchozí hodnota je „1“.

Nahrání Power Platform PAPortal

Nahrání obsahu webu Power Pages do aktuálního prostředí organizace Dataverse.

Fragment kódu 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'

Parametry (upload-paportal)

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby prostředí, do kterého chcete nahrávat obsah (například https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
UploadPath
Nahrání cesty k obsahu		 Cesta, ze které bude nahrán obsah webu Power Pages.
ModelVersion
Datový model webu		 Označuje, zda data webu, která mají být nahrána, budou používat standardní (1), nebo rozšířený datový model (2). Výchozí hodnota je „1“.

Katalog úloh Power Platform (Preview)

Tyto úlohy provádějí akce s katalogem v Power Platform a zahrnují následující.

Poznámka:

V současné době jsou úlohy katalogu pro Power Platform ve verzi Preview.

Instalace položky katalogu

Nainstalujte položku Catalogu do cílového prostředí.

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby prostředí, do kterého chcete nahrávat obsah (například https://powerappsbuildtools.crm.dynamics.com). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
Environment
Adresa URL cílového prostředí		 (Povinné) Adresa URL prostředí, na kterou je tento úkol zaměřen.
CatalogItemId
ID položky katalogu k instalaci		 (Povinné) Položka katalogu, která se má nainstalovat do cílového prostředí.
TargetEnvironmentUrl
Adresa URL cílového prostředí		 (Povinné) Adresa URL cílového prostředí pro instalaci položky katalogu (například „https://YourOrg.crm.dynamics.com“).
PollStatus
Dotaz na kontrolu stavu		 (Volitelné) Dotaz na kontrolu stavu vašeho požadavku (true|false).

Parametry (catalog-install)

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

Odeslání schválení katalogu

Odešle žádost o schválení Catalogu.

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby prostředí, do kterého chcete nahrávat obsah (například „https://powerappsbuildtools.crm.dynamics.com“). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
Environment
Adresa URL cílového prostředí		 (Povinné) Adresa URL prostředí, na kterou je tento úkol zaměřen.
CatalogSubmissionFile
Soubor odeslání katalogu		 (Povinné) Zadejte cestu a název souboru pro odeslání katalogu.
UsePackageSolutionZipFile
Typ souboru		 Typ souboru: soubor ZIP balíčku nebo řešení.
SolutionZipFile
Název souboru ZIP řešení		 Zadejte cestu a název souboru ZIP s řešením.
PollStatus
Dotaz na kontrolu stavu		 (Volitelné) Dotaz na kontrolu stavu vašeho požadavku (true|false).

Parametry (catalog-submit)

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

Stav požadavku na katalog

Získejte stav požadavku na instalaci/odeslání katalogu.

Parametry Popis
authenticationType
Typ ověřování		 (Povinné pro SPN) Určete buď PowerPlatformEnvironment pro připojení uživatelské jméno/heslo nebo PowerPlatformSPN pro připojení Instanční objekt/tajný kód klienta.
PowerPlatformSPN
Power Platform Instanční objekt		 Koncový bod služby prostředí, do kterého chcete nahrávat obsah (například „https://powerappsbuildtools.crm.dynamics.com“). Definováno v Servisních připojeních v Nastavení projektu za použití typu připojení Power Platform.
Environment
Adresa URL cílového prostředí		 (Povinné) Adresa URL prostředí, na kterou je tento úkol zaměřen.
TrackingId
ID sledování žádosti		 (Povinné) ID sledování žádosti.
RequestType
Typ žádosti		 (Požadováno) Typ žádosti. (Hodnoty: Install | Submit).

Parametry (catalog-status)

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

Sestavení a vydání kanálů

Nyní, když jsme zjistili, co lze udělat pomocí nástrojů pro sestavení, se podívejme, jak byste tyto nástroje mohli použít na vaše kanály sestavení a vydání. Níže je uveden koncepční přehled. Podívejme se na některé podrobnosti implementace kanálů pomocí úkolů nástroje sestavení v následujících částech.

Chcete-li se dozvědět více o vytváření těchto kanálů a skutečně provádět ruční vytváření kanálů pomocí Microsoft Power Platform Build Tools, dokončete zkušební semináře nástrojů sestavení, které si můžete stáhnout z GitHubu.

Další informace o Azure Pipelines: Použití Azure Pipelines

Sestavení kanálu: Exportujte řešení z vývojového prostředí (DEV)

Následující obrázek ukazuje úlohy nástroje sestavení, které můžete přidat do kanálu, který exportuje řešení z vývojového prostředí.

Export řešení z vývojového prostředí (DEV).

Kanál sestavení: Sestavte spravované řešení

Následující obrázek ukazuje úlohy nástroje sestavení, které můžete přidat do kanálu, který sestavuje spravované řešení.

Sestavení spravovaného řešení.

Kanál vydání: Nasazení provozního prostředí (PROD)

Následující obrázek ukazuje úlohy nástroje sestavení, které můžete přidat do kanálu, který provádí nasazení do provozního prostředí.

Nasazení do provozního prostředí (PROD).

Viz také

Microsoft Power Platform Sestavit nástroje pro Azure DevOps