Microsoft Power Platform Build Tools-feladatok

  • Cikk

A rendelkezésre álló buildelési feladatokat az alábbi szakaszok ismertetik. Ezután bemutatunk néhány példát az Azure Pipelinesra, amelyek ezeket a feladatokat használják. További információ a buildeszközökről és azok letöltéséről: Microsoft Power Platform Build Tools for Azure Pipelines.

Segítő feladata

Az elérhető segítő feladatokat a következőkben ismertetjük.

Power Platform eszköztelepítő

Ezt a feladatot egyszer hozzá kell adni minden Power Platform építési eszköz előtt a kiépítési és kiadási folyamatokhoz. Ez a művelet a Power Platform-ügynök által a buildelési feladatok futtatásához szükséges konkrét Microsoft Power Platform-eszközöket telepíti. Ez a feladat hozzáadáskor nem igényel további konfigurációt. Ez a feladat az egyes telepített eszközök adott verzióinak paramétereit tartalmazza.

Ha naprakészen szeretné tartani az eszköz verzióit hosszú távon ellenőrizze, hogy ezek a paraméterek megfelelnek-e a folyamat megfelelő futtatásához szükséges eszközök verzióinak.

YAML kódrészlet (Telepítő)

# 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

Paraméterek (Installer)

Paraméterek Ismertetés
DefaultVersion
Az alapértelmezett eszközverziók használata		 Ha az összes eszköz alapértelmezett verziójának használatához válassza az igaz, egyébként a hamis értéket. Szükséges (és hamis), ha bármely eszköz bármely verziója meg van adva.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Eszközverzió		 A használt eszköz speciális verziója.

Power Platform WhoAmI

Ellenőrzi a Power Platform környezet-szolgáltatási kapcsolatát egy WhoAmI kérés csatlakoztatásával és végrehajtásával. Ez a feladat a folyamat elején lehet hasznos, hogy a kapcsolat megkezdése előtt ellenőrizze a kapcsolatot.

YAML kódrészlet (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'

Paraméterek (WhoAmI)

Paraméterek Ismertetés
authenticationType
A hitelesítés típusa		 (Nem kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 Azon környezet szolgáltatásvégpontja, amelyhez kapcsolódni szeretne. A definíció aProjektbeállításokSzolgáltatási kapcsolatok részén adható meg. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
PowerPlatformSPN
Power Platform Szolgáltatásnév		 Azon környezet szolgáltatásvégpontja, amelyhez kapcsolódni szeretne. A definíció aProjektbeállításokSzolgáltatási kapcsolatok részén adható meg.

Minőség-ellenőrzés

A következő szakaszban a megoldás minőségének ellenőrzéséhez rendelkezésre álló feladatok találhatók.

Power Platform Checker

Ez a feladat statikus elemzési ellenőrzést futtat a megoldásokon az ajánlott eljárások szabályai alapján, hogy azonosítsa a megoldás létrehozásakor véletlenül bevezetett problémás mintákat.

YAML kódrészlet (ellenőrző)

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

Paraméterek (ellenőrző)

Paraméterek Ismertetés
PowerPlatformSPN
Szolgáltatáskapcsolat		 (Szükséges) A Power Platform ellenőrzőjének használatához kapcsolattal kell rendelkezni egy licencelt Microsoft Power Platform-környezethez. A szolgáltatáskapcsolatok definiálása a Projektbeállítások területen lévő Szolgáltatáskapcsolatok beállítással történik; a Power Platform kapcsolattípust kell megadni. További információ: lásd BuildTools.EnvironmentUrl a Környezet Power Platform létrehozása alatt

Megjegyzés: Az ellenőrző feladathoz szolgáltatásnév és felhasználónév/jelszó hitelesítési módszerek érhetők el. További információ a feladathoz használandó a szolgáltatási rendszerbiztonsági tag konfigurálásáról: Szolgáltatási rendszerbiztonsági tag kapcsolatainak konfigurálása Power Platform-környezetekhez.
UseDefaultPACheckerEndpoint
Alapértelmezett ellenőrző Power Platform Checker végpont		 Alapértelmezés szerint (igaz) az ellenőrző szolgáltatás földrajzi helye ugyanazt a földrajzi helyet használja, mint a környezet, amelyhez csatlakozik.
CustomPACheckerEndpoint
Egyéni DEKT-ellenőrző végpont		 HamisUseDefaultPACheckerEndpoint érték esetén kötelező. Megadhat egy másik földrajzi helyet is a használathoz, például https://japan.api.advisor.powerapps.com. Az elérhető földrajzi helyek listáját lásd: Az ellenőrző API Power Platform használata.
FileLocation
Az elemezni kívánt fájlok helye		 Akkor szükséges, ha közös hozzáférésű jogosultságkód (SAS) URL-címéről sasUriFile hivatkozik egy fájlra.

Megjegyzés: Fontos, hogy egy exportált megoldásfájlra hivatkozzon, ne pedig az adattárban lévő kicsomagolt forrásfájlokra. Mind a felügyelt, mind a nem felügyelt megoldások fájljai elemezhetők.
FilesToAnalyzeSasUri
Analizálni szükséges SAS-fájlok		 Kötelező, ha a FileLocation beállítása sasUriFile értékre van állítva. Adja meg a SAS URI-jét. Több SAS URI megadásához vesszővel (,) vagy pontosvesszővel (;) tagolt listát használhat.
FilesToAnalyze
Analizálni szükséges helyi fájlok		 Akkor szükséges, ha az SAS-fájlok nincsenek elemezve. Adja meg az elemezni kívánt zip-fájlok elérési útját és fájlnevét. Helyettesítő karakterek is használhatók. Írja be például a \*.zip értéket ** az összes almappában található összes zip-fájlhoz.
FilesToExclude
Kizárandó helyi fájlok		 Adja meg az elemzésből kizárni kívánt fájlok nevét. Egynél több esetén biztosítsa egy vesszővel (,) vagy pontosvesszővel (;) elválasztott listával. A lista teljes fájlnevet vagy helyettesítő karaktereket (például *jquery vagy form.js) is tartalmazhat
RulesToOverride
Felülbírálandó szabályok		 A felülbírálandó szabályokat és szinteket tartalmazó JSON-tömb. A OverrideLevel elfogadott értékei: kritikus, magas, közepes, alacsony, információs. Példa: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Szabályegyüttes		 (Kötelező) Adja meg, hogy melyik szabályegyüttest kell alkalmazni. Az alábbi két szabályegyüttest lehet használni:
  • Megoldás-ellenőrző: Ez a szabálykészlet megegyezik a Power Apps készítői portálról futtatott szabálykészlettel.
  • AppSource: Az alkalmazás közzététel AppSource előtti hitelesítésére használt kiterjesztett szabálykészlet.
ErrorLevel
Hiba szintje		 A hibával együtt a küszöbérték paraméter határozza meg az engedélyezett hibák és figyelmeztetések súlyosságát. A támogatott küszöbértékek a <level>IssueCount, ahol a level=kritikus, magas, közepes, alacsony és információs.
ErrorThreshold
Hiba küszöbértéke		 Egy megadott szint hibáinak (>=0) számát határozza meg, amelyeken az ellenőrző átadhatja az ellenőrzött megoldásokat.
FailOnPowerAppsCheckerAnalysisError
Hiba miatt sikertelen		 Ha igaz, akkor a hiba akkor történik meg, ha a Power Apps összekötő elemzése Sikertelen vagy FinishedWithErrors értékű.
ArtifactDestinationName
DevOps műtermék neve		 Adja meg az ellenőrző .sarif Azure Artifacts nevét.

Megoldásfeladatok

Ezek a feladatok automatizálják a megoldások műveleteit. A szakasz későbbi részében ismertetett környezeti feladatok, amelyek környezetet hoznak létre, másolnak vagy állítanak vissza, felülírják az újonnan létrehozott környezetekkel létesített szolgáltatási kapcsolatokat. Ezek a feladatok lehetővé teszik megoldási feladatok végrehajtását igény szerint létrehozott környezetekben.

Power Platform– Megoldás importálása

Egy megoldást célkörnyezetbe importál.

YAML kódrészlet (Importálás)

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

Paraméterek (importálás)

Paraméterek Ismertetés
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 A szolgáltatás végpont, amelybe importálni szeretné a megoldást (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás végpont, amelybe importálni szeretné a megoldást (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
SolutionInputFile
Megoldás bemeneti fájlja		 (Kötelező) A célkörnyezetbe importálni kívánt megoldás elérési útja és fájlneve .zip fájl (például $(Build.ArtifactStagingDirectory)$(SolutionName) .zip).

Megjegyzés: a változókkal kényelmesen viheti be az adatok legfontosabb részeit a folyamat különböző részei során. Átfogó lista: Előre definiált változók használata.
HoldingSolution
Importálás tároló megoldásként		 A megoldások frissítésének szükségességekor használt előzetes paraméter (igaz|hamis). Ez a paraméter üzemelteti a megoldást a Dataverse-ben, de addig nem frissíti a megoldást, amíg le nem fut a Megoldás frissítésének alkalmazása feladat.
OverwriteUnmanagedCustomizations
Felülírja a nem felügyelt testreszabásokat		 Adja meg, hogy felülírja-e a nem felügyelt testreszabásokat (igaz|hamis).
SkipProductUpdateDependencies
Termékfrissítési függőségek kihagyása		 Adja meg, hogy a termékfrissítésekkel kapcsolatos függőségek betartatása mellőzve legyen-e (igaz|hamis).
ConvertToManaged
Átminősítés felügyeltté		 Adja meg, hogy importálja-e felügyelt megoldásként (igaz|hamis).
AsyncOperation
Aszinkron impotrálás		 Ha az (igaz) lehetőséget választja, aszinkron módon végzi el az importálási műveletet. Ez nagyobb megoldások esetén ajánlott, mivel ez a feladat egyébként 4 perc múlva automatikusan időtúllépést eredményez. Az aszinkron kiválasztásával szavaz és megvárja, amíg a MaxAsyncWaitTime ideje el nem ért (igaz|hamis).
MaxAsyncWaitTime
Maximális várakozási idő		 Az aszinkron művelet maximális várakozási ideje percben; alapértelmezett érték 60 perc (1 óra), ugyanaz, mint a Azure DevOps feladatok alapértelmezett beállítása.
PublishWorkflows
Folyamatok aktiválása importálás után		 Adja meg, hogy a megoldásban bármelyik folyamatot (munkafolyamatot) aktiválni kell-e az importálás után (igaz|hamis).
UseDeploymentSettingsFile
Telepítési beállítások fájljainak használata		 A kapcsolati hivatkozások és a környezeti változók értékei beállíthatók egy telepítési beállítások fájllal (igaz|hamis).
DeploymentSettingsFile
Telepítési beállítások fájlja		 (UseDeploymentSettingsFile=igaz esetén kötelező) A telepítési beállítások fájljának elérési útja és fájlneve.

Power Platform Megoldás-összetevő hozzáadása

Megoldás-összetevőt ad hozzá egy nem felügyelt megoldáshoz.

YAML-kódrészlet (hozzáadás)

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

Paraméterek (hozzáadás)

Paraméterek Description
ComponentId
A megoldás-összetevő azonosítója		 A célmegoldáshoz hozzáadandó összetevő sémaneve vagy azonosítója.
ComponentType
Power Platform-környezet URL-címe		 A hozzáadni kívánt megoldás-összetevőt jelölő érték. Az összetevőértékek átfogó listájáért lásd: Előre definiált összetevőtípusok használata.
SolutionUniqueName
A megoldás neve		 A megoldás egyedi neve.
AddRequiredComponents
Bármely más megoldáshoz szükséges összetevő, amely a megoldás összetevőjétől függ		 (Nem kötelező) Azt jelzi, hogy a hozzáadni kívánt megoldás-összetevőhöz szükséges egyéb megoldás-összetevőket is hozzá kell-e adni a nem felügyelt megoldáshoz.
Environment
Környezet URL-címe vagy azonosítója		 (Nem kötelező) Környezet URL-címe vagy a célkörnyezet azonosítója.

Power Platform Megoldás frissítésének alkalmazása

A tároló megoldásként importált megoldás frissítése.

YAML kódrészlet (frissítés)

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

Paraméterek (frissítés)

Paraméterek Ismertetés
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 A szolgáltatás végpont, amelyre frissíteni szeretné a megoldást (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás végpont, amelyre frissíteni szeretné a megoldást (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
SolutionName
Megoldás neve		 (Kötelező) A frissítés alkalmazásához szükséges megoldás neve. Mindig a megoldás Nevét használja , nem a Megjelenítendő nevet.
AsyncOperation
Aszinkron frissítés		 Ha a (igaz) lehetőséget választja, aszinkron kötegelt feladatként végzi el a frissítési műveletet. Az aszinkron szavaz, és megvárja, amíg a MaxAsyncWaitTime elért.
MaxAsyncWaitTime
Maximális várakozási idő		 Az aszinkron művelet maximális várakozási ideje percben; alapértelmezett érték 60 perc (1 óra), ugyanaz, mint a Azure DevOps feladatok alapértelmezett beállítása.

Feljegyzés

A változók segítségével kényelmesen beviheti az adatok legfontosabb részeit a folyamat különböző részei során. Átfogó lista: Előre definiált változók használata. A célkörnyezetben előre feltöltheti a kapcsolati hivatkozásra és környezetváltozókra vonatkozó információkat, miközben egy megoldást a telepítési beállításokat tároló fájlból importál.

További információ:Kitöltés előtti kapcsolati hivatkozások és környezeti változók az automatizált telepítésekhez

Power Platform – Megoldás exportálása

Megoldást exportál egy forráskörnyezetből.

YAML kódrészlet (exportálás)

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

Paraméterek (export)

Paraméterek Ismertetés
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 A szolgáltatás végpont, amelyre frissíteni szeretné a megoldást (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás végpont, amelyre frissíteni szeretné a megoldást (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
SolutionName
Megoldás neve		 (Kötelező) Az exportálni kívánt megoldás neve. Mindig a megoldás Nevét használja , nem a Megjelenítendő nevet.
SolutionOutputFile
Megoldás kimeneti fájlja		 (Kötelező) Annak a solution.zip fájlnak az elérési útja és neve, amelybe a forráskörnyezetet exportálni kívánja (például $(Build.ArtifactStagingDirectory)$(SolutionName) .zip ).

Megjegyzés: a változókkal kényelmesen viheti be az adatok legfontosabb részeit a folyamat különböző részei során. Átfogó lista: Előre definiált változók használata.
AsyncOperation
Aszinkron exportálás		 Ha a (igaz) lehetőséget választja, aszinkron kötegelt feladatként végzi el az exportálás műveletet. Az aszinkron szavaz, és megvárja, amíg a MaxAsyncWaitTime elért.
MaxAsyncWaitTime
Maximális várakozási idő		 Az aszinkron művelet maximális várakozási ideje percben; alapértelmezett érték 60 perc (1 óra), ugyanaz, mint a Azure DevOps feladatok alapértelmezett beállítása.
Managed
Exportálás kezeltként		 Ha az (igaz) jelölőnégyzet be van jelölve, exportálja a megoldást felügyelt megoldás; egyébként nem kijelölt megoldásként exportálja.
ExportAutoNumberingSettings
Automatikus számozási beállítások exportálása		 Automatikus számozási beállítások exportálása (igaz|hamis).
ExportCalendarSettings
Naptár beállítások exportálása		 Naptár beállítások exportálása (igaz|hamis).
ExportCustomizationSettings
Testreszabási beállítások exportálása		 Testreszabási beállítások exportálása (igaz|hamis).
ExportEmailTrackingSettings
E-mail-követési beállítások exportálása		 Exportálja az e-mailek nyomon követésére vonatkozó beállításokat (igaz|hamis).
ExportGeneralSettings
Általános beállítások exportálása		 Általános beállítások exportálása (igaz|hamis).
ExportIsvConfig
ISV konfiguráció exportálása		 Exportálja az ISV-konfigurációt (igaz|hamis).
ExportMarketingSettings
Marketingbeállítások exportálása		 Marketingbeállítások exportálása (igaz|hamis).
ExportOutlookSynchronizationSettings
Az Outlook szinkronizálási beállításainak exportálása		 Outlook-szinkronizálási beállítások exportálása (igaz|hamis).
ExportRelationshipRoles
Kapcsolati szerepkörök exportálása		 Kapcsolati szerepkörök exportálása (igaz|hamis).
ExportSales
Értékesítés exportálása		 Értékesítés exportálása (igaz|hamis).

Power Platform – megoldás kicsomagolása

Egy tömörített megoldásfájlt különböző XML-fájlokra bont, így ezek a fájlok könnyebben olvashatók és kezelhetők egy forrásvezérlő rendszerrel.

YAML kódrészlet (Kicsomagolás)

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

Paraméterek (Kicsomagolás)

Paraméterek Ismertetés
SolutionInputFile
Megoldás bemeneti fájlja		 (Kötelező) A kicsomagolni kívánt solution.zip fájl elérési útvonala és fájlneve.
SolutionTargetFolder
A kicsomagolni kívánt megoldás célmappája		 (Kötelező) Az elérési út és a célmappa, ahova a megoldást ki akarja csomagolni.
SolutionType
Megoldás típusa		 (Kötelező) A kicsomagolni kívánt megoldás típusa. A használható típusok: Nem felügyelt (ajánlott), Felügyelt és Mindkettő.

Power Platform– megoldás csomagolása

A forrásvezérlőben lévő megoldást egy másik környezetbe importálható solution.zip fájlba csomagolja be.

YAML kódrészlet (csomagolás)

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

Paraméterek (csomagolás)

Paraméterek Ismertetés
SolutionOutputFile
Megoldás kimeneti fájlja		 (Kötelező) Annak a solution.zip csomagnak az elérési útja és fájlneve, amelybe a megoldást csomagolni kívánja.
SolutionSourceFolder
A becsomagolni kívánt megoldás forrásmappája		 (Kötelező) A becsomagolni kívánt megoldás elérési útvonala és forrásmappája.
SolutionType
Megoldás típusa		 (Kötelező) A becsomagolni kívánt megoldás típusa. A használható típusok: Felügyelt (ajánlott), Nem felügyelt és Mindkettő.

Power Platform megoldás törlése

Törölje a megoldást a célkörnyezetben.

YAML kódrészlet (Törlés)

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'

Paraméterek (törlés)

Paraméterek Ismertetés
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 A szolgáltatás végpont, hogy törölni szeretné a megoldást (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás végpont, hogy törölni szeretné a megoldást (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
SolutionName
Megoldás neve		 (Kötelező) A törölni kívánt megoldás neve. Mindig a megoldás Nevét használja , nem a Megjelenítendő nevet.

Power Platform – Testreszabások közzététele

Az összes testreszabást közzéteszi egy környezetben.

YAML kódrészlet (Közzététel)

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

Paraméterek (közzététel)

Paraméterek Ismertetés
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 A szolgáltatás végpont, hogy közzé szeretné tenni a testreszabásokat (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás végpont, hogy közzé szeretné tenni a testreszabásokat (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt

Power Platform – Megoldásverzió beállítása

Frissíti egy megoldás verzióját.

YAML kódrészlet (verzió)

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

Paraméterek (verzió)

Paraméterek Ismertetés
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 A szolgáltatás végpont, hogy be szeretné állítani a megoldás verzióját (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás végpont, hogy be szeretné állítani a megoldás verzióját (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
SolutionName
Megoldás neve		 (Kötelező) A verzió beállításához szükséges megoldás neve. Mindig a megoldás Nevét használja , nem a Megjelenítendő nevet.
SolutionVersionNumber
Megoldás verziószáma		 (Kötelező) A beállítani kívánt verziószám.

Bár a verziószám a folyamat során rögzítve lehet, ajánlott olyan Azure DevOps-folyamatváltozót használni, mint a BuildId. Itt a verziószám pontos alakja definiálható a "Beállítások" lapon, például : $(Év:yyyy)-$(Hónap:HH)-$(Nap:dd)-$(rev:rr)-3

Ez a meghatározás ezután használható a Megoldásverzió beállítása feladatban a következő Verziószámtulajdonság beállításával $(Build.BuildId) értékre, a 20200824.0.0.2 beépítése helyett.

Másik lehetőségként egy powershell inline feladat-parancsfájl $(Get-Date -Format yyyy.MM.dd.HHmm) kimenet a SolutionVersion üres változó neve Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), A megoldás verziószámának beállítása $(SolutionVersion) értékként.

Power Platform Kapcsolati változók beállítása

Beállítja a BuildTools.* változókat, hogy egyéni szkriptfeladatok hozzáférést biztosítsanak a szolgáltatáskapcsolat egyetlen igazságforrásként való használatához.

YAML-kódrészlet (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

Paraméterek (SetConnectionVariables)

Paraméterek Description
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 Az a szolgáltatás végpont amelyhez kapcsolati változókat szeretne beállítani. Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
timeoutInMinutes
Timeout		 Megadja azt a maximális időtartamot (percben), ameddig egy feladat végrehajtható, mielőtt a kiszolgáló megszakítaná. A nulla érték végtelen időtúllépést jelez.
retryCountOnTaskFailure
Újrapróbálkozások száma, ha a feladat sikertelen volt		 Megadja a feladat sikertelen végrehajtása esetén végrehajtandó újrapróbálkozások számát. Ügynök nélküli feladatokhoz nem támogatott.
ApplicationId
Alkalmazásazonosító a bejelentkezéshez		 (felhasználónévhez/jelszóhoz szükséges) A bejelentkezéshez használandó alkalmazásazonosító (lásd az alábbi kiegészítő megjegyzést).
RedirectUri
Az adott alkalmazás átirányítási URI-ja		 (felhasználónévhez/jelszóhoz szükséges) A megadott alkalmazás átirányítási URI-ja. Alkalmazásazonosító megadásakor szükséges. (Lásd az alábbi kiegészítő megjegyzést).

Feljegyzés

A felhasználónév/jelszó hitelesítési típus használata esetén az alkalmazásazonosítóra és az átirányítási URI-ra lesz szükség. Ez a hitelesítési oauth-dokumentum magyarázatot tartalmaz arra, hogy miért kell alkalmazásregisztrációt létrehoznia a hitelesítéshez Dataverse. Ha felhasználónév/jelszó hitelesítéssel csatlakozik, a kapcsolat olyan alkalmazásként viselkedik, amely a felhasználó nevében csatlakozik Dataverse.

Power Platform – Csomag telepítése

Csomagot telepít egy környezetbe. Ha egyetlen megoldásfájl helyett csomagot telepít, akkor többféle megoldást, adatot és kódot helyezhet el egy környezetben.

YAML kódrészlet (Üzembe helyezés)

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

Paraméterek (üzembe helyezés)

Paraméterek Ismertetés
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 Az a szolgáltatás végpont, amelybe telepíteni szeretné a csomagot (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
PowerPlatformSPN
Power Platform Szolgáltatásnév		 Az a szolgáltatás végpont, amelybe telepíteni szeretné a csomagot (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával. További információért lásd: BuildTools.EnvironmentUrl a Power Platform Környezet létrehozása alatt
PackageFile
Csomagfájl		 (Kötelező) A csomagfájl összeszerelésének (.dll) elérési útja és fájlneve.
MaxAsyncWaitTime
Maximális várakozási idő		 Az aszinkron művelet maximális várakozási ideje percben; alapértelmezett érték 60 perc (1 óra), ugyanaz, mint a Azure DevOps feladatok alapértelmezett beállítása.

Környezetkezelési feladatok

Környezet-életciklus kezelésére szolgáló (ELM) gyakori feladatok automatizálása.

Power Platform környezet létrehozása

Új környezet létrehozása. Az új környezet létrehozása automatikusan létrehozza a következőt: BuildTools.EnvironmentUrl.

Fontos

A BuildTools.EnvironmentUrl beállításakor a rendszer alapértelmezett szolgáltatáskapcsolatként használja a folyamat későbbi feladataihoz. A cikkben ismertetett minden feladat csak akkor használja végpont a szolgáltatáskapcsolatból származó erőforrást, ha a BuildTools.EnvironmentUrl nincs beállítva.

Az új környezet csak akkor építhető ki, ha a licence vagy a kapacitása lehetővé teszi a további környezetek létrehozását. További információ a kapacitás megtekintéséről: A Kapacitás oldal részletei.

YAML kódrészlet (Létrehozás-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

Paraméterek (Létrehozás-env)

Paraméterek Ismertetés
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 A szolgáltatás végpont, hogy létre szeretné hozni a környezetet (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás végpont, hogy létre szeretné hozni a környezetet (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
DisplayName
Megjelenítendő név		 (Kötelező) A létrehozott környezet megjelenítendő neve.
LocationName
Telepítési régió		 (Kötelező) Az a régió, ahol a környezetet létre kell hozni.
EnvironmentSku
Környezet típusa		 (Kötelező) A telepítendő példány típusa. A lehetőségek a Tesztkörnyezet, Gyártás, Próbaverzió és SubscriptionBasedTrial értékek.
AppsTemplate
Alkalmazások		 Nem próbaverziós környezet esetén a támogatott alkalmazások: D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation és D365_Sales.
CurrencyName
Pénznem		 (Kötelező) A létrehozott környezet alappénzneme. A pénznem a környezet létrehozása után nem frissíthető.
LanguageName
Language		 (Kötelező) A környezet alapnyelve.
DomainName
Tartománynév		 (Kötelező) Ez az URL-cím részét képező környezetspecifikus sztring. Például ahttps://powerappsbuildtasks.crm.dynamics.com/ URL-címmel rendelkező környezet esetében a tartománynév a powerappsbuildtasks.

Megjegyzés: ha már használatban lévő tartománynevet ad meg, a feladat egy numerikus értéket fűz hozzá a tartománynévhez – nullával kezdődően. A fenti példában előfordulhat, hogy az URL-címhttps://powerappsbuildtasks0.crm.dynamics.com/ lesz.

Power Platform – környezet törlése

Töröl egy környezetet.

YAML kódrészlet (Törlés-env)

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

Paraméterek (törlés-env)

Paraméterek Ismertetés
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 A szolgáltatás végpont, hogy törölni szeretné a környezetet (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás végpont, hogy törölni szeretné a környezetet (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.

Power Platform Felhasználó hozzárendelése

Felhasználó hozzárendelése a megadott biztonsági szerepkör célkörnyezethez.

YAML-kódrészlet (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

Paraméterek (AssignUser-env)

Paraméterek Description
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás ahhoz a környezethez végpont, amelyhez hozzá szeretné rendelni a felhasználót (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
User
Power Platform felhasználónév		 Microsoft Entra objektumazonosító vagy a felhasználó egyszerű neve a célkörnyezethez való hozzárendeléshez.
Role
Biztonsági szerepkör név vagy azonosító		 Biztonsági szerepkör felhasználóhoz hozzárendelni kívánt név vagy azonosító.
ApplicationUser
Power Platform alkalmazás felhasználóneve		 Megadja, hogy a bemeneti felhasználó alkalmazásfelhasználó (igaz|hamis).

Power Platform Környezet visszaállítása

Visszaállítja a környezetet.

YAML-kódrészlet (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'

Paraméterek (Reset-env)

Paraméterek Description
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 A szolgáltatás végpont, hogy alaphelyzetbe szeretné állítani a környezetet (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás végpont, hogy alaphelyzetbe szeretné állítani a környezetet (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.

Power Platform – biztonsági másolat készítése a környezetről

Biztonsági másolat készítése egy környezetről.

YAML kódrészlet (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)'

Paraméterek (Backup-env)

Paraméterek Ismertetés
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 A szolgáltatás végpont, hogy biztonsági másolatot szeretne készíteni a környezetről (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás végpont, hogy biztonsági másolatot szeretne készíteni a környezetről (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
BackupLabel
Biztonsági másolat címkéje		 (Szükséges) A biztonsági másolathoz rendelt címke.

Power Platform – Környezet másolása

Egy környezetet egy célkörnyezetbe másol. Két típusú másolás használható: teljes és minimális. A teljes másolás az adatokra és a megoldások metaadataira (testreszabások) is kiterjed; a minimális csak a megoldások metaadataira, a tényleges adatokra nem.

YAML-kódrészletének (másolás-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

Paraméterek (másolás-env)

Paraméterek Ismertetés
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 A szolgáltatás ahhoz a forráskörnyezethez végpont, amelyből másolni szeretne (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás ahhoz a forráskörnyezethez végpont, amelyből másolni szeretne (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
TargetEnvironmentUrl
Célkörnyezet URL-címe		 (Szükséges) Annak a cél-környezetnek az URL-címe, amelyet másolni szeretne.
CopyType
Másolás típusa		 A másolás típusa a teljesítményhez: FullCopy vagy MinimalCopy
OverrideFriendlyName
Felhasználóbarát név felülbírálása		 Változtassa a célkörnyezet felhasználóbarát nevét másik névre (igaz|hamis).
FriendlyName
Felhasználóbarát név		 A célkörnyezet felhasználóbarát neve.
DisableAdminMode
Rendszergazdai mód letiltása		 Megadhatja, hogy tiltsa-e le az adminisztrációs módot (igaz|hamis).

Power Platform Környezet visszaállítása

Visszaállítja a környezetet egy adott biztonsági másolatba.

YAML-kódrészlet (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'

Paraméterek (Restore-env)

Paraméterek Description
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformEnvironment
Power Platform-környezet URL-címe		 A szolgáltatás ahhoz a forráskörnyezethez végpont, amelyből vissza szeretné állítani (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás ahhoz a forráskörnyezethez végpont, amelyből vissza szeretné állítani (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
RestoreLatestBackup
A legutóbbi biztonsági mentés visszaállítása		 Azt határozza meg, hogy visszaállítja-e a legújabb biztonsági másolatot, vagy megadja a RestoreTimeStamp (igaz|hamis) értéket.
RestoreTimeStamp
A biztonsági mentés dátuma		 A biztonsági másolat DateTime értéke „hh/nn/éééé óó:pp” formátumban, VAGY „legutóbbi” karakterlánc
TargetEnvironmentUrl
Célkörnyezet URL-címe		 (Kötelező) A visszaállítani kívánt célkörnyezet URL-címe.
FriendlyName
A visszaállított környezet neve		 (Nem kötelező) A helyreállított környezet neve.
DisableAdminMode
Rendszergazdai mód letiltása		 Megadhatja, hogy tiltsa-e le az adminisztrációs módot (igaz|hamis).

Adatok exportálása Dataverse

Adatok exportálása egy környezetből a megadott sémával.

YAML-kódrészlet (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

Paraméterek (exportdata-env)

Paraméterek Description
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás ahhoz a környezethez végpont, amelyből adatokat szeretne exportálni (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
SchemaFile
Séma XML-fájlneve		 Séma XML-fájlneve. A Configuration Migration eszközzel hozható létre.
DataFile
Adatfájl neve		 Az exportálandó adatok fájlneve (zip-fájl).
Overwrite
Tartalom felülírása		 Power Pages felülírandó webhelytartalom (igaz|hamis).

Adatok importálása Dataverse

Adatok importálása egy környezetbe.

YAML-kódrészlet (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'

Paraméterek (importdata-env)

Paraméterek Description
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás végpont ahhoz a környezethez, amelybe adatokat szeretne importálni (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
DataFile
Adatfájl neve		 A tömörített zip fájlneve) adatfájl importálása, vagy az importálni kívánt data-schema.xml és data.xml tartalmazó mappa.

Power Pages Kezelési feladatok

A webhelyekkel való Power Pages munka feladatai.

Power Platform PAPortal letöltés

Power Pages-webhely tartalmának letöltése a jelenlegi Dataverse-környezetből.

YAML-kódrészlet (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

Paraméterek (download-paportal)

Paraméterek Description
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás ahhoz a környezethez végpont, amelyből tartalmat szeretne letölteni (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
WebsiteId
Portál webhelyének azonosítója		 Power Pages webhely azonosítója a letöltéshez.
Overwrite
Tartalom felülírása		 Power Pages felülírandó webhelytartalom (igaz|hamis).
ModelVersion
Helyadat-modell		 Azt jelzi, hogy a feltöltendő webhelyadatok a szabványos (1) vagy a továbbfejlesztett adatmodellt () használják-e.2 Az alapértelmezett érték "1".

Power Platform PAPortal feltöltés

Töltse fel Power Pages a webhely tartalmát az aktuális Dataverse környezetbe.

YAML-kódrészlet (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'

Paraméterek (upload-paportal)

Paraméterek Description
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás ahhoz a környezethez végpont, amelybe tartalmat szeretne feltölteni (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
UploadPath
Tartalom feltöltési útvonala		 Az elérési út, ahonnan a Power Pages webhely tartalma feltöltésre kerül.
ModelVersion
Helyadat-modell		 Azt jelzi, hogy a feltöltendő webhelyadatok a szabványos (1) vagy a továbbfejlesztett adatmodellt () használják-e.2 Az alapértelmezett érték "1".

Feladatok katalógusa Power Platform (előzetes verzió)

Ezek a feladatok műveleteket hajtanak végre a katalóguson, Power Platform és a következőket tartalmazzák.

Feljegyzés

Jelenleg a katalógusfeladatai előzetes Power Platform kiadásúak.

Katalóguselem telepítése

Katalóguselem telepítése a célkörnyezetbe.

Paraméterek Description
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás ahhoz a környezethez végpont, amelybe tartalmat szeretne feltölteni (például). https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
Environment
Célkörnyezet URL-címe		 (Kötelező) A feladat által megcélzott környezeti URL-cím.
CatalogItemId
Telepítendő katalóguselem-azonosító		 (Kötelező) A célkörnyezetre telepítendő katalóguselem.
TargetEnvironmentUrl
Célkörnyezet URL-címe		 (Kötelező) A katalóguselem célkörnyezetének URL-címe (például "https://YourOrg.crm.dynamics.com").
PollStatus
Ellenőrizze a szavazás állapotát		 (Nem kötelező) Szavazással ellenőrizheti a kérés állapotát (igaz|hamis).

Paraméterek (katalógus-telepítés)

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

Katalógus jóváhagyásának elküldése

Katalógusjóváhagyási kérés küldése.

Paraméterek Description
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás ahhoz a környezethez végpont, amelybe tartalmat szeretne feltölteni (például "").https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
Environment
Célkörnyezet URL-címe		 (Kötelező) A feladat által megcélzott környezeti URL-cím.
CatalogSubmissionFile
Katalógusbeküldési fájl		 (Kötelező) Adja meg a katalógusküldési fájl elérési útját és fájlnevét.
UsePackageSolutionZipFile
Fájltípus		 Fájltípus: csomag vagy megoldás zip-fájlja.
SolutionZipFile
Megoldás zip-fájlneve		 Adja meg a megoldás zip-fájljának elérési útját és fájlnevét.
PollStatus
Ellenőrizze a szavazás állapotát		 (Nem kötelező) Szavazással ellenőrizheti a kérés állapotát (igaz|hamis).

Paraméterek (katalógus elküldése)

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

Katalóguskérelem állapota

A katalógus telepítési/küldési kérésének állapotának lekérése.

Paraméterek Description
authenticationType
A hitelesítés típusa		 (SPN-hez kötelező) Adja meg vagy a PowerPlatformEnvironment értéket a jelszó/felhasználónév kapcsolathoz vagy a PowerPlatformSPN értéket egy szolgáltatásnév/titkos ügyfélkód kapcsolatához.
PowerPlatformSPN
Power Platform Szolgáltatásnév		 A szolgáltatás ahhoz a környezethez végpont, amelybe tartalmat szeretne feltölteni (például "").https://powerappsbuildtools.crm.dynamics.com Definiálva van a ProjektbeállításokSzolgáltatáskapcsolatok lehetőség alatt a Power Platform kapcsolattípus használatával.
Environment
Célkörnyezet URL-címe		 (Kötelező) A feladat által megcélzott környezeti URL-cím.
TrackingId
Kérelem nyomon követési azonosítója		 (Kötelező) Nyomkövetési azonosító kérése.
RequestType
Kérelem típusa		 (Kötelező) Reqeust típus. (Értékek: Telepítés | Küldés).

Paraméterek (katalógus-állapot)

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

Buildelési és kiadási folyamatok

Miutáán megtanulta, hogy mire használhatók a buildelési eszközök, nézzük meg, hogyan alkalmazhatja ezeket az eszközöket a buildelési és kiadási folyamatok során. Az alábbiakban egy elméleti áttekintést lát. A közvetkező alszakaszokban bemutatunk néhány részletet a folyamat buildeszközök feladatainak használatával történő megvalósításáról.

Ha többet szeretne tudni ezekről a folyamatokról, és gyakorlatban használatos eszközöket szeretne készíteni a Microsoft Power Platform Build Tools segítségével, végezze el a GitHubról letölthető buildeszközök laborja képzést.

További információ az Azure Pipelinesról: Az Azure Pipelines használata

Buildelési folyamat: megoldás exportálása a fejlesztői környezetből (DEV)

Az alábbi ábra azokat a buildelési eszközöket mutatja be, amelyek hozzáadhatók olyan folyamatokhoz, amelyek fejlesztői környezetből exportálnak megoldást.

Megoldás exportálása fejlesztési környezetből (DEV).

Buildelési folyamat: felügyelt megoldás buildelése

Az alábbi ábra azokat a buildelési eszközöket mutatja be, amelyek hozzáadhatók olyan folyamatokhoz, amelyek felügyelt megoldásokat buildelnek.

Építsen egy felügyelt megoldás.

Kiadási folyamat: telepítés éles környezetbe (PROD)

Az alábbi ábra azokat a buildelési eszközöket mutatja be, amelyek hozzáadhatók olyan folyamatokhoz, amelyeket éles környezetbe telepítenek.

Üzembe helyezés éles környezetben (PROD).

Lásd még

Microsoft Power Platform Build Tools for Azure DevOps