Úlohy Microsoft Power Platform Build Tools

Článek
03/29/2024

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

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

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

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

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

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

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

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á, k názvu domény připojí úloha číselnou hodnotu, počínaje 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@0
  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@0
  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@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

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 Build Tools pro Azure DevOps

Share via

Úlohy Microsoft Power Platform Build Tools

Úkol asistenta

Instalátor nástrojů Power Platform

Fragment YAML (instalační program)

Parametry (instalační program)

Power Platform WhoAmI

Fragment YAML (WhoAmI)

Parametry (WhoAmI)

Kontrola kvality

Power Platform Checker

Fragment YAML (kontrola)

Parametry (kontrola)

Úkoly řešení

Import řešení Power Platform

Fragment YAML (Import)

Parametry (import)

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

Fragment YAML (Přidat)

Parametry (Přidat)

Nainstalovat upgrade řešení Power Platform

Fragment YAML (Upgrade)

Parametry (Upgrade)

Export řešení Power Platform

Fragment YAML (Export)

Parametry (Export)

Vybalení řešení Power Platform

Fragment YAML (Rozbalit)

Parametry (Rozbalit)

Balíček řešení Power Platform

Fragment YAML (Zabalit)

Parametry (Zabalit)

Odstranění řešení Power Platform

Fragment YAML (Odstranit)

Parametry (Odstranit)

Publikování vlastního nastavení Power Platform

Fragment YAML (Publikovat)

Parametry (Publikovat)

Nastavení verze řešení Power Platform

Fragment YAML (Verze)

Parametry (Verze)

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

Fragment YAML (SetConnectionVariables)

Parametry (SetConnectionVariables)

Balíček pro nasazení Power Platform

Fragment YAML (Nasadit)

Parametry (Nasadit)

Úkoly správy prostředí

Vytvoření prostředí Power Platform

Fragment YAML (Create-env)

Parametry (Create-env)

Odstranění prostředí Power Platform

Fragment YAML (Delete-env)

Parametry (Delete-env)

Přiřazení uživatele Power Platform

Fragment kódu YAML (AssignUser-env)

Parametry (AssignUser-env)

Obnovení prostředí Power Platform

Fragment kódu YAML (Reset-env)

Parametry (Reset-env)

Prostředí zálohy Power Platform

Fragment YAML (Backup-env)

Parametry (Backup-env)

Kopírovat prostředí Power Platform

Fragment YAML (Copy-env)

Parametry (Copy-env)

Obnovení prostředí Power Platform

Fragment YAML (Restore-env)

Parametry (Restore-env)

Export dat Dataverse

Fragment kódu YAML (exportdata-env)

Parametry (exportdata-env)

Import dat Dataverse

Fragment kódu YAML (importdata-env)

Parametry (importdata-env)

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

Stažení Power Platform PAPortal

Fragment kódu YAML (download-paportal)

Parametry (download-paportal)

Nahrání Power Platform PAPortal