Dela via

Microsoft Power Platform Build Tools

  • Artikel

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 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
DefaultVersion
Anvä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.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Verktygsversion		 Den specifika versionen av verktyget som ska användas.

Power Platform WhoAmI

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
authenticationType
Autentiseringstyp		 (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ö
PowerPlatformEnvironment
Miljö-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ö
PowerPlatformSPN
Power 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
PowerPlatformSPN
Tjä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.
UseDefaultPACheckerEndpoint
Anvä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.
CustomPACheckerEndpoint
Anpassad 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.
FileLocation
Platsen 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.
FilesToAnalyzeSasUri
SAS-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.
FilesToAnalyze
Lokala 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.
FilesToExclude
Lokala 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
RulesToOverride
Regler 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."}]
RuleSet
Regeluppsättning		 (Krävs) Ange vilken regeluppsättning som ska tillämpas. Följande två regeluppsättningar är tillgängliga:
  • Lösningskontroll: Det här är samma regeluppsättning som körs från Power Apps Maker Portal.
  • AppSource: Den utökade regeluppsättning som används för att certifiera ett program innan det kan publiceras på AppSource.
ErrorLevel
Felnivå		 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.
ErrorThreshold
Feltröskel		 Definierar antalet fel (>=0) på en angiven nivå som tillåts för att kontrollen ska skicka de lösningar som kontrolleras.
FailOnPowerAppsCheckerAnalysisError
Misslyckas vid fel		 Om sant misslyckas om Power Apps kontrollanalysen returneras som Misslyckades eller FinishedWithErrors.
ArtifactDestinationName
DevOps-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
    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

Parametrar (Importera)

Parameters Beskrivning
authenticationType
Autentiseringstyp		 (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.
PowerPlatformEnvironment
Miljö-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ö
PowerPlatformSPN
Power 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ö
SolutionInputFile
Lö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).

Variabler ger dig ett bekvämt sätt att hämta viktiga databitar till olika delar av din pipeline. Se Använda fördefinierade variabler för att via en omfattande lista.
HoldingSolution
Importera 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.
OverwriteUnmanagedCustomizations
Skriv över icke-hanterade anpassningar		 Ange om icke-hanterade anpassningar ska skrivas över (true|false).
SkipProductUpdateDependencies
Hoppa över beroenden för produktuppdatering		 Ange om tvingande beroenden som är relaterade till produktuppdateringar ska hoppa över (true|false).
ConvertToManaged
Konvertera till hanterad		 Ange om du vill importera som hanterad lösning (true|false).
AsyncOperation
Asynkron 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).
MaxAsyncWaitTime
Hö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.
PublishWorkflows
Aktivera processer efter import		 Ange om några processer (arbetsflöden) i lösningen ska aktiveras efter import (true|false).
UseDeploymentSettingsFile
Använd fil för installationsinställningar		 Anslutningsreferenser och miljövariabler kan ställas in med hjälp av en distributionsinställningar fil (true|false).
DeploymentSettingsFile
Distributionsinstä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)

Parametrar Beskrivning
ComponentId
Lösningskomponentens ID		 Schemanamnet eller ID:t för komponenten som ska läggas till mållösningen.
ComponentType
Miljö-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.
SolutionUniqueName
Namn på lösningen		 Unikt namn på lösningen.
AddRequiredComponents
Alla 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.
Environment
Miljö-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
authenticationType
Autentiseringstyp		 (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.
PowerPlatformEnvironment
Miljö-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ö
PowerPlatformSPN
Power 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ö
SolutionName
Lösningsnamn		 (Obligatoriskt) Namnet på den lösning som ska användas vid uppgraderingen. Använd alltid lösningens Namn, inte dess visningsnamn.
AsyncOperation
Asynkron 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.
MaxAsyncWaitTime
Hö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
authenticationType
Autentiseringstyp		 (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.
PowerPlatformEnvironment
Miljö-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ö
PowerPlatformSPN
Power 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ö
SolutionName
Lösningsnamn		 (Krävs) Namnet på lösningen som ska exporteras. Använd alltid lösningens Namn, inte dess visningsnamn.
SolutionOutputFile
Lö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).

Variabler ger dig ett bekvämt sätt att hämta viktiga databitar till olika delar av din pipeline. Se Använda fördefinierade variabler för att via en omfattande lista.
AsyncOperation
Asynkron 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.
MaxAsyncWaitTime
Hö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.
Managed
Exportera som hanterad		 Om alternativet är (sant), exportera lösningen som en hanterad lösning; annars exportera som en icke-hanterad lösning.
ExportAutoNumberingSettings
Exportera inställningar för automatisk numrering		 Exportera inställningar för automatisk numrering (true|false).
ExportCalendarSettings
Exportera kalenderinställningar		 Exportera kalenderinställningar (true|false).
ExportCustomizationSettings
Exportera anpassningsinställningar		 Exportera anpassningsinställningar (true|false).
ExportEmailTrackingSettings
Exportera inställningar av e-postspårning		 Exportera e-postspårningsinställningar (true|false).
ExportGeneralSettings
Exportera allmänna systeminställningar		 Exportera allmänna inställningar (true|false).
ExportIsvConfig
Exportera ISV-konfiguration		 Exportera ISV-konfiguration (true|false).
ExportMarketingSettings
Exportera inställningar för marknadsföring		 Exportera inställningar för marknadsföring (true|false).
ExportOutlookSynchronizationSettings
Exportera synkroniseringsinställningar för Outlook		 Exportera synkroniseringsinställningar för Outlook (true|false).
ExportRelationshipRoles
Exportera relationsroller		 Exportera relationsroller (true|false).
ExportSales
Exportera 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
SolutionInputFile
Lösningens indatafil		 (Krävs) Sökväg och filnamn för de lösnings-zip-filer som ska packas upp.
SolutionTargetFolder
Må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.
SolutionType
Lö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
SolutionOutputFile
Lösningens utdatafil		 (Obligatoriskt) Sökväg och filnamn för den lösnings-zip-fil där lösningen ska packas.
SolutionSourceFolder
Källmapp för lösning till paket		 (Krävs) Sökväg och källmapp för den lösning som ska packas.
SolutionType
Lö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
authenticationType
Autentiseringstyp		 (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.
PowerPlatformEnvironment
Miljö-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ö
PowerPlatformSPN
Power 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ö
SolutionName
Lö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
authenticationType
Autentiseringstyp		 (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.
PowerPlatformEnvironment
Miljö-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ö
PowerPlatformSPN
Power 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
authenticationType
Autentiseringstyp		 (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.
PowerPlatformEnvironment
Miljö-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ö
PowerPlatformSPN
Power 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ö
SolutionName
Lösningsnamn		 (Obligatoriskt) Namnet på den lösning som ska ange version för. Använd alltid lösningens Namn, inte dess visningsnamn.
SolutionVersionNumber
Lö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 BuildTools.* variabler för att ge åtkomst till anpassade skriptuppgifter för att använda tjänstanslutningen som en enskild sanningens källa.

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)

Parametrar Beskrivning
authenticationType
Autentiseringstyp		 (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.
PowerPlatformSPN
Power 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ö
timeoutInMinutes
Timeout		 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.
retryCountOnTaskFailure
Antal å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 handläggare.
ApplicationId
Program-ID för inloggning		 (Krävs för användarnamn/lösenord) Program-ID att använda för inloggning (se ytterligare anteckning nedan).
RedirectUri
Omdirigera 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).

Anteckning

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
authenticationType
Autentiseringstyp		 (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.
PowerPlatformEnvironment
Miljö-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ö
PowerPlatformSPN
Power 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ö
PackageFile
Paketfil		 (Obligatoriskt) Sökväg och filnamn för paketfilen (.dll).
MaxAsyncWaitTime
Hö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 bara etableras om din licens eller kapacitet tillåter att ytterligare miljöer skapas. 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
authenticationType
Autentiseringstyp		 (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.
PowerPlatformEnvironment
Miljö-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.
PowerPlatformSPN
Power 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.
DisplayName
Visningsnamn		 (Obligatoriskts) Visningsnamnet för den miljö som skapas.
LocationName
Distributionsregion		 (Obligatoriskt) Den region som miljön ska skapas i.
EnvironmentSku
Miljötyp		 (Obligatoriskt) Instanstypen som ska distribueras. Alternativen är Sandbox, Produktion, Utvärdering och SubscriptionBasedTrial.
AppsTemplate
Program		 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.
CurrencyName
Valuta		 (Obligatoriskt) Basvalutan för miljön som skapas. Valutan kan inte uppdateras när miljön har skapats.
LanguageName
Language		 (Obligatoriskt) tillBasspråket i miljön.
DomainName
Domä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".

Om du anger ett domännamn som redan används lägger uppgiften till ett numeriskt värde till domännamnet, med början på 0. I exemplet ovan kan URL:en vara https://powerappsbuildtasks0.crm.dynamics.com/.

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
authenticationType
Autentiseringstyp		 (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.
PowerPlatformEnvironment
Miljö-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.
PowerPlatformSPN
Power 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)

Parametrar Beskrivning
authenticationType
Autentiseringstyp		 (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.
PowerPlatformSPN
Power 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.
User
Power Platform användarnamn		 Microsoft Entra objekt-ID eller användarens huvudnamn som ska tilldelas målmiljön.
Role
Säkerhetsroll namn eller ID		 Namn eller ID för säkerhetsrollen som används för användaren.
ApplicationUser
Power 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)

Parametrar Beskrivning
authenticationType
Autentiseringstyp		 (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.
PowerPlatformEnvironment
Miljö-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.
PowerPlatformSPN
Power 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
authenticationType
Autentiseringstyp		 (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.
PowerPlatformEnvironment
Miljö-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.
PowerPlatformSPN
Power 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.
BackupLabel
Sä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'
    DisableAdminMode: false

Parametrar (Kopiera-env)

Parameters Beskrivning
authenticationType
Autentiseringstyp		 (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.
PowerPlatformEnvironment
Miljö-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.
PowerPlatformSPN
Power 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.
TargetEnvironmentUrl
Målmiljö-URL		 (Krävs) URL-adressen för målmiljön du vill kopiera till.
CopyType
Kopieringstyp		 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).
FriendlyName
Användarvänligt namn		 Användarvänligt namn för målmiljön.
DisableAdminMode
Inaktivera adminstratörsläge		 Om administrationsläge ska inaktiveras (true|false).

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)

Parametrar Beskrivning
authenticationType
Autentiseringstyp		 (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.
PowerPlatformEnvironment
Miljö-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.
PowerPlatformSPN
Power 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.
RestoreLatestBackup
Senaste säkerhetskopia att återställa		 Om du vill återställa den senaste säkerhetskopian eller tillhandahålla RestoreTimeStamp (true|false).
RestoreTimeStamp
Datum/tid för säkerhetskopian		 DateTime för säkerhetskopian med formatet mm/dd/åååå hh:mm ELLER strängen "latest".
TargetEnvironmentUrl
Målmiljö-URL		 (Krävs) URL-adressen för målmiljön du vill återställa till.
FriendlyName
Namn på den återställda miljön		 (Valfritt) Namn på den återställda miljön.
DisableAdminMode
Inaktivera 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)

Parametrar Beskrivning
authenticationType
Autentiseringstyp		 (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.
PowerPlatformSPN
Power 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.
SchemaFile
Namn på XML-schemafil		 Namn på XML-schemafil. Det kan skapas med konfiguration av migreringsverktyget.
DataFile
Datafilens namn		 Filnamn för data att exportera (zip-fil).
Overwrite
Skriv ö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)

Parametrar Beskrivning
authenticationType
Autentiseringstyp		 (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.
PowerPlatformSPN
Power 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.
DataFile
Datafilens 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)

Parametrar Beskrivning
authenticationType
Autentiseringstyp		 (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.
PowerPlatformSPN
Power 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.
WebsiteId
Portalwebbplats-ID		 Power Pages-webbplats-ID att ladda ned.
Overwrite
Skriv över innehåll		 Power Pages webbplatsinnehåll som ska skrivas över (true|false).
ModelVersion
Platsdatamodell		 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)

Parametrar Beskrivning
authenticationType
Autentiseringstyp		 (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.
PowerPlatformSPN
Power 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.
UploadPath
Ladda upp innehållsväg		 Sökväg som Power Pages-webbplatsinnehållet ska laddas upp från.
ModelVersion
Platsdatamodell		 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.

Parametrar Beskrivning
authenticationType
Autentiseringstyp		 (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.
PowerPlatformSPN
Power 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.
Environment
Målmiljö-URL		 (Obligatoriskt) Miljö-URL till den här uppgiften.
CatalogItemId
Katalogobjekt-ID som ska installeras		 (Obligatoriskt) Katalogobjekt som ska installeras i målmiljön.
TargetEnvironmentUrl
Målmiljö-URL		 (Obligatoriskt) Url för målmiljön för att installera katalogobjekt i (till exempel "https://YourOrg.crm.dynamics.com").
PollStatus
Kontrollera 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.

Parametrar Beskrivning
authenticationType
Autentiseringstyp		 (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.
PowerPlatformSPN
Power 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.
Environment
Målmiljö-URL		 (Obligatoriskt) Miljö-URL till den här uppgiften.
CatalogSubmissionFile
Fil 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.
UsePackageSolutionZipFile
Filtyp		 Filtyp: paket- eller lösnings-zip-fil.
SolutionZipFile
Lösningens zip-filnamn		 Ange sökväg och filnamn för de lösnings-zip-filer.
PollStatus
Kontrollera 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.

Parametrar Beskrivning
authenticationType
Autentiseringstyp		 (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.
PowerPlatformSPN
Power 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.
Environment
Målmiljö-URL		 (Obligatoriskt) Miljö-URL till den här uppgiften.
TrackingId
Begär spårnings-ID		 (Krävs) Begär spårnings-ID.
RequestType
Typ 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ö.

Exportera en lösning från en utvecklingsmiljö (DEV).

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.

Bygg 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ö.

Distribuera till en produktionsmiljö (PROD).

Se även

Microsoft Power Platform Bygg verktyg för Azure DevOps