Microsoft Power Platform Build Tools-feladatok

A rendelkezésre álló buildelési feladatokat az alábbi szakaszok ismertetik. Ezt követően 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

A rendelkezésre álló 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 nem igényel további konfigurációt a hozzáadáskor. Ez a feladat tartalmazza a telepített eszközök adott verzióinak paramétereit.

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

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

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

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

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

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

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ére 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@2
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

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

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 című szakaszt Megjegyzés : A szolgáltatásnév és a felhasználónév/jelszó hitelesítési módszerek elérhetők az ellenőrző feladathoz. 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, 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 az 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	Kötelező, ha az SAS-fájlok elemzése nem történik meg. 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 lévő ö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 ugyanaz, mint a Power Apps készítői portálról futtatott. AppSource: Az alkalmazás hitelesítésére szolgáló kiterjesztett szabálykészlet, mielőtt közzé AppSource lehetne tenni.
ErrorLevel Hiba szintje	A hibával kombinálva a threshold 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 fájl 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örnyezetet létrehozó, másoló vagy visszaállító környezeti feladatok felülírják az újonnan létrehozott környezetekkel való szolgáltatáskapcsolatokat. Ezek a feladatok lehetővé teszik a megoldási feladatok végrehajtását az igény szerint létrehozott környezeteken.

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

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

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	Az a szolgáltatásvé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	Az a szolgáltatásvé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 megoldás elérési útja és fájlneve .zip a célkörnyezetbe importálandó fájlt (például $(Build.ArtifactStagingDirectory)$(SolutionName) .zip). Megjegyzés: A változók kényelmes módot biztosítanak arra, hogy kulcsfontosságú adatokat szerezzen be a folyamat különböző részeibe. Á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

Hozzáad egy megoldás-összetevőt 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át lásd: Előre definiált összetevőtípusok használata.
SolutionUniqueName A megoldás neve	A megoldás egyedi neve.
AddRequiredComponents A megoldás összetevőjétől függő más megoldáshoz szükséges összetevők	(Nem kötelező) Azt jelzi, hogy a hozzáadni kívánt megoldás-összetevő által igényelt egyéb megoldás-összetevőket is hozzá kell-e adni a nem felügyelt megoldáshoz.
Environment Környezeti URL-cím vagy azonosító	(Nem kötelező) A célkörnyezet környezeti URL-címe vagy 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@2
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    AsyncOperation: false

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

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	Az a szolgáltatásvé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	Az a szolgáltatásvé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.

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

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

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	Az a szolgáltatásvé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	Az a szolgáltatásvé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 fájlneve, amelybe exportálni szeretné a forráskörnyezetet (például $(Build.ArtifactStagingDirectory)$(SolutionName) .zip ). Megjegyzés: A változók kényelmes módot biztosítanak arra, hogy kulcsfontosságú adatokat szerezzen be a folyamat különböző részeibe. Á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@2
  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@2
  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@2
  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	Az a szolgáltatásvégpont, amelyről 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	Az a szolgáltatásvégpont, amelyről 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@2
  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 testreszabásokat közzétenni kívánt szolgáltatásvégpont (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 testreszabásokat közzétenni kívánt szolgáltatásvégpont (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@2
  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 megoldás verzióját beállítani kívánt szolgáltatásvégpont (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 megoldás verzióját beállítani kívánt szolgáltatásvégpont (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 szkriptfeladatokhoz hozzáférést biztosítson 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ásvé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	Megadja a feladat sikertelensége esetén végrehajtandó újrapróbálkozások számát. Ügynök nélküli feladatok esetén nem támogatott.
ApplicationId Alkalmazásazonosító a bejelentkezéshez	(Felhasználónév/jelszó esetén kötelező) A bejelentkezéshez használandó alkalmazásazonosító (lásd az alábbi további megjegyzést).
RedirectUri Az adott alkalmazás átirányítási URI-ja	(Felhasználónév/jelszó esetén kötelező) A megadott alkalmazás átirányítási URI-ja. Alkalmazásazonosító megadásakor szükséges. (Lásd az alábbi további megjegyzést).

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@2
  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ásvé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ásvé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.

YAML kódrészlet (Létrehozás-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@2
  displayName: 'Power Platform Create Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    DisplayName: 'First Coffee test'
    DomainName: firstcoffee

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

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 környezetet létrehozni kívánt szolgáltatásvégpont (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 környezetet létrehozni kívánt szolgáltatásvégpont (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 olyan tartománynevet ad meg, amely már használatban van, a feladat egy numerikus értéket fűz a tartománynévhez, 0-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@2
  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 környezetet törölni kívánt szolgáltatásvégpont (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 környezetet törölni kívánt szolgáltatásvégpont (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 egy meghatározott biztonsági szerepkörrel rendelkező 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	Annak a környezetnek a szolgáltatásvégpontja, 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 neve vagy azonosítója	A felhasználóhoz hozzárendelendő biztonsági szerepkör neve vagy azonosítója.
ApplicationUser Power Platform Alkalmazás felhasználóneve	Megadja, hogy a bemeneti felhasználó alkalmazásfelhasználó-e (true|false).

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

Alaphelyzetbe á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 környezetet alaphelyzetbe állítani kívánt szolgáltatásvégpont (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 környezetet alaphelyzetbe állítani kívánt szolgáltatásvégpont (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@2
  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	Az a szolgáltatásvégpont, amelyről 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	Az a szolgáltatásvégpont, amelyről 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@2
  displayName: 'Power Platform Copy Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'

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

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	Annak a forráskörnyezetnek a szolgáltatásvégpontja, 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	Annak a forráskörnyezetnek a szolgáltatásvégpontja, 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.
SkipAuditData SkipAuditData	Kihagyja-e a naplózási adatokat a másolási művelet során. (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	Annak a forráskörnyezetnek a szolgáltatásvégpontja, 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	Annak a forráskörnyezetnek a szolgáltatásvégpontja, 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 Legújabb visszaállítási biztonsági mentés	Vissza kell-e állítani a legújabb biztonsági másolatot, vagy meg kell-e adni a RestoreTimeStamp (true|false) értéket.
RestoreTimeStamp A biztonsági mentés dátuma és időpontja	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 visszaá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	Annak a környezetnek a szolgáltatásvégpontja, 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ájlnév. A konfigurációáttelepítési 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ó webhely tartalma (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	Az adatokat importálni kívánt környezet szolgáltatásvégpontja (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	Az importálandó tömörített zip) adatfájl fájlneve, vagy az importálni kívánt data-schema.xml és data.xml tartalmazó mappa.

Power Pages Kezelési feladatok

Weboldallal való munkához Power Pages szükséges feladatok.

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	Annak a környezetnek a szolgáltatásvégpontja, 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 webhelyazonosítója	Power Pages webhely azonosítója a letöltéshez.
Overwrite Tartalom felülírása	Power Pages felülírandó webhely tartalma (igaz|hamis).
ModelVersion Helyadat-modell	Azt jelzi, hogy a feltöltendő webhelyadatok a standard (1) vagy a bővített adatmodell ()2 adatokat használják-e. 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	Annak a környezetnek a szolgáltatásvégpontja, 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ődik.
ModelVersion Helyadat-modell	Azt jelzi, hogy a feltöltendő webhelyadatok a standard (1) vagy a bővített adatmodell ()2 adatokat használják-e. 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.

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	Annak a környezetnek a szolgáltatásvégpontja, 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óguselemek telepítésének célkörnyezetének URL-címe (például "").https://YourOrg.crm.dynamics.com
PollStatus Szavazás állapotának ellenőrzése	(Nem kötelező) Szavazás a kérés állapotának ellenőrzéséhez (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	Annak a környezetnek a szolgáltatásvégpontja, 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ógus beküldési fájl	(Kötelező) Adja meg a katalógusbekü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ájl.
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 Szavazás állapotának ellenőrzése	(Nem kötelező) Szavazás a kérés állapotának ellenőrzéséhez (igaz|hamis).

Paraméterek (katalógus-küldés)

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

Szerezze be a katalógus telepítési/elküldési kérésének állapotát.

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	Annak a környezetnek a szolgáltatásvégpontja, 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 Nyomkövetési azonosító kérése	(Kötelező) Nyomkövetési azonosító kérése.
RequestType Kérelem típusa	(Kötelező) Igény típusa. (É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.

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.

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.

Lásd még

Microsoft Power Platform Készítsen eszközöket Azure DevOps