Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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 |
|---|---|
DefaultVersionUż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. |
AddToolsToPathDodawanie 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. |
PowerAppsAdminVersionXrmToolingPackageDeploymentVersionMicrosoftPowerAppsCheckerVersionCrmSdkCoreToolsVersionWersja 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 |
|---|---|
authenticationTypeTyp 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 |
PowerPlatformEnvironmentAdres 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 |
PowerPlatformSPNNazwa 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 |
|---|---|
PowerPlatformSPNPołą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 PlatformUwaga: 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. |
UseDefaultPACheckerEndpointUż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. |
CustomPACheckerEndpointNiestandardowy 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. |
FileLocationLokalizacja 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. |
FilesToAnalyzeSasUriPliki 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. |
FilesToAnalyzePliki 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. |
FilesToExcludePliki 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 |
RulesToOverrideReguł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"}] |
RuleSetZestaw reguł |
(Wymagane) Określ, który zestaw reguł ma zostać zastosowany. Dostępne są następujące zestawy reguł:
|
ErrorLevelPoziom 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. |
ErrorThresholdPró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. |
FailOnPowerAppsCheckerAnalysisErrorNiepowodzenie 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. |
ArtifactDestinationNameNazwa 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformEnvironmentAdres 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 |
PowerPlatformSPNNazwa 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 |
SolutionInputFileWersja 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ę. |
HoldingSolutionImportowanie 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. |
OverwriteUnmanagedCustomizationsNadpisywanie niezarządzanych dostosowań |
Określa, czy nadpisywać niezarządzane dostosowania (true|false). |
SkipProductUpdateDependenciesPomiń zależności od aktualizacji produktu |
Określ, czy egzekwowanie zależności związanych z aktualizacjami produktu ma być pomijane (true|false). |
ConvertToManagedPrzekształcenie na zarządzane |
Nieaktualne. Po zaimportowaniu rozwiązania zarządzanego system przekonwertuje komponenty rozwiązania niezarządzanego na zarządzane. |
AsyncOperationImport 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). |
MaxAsyncWaitTimeMaksymalny 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ń. |
PublishWorkflowsAktywacja procesów po imporcie |
Określenie, czy procesy (przepływy pracy) w rozwiązaniu mają być aktywowane po imporcie (true|false). |
UseDeploymentSettingsFileUż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). |
DeploymentSettingsFilePlik 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 |
|---|---|
ComponentIdIdentyfikator składnika rozwiązania |
Nazwa schematu lub identyfikator składnika, który ma zostać dodany do rozwiązania docelowego. |
ComponentTypeAdres 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. |
SolutionUniqueNameNazwa rozwiązania |
Unikatowa nazwa rozwiązania. |
AddRequiredComponentsWszystkie 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. |
EnvironmentIdentyfikator 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformEnvironmentAdres 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 |
PowerPlatformSPNNazwa 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 |
SolutionNameNazwa 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. |
AsyncOperationUaktualnienie 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. |
MaxAsyncWaitTimeMaksymalny 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformEnvironmentAdres 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 |
PowerPlatformSPNNazwa 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 |
SolutionNameNazwa rozwiązania |
(Wymagane) Nazwa rozwiązania do wyeksportowania. Zawsze należy używać Nazwy rozwiązania, a nie jej Wyświetlanej nazwy. |
SolutionOutputFileWersja 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ę. |
AsyncOperationEksport 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. |
MaxAsyncWaitTimeMaksymalny 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ń. |
ManagedEksportuj 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. |
ExportAutoNumberingSettingsEksportuj ustawienia autonumeracji |
Eksportuj ustawienia autonumeracji (true|false). |
ExportCalendarSettingsEksport ustawień kalendarza |
Eksport ustawień kalendarza (true|false). |
ExportCustomizationSettingsEksportuj ustawienia dostosowywania |
Eksportuj ustawienia dostosowywania (true|false). |
ExportEmailTrackingSettingsEksportuj ustawienia śledzenia wiadomości e-mail |
Wyeksportuj ustawienia śledzenia wiadomości e-mail (true|false). |
ExportGeneralSettingsEksportuj ustawienia ogólne |
Eksportuj ustawienia ogólne (true|false). |
ExportIsvConfigEksport konfiguracji ISV |
Eksport konfiguracji ISV (true|false). |
ExportMarketingSettingsEksport ustawień marketingowych |
Eksport ustawień marketingowych (true|false). |
ExportOutlookSynchronizationSettingsEksportuj ustawienia synchronizacji programu Outlook |
Eksportuj ustawienia synchronizacji programu Outlook (true|false). |
ExportRelationshipRolesRole relacji eksportowych |
Role relacji eksportowych (true|false). |
ExportSalesSprzedaż 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 |
|---|---|
SolutionInputFileWersja pliku z danymi wejściowymi |
(Wymagane) Podaj ścieżkę i nazwę pliku .zip z rozwiązaniem do rozpakowania. |
SolutionTargetFolderFolder docelowy, do którego rozwiązanie ma zostać rozpakowane |
(Wymagane) Folder ścieżki i lokalizacji docelowej, do którego ma zostać rozpakowane rozwiązanie. |
SolutionTypeTyp 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 |
|---|---|
SolutionOutputFileWersja pliku z danymi wyjściowymi |
(Wymagane) Ścieżka i nazwa pliku z archiwum zip rozwiązania, do którego należy zapakować rozwiązanie. |
SolutionSourceFolderFolder źródłowy rozwiązania do spakowania |
(Wymagane) Ścieżka i folder źródłowy rozwiązania do spakowania. |
SolutionTypeTyp 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformEnvironmentAdres 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 |
PowerPlatformSPNNazwa 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 |
SolutionNameNazwa 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformEnvironmentAdres 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 |
PowerPlatformSPNNazwa 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformEnvironmentAdres 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 |
PowerPlatformSPNNazwa 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 |
SolutionNameNazwa 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. |
SolutionVersionNumberNumer 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.TenantIdPowerPlatformSetConnectionVariables.BuildTools.ApplicationIdPowerPlatformSetConnectionVariables.BuildTools.ClientSecretPowerPlatformSetConnectionVariables.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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformSPNNazwa 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 |
timeoutInMinutesTimeout |
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. |
retryCountOnTaskFailureLiczba 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. |
ApplicationIdIdentyfikator aplikacji do logowania |
(Wymagane do nazw użytkowników/haseł) Identyfikator aplikacji do użycia w celu logowania (zobacz niżej dodatkową notatkę). |
RedirectUriPrzekierowywanie 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformEnvironmentAdres 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 |
PowerPlatformSPNNazwa 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 |
PackageFilePlik pakietu |
(Wymagane) Ścieżka i nazwa pliku zespołu pliku pakietu (.dll). |
MaxAsyncWaitTimeMaksymalny 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformEnvironmentAdres 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. |
PowerPlatformSPNNazwa 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. |
DisplayNameDisplay name |
(Wymagane) Nazwa wyświetlana utworzonego środowiska. |
LocationNameRegion rozmieszczenia |
(Wymagane) Region, w którym powinno zostać utworzone środowisko. |
EnvironmentSkuTyp środowiska |
(Wymagane) Typ wystąpienia, które ma zostać wdrożone. Opcje to Sandbox, Produkcja, Próba i Próba oparta na subskrypcji. |
AppsTemplateAplikacje |
W przypadku typu środowiska nietestowego obsługiwanymi aplikacjami są D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation i D365_Sales. |
CurrencyNameWaluta |
(Wymagane) Waluta podstawowa dla utworzonego środowiska. Waluta nie może być aktualizowana po utworzeniu środowiska. |
LanguageNameJęzyk |
(Wymagane) Język podstawowy w środowisku. |
DomainNameNazwa 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: |
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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformEnvironmentAdres 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. |
PowerPlatformSPNNazwa 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformSPNNazwa 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. |
UserNazwa użytkownika Power Platform |
Identyfikator obiektu Microsoft Entra lub główna nazwa użytkownika do przypisania do środowiska docelowego. |
RoleRola zabezpieczeń lub identyfikator |
Nazwa lub identyfikator roli zabezpieczeń przypisane do użytkownika. |
ApplicationUserNazwa 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformEnvironmentAdres 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. |
PowerPlatformSPNNazwa 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformEnvironmentAdres 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. |
PowerPlatformSPNNazwa 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. |
BackupLabelEtykieta 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformEnvironmentAdres 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. |
PowerPlatformSPNNazwa 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. |
TargetEnvironmentUrlURL środowiska docelowego |
(Wymagane) Adres URL docelowego środowiska, do którego ma zostać skopiowany program. |
CopyTypeTyp kopii |
Typ kopii do wykonania: FullCopy lub MinimalCopy |
OverrideFriendlyNameZastąpić przyjazną nazwę |
Zmień przyjazną nazwę środowiska docelowego na inną (true|false). |
FriendlyNamePrzyjazna nazwa |
Przyjazna nazwa środowiska docelowego. |
SkipAuditDataSkipAuditData |
Określa, czy dane audytu mają być pomijane podczas operacji kopiowania. (true|false). |
MaxAsyncWaitTimeMaksymalny 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformEnvironmentAdres 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. |
PowerPlatformSPNNazwa 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. |
RestoreLatestBackupOstatnia kopia zapasowa do przywrócenia |
Czy ma być przywrócona najnowsza kopia zapasowa, czy podać element RestoreTimeStamp (true|false). |
RestoreTimeStampData/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”. |
TargetEnvironmentUrlURL środowiska docelowego |
(Wymagane) Adres URL docelowego środowiska, do którego ma zostać przywrócony. |
FriendlyNameNazwa przywróconego środowiska |
(Opcjonalna) Nazwa przywróconego środowiska. |
DisableAdminModeWyłą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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformSPNNazwa 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. |
SchemaFileNazwa pliku schematu XML |
Nazwa pliku schematu XML. Można go utworzyć przy użyciu narzędzia migracji konfiguracji. |
DataFileNazwa pliku danych |
Nazwa pliku ZIP z danymi do eksportowania (plik ZIP). |
OverwriteZastą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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformSPNNazwa 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. |
DataFileNazwa 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformSPNNazwa 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. |
WebsiteIdIdentyfikator strony internetowej portalu |
Identyfikator witryny Power Pages do pobrania. |
OverwriteZastąp zawartość |
Treść witryny Power Pages do zastąpienia (prawda|fałsz). |
ModelVersionModel 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformSPNNazwa 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. |
ModelVersionModel 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformSPNNazwa 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. |
EnvironmentURL środowiska docelowego |
(Wymagane) Środowisko url, na które ukierunkowane jest to zadanie. |
CatalogItemIdIdentyfikator produktu katalogowego do zainstalowania |
(Wymagane) Produkt katalogowy do zainstalowania w środowisku docelowym. |
TargetEnvironmentUrlURL środowiska docelowego |
(Wymagane) Adres URL środowiska docelowego dla instalacji produktu w katalogu (na przykład „https://YourOrg.crm.dynamics.com”). |
PollStatusSprawdź 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformSPNNazwa 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. |
EnvironmentURL środowiska docelowego |
(Wymagane) Środowisko url, na które ukierunkowane jest to zadanie. |
CatalogSubmissionFilePlik zgłoszenia katalogu |
(Wymagane) Określ ścieżkę i nazwę pliku przesyłania katalogu. |
UsePackageSolutionZipFileTyp pliku |
Typ pliku: pakiet lub plik zip z rozwiązaniem. |
SolutionZipFileNazwa pliku zip z rozwiązaniem |
Określ ścieżkę i nazwę pliku zip rozwiązania. |
PollStatusSprawdź 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 |
|---|---|
authenticationTypeTyp 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. |
PowerPlatformSPNNazwa 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. |
EnvironmentURL środowiska docelowego |
(Wymagane) Środowisko url, na które ukierunkowane jest to zadanie. |
TrackingIdIdentyfikator śledzenia żądania |
(Wymagane) Identyfikator śledzenia żądania. |
RequestTypeTyp żą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.
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.
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.
Zobacz też
Narzędzia Microsoft Power Platform Build Tools dla Azure DevOps