Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
De tillgängliga versionsuppgifterna beskrivs i följande avsnitt. Därefter presenterar vi några exempel på Azure Pipelines som gör det enklare att använda dessa uppgifter. Mer information om Build Tools och hur du hämtar dem finns i Microsoft Power Platform Build Tools för Azure Pipelines.
Assistentuppgift
De tillgängliga hjälpuppgifterna beskrivs bredvid.
Installationsprogram för Power Platform-verktyg
Den här uppgiften krävs för att läggas till en gång före alla andra uppgifter för Power Platform-versionsverktyg och verionspipelines. Denna uppgift installerar en uppsättning Power Platform-specifika verktyg som krävs av agenten för att köra Microsoft Power Platform-versionsuppgifter. För den här uppgiften krävs ingen ytterligare konfiguration när den läggs till. För den här uppgiften innehåller parametrar för de specifika versionerna av varje verktyg som installeras.
Du kan hålla dig uppdaterad om verktygsversionen över tid genom att se till att dessa parametrar motsvarar de versioner av verktygen som krävs för att pipelinen ska kunna köras korrekt.
YAML kodavsnitt (installationsprogram)
# Installs default Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
displayName: 'Power Platform Tool Installer'
# Installs default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
displayName: 'Power Platform Tool Installer'
inputs:
AddToolsToPath: true
# 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
Parametrar (installationsprogram)
| Parameters | Beskrivning |
|---|---|
DefaultVersionAnvända standardverktygsversioner |
Ange till sant för att använda standardversionen av alla verktyg, annars falskt. Obligatoriskt (och falskt) om någon verktygsversion har angetts. |
AddToolsToPathLägg till verktyg i sökvägen |
Lägger till pac cli i PATH miljövariabeln. Möjliggör för dig att använda pac CLI från skript utan att behöva ange sökvägen manuellt. |
PowerAppsAdminVersionXrmToolingPackageDeploymentVersionMicrosoftPowerAppsCheckerVersionCrmSdkCoreToolsVersionVerktygsversion |
Den specifika versionen av verktyget som ska användas. |
Power Platform VemÄrJag
Verifierar en serviceanslutning till en Power Platform-miljö genom att ansluta till och göra en WhoAmI-förfrågan. Denna uppgift kan vara bra att ta med tidigt i pipelinen i syfte att bekräfta anslutningen innan bearbetningen påbörjas.
YAML kodavsnitt (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'
Parametrar (WhoAmI)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Valfritt) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Tjänsteslutpunkten för den miljö som du vill ansluta till. Definieras under Tjänsteanslutningar under Projektinställningar. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Tjänsteslutpunkten för den miljö som du vill ansluta till. Definieras under Tjänsteanslutningar under Projektinställningar. |
Kvalitetskontroll
I nästa avsnitt visas de tillgängliga uppgifterna för att kontrollera kvaliteten i en lösning.
Power Platform-kontroll
Med den här uppgiften körs en statisk analyskontroll av dina lösningar mot en uppsättning regler för att identifiera eventuella problematiska mönster som du av misstag har introducerat när lösningen skapades.
YAML kodavsnitt (kontroll)
# 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'
Parametrar (kontroll)
| Parameters | Beskrivning |
|---|---|
PowerPlatformSPNTjänstanslutning |
(Krävs) En anslutning till en licensierad Microsoft Power Platform-miljö krävs för att du ska kunna använda Power Platform-kontrollen. Tjänstanslutningar definieras i Tjänstanslutningar under Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform skapa miljöObs! Huvudkonto för tjänsten och autentiseringsmetoderna användarnamn/lösenord är tillgängliga för kontrolluppgift. Mer information om hur du konfigurerar tjänsthuvud för användning med den här uppgiften finns i Konfigurera tjänsthuvud anslutningar för Power Platform-miljöer. |
UseDefaultPACheckerEndpointAnvänd standard Power Platform slutpunkt för kontroll |
Som standard (sant), den geografiska platsen för kontrolltjänsten kommer att använda samma geografi som miljön du ansluter till. |
CustomPACheckerEndpointAnpassad PAC slutpunkt för kontroll |
Obligatoriskt när UseDefaultPACheckerEndpoint är falskt. Du kan ange att ytterligare ett geografiskt område som ska användas, till exempel https://japan.api.advisor.powerapps.com.En lista över tillgängliga geografier finns i Använda Power Platform Checker API. |
FileLocationPlatsen för filer som ska analyseras |
Krävs när en fil refereras från en SAS-URL (signatur för delad åtkomst). sasUriFile.Obs! Det är viktigt att referera till en exporterad lösningsfil och inte till de opackade källfilerna i databasen. Både hanterade och icke-hanterade lösningsfiler kan analyseras. |
FilesToAnalyzeSasUriSAS-filer att analysera |
Obligatoriskt när FileLocation är inställt på sasUriFile. Ange en SAS URI. Du kan lägga till fler än en SAS-URI via komma (,) eller semikolon (;) separat lista. |
FilesToAnalyzeLokala filer att analysera |
Krävs när SAS-filer inte analyseras. Ange sökväg och filnamn för de zip-filer som ska analyseras. Jokertecken kan användas. Ange till exempel **\*.zip för alla zip-filer i alla undermappar. |
FilesToExcludeLokala filer att exkludera |
Ange namnen på filer som ska uteslutas från analysen. Om fler än en tillhandahåller ett komma (,) eller semikolon (;) listan med avgränsade listor. Den här listan kan innehålla ett fullständigt filnamn eller ett namn med inledande eller avslutande jokertecken, t.ex. *jquery eller form.js |
RulesToOverrideRegler som ska åsidosätts |
En JSON-matris som innehåller regler och nivåer som ska åsidosätts. Godkända värden för OverrideLevel är: Kritisk, Hög, Låg, Informerande. Exempel: [{"Id":"meta-ta bort-dup-reg","OverrideLevel":"Han"},{"Id":"--undvika-specialiserade-update-ops","OverrideLevel":"4."}] |
RuleSetRegeluppsättning |
(Krävs) Ange vilken regeluppsättning som ska tillämpas. Följande två regeluppsättningar är tillgängliga:
|
ErrorLevelFelnivå |
I kombination med parametern för feltröskel definierar denna allvarlighetsnivån i de fel och varningar om som tillåts. Tröskelvärden som stöds är <level>IssueCount där nivå = Kritisk, Hög, Låg och Informerande. |
ErrorThresholdFeltröskel |
Definierar antalet fel (>=0) på en angiven nivå som tillåts för att kontrollen ska skicka de lösningar som kontrolleras. |
FailOnPowerAppsCheckerAnalysisErrorMisslyckas vid fel |
Om sant misslyckas om Power Apps kontrollanalysen returneras som Misslyckades eller FinishedWithErrors. |
ArtifactDestinationNameDevOps-artefaktnamn |
Ange Azure artefaktnamnet för kontrollen .sarif-filen. |
Lösningsuppgifter
Denna uppsättning uppgifter kan automatisera lösningsåtgärder. Miljöuppgifterna som beskrivs längre fram i det här avsnittet beskriver hur du skapar, kopierar eller återställer en miljö skriver över tjänstanslutningarna till de nyskapade miljöerna. De här uppgifterna gör det möjligt att utföra lösningsuppgifter mot miljöer som skapas på begäran.
Importlösning i Power Platform
Importerar en lösning till en målmiljö.
YAML kodavsnitt (Importera)
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
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
Parametrar (Importera)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Den tjänstslutpunkt du vill importera lösningen till (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Den tjänstslutpunkt du vill importera lösningen till (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
SolutionInputFileLösningens indatafil |
(Krävs) Sökväg och filnamn för den lösnings-zip-fil som ska importeras till målmiljön (t. ex $(Build.ArtifactStagingDirectory)$(SolutionName).zip).
Obs! Med variabler får du ett bekvämt sätt att få viktiga databitar i olika delar av din pipeline. Se Använda fördefinierade variabler för att via en omfattande lista. |
HoldingSolutionImportera som en lösning som håller |
En förskottsparameter (true|false) används när en lösning måste uppgraderas. Den här parametern håller lösningen i Dataverse men uppgraderar inte lösningen förrän uppgiften Använd lösningsuppgradering har körts. |
OverwriteUnmanagedCustomizationsSkriv över icke-hanterade anpassningar |
Ange om icke-hanterade anpassningar ska skrivas över (true|false). |
SkipProductUpdateDependenciesHoppa över beroenden för produktuppdatering |
Ange om tvingande beroenden som är relaterade till produktuppdateringar ska hoppa över (true|false). |
ConvertToManagedKonvertera till hanterad |
Föråldrad. Systemet konverterar ohanterade komponenter till hanterade när du importerar en hanterad lösning. |
AsyncOperationAsynkron import |
Om vald (sant), kommer importåtgärden att utföras asynkront. Detta rekommenderas för större lösningar eftersom den här uppgiften automatiskt gör timeout efter 4 minuter. Om du väljer asynkron avsöks den och väntar tills MaxAsyncWaitTime har nåtts (true|false). |
MaxAsyncWaitTimeHögsta väntetid |
Längsta väntetid i minuter för asynkron åtgärd; standardvärdet är 60 min (1 timme), samma som Azure DevOps standard för uppgifter. |
PublishWorkflowsAktivera processer efter import |
Ange om några processer (arbetsflöden) i lösningen ska aktiveras efter import (true|false). |
UseDeploymentSettingsFileAnvänd fil för installationsinställningar |
Anslutningsreferenser och miljövariabler kan ställas in med hjälp av en distributionsinställningar fil (true|false). |
DeploymentSettingsFileDistributionsinställningsfil |
(Krävs när UseDeploymentSettingsFile=sant) Sökvägen och filnamnet för distributionsinställningarnas fil. |
Power Platform lägg till lösningskomponent
Lägger till en lösningskomponent till en ohanterad lösning.
YAML kodavsnitt (lägg till)
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
Parametrar (lägg till)
| Parameters | Beskrivning |
|---|---|
ComponentIdLösningskomponentens ID |
Schemanamnet eller ID:t för komponenten som ska läggas till mållösningen. |
ComponentTypeMiljö-URL för Power Platform |
Värdet som representerar den lösningskomponent du lägger till. Se Använd fördefinierade komponenttyper för en omfattande lista över komponentvärden. |
SolutionUniqueNameNamn på lösningen |
Unikt namn på lösningen. |
AddRequiredComponentsAlla komponenter som krävs från en annan lösning som är beroende av lösningskomponent |
(Valfritt) Anger om andra lösningskomponenter som krävs av den lösningskomponenten du lägger till också ska läggas till i den ohanterade lösningen. |
EnvironmentMiljö-URL eller ID |
(Valfritt) Miljö-URL eller miljö-ID för målmiljön. |
Power Platform Tillämpa uppgradering av lösning
Uppgraderar en lösning som har importerats som en förvaringslösning.
YAML kodavsnitt (uppgradering)
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
Parametrar (uppgradering)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Den tjänstslutpunkt du vill uppgradera lösningen till (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Den tjänstslutpunkt du vill uppgradera lösningen till (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
SolutionNameLösningsnamn |
(Obligatoriskt) Namnet på den lösning som ska användas vid uppgraderingen. Använd alltid lösningens Namn, inte dess visningsnamn. |
AsyncOperationAsynkron uppgradering |
Om vald (sant), kommer uppgraderingsåtgärden att utföras som ett asynkront batch-jobb. Om du väljer asynkron avsöks den och väntar tills MaxAsyncWaitTime har nåtts. |
MaxAsyncWaitTimeHögsta väntetid |
Längsta väntetid i minuter för asynkron åtgärd; standardvärdet är 60 min (1 timme), samma som Azure DevOps standard för uppgifter. |
Kommentar
Med variabler får du ett bekvämt sätt att få viktiga databitar i olika delar av din pipeline. Se Använda fördefinierade variabler för att via en omfattande lista. Du kan fylla i information om anslutningsreferenser och miljövariabler i förväg för målmiljön när du importerar en lösning med hjälp av en distributionsinställning fil.
Mer information: Förifyllda anslutningsreferenser och miljövariabler för automatiserade distributioner
Exportlösning i Power Platform
Exportera en lösning från en källmiljö.
YAML kodavsnitt (Exportera)
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
Parametrar (Export)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Den tjänstslutpunkt du vill uppgradera lösningen till (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Den tjänstslutpunkt du vill uppgradera lösningen till (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
SolutionNameLösningsnamn |
(Krävs) Namnet på lösningen som ska exporteras. Använd alltid lösningens Namn, inte dess visningsnamn. |
SolutionOutputFileLösningens utdatafil |
(Krävs) Sökväg och filnamn för den lösnings-zip-fil som ska exporteras till källmiljön (t. ex $(Build.ArtifactStagingDirectory)$(SolutionName).zip).
Obs! Med variabler får du ett bekvämt sätt att få viktiga databitar i olika delar av din pipeline. Se Använda fördefinierade variabler för att via en omfattande lista. |
AsyncOperationAsynkron export |
Om vald (sant), kommer exporteringsåtgärden att utföras som ett asynkront batch-jobb. Om du väljer asynkron avsöks den och väntar tills MaxAsyncWaitTime har nåtts. |
MaxAsyncWaitTimeHögsta väntetid |
Längsta väntetid i minuter för asynkron åtgärd; standardvärdet är 60 min (1 timme), samma som Azure DevOps standard för uppgifter. |
ManagedExportera som hanterad |
Om alternativet är (sant), exportera lösningen som en hanterad lösning; annars exportera som en icke-hanterad lösning. |
ExportAutoNumberingSettingsExportera inställningar för automatisk numrering |
Exportera inställningar för automatisk numrering (true|false). |
ExportCalendarSettingsExportera kalenderinställningar |
Exportera kalenderinställningar (true|false). |
ExportCustomizationSettingsExportera anpassningsinställningar |
Exportera anpassningsinställningar (true|false). |
ExportEmailTrackingSettingsExportera inställningar av e-postspårning |
Exportera e-postspårningsinställningar (true|false). |
ExportGeneralSettingsExportera allmänna systeminställningar |
Exportera allmänna inställningar (true|false). |
ExportIsvConfigExportera ISV-konfiguration |
Exportera ISV-konfiguration (true|false). |
ExportMarketingSettingsExportera inställningar för marknadsföring |
Exportera inställningar för marknadsföring (true|false). |
ExportOutlookSynchronizationSettingsExportera synkroniseringsinställningar för Outlook |
Exportera synkroniseringsinställningar för Outlook (true|false). |
ExportRelationshipRolesExportera relationsroller |
Exportera relationsroller (true|false). |
ExportSalesExportera försäljning |
Exporterar försäljning (true|false). |
Uppackningslösning i Power Platform
Tar en komprimerad lösningsfil och delar upp den i flera olika XML- och andra filer så att dessa filer kan läsas och hanteras lättare av ett källkontrollsystem.
YAML kodavsnitt (Packa upp)
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
Parametrar (packa upp)
| Parameters | Beskrivning |
|---|---|
SolutionInputFileLösningens indatafil |
(Krävs) Sökväg och filnamn för de lösnings-zip-filer som ska packas upp. |
SolutionTargetFolderMålmapp för att packa upp en lösning |
(Krävs) Den sökväg och målmapp du vill packa upp lösningen i. |
SolutionTypeLösningstyp |
(Krävs) Den typ av lösning du vill packa upp. Alternativen är: icke-hanterad (rekommenderas), hanteras och både. |
Paketlösning i Power Platform
Packar en lösning som visas i källkontrollen i en lösnings-zip-fil som kan importeras till en annan miljö.
YAML kodavsnitt (Packa)
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
Parametrar (packa)
| Parameters | Beskrivning |
|---|---|
SolutionOutputFileLösningens utdatafil |
(Obligatoriskt) Sökväg och filnamn för den lösnings-zip-fil där lösningen ska packas. |
SolutionSourceFolderKällmapp för lösning till paket |
(Krävs) Sökväg och källmapp för den lösning som ska packas. |
SolutionTypeLösningstyp |
(Obligatoriskt) Den typ av lösning du vill packa. Alternativen är: Hanterad (rekommenderas), Icke-hanterad och Båda. |
Power Platform Ta bort lösning
Tar bort en lösning i målmiljön.
YAML kodavsnitt (Ta bort)
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'
Parametrar (Ta bort)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Den slutpunkt där du vill ta bort lösningen (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Den slutpunkt där du vill ta bort lösningen (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
SolutionNameLösningsnamn |
(Obligatoriskt) Namnet på lösningen som ska raderas. Använd alltid lösningens Namn, inte dess visningsnamn. |
Publicera anpassningar i Power Platform
Publicerar alla anpassningar i en miljö.
YAML kodavsnitt (publicera)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.publish-customizations.PowerPlatformPublishCustomizations@2
displayName: 'Power Platform Publish Customizations '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
Parametrar (publicera)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Den tjänstslutpunkt där du vill publicera anpassningarna (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Den tjänstslutpunkt där du vill publicera anpassningarna (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
Ange lösningsversion i Power Platform
Uppdaterar versionen av en lösning.
YAML kodavsnitt (version)
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
Innehållsversion för parametrar
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Den tjänstslutpunkt där du vill ange lösningsversionen (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Den tjänstslutpunkt där du vill ange lösningsversionen (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
SolutionNameLösningsnamn |
(Obligatoriskt) Namnet på den lösning som ska ange version för. Använd alltid lösningens Namn, inte dess visningsnamn. |
SolutionVersionNumberLösningsversionens nummer |
(Krävs) Versionsnummer du vill ange. |
Även om versionsnumret kan hårdkodade i pipelinen, bör du använda en Azure DevOps pipelinevariabel som BuildId. Det här innehåller alternativ för att definiera den exakta formen på versionsnumret under fliken Alternativ, till exempel: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3
Definitionen kan sedan användas i aktiviteten Ange lösningsversion genom att ange versionsnummer egenskapen med: $(Build.BuildId) i stället för hårdkodning 20200824.0.0.2.
Alternativt ett powershell infogat uppgiftsskript $(Get-Date -Format yyyy.MM.dd.HHmm) utdata satt till tom variabel med namnet SolutionVersion som skriv värd ("##vso[task.setvariable variable=SolutionVersion;]$version"), ange lösningsversion som $(SolutionVersion).
Power Platform ange anslutningsvariabel
Anger PowerPlatformSetConnectionVariables.BuildTools.* variabler för att ge åtkomst till anpassade skriptuppgifter för att använda tjänstanslutningen som en enda sanningskälla.
Följande variabler anges:
PowerPlatformSetConnectionVariables.BuildTools.TenantIdPowerPlatformSetConnectionVariables.BuildTools.ApplicationIdPowerPlatformSetConnectionVariables.BuildTools.ClientSecretPowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString
YAML-kodavsnitt (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
Parametrar (SetConnectionVariables)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Tjänstens slutpunkt som du vill ställa in anslutningsvariabler för. Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
timeoutInMinutesTimeout |
Anger den maximala tiden i minuter som en uppgift får köras innan den avbryts av servern. Ett nollvärde anger en tidsgräns för händelsen. |
retryCountOnTaskFailureAntal återförsök om uppgiften misslyckades |
Anger antalet uppgifter som ska upprepas för den här uppgiften om det uppstår fel i uppgiften. Stöds inte för uppgifter utan agent. |
ApplicationIdProgram-ID för inloggning |
(Krävs för användarnamn/lösenord) Program-ID att använda för inloggning (se ytterligare anteckning nedan). |
RedirectUriOmdirigera URI för den specifika appen |
(Krävs för användarnamn/lösenord) Omdirigera URI för den angivna appen. Behövs när du anger ett app-ID. (Se ytterligare anteckning nedan). |
Kommentar
När du använder autentiseringstypen för användarnamn/lösenord krävs app-ID och omdirigerings-Uri. Det här dokumentet autentisering OAuth innehåller en förklaring till varför du måste skapa en appregistrering för autentisering med Dataverse När du ansluter med användarnamn/lösenordsautentisering fungerar anslutningen som ett program som ansluter för en användares räkning till Dataverse.
Distribuera paket i Power Platform
Distribuerar ett paket till en miljö. Distribuerar ett paket istället för en enskild lösningsfil kan du välja att distribuera flera lösningar, data och kod till en miljö.
YAML kodavsnitt (distribuera)
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
Parametrar (distribuera)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Den tjänstslutpunkt du vill distribuera paketet till (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Den tjänstslutpunkt du vill distribuera paketet till (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. Mer information: se BuildTools.EnvironmentUrl under Power Platform Skapa miljö |
PackageFilePaketfil |
(Obligatoriskt) Sökväg och filnamn för paketfilen (.dll). |
MaxAsyncWaitTimeHögsta väntetid |
Längsta väntetid i minuter för asynkron åtgärd; standardvärdet är 60 min (1 timme), samma som Azure DevOps standard för uppgifter. |
Miljöhanteringsuppgifter
Automatisera vanliga uppgifter för livscykelhantering av miljö (ELM).
Skapa miljö i Power Platform
Skapar en ny miljö. När du skapar en ny miljö skapas också automatiskt BuildTools.EnvironmentUrl.
Viktigt!
När detta är inställt används BuildTools.EnvironmentUrl som standardtjänstanslutning för efterföljande uppgifter i pipelinen. För varje uppgift som beskrivs i den här artikeln används endast slutpunkt från tjänstanslutningen när BuildTools.EnvironmentUrl inte är inställd.
En ny miljö kan endast etableras om din licens eller kapacitet gör det möjligt att skapa ytterligare miljöer. Mer information om hur du visar kapacitet finns i Information om kapacitetssida.
YAML kodavsnitt (Skapa-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
Parametrar (Skapa-env)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Den tjänstslutpunkt där du vill skapa miljön (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Den tjänstslutpunkt där du vill skapa miljön (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
DisplayNameVisningsnamn |
(Obligatoriskts) Visningsnamnet för den miljö som skapas. |
LocationNameDistributionsregion |
(Obligatoriskt) Den region som miljön ska skapas i. |
EnvironmentSkuMiljötyp |
(Obligatoriskt) Instanstypen som ska distribueras. Alternativen är Sandbox, Produktion, Utvärdering och SubscriptionBasedTrial. |
AppsTemplateProgram |
För en miljötyp som inte ingår i utvärderingsversionen är programmen som stöds D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation och D365_Sales. |
CurrencyNameValuta |
(Obligatoriskt) Basvalutan för miljön som skapas. Valutan kan inte uppdateras när miljön har skapats. |
LanguageNameLanguage |
(Obligatoriskt) tillBasspråket i miljön. |
DomainNameDomännamn |
(Obligatoriskt) Detta är en miljöspecifik sträng som utgör en del av URL-adressen. För en miljö med följande URL-adress: https://powerappsbuildtasks.crm.dynamics.com/ skulle domännamnet exempelvis vara "powerappsbuildtasks".
Obs! Om du anger ett domännamn som redan används lägger uppgiften till ett numeriskt värde i domännamnet, med början på 0. I exemplet ovan kan URL:en vara |
Ta bort en miljö i Power Platform
Tar bort en miljö.
YAML kodavsnitt (Ta bort-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@2
displayName: 'Power Platform Delete Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
Parametrar (Ta bort-env)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Den tjänstslutpunkt där du vill ta bort miljön (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Den tjänstslutpunkt där du vill ta bort miljön (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
Power Platform tilldela användare
Tilldela en användare i en målmiljö med angiven säkerhetsroll.
YAML-kodavsnitt (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
Parametrar (AssignUser-env)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Tjänsteslutpunkten för den miljö som du vill tilldela användaren åt (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
UserPower Platform användarnamn |
Microsoft Entra objekt-ID eller användarens huvudnamn som ska tilldelas målmiljön. |
RoleSäkerhetsroll namn eller ID |
Namn eller ID för säkerhetsrollen som används för användaren. |
ApplicationUserPower Platform programmets användarnamn |
Anger om indataanvändaren är en programanvändare (true|false). |
Power Platform återställ miljö
Återställ en miljö.
YAML kodavsnitt (Återställa-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'
Parameters (Återställa-env)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Den tjänstslutpunkt där du vill återställa miljön (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Den tjänstslutpunkt där du vill återställa miljön (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
Säkerhetskopierad Power Platform-miljö
Säkerhetskopierar en miljö.
YAML kodavsnitt (Säkerhetskopia-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)'
Parametrar (Säkerhetskopia-env)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Den slutpunkt du vill säkerhetskopiera miljön (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Den slutpunkt du vill säkerhetskopiera miljön (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
BackupLabelSäkerhetskopieringens etikett |
(Krävs) Etiketten som ska tilldelas säkerhetskopian. |
Kopiera miljö i Power Platform
Kopierar en miljö till en målmiljö. Det finns två typer av kopia: fullständig och minimal. En fullständig kopia innehåller både data och lösningsmetadata (anpassningar), medan en minimal kopia endast innehåller metadata för lösningen, inte själva informationen.
YAML kodavsnitt (Kopiera-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
MaxAsyncWaitTime: 60
Parametrar (Kopiera-env)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Tjänsteslutpunkten för den källmiljö som du vill kopiera från (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Tjänsteslutpunkten för den källmiljö som du vill kopiera från (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
TargetEnvironmentUrlMålmiljö-URL |
(Krävs) URL-adressen för målmiljön du vill kopiera till. |
CopyTypeKopieringstyp |
Typ av kopia som ska utföras: FullCopy eller MinimalCopy |
OverrideFriendlyNameÅsidosätt användarvänligt namn |
Ändra målmiljöns användarvänligt namn till ett annat namn (true|false). |
FriendlyNameAnvändarvänligt namn |
Användarvänligt namn för målmiljön. |
SkipAuditDataSkipAuditData |
Om du vill hoppa över granskningsdata under kopieringsåtgärden. (sant|falsk). |
MaxAsyncWaitTimeHögsta väntetid |
Längsta väntetid i minuter för asynkron åtgärd; standardvärdet är 60 min (1 timme), samma som Azure DevOps standard för uppgifter. |
Power Platform återställ miljön
Återställer en miljö till en angiven säkerhetskopia.
YAML kodavsnitt (Återställa-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'
Parameters (Återställa-env)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformEnvironmentMiljö-URL för Power Platform |
Tjänsteslutpunkten för den källmiljö som du vill återställa från (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Tjänsteslutpunkten för den källmiljö som du vill återställa från (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
RestoreLatestBackupSenaste säkerhetskopia att återställa |
Om du vill återställa den senaste säkerhetskopian eller tillhandahålla RestoreTimeStamp (true|false). |
RestoreTimeStampDatum/tid för säkerhetskopian |
DateTime för säkerhetskopian med formatet mm/dd/åååå hh:mm ELLER strängen "latest". |
TargetEnvironmentUrlMålmiljö-URL |
(Krävs) URL-adressen för målmiljön du vill återställa till. |
FriendlyNameNamn på den återställda miljön |
(Valfritt) Namn på den återställda miljön. |
DisableAdminModeInaktivera adminstratörsläge |
Om administrationsläge ska inaktiveras (true|false). |
Exportera Dataverse-data
Exportera data från en miljö med det medföljande schemat.
YAML-kodavsnitt (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
Parametrar (exportdata-env)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Tjänsteslutpunkten för den källmiljö som du vill exportera data från (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
SchemaFileNamn på XML-schemafil |
Namn på XML-schemafil. Det kan skapas med konfiguration av migreringsverktyget. |
DataFileDatafilens namn |
Filnamn för data att exportera (zip-fil). |
OverwriteSkriv över innehåll |
Power Pages webbplatsinnehåll som ska skrivas över (true|false). |
Importera Dataverse data
Importera data till en miljö.
YAML-kodavsnitt (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'
Parametrar (importdata-env)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Tjänsteslutpunkten för den källmiljö som du vill importera data från (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
DataFileDatafilens namn |
Filnamn för komprimerad zip-datafil som ska importeras, eller mappen med data-schema.xml och data.xml som ska importeras. |
Power Pages hanteringsuppgifter
Uppgifter att arbeta med i en Power Pages-webbplats.
Power Platform ladda ner PAPortal
Ladda ned Power Pages-webbplatsinnehåll från den aktuella Dataverse-miljön.
YAML-kodavsnitt (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
Parametrar (download-paportal)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Tjänsteslutpunkten för den miljö som du vill ladda ner innehåll från (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
WebsiteIdPortalwebbplats-ID |
Power Pages-webbplats-ID att ladda ned. |
OverwriteSkriv över innehåll |
Power Pages webbplatsinnehåll som ska skrivas över (true|false). |
ModelVersionPlatsdatamodell |
Anger om webbplatsdata som ska laddas upp kommer att använda standarddatamodellen (1) eller den förbättrade datamodellen (2). Standardvärdet är 1. |
Power Platform ladda upp PAPortal
Ladda upp Power Pages webbplatsinnehåll till den aktuella Dataverse-miljön.
YAML-kodavsnitt (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'
Parametrar (upload-paportal)
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Tjänsteslutpunkten för den källmiljö som du vill ladda upp data till (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
UploadPathLadda upp innehållsväg |
Sökväg som Power Pages-webbplatsinnehållet ska laddas upp från. |
ModelVersionPlatsdatamodell |
Anger om webbplatsdata som ska laddas upp kommer att använda standarddatamodellen (1) eller den förbättrade datamodellen (2). Standardvärdet är 1. |
Katalog för Power Platform uppgifter (förhandsgranskning)
Dessa uppgifter utför åtgärder mot katalogen i Power Platform och omfattar följande.
Kommentar
För närvarande gäller kataloguppgifter Power Platform i förhandsversion.
Installera katalogobjekt
Installera ett catalog-objekt i målmiljön.
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Tjänsteslutpunkten för den källmiljö som du vill ladda upp data till (t.ex. https://powerappsbuildtools.crm.dynamics.com). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
EnvironmentMålmiljö-URL |
(Obligatoriskt) Miljö-URL till den här uppgiften. |
CatalogItemIdKatalogobjekt-ID som ska installeras |
(Obligatoriskt) Katalogobjekt som ska installeras i målmiljön. |
TargetEnvironmentUrlMålmiljö-URL |
(Obligatoriskt) Url för målmiljön för att installera katalogobjekt i (till exempel "https://YourOrg.crm.dynamics.com"). |
PollStatusKontrollera undersökningens status |
(Valfritt) Enkät för att kontrollera status för förfrågan (true|false). |
Parametrar (kataloginstallation)
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
Skicka godkännande av katalog
Skicka begäran om catalog-godkännande.
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Tjänsteslutpunkten för den källmiljö som du vill ladda upp data till (t.ex. "https://powerappsbuildtools.crm.dynamics.com"). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
EnvironmentMålmiljö-URL |
(Obligatoriskt) Miljö-URL till den här uppgiften. |
CatalogSubmissionFileFil för inlämning av kataloger |
(Krävs) Ange sökväg och filnamn för de filer för inlämning av kataloger som ska analyseras. |
UsePackageSolutionZipFileFiltyp |
Filtyp: paket- eller lösnings-zip-fil. |
SolutionZipFileLösningens zip-filnamn |
Ange sökväg och filnamn för de lösnings-zip-filer. |
PollStatusKontrollera undersökningens status |
(Valfritt) Enkät för att kontrollera status för förfrågan (true|false). |
Parametrar (katalog-skicka)
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
Katalogbegäran status
Få status för katalogens installations-/skicka-begäran.
| Parameters | Beskrivning |
|---|---|
authenticationTypeAutentiseringstyp |
(Krävs för SPN) Ange antingen PowerPlatformEnvironment för en anslutning för användarnamn/lösenord eller PowerPlatformSPN för en anslutning för huvudkonto/klienthemlighet. |
PowerPlatformSPNPower Platform huvudkonto för tjänsten |
Tjänsteslutpunkten för den källmiljö som du vill ladda upp data till (t.ex. "https://powerappsbuildtools.crm.dynamics.com"). Definieras under Tjänstanslutningar i Projektinställningar med hjälp av Power Platform anslutningstypen. |
EnvironmentMålmiljö-URL |
(Obligatoriskt) Miljö-URL till den här uppgiften. |
TrackingIdBegär spårnings-ID |
(Krävs) Begär spårnings-ID. |
RequestTypeTyp av begäran |
(Obligatoriskt) Typ av begäran. (Värden: Installera | Skicka). |
Parametrar (katalog-status)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.catalog-status.PowerPlatforCatalogStatus@2
displayName: 'Power Platform Catalog Status '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
Environment: '$(BuildTools.EnvironmentUrl)'
TrackingId: '00000000-0000-0000-0000-000000000002'
RequestType: Submit
Versions- och utgivningspipelines
Nu när vi har identifierat vad som kan göras med hjälp av framställningsverktygen ska vi ta oss en titt på hur du kan använda verktygen i pipelines för version och utgivning. En konceptöversikt visas nedan. Vi ska nu ta oss en titt på några detaljer som berör implementeringen av pipeline med hjälp av uppgifter i Build Toolset i underavdelningarna nedan.
Om du vill lära dig mer om hur du skapar dessa pipelines och faktiskt utför praktisk redigering av pipelines med hjälp av Microsoft Power Platform Build Tools, slutför Build Tools-labbar, som du kan hämta från GitHub.
Mer information om Azure Pipelines: Använd Azure-pipelines
Versionspipeline: Exportera en lösning från en utvecklingsmiljö (DEV)
I bilden nedan visas uppgifter i framställningsverktyget som du kan lägga till i en pipeline som exporterar en lösning från en utvecklingsmiljö.
Versionspipeline: Bygg en hanterad lösning
I bilden nedan visas uppgifter i framställningsverktyget som du kan lägga till i en pipeline som bygger en hanterad lösning.
Utgivningspipeline: Distribuera till en produktionsmiljö (PROD)
I bilden nedan visas de uppgifter i framställningsverktyget som du kan lägga till i en pipeline som distribuerar en produktionsmiljö.