Udostępnij za pośrednictwem

Microsoft Power Platform Build Tools — zadania

  • Artykuł

Dostępne zadania kompilacji opisano w poniższych sekcjach. Później prezentujemy kilka przykładów użycia tych zadań w usłudze Azure Pipelines. Aby uzyskać informacje na temat narzędzi do tworzenia i pobierania ich, zobacz temat Tworzenie narzędzi Microsoft Power Platform Build Tools dla potoków Azure Pipelines.

Zadanie pomocy

Dostępne zadania pomocy opisano poniżej.

Instalator narzędzia Power Platform

To zadanie jest wymagane do dodania jednorazowo przed innymi zadaniami instalatora narzędzia Power Platform w ramach kompilacji i potoku wydawniczego. To zadanie powoduje zainstalowanie zestawu Power Platform — specjalnych narzędzi wymaganych przez agenta w celu uruchomienia zadań kompilacji Microsoft Power Platform. To zadanie nie wymaga dodatkowej konfiguracji po dodaniu. To zadanie zawiera parametry poszczególnych wersji każdego instalowanego narzędzia.

Aby zadbać o aktualność narzędzi w czasie, należy się upewnić, że te parametry odpowiadają wersjom narzędzi wymaganym do poprawnego funkcjonowania potoku.

Wstawka YAML (Instalator)

# 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

Parametry (Instalator)

Parametry Opis
DefaultVersion
Używanie domyślnych wersji narzędzi		 Ustaw na true, aby użyć domyślnej wersji wszystkich narzędzi, w przeciwnym razie false. Wymagane (i false), jeśli podano wersje narzędzia.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Wersja narzędzia		 Określona wersja narzędzia do użycia.

Power Platform WhoAmI

Weryfikuje połączenie z usługami środowiska Power Platform dzięki połączeniu i przetworzeniu żądania WhoAmI. To zadanie może być przydatne na wczesnym etapie procesu, aby przed rozpoczęciem przetwarzania sprawdzić łączność.

Wstawka YAML (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'

Parametry (WhoAmI)

Parametry Opis
authenticationType
Typ uwierzytelniania		 (Opcjonalnie) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformEnvironment
URL środowiska Power Platform		 Punkt końcowy usługi środowiska, z którym chcesz się połączyć. Zdefiniowane w obszarze Połączenia usługi w Ustawieniach projektu. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi środowiska, z którym chcesz się połączyć. Zdefiniowane w obszarze Połączenia usługi w Ustawieniach projektu.

Sprawdzanie jakości

W następnej sekcji omawiamy zadania dostępne do sprawdzenia jakości rozwiązania.

Power Platform Checker

W tym zadaniu są uruchamiane statyczne analizy przeprowadzone na rozwiązaniach w oparciu o zestaw reguł postępowania w celu zidentyfikowania wszystkich wzorców, które mogą zostać przypadkowo wprowadzone podczas tworzenia rozwiązania.

Wstawka YAML (Narzędzie sprawdzania)

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

Parametry (Narzędzie do sprawdzania)

Parametry Opis
PowerPlatformSPN
Połączenie z usługą		 (Wymagane) Połączenie z licencjonowanym środowiskiem Microsoft Power Platform jest wymagane do korzystania z modułu sprawdzania Power Platform. Połączenia z usługami są definiowane w obszarze Połączenia usługi w obszarze Ustawienia projektu przy użyciu danego typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl w obszarze Utwórz środowisko Power Platform

Uwaga: metody jednostki usługi i uwierzytelniania przy użyciu nazwy użytkownika/hasła są dostępne dla zadania sprawdzania. Więcej informacji na temat konfigurowania podmiotów usługi, które mają być używane z tym zadaniem, znajduje się w części Konfigurowanie połączeń głównych usługi dla środowisk Power Platform.
UseDefaultPACheckerEndpoint
Użyj domyślnego punktu końcowego sprawdzania Power Platform		 Domyślnie (prawda) lokalizacja geograficzna usługi sprawdzania używa tej samej lokalizacji geograficznej, co środowisko, z którym nawiązujesz połączenie.
CustomPACheckerEndpoint
Niestandardowy punkt końcowy kontrolera PAC		 Wymagane gdy UseDefaultPACheckerEndpoint to false. Można określić inną używaną lokalizację geograficzną, na przykład https://japan.api.advisor.powerapps.com. Aby uzyskać listę dostępnych lokalizacji geograficznych, zobacz Użycie interfejsu API sprawdzania Power Platform.
FileLocation
Lokalizacja plików do analizy		 Wymagane w przypadku odwoływania się do pliku z adresu URL podpisu dostępu udostępnionego sasUriFile (SAS).

Uwaga: Ważne jest, aby odwoływać się do wyeksportowanego pliku rozwiązania, a nie rozpakowanych plików źródłowych w repozytorium. Można analizować oba pliki rozwiązania zarządzanego i niezarządzanego.
FilesToAnalyzeSasUri
Pliki SAS do analizy		 Wymagane gdy FileLocation jest ustawione na sasUriFile. Wprowadź adres URI usługi SAS. Można dodać więcej niż jeden identyfikator URI SAS do przecinka (,) lub średnika (;) Lista oddzielana.
FilesToAnalyze
Pliki lokalne do analizy		 Wymagane, gdy pliki SAS nie są analizowane. Podaj ścieżkę i nazwę pliku zip do przeanalizowania. Można używać symboli wieloznacznych. Wprowadź na przykład wartość **\*.zip, aby wyszukać wszystkie pliki zip we wszystkich podfolderach.
FilesToExclude
Pliki lokalne do wykluczenia		 Określ nazwy plików, które mają być wyłączone z analizy. Jeśli jest ich więcej niż jeden, należy podać je w formie listy oddzielonej przecinkiem (,) lub średnikiem (;). Ta lista może zawierać pełną nazwę pliku lub nazwę z początkowymi lub końcowymi znakami wieloznacznymi, takimi jak *jquery lub form.js
RulesToOverride
Reguły do zastąpienia		 Tablica JSON zawierająca reguły i poziomy do nadpisania. Akceptowane wartości dla OverrideLevel to: Krytyczny, Wysoki, Średni, Niski, Informacyjny. Przykład: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Zestaw reguł		 (Wymagane) Określ, który zestaw reguł ma zostać zastosowany. Dostępne są następujące zestawy reguł:
  • Sprawdzanie rozwiązania: ten zestaw reguł jest taki sam, jak uruchamiany w portalu Power Apps Maker Portal.
  • AppSource: zestaw reguł rozszerzonych, który jest używany do certyfikacji aplikacji przed jej opublikowaniem w AppSource.
ErrorLevel
Poziom błędu		 W połączeniu z parametrem progu błędu definiuje dotkliwość błędów i ostrzeżeń, które są dozwolone. Obsługiwane wartości progowe to <level>IssueCount, gdzie level=Krytyczny, Wysoki, Średni, Niski i Informacyjny.
ErrorThreshold
Próg błędu		 Określa liczbę błędów (>=0) o określonym poziomie, które są dozwolone, aby sprawdzający mógł zaliczyć sprawdzane rozwiązania.
FailOnPowerAppsCheckerAnalysisError
Niepowodzenie z powodu błędu		 Gdy true, zakończy się niepowodzeniem, jeśli analiza narzędzia do sprawdzania Power Apps zostanie zwrócona jako Failed lub FinishedWithErrors.
ArtifactDestinationName
Nazwa artefaktu DevOps		 Określ nazwę Azure Artifacts dla sprawdzenia pliku .sarif.

Zadania rozwiązania

Ten zestaw zadań umożliwia zautomatyzowanie akcji rozwiązania. Zadania środowiska opisane w dalszej części tej sekcji, które tworzą, kopiują lub przywrócą środowisko, zastąpią połączenia usługowe z nowo utworzonymi środowiskami. Zadania te mogą umożliwiać wykonywanie zadań rozwiązania w środowiskach utworzonych na żądanie.

Importowanie rozwiązania Power Platform

Importuje rozwiązanie do środowiska docelowego.

Wstawka YAML (Import)

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

Parametry (Import)

Parametry Opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
URL środowiska Power Platform		 Usługa punku końcowego do której chcesz zaimportować rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Usługa punku końcowego do której chcesz zaimportować rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
SolutionInputFile
Wersja pliku z danymi wejściowymi		 (Wymagane) Ścieżka i nazwa pliku ZIP rozwiązania, który ma być zaimportowany do środowiska docelowego (np. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Uwaga: Zmienne zapewniają wygodny sposób pobierania kluczowych bitów danych do różnych części potoku. Zobacz Korzystanie ze wstępnie zdefiniowanych zmiennych, aby uzyskać pełną listę.
HoldingSolution
Importowanie jako rozwiązanie do przechowywania		 Zaawansowany parametr (true|false) używany podczas uaktualnienia rozwiązania. Parametr ten obejmuje rozwiązanie w Dataverse, ale nie uaktualnia go, dopóki nie zostanie uruchomione zadanie Zastosuj uaktualnienie rozwiązania.
OverwriteUnmanagedCustomizations
Nadpisywanie niezarządzanych dostosowań		 Określa, czy nadpisywać niezarządzane dostosowania (true|false).
SkipProductUpdateDependencies
Pomiń zależności od aktualizacji produktu		 Określ, czy egzekwowanie zależności związanych z aktualizacjami produktu ma być pomijane (true|false).
ConvertToManaged
Przekształcenie na zarządzane		 Określ, czy importować jako rozwiązanie zarządzane (true|false).
AsyncOperation
Import asynchroniczny		 Jeśli wybrano (true), operacja importu zostanie wykonana asynchronicznie. Jest to zalecane w przypadku większych rozwiązań, ponieważ to zadanie będzie automatycznie przekroczyć limit czasu, jeśli w przeciwnym razie 4 min. Wybranie opcji asynchronicznej spowoduje odpytywanie i czekanie aż MaxAsyncWaitTime zostanie osiągnięty (true|false).
MaxAsyncWaitTime
Maksymalny czas oczekiwania		 Maksymalny czas oczekiwania w minutach na operację asynchroniczną; domyślnie 60 min (1 godz.), tak samo jak domyślnie dla zadań Azure DevOps.
PublishWorkflows
Aktywacja procesów po imporcie		 Określenie, czy procesy (przepływy pracy) w rozwiązaniu mają być aktywowane po imporcie (true|false).
UseDeploymentSettingsFile
Użyj pliku ustawień obrazu stanowiska		 Odwołania do połączeń i wartości zmiennych środowiskowych można ustawić za pomocą pliku ustawienia wdrożenia (true|false).
DeploymentSettingsFile
Plik ustawień rozmieszczenia		 (Wymagane, jeśli UseDeploymentSettingsFile=true) Ścieżka i nazwa pliku ustawień wdrożenia.

Power Platform — Dodawanie składnika rozwiązania

Dodaje składnik rozwiązania do rozwiązania niezarządzanego.

Wstawka YAML (Dodaj)

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

Parametry (Dodaj)

Parametry opis
ComponentId
Identyfikator składnika rozwiązania		 Nazwa schematu lub identyfikator składnika, który ma zostać dodany do rozwiązania docelowego.
ComponentType
URL środowiska Power Platform		 Wartość reprezentująca składnik rozwiązania, który dodajesz. Zobacz Korzystanie z predefiniowanych typów składników, aby uzyskać wyczerpującą listę wartości składników.
SolutionUniqueName
Nazwa rozwiązania		 Unikatowa nazwa rozwiązania.
AddRequiredComponents
Wszystkie składniki wymagane w innym rozwiązaniu zależne od składnika rozwiązania		 (Opcjonalnie) Wskazuje, czy inne składniki rozwiązania, których wymaga dodawany składnik rozwiązania, mają również zostać dodane do rozwiązania niezarządzanego.
Environment
Identyfikator lub adres URL środowiska		 (Opcjonalnie) Adres URL lub identyfikator środowiska docelowego.

Uaktualnienie zastosowania rozwiązania Power Platform

Uaktualnia rozwiązanie zaimportowane jako rozwiązanie służące do przechowywania.

Wstawka YAML (uaktualnienie)

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

Parametry (uaktualnienie)

Parametry Opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
URL środowiska Power Platform		 Punkt końcowy usługi, do którego chcesz uaktualnić rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi, do którego chcesz uaktualnić rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
SolutionName
Nazwa rozwiązania		 (Wymagane) Nazwa rozwiązania, które ma zastosowanie do uaktualnienia. Zawsze należy używać Nazwy rozwiązania, a nie jej Wyświetlanej nazwy.
AsyncOperation
Uaktualnienie asynchroniczne		 Jeśli zaznaczone (true), operacja uaktualnienia zostanie wykonana jako asynchroniczne zadanie wsadowe. Wybranie opcji asynchronicznej spowoduje odpytywanie i czekanie aż MaxAsyncWaitTime zostanie osiągnięty.
MaxAsyncWaitTime
Maksymalny czas oczekiwania		 Maksymalny czas oczekiwania w minutach na operację asynchroniczną; domyślnie 60 min (1 godz.), tak samo jak domyślnie dla zadań Azure DevOps.

Uwaga

Zmienne to wygodny sposób uzyskiwania znaczących elementów informacji dot. różnych części potoku. Zobacz Korzystanie ze wstępnie zdefiniowanych zmiennych, aby uzyskać pełną listę. Podczas importowania rozwiązania przy użyciu pliku ustawień wdrożenia można wstępnie wypełnić informacje dotyczące odwołania do połączenia i zmiennych środowiska dla środowiska docelowego.

Więcej informacji: Wstępne wypełnianie odwołań do połączeń i zmiennych środowiska w celu zautomatyzowanego wdrożenia

Eksportowanie rozwiązania Power Platform

Powoduje wyeksportowanie rozwiązania ze środowiska źródłowego.

Wstawka YAML (Eksport)

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

Parametry (eksport)

Parametry Opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
URL środowiska Power Platform		 Punkt końcowy usługi, do którego chcesz uaktualnić rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi, do którego chcesz uaktualnić rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
SolutionName
Nazwa rozwiązania		 (Wymagane) Nazwa rozwiązania do wyeksportowania. Zawsze należy używać Nazwy rozwiązania, a nie jej Wyświetlanej nazwy.
SolutionOutputFile
Wersja pliku z danymi wyjściowymi		 (Wymagane) Ścieżka i nazwa pliku ZIP rozwiązania, który ma być wyeksportowany do środowiska źródłowego (np. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Uwaga: Zmienne zapewniają wygodny sposób pobierania kluczowych bitów danych do różnych części potoku. Zobacz Korzystanie ze wstępnie zdefiniowanych zmiennych, aby uzyskać pełną listę.
AsyncOperation
Eksport asynchroniczny		 Jeśli zaznaczone (true), operacja eksportu zostanie wykonana jako asynchroniczne zadanie wsadowe. Wybranie opcji asynchronicznej spowoduje odpytywanie i czekanie aż MaxAsyncWaitTime zostanie osiągnięty.
MaxAsyncWaitTime
Maksymalny czas oczekiwania		 Maksymalny czas oczekiwania w minutach na operację asynchroniczną; domyślnie 60 min (1 godz.), tak samo jak domyślnie dla zadań Azure DevOps.
Managed
Eksportuj jako zarządzany		 Jeśli wybrano opcję (true), należy eksportować rozwiązanie jako rozwiązanie zarządzane; w przeciwnym razie eksportować jako rozwiązanie niezarządzane.
ExportAutoNumberingSettings
Eksportuj ustawienia autonumeracji		 Eksportuj ustawienia autonumeracji (true|false).
ExportCalendarSettings
Eksport ustawień kalendarza		 Eksport ustawień kalendarza (true|false).
ExportCustomizationSettings
Eksportuj ustawienia dostosowywania		 Eksportuj ustawienia dostosowywania (true|false).
ExportEmailTrackingSettings
Eksportuj ustawienia śledzenia wiadomości e-mail		 Wyeksportuj ustawienia śledzenia wiadomości e-mail (true|false).
ExportGeneralSettings
Eksportuj ustawienia ogólne		 Eksportuj ustawienia ogólne (true|false).
ExportIsvConfig
Eksport konfiguracji ISV		 Eksport konfiguracji ISV (true|false).
ExportMarketingSettings
Eksport ustawień marketingowych		 Eksport ustawień marketingowych (true|false).
ExportOutlookSynchronizationSettings
Eksportuj ustawienia synchronizacji programu Outlook		 Eksportuj ustawienia synchronizacji programu Outlook (true|false).
ExportRelationshipRoles
Role relacji eksportowych		 Role relacji eksportowych (true|false).
ExportSales
Sprzedaż eksportowa		 Sprzedaż eksportowa (true|false).

Rozpakowywanie rozwiązania Power Platform

Rozkłada pliki skompresowane rozwiązań usługi na wiele plików XML i innych, co umożliwia łatwiejsze odczytywanie i zarządzanie tymi plikami w systemie kontroli źródła.

Wstawka YAML (Rozpakowanie)

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

Parametry (Rozpakowanie)

Parametry Opis
SolutionInputFile
Wersja pliku z danymi wejściowymi		 (Wymagane) Podaj ścieżkę i nazwę pliku .zip z rozwiązaniem do rozpakowania.
SolutionTargetFolder
Folder docelowy, do którego rozwiązanie ma zostać rozpakowane		 (Wymagane) Folder ścieżki i lokalizacji docelowej, do którego ma zostać rozpakowane rozwiązanie.
SolutionType
Typ rozwiązania		 (Wymagane) Typ rozwiązania do rozpakowania. Dostępne opcje to: Niezarządzane (zalecane), Zarządzany i Oba.

Pakowanie rozwiązania Power Platform

Pakuje rozwiązanie reprezentowane w kontroli źródła do pliku solution.zip, który można zaimportować do innego środowiska.

Wstawka YAML (Pakowanie)

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

Parametry (Pakowanie)

Parametry Opis
SolutionOutputFile
Wersja pliku z danymi wyjściowymi		 (Wymagane) Ścieżka i nazwa pliku z archiwum zip rozwiązania, do którego należy zapakować rozwiązanie.
SolutionSourceFolder
Folder źródłowy rozwiązania do spakowania		 (Wymagane) Ścieżka i folder źródłowy rozwiązania do spakowania.
SolutionType
Typ rozwiązania		 (Wymagane) Typ rozwiązania do spakowania. Dostępne opcje to: Zarządzane (zalecane), Niezarządzane i Oba.

Rozwiązanie usuwania Power Platform

Usuwa rozwiązanie w środowisku docelowym.

Wstawka YAML (Usuwanie)

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'

Parametry (Usuń)

Parametry Opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
URL środowiska Power Platform		 Punkt końcowy usługi, w którym chcesz usunąć rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi, w którym chcesz usunąć rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
SolutionName
Nazwa rozwiązania		 (Wymagane) Nazwa rozwiązania, które ma zostać usunięte. Zawsze należy używać Nazwy rozwiązania, a nie jej Wyświetlanej nazwy.

Publikowanie dostosowań Power Platform

Powoduje opublikowanie wszystkich dostosowań w środowisku.

Wstawka YAML (Publikowanie)

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

Parametry (Opublikuj)

Parametry Opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
URL środowiska Power Platform		 Punkt końcowy usługi, do którego chcesz opublikować dostosowania (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi, do którego chcesz opublikować dostosowania (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform

Ustawianie wersji rozwiązania Power Platform

Aktualizacja wersji rozwiązania.

Wstawka YAML (wersja)

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

Parametry (Wersja)

Parametry Opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
URL środowiska Power Platform		 Punkt końcowy usługi, w którym chcesz ustawić wersję rozwiązania (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi, w którym chcesz ustawić wersję rozwiązania (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
SolutionName
Nazwa rozwiązania		 (Wymagane) Nazwa rozwiązania, dla którego ma zostać ustawiona wersja. Zawsze należy używać Nazwy rozwiązania, a nie jej Wyświetlanej nazwy.
SolutionVersionNumber
Numer wersji rozwiązania		 (Wymagane) Numer wersji, który chcesz ustawić.

Podczas gdy numer wersji może być zakodowany w rurociągu, zalecane jest użycie zmiennej rurociągu Azure DevOps, takiej jak BuildId. Zawiera opcje służące do definiowania dokładnego kształtu numeru wersji na karcie „Opcje”, na przykład: $(Rok:rrrr)-$(Miesiąc:MM)-$(Dzień:dd)-$(wersja:ww)-3

Tej definicji można następnie użyć w zadaniu Ustawiania wersji rozwiązania, ustawiając właściwość numeru wersji na wartość: $(Build.BuildId) zamiast twardego zakodowania wartości 20200824.0.0.2.

Alternatywnie w powershell inline skrypt zadania $(Get-Date -Format yyyy.MM.dd.HHmm) wyjście ustawione na pustą zmienną o nazwie SolutionVersion jako Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Set Solution Version as $(SolutionVersion).

Power Platform ustawia zmienne połączenia

Ustawia zmienne BuildTools.* w celu zapewnienia dostępu do zadań skryptów niestandardowych w celu użycia połączenia usługi jako jednego źródła rzeczywistości.

Wstawka YAML (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

Parametry (SetConnectionVariables)

Parametry Description
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Usługa punktu końcowego, dla której chcesz ustawić zmienne połączenia. Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
timeoutInMinutes
Timeout		 Określa w minutach maksymalny czas, przez który zadanie może być wykonywane przed anulowaniem przez serwer. Wartość zera wskazuje na niekończący się limit czasu.
retryCountOnTaskFailure
Liczba zadań, które zakończyły się niepowodzeniem		 Określa liczbę operacji zadań, które będą się działy w przypadku niepowodzenia zadania. Nie jest obsługiwany w przypadku zadań wykonywanych bez agenta.
ApplicationId
Identyfikator aplikacji do logowania		 (Wymagane do nazw użytkowników/haseł) Identyfikator aplikacji do użycia w celu logowania (zobacz niżej dodatkową notatkę).
RedirectUri
Przekierowywanie URI określonej aplikacji		 (Wymagane do nazw użytkowników/haseł) Przekierowywanie URI określonej aplikacji. Potrzebne podczas określania identyfikatora aplikacji. (Zobacz niżej dodatkową notatkę).

Uwaga

W przypadku uwierzytelniania typu nazwa użytkownika/hasło wymagany będzie identyfikator aplikacji i przekierowywanie URI. Ten dokument uwierzytelnienia OAuth zawiera wyjaśnienie, dlaczego w celu uwierzytelnienia należy utworzyć rejestrację aplikacji Dataverse. W przypadku łączenia się przy użyciu uwierzytelniania nazwa użytkownika/hasło połączenie działa jako aplikacja łącząca się w imieniu użytkownika Dataverse.

Wdrażanie pakietu Power Platform

Powoduje wdrożenie pakietu w środowisku. Wdrożenie całego pakietu, w przeciwieństwie do korzystania z tylko jednego pliku rozwiązania, daje możliwość wdrożenia wielu rozwiązań, danych i kodu w środowisku.

Wstawka YAML (Wdrażanie)

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

Parametry (Wdrażanie)

Parametry Opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
URL środowiska Power Platform		 Punkt końcowy usługi, do którego chcesz wdrożyć pakiet (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi, do którego chcesz wdrożyć pakiet (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PackageFile
Plik pakietu		 (Wymagane) Ścieżka i nazwa pliku zespołu pliku pakietu (.dll).
MaxAsyncWaitTime
Maksymalny czas oczekiwania		 Maksymalny czas oczekiwania w minutach na operację asynchroniczną; domyślnie 60 min (1 godz.), tak samo jak domyślnie dla zadań Azure DevOps.

Zarządzanie zadaniami w środowisku

Automatyzuj typowe zadania zarządzania cyklem życia środowiska (ELM).

Tworzenie środowiska Power Platform

Tworzy nowe środowisko. Utworzenie nowego środowiska powoduje również automatyczne utworzenie BuildTools.EnvironmentUrl.

Ważne

Gdy ustawione, BuildTools.EnvironmentUrl będzie używane jako domyślne połączenie serwisowe dla kolejnych zadań w potoku. Każde zadanie opisane w tym artykule wykorzystuje punkt końcowy z połączenia serwisowego tylko wtedy, gdy BuildTools.EnvironmentUrl nie jest ustawione.

Nowe środowisko można aprowizować tylko wtedy, gdy licencja lub pojemność pozwala na tworzenie dodatkowych środowisk. Więcej informacji na temat wyświetlania pojemności można znaleźć w temacie Szczegóły strony wydajności.

Wstawka YAML (Create-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

Parametry (Create-env)

Parametry Opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
URL środowiska Power Platform		 Punkt końcowy usługi, w którym chcesz utworzyć środowisko (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi, w którym chcesz utworzyć środowisko (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
DisplayName
Nazwa wyświetlana		 (Wymagane) Nazwa wyświetlana utworzonego środowiska.
LocationName
Region rozmieszczenia		 (Wymagane) Region, w którym powinno zostać utworzone środowisko.
EnvironmentSku
Typ środowiska		 (Wymagane) Typ wystąpienia, które ma zostać wdrożone. Opcje to Sandbox, Produkcja, Próba i Próba oparta na subskrypcji.
AppsTemplate
Aplikacje		 W przypadku typu środowiska nietestowego obsługiwanymi aplikacjami są D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation i D365_Sales.
CurrencyName
Waluta		 (Wymagane) Waluta podstawowa dla utworzonego środowiska. Waluta nie może być aktualizowana po utworzeniu środowiska.
LanguageName
Language		 (Wymagane) Język podstawowy w środowisku.
DomainName
Nazwa domeny		 (Wymagane) Jest to ciąg specyficzny dla środowiska, który stanowi część adresu URL. Na przykład dla środowiska o następującym adresie URL: https://powerappsbuildtasks.crm.dynamics.com/, nazwa domeny to „powerappsbuildtasks”.

Uwaga: Jeśli wprowadzisz nazwę domeny, która jest już używana, zadanie dołączy do niej wartość liczbową rozpoczynającą się od 0. W przypadku powyższego przykładu adres URL może wyglądać tak: https://powerappsbuildtasks0.crm.dynamics.com/.

Usuwanie środowiska Power Platform

Usuwa środowisko.

Wstawka YAML (Delete-env)

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

Parametry (Delete-env)

Parametry Opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
URL środowiska Power Platform		 Punkt końcowy usługi, w którym chcesz usunąć środowisko (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi, w którym chcesz usunąć środowisko (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.

Przypisz użytkowników Power Platform

Przypisz użytkownika do docelowego środowiska, używając określonej roli zabezpieczeń.

Wstawka YAML (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

Parametry (AssignUser-env)

Parametry opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi dla środowiska, do którego chcesz przypisać użytkownika (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
User
Nazwa użytkownika Power Platform		 Identyfikator obiektu Microsoft Entra lub główna nazwa użytkownika, która ma zostać przypisana do środowiska docelowego.
Role
Rola zabezpieczeń lub identyfikator		 Nazwa lub identyfikator roli zabezpieczeń przypisane do użytkownika.
ApplicationUser
Nazwa użytkownika aplikacji Power Platform		 Określa, czy użytkownik wejściowy jest użytkownikiem aplikacji (true|false).

Środowisko resetowania Power Platform

Resetuj środowisko.

Wstawka YAML (Reset-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.reset-environment.PowerPlatformResetEnvironment@2
  displayName: 'Power Platform Reset Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    CurrencyName: ALL
    Purpose: 'Reset to PointInTime'
    AppsTemplate: 'D365_CustomerService,D365_FieldService'

Parametry (Reset-env)

Parametry opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
URL środowiska Power Platform		 Punkt końcowy usługi, w którym chcesz zresetować środowisko (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi, w którym chcesz zresetować środowisko (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.

Tworzenie kopii zapasowej środowiska Power Platform

Tworzy kopię zapasową środowiska.

Wstawka YAML (Backup-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.backup-environment.PowerPlatformBackupEnvironment@2
  displayName: 'Power Platform Backup Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    BackupLabel: 'Full backup - $(Build.BuildNumber)'

Parametry (Backup-env)

Parametry Opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
URL środowiska Power Platform		 Punkt końcowy usługi, w którym chcesz utworzyć kopię zapasową środowiska (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi, w którym chcesz utworzyć kopię zapasową środowiska (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
BackupLabel
Etykieta kopii zapasowej		 (Wymagane) Etykieta, która ma być przypisana do kopii zapasowej.

Kopiowanie środowiska Power Platform

Kopiuje środowisko do środowiska docelowego. Dostępne są dwa typy kopii: pełne i minimalne. Kopia pełna zawiera dane i metadane rozwiązania (dostosowania), a kopia minimalna zawiera tylko metadane rozwiązania, a nie faktyczne dane.

Wstawka YAML (Copy-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

Parametry (Copy-env)

Parametry Opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
URL środowiska Power Platform		 Punkt końcowy usługi dla środowiska źródłowego, z którego chcesz kopiować (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi dla środowiska źródłowego, z którego chcesz kopiować (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
TargetEnvironmentUrl
URL środowiska docelowego		 (Wymagane) Adres URL docelowego środowiska, do którego ma zostać skopiowany program.
CopyType
Typ kopii		 Typ kopii do wykonania: FullCopy lub MinimalCopy
OverrideFriendlyName
Zastąpić przyjazną nazwę		 Zmień przyjazną nazwę środowiska docelowego na inną (true|false).
FriendlyName
Przyjazna nazwa		 Przyjazna nazwa środowiska docelowego.
DisableAdminMode
Wyłącz tryb administratora		 Czy wyłączyć tryb administracyjny (true|false).

Przywracanie środowiska Power Platform

Przywraca środowisko z danej kopii zapasowej.

Wstawka YAML (Restore-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.restore-environment.PowerPlatformRestoreEnvironment@2
  displayName: 'Power Platform Restore Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    RestoreLatestBackup: false
    RestoreTimeStamp: '12/01/2022 09:00'
    FriendlyName: 'Contoso Test'

Parametry (Restore-env)

Parametry opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
URL środowiska Power Platform		 Punkt końcowy usługi dla środowiska źródłowego, z którego chcesz przywracać (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi dla środowiska źródłowego, z którego chcesz przywracać (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
RestoreLatestBackup
Ostatnia kopia zapasowa do przywrócenia		 Czy ma być przywrócona najnowsza kopia zapasowa, czy podać element RestoreTimeStamp (true|false).
RestoreTimeStamp
Data/godzina dla kopii zapasowej		 Wartość określająca datę i godzinę wykonania kopii zapasowej w formacie „rrrr-mm-dd gg:mm” LUB ciąg „najnowsza”.
TargetEnvironmentUrl
URL środowiska docelowego		 (Wymagane) Adres URL docelowego środowiska, do którego ma zostać przywrócony.
FriendlyName
Nazwa przywróconego środowiska		 (Opcjonalna) Nazwa przywróconego środowiska.
DisableAdminMode
Wyłącz tryb administratora		 Czy wyłączyć tryb administracyjny (true|false).

Eksportowanie danych usługi Dataverse

Wyeksportuj dane ze środowiska przy użyciu dostępnego schematu.

Wstawka YAML (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

Parametry (exportdata-env)

Parametry opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi dla środowiska, z którego chcesz eksportować dane (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
SchemaFile
Nazwa pliku schematu XML		 Nazwa pliku schematu XML. Można go utworzyć przy użyciu narzędzia migracji konfiguracji.
DataFile
Nazwa pliku danych		 Nazwa pliku ZIP z danymi do eksportowania (plik ZIP).
Overwrite
Zastąp zawartość		 Zawartość witryny internetowej Power Pages portalu do zastąpienia (true|false).

Importowanie danych Dataverse

Importowanie danych do środowiska.

Wstawka YAML (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'

Parametry (importdata-env)

Parametry opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi dla środowiska, do którego chcesz importować dane (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
DataFile
Nazwa pliku danych		 Nazwa pliku skompresowanego (zip), plik danych do zaimportowania lub folder z plikami data-schema.xml i data.xml do zaimportowania.

Zadania związane z zarządzaniem Power Pages

Zadania do pracy z witryną internetową usługi Power Pages.

Pobierz portal Power Platform

Pobieranie zawartości witryny internetowej usługi Power Pages z poziomu bieżącego środowiska usługi Dataverse.

Wstawka YAML (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

Parametry (download-paportal)

Parametry opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi dla środowiska , z którego chcesz pobierać zawartość (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
WebsiteId
Identyfikator strony internetowej portalu		 Identyfikator witryny internetowej usługi Power Pages do pobrania.
Overwrite
Zastąp zawartość		 Zawartość witryny internetowej Power Pages portalu do zastąpienia (true|false).
ModelVersion
Model danych witryny		 Wskazuje, czy dane witryny do przekazania będą używać standardowego (1) czy ulepszonego modelu danych (2). Wartość domyślna to „1”.

Przekaż portal Power Platform

Przekaż zawartość strony portalu Power Pages do aktualnego środowiska Dataverse.

Wstawka YAML (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'

Parametry (upload-paportal)

Parametry opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi dla środowiska, do którego chcesz przekazać zawartość (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
UploadPath
Ścieżka zawartości do przekazania		 Ścieżka, z której zostanie przekazana zawartość witryny internetowej usługi Power Pages.
ModelVersion
Model danych witryny		 Wskazuje, czy dane witryny do przekazania będą używać standardowego (1) czy ulepszonego modelu danych (2). Wartość domyślna to „1”.

Katalog zadań Power Platform (wersja zapoznawcza)

Zadania te wykonują akcje względem katalogu w Power Platform i obejmują następujące elementy.

Uwaga

Obecnie zadania katalogowe dla Power Platform są w wersji zapoznawczej.

Zainstaluj produkt katalogowy

Zainstaluj element usługi Catalog w środowisku docelowym.

Parametry opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi dla środowiska, do którego chcesz przekazać zawartość (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
Environment
URL środowiska docelowego		 (Wymagane) Środowisko url, na które ukierunkowane jest to zadanie.
CatalogItemId
Identyfikator produktu katalogowego do zainstalowania		 (Wymagane) Produkt katalogowy do zainstalowania w środowisku docelowym.
TargetEnvironmentUrl
URL środowiska docelowego		 (Wymagane) Adres URL środowiska docelowego dla instalacji produktu w katalogu (na przykład „https://YourOrg.crm.dynamics.com”).
PollStatus
Sprawdź stan ankiety		 (Opcjonalnie) Odpytywanie w celu sprawdzenia statusu żądania (true|false).

Parametry (catalog-install)

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

Prześlij zatwierdzenie katalogu

Prześlij żądanie zatwierdzenia usługi Catalog.

Parametry opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi dla środowiska, do którego chcesz przekazać zawartość (np. „https://powerappsbuildtools.crm.dynamics.com”). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
Environment
URL środowiska docelowego		 (Wymagane) Środowisko url, na które ukierunkowane jest to zadanie.
CatalogSubmissionFile
Plik zgłoszenia katalogu		 (Wymagane) Określ ścieżkę i nazwę pliku przesyłania katalogu.
UsePackageSolutionZipFile
Typ pliku		 Typ pliku: pakiet lub plik zip z rozwiązaniem.
SolutionZipFile
Nazwa pliku zip z rozwiązaniem		 Określ ścieżkę i nazwę pliku zip rozwiązania.
PollStatus
Sprawdź stan ankiety		 (Opcjonalnie) Odpytywanie w celu sprawdzenia statusu żądania (true|false).

Parametry (catalog-submit)

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

Status żądania katalogowego

Uzyskanie statusu żądania instalacji/przesłania katalogu.

Parametry opis
authenticationType
Typ uwierzytelniania		 (Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN
Nazwa główna usługi Power Platform		 Punkt końcowy usługi dla środowiska, do którego chcesz przekazać zawartość (np. „https://powerappsbuildtools.crm.dynamics.com”). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
Environment
URL środowiska docelowego		 (Wymagane) Środowisko url, na które ukierunkowane jest to zadanie.
TrackingId
Identyfikator śledzenia żądania		 (Wymagane) Identyfikator śledzenia żądania.
RequestType
Typ żądania		 (Wymagane) Typ żądania. (Wartości: Zainstaluj | Prześlij).

Parametry (catalog-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

Tworzenie i wydawanie potoków

Po zidentyfikowaniu czynności, które można wykonać przy użyciu narzędzi kompilacji, zobaczmy teraz, jak użyć tych narzędzi w ramach kompilacji i potoku wydawniczego. Informacje ogólne przedstawiono w poniższej sekcji. Zobaczmy więcej informacji o implementacji potoku przy użyciu narzędzi kompilacji w podsekcjach znajdujących się poniżej.

Aby dowiedzieć się więcej o tym, jak tworzyć te potoki i rzeczywiście tworzyć je za pomocą narzędzi kompilacji Microsoft Power Platform Build Tools, należy ukończyć Laboratorium narzędzi kompilacji build tools, które można pobrać z witryny GitHub.

Więcej informacji o potokach Azure Pipeline: Korzystanie z potoków Azure Pipelines

Potok kompilacji: eksportowanie rozwiązania z środowiska projektowego (DEV)

Na poniższym rysunku przedstawiono zadania narzędzi kompilacyjnych, które można dodać do potoku, który eksportuje rozwiązanie ze środowiska projektowego.

Eksportowanie rozwiązania z środowiska projektowego (DEV).

Planowany potok: tworzenie rozwiązań zarządzanych

Na poniższym rysunku przedstawiono zadania narzędzi kompilacyjnych, które można dodać do potoku tworzącego rozwiązanie zarządzane.

Kompilowanie rozwiązania zarządzanego.

Potok wstępny: wdrażanie w środowisku produkcyjnym (PROD)

Na poniższym rysunku przedstawiono zadania narzędzi kompilacyjnych, które jest wdrażane do środowiska produkcynego.

Wdrażanie w środowisku produkcyjnym (PROD).

Zobacz też

Microsoft Power Platform Narzędzia do budowania dla Azure DevOps