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:
|
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. |
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@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). |
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 létrehoznia egy alkalmazásregisztrációt a hitelesítéshez Dataverse. Ha felhasználónév/jelszó hitelesítéssel csatlakozik, a kapcsolat 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@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
.
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.
Új környezet csak akkor építhető ki, ha a licenc vagy a kapacitás lehetővé teszi 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@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ím |
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.
Feljegyzés
Jelenleg a katalógusfeladatok Power Platform előzetes kiadásban vannak.
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.