Udostępnij przez


Zadania dotyczące narzędzi do tworzenia platformy Microsoft Power Platform

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ędzi platformy Power Platform

To zadanie należy dodać jednokrotnie przed innymi zadaniami narzędzi Power Platform Build Tools w potokach kompilacji i wydawania. To zadanie instaluje zestaw narzędzi specyficznych dla Power Platform wymaganych przez agenta do uruchamiania 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 default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    AddToolsToPath: true
# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    DefaultVersion: false
    XrmToolingPackageDeploymentVersion: 3.3.0.928

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.
AddToolsToPath
Dodawanie narzędzi do ścieżki
Dodaje pac CLI do PATH zmiennej środowiskowej. Umożliwia używanie pac cli z zadań skryptowych bez konieczności ręcznego ustawiania ścieżki.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Wersja narzędzia
Określona wersja narzędzia do użycia.

Power Platform WhoAmI

Weryfikuje połączenie usługi środowiska Power Platform, łącząc się i wysyłając żądanie 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformEnvironment
Adres 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.

Kontroler Power Platform

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) Do korzystania z modułu sprawdzającego Power Platform wymagane jest połączenie z licencjonowanym środowiskiem Microsoft 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 narzędzia Power Platform Checker
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ł:
  • Kontroler rozwiązań: jest to ten sam zestaw reguł, który jest uruchamiany z Maker Portal w Power Apps.
  • AppSource: Jest to rozszerzony zestaw reguł używany do certyfikowania aplikacji, aby można je było opublikować 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 Power Apps Checker zostanie zwrócona jako Niepowodzenie lub ZakończonoWithErrors.
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
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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
Adres 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 z archiwum zip rozwiązania, który ma zostać zaimportowany do środowiska docelowego (np. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

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ę.

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
Nieaktualne. Po zaimportowaniu rozwiązania zarządzanego system przekonwertuje komponenty rozwiązania niezarządzanego na zarządzane.
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ą; wartość domyślna to 60 minut (1 godzina), tak samo jak wartość domyślna usługi Azure DevOps dla zadań.
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 Dodaj komponent 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
Adres 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.

Aktualizacja rozwiązania Power Platform Apply

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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
Adres 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ą; wartość domyślna to 60 minut (1 godzina), tak samo jak wartość domyślna usługi Azure DevOps dla zadań.

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

Rozwiązanie eksportowe platformy 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
Adres 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 z archiwum zip rozwiązania, z którego ma zostać eksportowane środowisko źródeł (np. $(Build.ArtifactStagingDirectory)$(SolutionName).zip ).

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ę.

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ą; wartość domyślna to 60 minut (1 godzina), tak samo jak wartość domyślna usługi Azure DevOps dla zadań.
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).

Rozwiązanie do rozpakowywania platformy 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.

Rozwiązanie pakietu 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
Adres 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.

Dostosowania publikowania platformy 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
Adres 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

Wersja rozwiązania zestawu 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
Adres 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ć.

Należy pamiętać, że w potoku Azure DevOps może być twardo zakodowany numer wersji, jednak zaleca się użycie zmiennej potoku , na przykład 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 ustawienie zmienne połączenia

Ustawia PowerPlatformSetConnectionVariables.BuildTools.* zmienne, aby zapewnić dostęp niestandardowym zadaniom skryptowym do używania połączenia z usługą jako jedynego źródła prawdy.

Ustawiane są następujące zmienne:

  • PowerPlatformSetConnectionVariables.BuildTools.TenantId
  • PowerPlatformSetConnectionVariables.BuildTools.ApplicationId
  • PowerPlatformSetConnectionVariables.BuildTools.ClientSecret
  • PowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString

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 Opis
authenticationType
Typ uwierzytelniania
(Wymagane dla SPN) Określ Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN 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. Kiedy łączysz się przy użyciu uwierzytelniania za pomocą nazwy użytkownika/hasła, połączenie zachowuje się jak aplikacja łącząca się w imieniu użytkownika z Dataverse.

Pakiet wdrożeniowy platformy 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
Adres 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ą; wartość domyślna to 60 minut (1 godzina), tak samo jak wartość domyślna usługi Azure DevOps dla zadań.

Zarządzanie zadaniami w środowisku

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

Platforma Power Platform Utwórz środowisko

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.

Obsługę nowego środowiska można zainicjować tylko wtedy, gdy dana licencja lub pojemność zezwala 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
Adres 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
Display name
(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
Język
(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: w przypadku wprowadzenia nazwy domeny, która jest już używana, zadanie dołącza do nazwy domeny 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/.

Platforma Power Platform Usuń środowisko

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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
Adres 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN 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 do przypisania 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 platformy 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
Adres 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.

Środowisko kopii zapasowych platformy 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
Adres 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.

Środowisko kopiowania platformy 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'
    SkipAuditData: true
    MaxAsyncWaitTime: 60

Parametry (Copy-env)

Parametry Opis
authenticationType
Typ uwierzytelniania
(Wymagane dla SPN) Określ Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
Adres 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.
SkipAuditData
SkipAuditData
Określa, czy dane audytu mają być pomijane podczas operacji kopiowania. (true|false).
MaxAsyncWaitTime
Maksymalny czas oczekiwania
Maksymalny czas oczekiwania w minutach na operację asynchroniczną; wartość domyślna to 60 minut (1 godzina), tak samo jak wartość domyślna usługi Azure DevOps dla zadań.

Środowisko przywracania platformy 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment
Adres 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).

Eksportuj dane 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN 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ść
Treść witryny Power Pages do zastąpienia (prawda|fałsz).

Importuj dane 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN 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 zarządzania Power Pages Management

Zadania związane z pracą z witryną Power Pages.

Power Platform Pobierz PAPortal

Pobierz zawartość witryny Power Pages z bieżącego środowiska 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN 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 Power Pages do pobrania.
Overwrite
Zastąp zawartość
Treść witryny Power Pages do zastąpienia (prawda|fałsz).
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”.

Power Platform Prześlij PAPortal

Prześlij zawartość witryny Power Pages do bieżącego ś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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN 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 przesłana zawartość witryny 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 czynności.

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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN 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 Power PlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub Power PlatformSPN 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 w Microsoft Power Platform Build Tools za pomocą narzędzi kompilacji, należy ukończyć Laboratorium narzędzi kompilacji, 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 produkcyjnego.

Wdrażanie w środowisku produkcyjnym (PROD).

Zobacz też

Narzędzia Microsoft Power Platform Build Tools dla Azure DevOps