To zadanie jest wymagane do dodania jednorazowo przed innymi zadaniami instalatora narzędzia Power Platform w ramach kompilacji i potoku wydawniczego. To zadanie powoduje zainstalowanie zestawu Power Platform — specjalnych narzędzi wymaganych przez agenta w celu uruchomienia zadań kompilacji Microsoft Power Platform. To zadanie nie wymaga dodatkowej konfiguracji po dodaniu. To zadanie zawiera parametry poszczególnych wersji każdego instalowanego narzędzia.
Aby zadbać o aktualność narzędzi w czasie, należy się upewnić, że te parametry odpowiadają wersjom narzędzi wymaganym do poprawnego funkcjonowania potoku.
# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
displayName: 'Power Platform Tool Installer'
inputs:
DefaultVersion: false
XrmToolingPackageDeploymentVersion: 3.3.0.928
Parametry (Instalator)
Parametry
Opis
DefaultVersion Używanie domyślnych wersji narzędzi
Ustaw na true, aby użyć domyślnej wersji wszystkich narzędzi, w przeciwnym razie false. Wymagane (i false), jeśli podano wersje narzędzia.
PowerAppsAdminVersion XrmToolingPackageDeploymentVersion MicrosoftPowerAppsCheckerVersion CrmSdkCoreToolsVersion Wersja narzędzia
Określona wersja narzędzia do użycia.
Power Platform WhoAmI
Weryfikuje połączenie z usługami środowiska Power Platform dzięki połączeniu i przetworzeniu żądania WhoAmI. To zadanie może być przydatne na wczesnym etapie procesu, aby przed rozpoczęciem przetwarzania sprawdzić łączność.
Wstawka YAML (WhoAmI)
# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@2
displayName: 'Power Platform WhoAmI'
inputs:
# Service Principal/client secret (supports MFA)
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'My service connection'
# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@2
displayName: 'Power Platform WhoAmI'
inputs:
# Username/password (no MFA support)
PowerPlatformEnvironment: 'My service connection'
Parametry (WhoAmI)
Parametry
Opis
authenticationType Typ uwierzytelniania
(Opcjonalnie) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformEnvironment URL środowiska Power Platform
Punkt końcowy usługi środowiska, z którym chcesz się połączyć. Zdefiniowane w obszarze Połączenia usługi w Ustawieniach projektu. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi środowiska, z którym chcesz się połączyć. Zdefiniowane w obszarze Połączenia usługi w Ustawieniach projektu.
Sprawdzanie jakości
W następnej sekcji omawiamy zadania dostępne do sprawdzenia jakości rozwiązania.
Power Platform Checker
W tym zadaniu są uruchamiane statyczne analizy przeprowadzone na rozwiązaniach w oparciu o zestaw reguł postępowania w celu zidentyfikowania wszystkich wzorców, które mogą zostać przypadkowo wprowadzone podczas tworzenia rozwiązania.
Wstawka YAML (Narzędzie sprawdzania)
# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@2
displayName: 'Power Platform Checker '
inputs:
PowerPlatformSPN: 'Dataverse service connection'
RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'
(Wymagane) Połączenie z licencjonowanym środowiskiem Microsoft Power Platform jest wymagane do korzystania z modułu sprawdzania Power Platform. Połączenia z usługami są definiowane w obszarze Połączenia usługi w obszarze Ustawienia projektu przy użyciu danego typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl w obszarze Utwórz środowisko Power Platform
Uwaga: metody jednostki usługi i uwierzytelniania przy użyciu nazwy użytkownika/hasła są dostępne dla zadania sprawdzania. Więcej informacji na temat konfigurowania podmiotów usługi, które mają być używane z tym zadaniem, znajduje się w części Konfigurowanie połączeń głównych usługi dla środowisk Power Platform.
UseDefaultPACheckerEndpoint Użyj domyślnego punktu końcowego sprawdzania Power Platform
Domyślnie (prawda) lokalizacja geograficzna usługi sprawdzania używa tej samej lokalizacji geograficznej, co środowisko, z którym nawiązujesz połączenie.
CustomPACheckerEndpoint Niestandardowy punkt końcowy kontrolera PAC
Wymagane gdy UseDefaultPACheckerEndpoint to false. Można określić inną używaną lokalizację geograficzną, na przykład https://japan.api.advisor.powerapps.com. Aby uzyskać listę dostępnych lokalizacji geograficznych, zobacz Użycie interfejsu API sprawdzania Power Platform.
FileLocation Lokalizacja plików do analizy
Wymagane w przypadku odwoływania się do pliku z adresu URL podpisu dostępu udostępnionego sasUriFile (SAS).
Uwaga: Ważne jest, aby odwoływać się do wyeksportowanego pliku rozwiązania, a nie rozpakowanych plików źródłowych w repozytorium. Można analizować oba pliki rozwiązania zarządzanego i niezarządzanego.
FilesToAnalyzeSasUri Pliki SAS do analizy
Wymagane gdy FileLocation jest ustawione na sasUriFile. Wprowadź adres URI usługi SAS. Można dodać więcej niż jeden identyfikator URI SAS do przecinka (,) lub średnika (;) Lista oddzielana.
FilesToAnalyze Pliki lokalne do analizy
Wymagane, gdy pliki SAS nie są analizowane. Podaj ścieżkę i nazwę pliku zip do przeanalizowania. Można używać symboli wieloznacznych. Wprowadź na przykład wartość **\*.zip, aby wyszukać wszystkie pliki zip we wszystkich podfolderach.
FilesToExclude Pliki lokalne do wykluczenia
Określ nazwy plików, które mają być wyłączone z analizy. Jeśli jest ich więcej niż jeden, należy podać je w formie listy oddzielonej przecinkiem (,) lub średnikiem (;). Ta lista może zawierać pełną nazwę pliku lub nazwę z początkowymi lub końcowymi znakami wieloznacznymi, takimi jak *jquery lub form.js
RulesToOverride Reguły do zastąpienia
Tablica JSON zawierająca reguły i poziomy do nadpisania. Akceptowane wartości dla OverrideLevel to: Krytyczny, Wysoki, Średni, Niski, Informacyjny. Przykład: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet Zestaw reguł
(Wymagane) Określ, który zestaw reguł ma zostać zastosowany. Dostępne są następujące zestawy reguł:
Sprawdzanie rozwiązania: ten zestaw reguł jest taki sam, jak uruchamiany w portalu Power Apps Maker Portal.
AppSource: zestaw reguł rozszerzonych, który jest używany do certyfikacji aplikacji przed jej opublikowaniem w AppSource.
ErrorLevel Poziom błędu
W połączeniu z parametrem progu błędu definiuje dotkliwość błędów i ostrzeżeń, które są dozwolone. Obsługiwane wartości progowe to <level>IssueCount, gdzie level=Krytyczny, Wysoki, Średni, Niski i Informacyjny.
ErrorThreshold Próg błędu
Określa liczbę błędów (>=0) o określonym poziomie, które są dozwolone, aby sprawdzający mógł zaliczyć sprawdzane rozwiązania.
FailOnPowerAppsCheckerAnalysisError Niepowodzenie z powodu błędu
Gdy true, zakończy się niepowodzeniem, jeśli analiza narzędzia do sprawdzania Power Apps zostanie zwrócona jako Failed lub FinishedWithErrors.
ArtifactDestinationName Nazwa artefaktu DevOps
Określ nazwę Azure Artifacts dla sprawdzenia pliku .sarif.
Zadania rozwiązania
Ten zestaw zadań umożliwia zautomatyzowanie akcji rozwiązania. Zadania środowiska opisane w dalszej części tej sekcji, które tworzą, kopiują lub przywrócą środowisko, zastąpią połączenia usługowe z nowo utworzonymi środowiskami. Zadania te mogą umożliwiać wykonywanie zadań rozwiązania w środowiskach utworzonych na żądanie.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment URL środowiska Power Platform
Usługa punku końcowego do której chcesz zaimportować rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN Nazwa główna usługi Power Platform
Usługa punku końcowego do której chcesz zaimportować rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
SolutionInputFile Wersja pliku z danymi wejściowymi
(Wymagane) Ścieżka i nazwa pliku ZIP rozwiązania, który ma być zaimportowany do środowiska docelowego (np. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).
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.
Określa, czy nadpisywać niezarządzane dostosowania (true|false).
SkipProductUpdateDependencies Pomiń zależności od aktualizacji produktu
Określ, czy egzekwowanie zależności związanych z aktualizacjami produktu ma być pomijane (true|false).
ConvertToManaged Przekształcenie na zarządzane
Określ, czy importować jako rozwiązanie zarządzane (true|false).
AsyncOperation Import asynchroniczny
Jeśli wybrano (true), operacja importu zostanie wykonana asynchronicznie. Jest to zalecane w przypadku większych rozwiązań, ponieważ to zadanie będzie automatycznie przekroczyć limit czasu, jeśli w przeciwnym razie 4 min. Wybranie opcji asynchronicznej spowoduje odpytywanie i czekanie aż MaxAsyncWaitTime zostanie osiągnięty (true|false).
MaxAsyncWaitTime Maksymalny czas oczekiwania
Maksymalny czas oczekiwania w minutach na operację asynchroniczną; domyślnie 60 min (1 godz.), tak samo jak domyślnie dla zadań Azure DevOps.
PublishWorkflows Aktywacja procesów po imporcie
Określenie, czy procesy (przepływy pracy) w rozwiązaniu mają być aktywowane po imporcie (true|false).
UseDeploymentSettingsFile Użyj pliku ustawień obrazu stanowiska
Odwołania do połączeń i wartości zmiennych środowiskowych można ustawić za pomocą pliku ustawienia wdrożenia (true|false).
AddRequiredComponents Wszystkie składniki wymagane w innym rozwiązaniu zależne od składnika rozwiązania
(Opcjonalnie) Wskazuje, czy inne składniki rozwiązania, których wymaga dodawany składnik rozwiązania, mają również zostać dodane do rozwiązania niezarządzanego.
Environment Identyfikator lub adres URL środowiska
(Opcjonalnie) Adres URL lub identyfikator środowiska docelowego.
Uaktualnienie zastosowania rozwiązania Power Platform
Uaktualnia rozwiązanie zaimportowane jako rozwiązanie służące do przechowywania.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment URL środowiska Power Platform
Punkt końcowy usługi, do którego chcesz uaktualnić rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi, do którego chcesz uaktualnić rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
SolutionName Nazwa rozwiązania
(Wymagane) Nazwa rozwiązania, które ma zastosowanie do uaktualnienia. Zawsze należy używać Nazwy rozwiązania, a nie jej Wyświetlanej nazwy.
AsyncOperation Uaktualnienie asynchroniczne
Jeśli zaznaczone (true), operacja uaktualnienia zostanie wykonana jako asynchroniczne zadanie wsadowe. Wybranie opcji asynchronicznej spowoduje odpytywanie i czekanie aż MaxAsyncWaitTime zostanie osiągnięty.
MaxAsyncWaitTime Maksymalny czas oczekiwania
Maksymalny czas oczekiwania w minutach na operację asynchroniczną; domyślnie 60 min (1 godz.), tak samo jak domyślnie dla zadań Azure DevOps.
Uwaga
Zmienne to wygodny sposób uzyskiwania znaczących elementów informacji dot. różnych części potoku. Zobacz Korzystanie ze wstępnie zdefiniowanych zmiennych, aby uzyskać pełną listę.
Podczas importowania rozwiązania przy użyciu pliku ustawień wdrożenia można wstępnie wypełnić informacje dotyczące odwołania do połączenia i zmiennych środowiska dla środowiska docelowego.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment URL środowiska Power Platform
Punkt końcowy usługi, do którego chcesz uaktualnić rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi, do którego chcesz uaktualnić rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
SolutionName Nazwa rozwiązania
(Wymagane) Nazwa rozwiązania do wyeksportowania. Zawsze należy używać Nazwy rozwiązania, a nie jej Wyświetlanej nazwy.
SolutionOutputFile Wersja pliku z danymi wyjściowymi
(Wymagane) Ścieżka i nazwa pliku ZIP rozwiązania, który ma być wyeksportowany do środowiska źródłowego (np. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).
Jeśli zaznaczone (true), operacja eksportu zostanie wykonana jako asynchroniczne zadanie wsadowe. Wybranie opcji asynchronicznej spowoduje odpytywanie i czekanie aż MaxAsyncWaitTime zostanie osiągnięty.
MaxAsyncWaitTime Maksymalny czas oczekiwania
Maksymalny czas oczekiwania w minutach na operację asynchroniczną; domyślnie 60 min (1 godz.), tak samo jak domyślnie dla zadań Azure DevOps.
Managed Eksportuj jako zarządzany
Jeśli wybrano opcję (true), należy eksportować rozwiązanie jako rozwiązanie zarządzane; w przeciwnym razie eksportować jako rozwiązanie niezarządzane.
ExportMarketingSettings Eksport ustawień marketingowych
Eksport ustawień marketingowych (true|false).
ExportOutlookSynchronizationSettings Eksportuj ustawienia synchronizacji programu Outlook
Eksportuj ustawienia synchronizacji programu Outlook (true|false).
ExportRelationshipRoles Role relacji eksportowych
Role relacji eksportowych (true|false).
ExportSales Sprzedaż eksportowa
Sprzedaż eksportowa (true|false).
Rozpakowywanie rozwiązania Power Platform
Rozkłada pliki skompresowane rozwiązań usługi na wiele plików XML i innych, co umożliwia łatwiejsze odczytywanie i zarządzanie tymi plikami w systemie kontroli źródła.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment URL środowiska Power Platform
Punkt końcowy usługi, w którym chcesz usunąć rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi, w którym chcesz usunąć rozwiązanie (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
SolutionName Nazwa rozwiązania
(Wymagane) Nazwa rozwiązania, które ma zostać usunięte. Zawsze należy używać Nazwy rozwiązania, a nie jej Wyświetlanej nazwy.
Publikowanie dostosowań Power Platform
Powoduje opublikowanie wszystkich dostosowań w środowisku.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment URL środowiska Power Platform
Punkt końcowy usługi, do którego chcesz opublikować dostosowania (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi, do którego chcesz opublikować dostosowania (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
Ustawianie wersji rozwiązania Power Platform
Aktualizacja wersji rozwiązania.
Wstawka YAML (wersja)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-solution-version.PowerPlatformSetSolutionVersion@2
displayName: 'Power Platform Set Solution Version '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
SolutionVersionNumber: 1.0.0.0
Parametry (Wersja)
Parametry
Opis
authenticationType Typ uwierzytelniania
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment URL środowiska Power Platform
Punkt końcowy usługi, w którym chcesz ustawić wersję rozwiązania (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi, w którym chcesz ustawić wersję rozwiązania (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
SolutionName Nazwa rozwiązania
(Wymagane) Nazwa rozwiązania, dla którego ma zostać ustawiona wersja. Zawsze należy używać Nazwy rozwiązania, a nie jej Wyświetlanej nazwy.
SolutionVersionNumber Numer wersji rozwiązania
(Wymagane) Numer wersji, który chcesz ustawić.
Podczas gdy numer wersji może być zakodowany w rurociągu, zalecane jest użycie zmiennej rurociągu Azure DevOps, takiej jak BuildId.
Zawiera opcje służące do definiowania dokładnego kształtu numeru wersji na karcie „Opcje”, na przykład: $(Rok:rrrr)-$(Miesiąc:MM)-$(Dzień:dd)-$(wersja:ww)-3
Tej definicji można następnie użyć w zadaniu Ustawiania wersji rozwiązania, ustawiając właściwość numeru wersji na wartość: $(Build.BuildId) zamiast twardego zakodowania wartości 20200824.0.0.2.
Alternatywnie w powershell inline skrypt zadania $(Get-Date -Format yyyy.MM.dd.HHmm) wyjście ustawione na pustą zmienną o nazwie SolutionVersion jako Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Set Solution Version as $(SolutionVersion).
Power Platform ustawia zmienne połączenia
Ustawia zmienne BuildTools.* w celu zapewnienia dostępu do zadań skryptów niestandardowych w celu użycia połączenia usługi jako jednego źródła rzeczywistości.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN Nazwa główna usługi Power Platform
Usługa punktu końcowego, dla której chcesz ustawić zmienne połączenia. Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
timeoutInMinutes Timeout
Określa w minutach maksymalny czas, przez który zadanie może być wykonywane przed anulowaniem przez serwer. Wartość zera wskazuje na niekończący się limit czasu.
retryCountOnTaskFailure Liczba zadań, które zakończyły się niepowodzeniem
Określa liczbę operacji zadań, które będą się działy w przypadku niepowodzenia zadania. Nie jest obsługiwany w przypadku zadań wykonywanych bez agenta.
ApplicationId Identyfikator aplikacji do logowania
(Wymagane do nazw użytkowników/haseł) Identyfikator aplikacji do użycia w celu logowania (zobacz niżej dodatkową notatkę).
RedirectUri Przekierowywanie URI określonej aplikacji
(Wymagane do nazw użytkowników/haseł) Przekierowywanie URI określonej aplikacji. Potrzebne podczas określania identyfikatora aplikacji. (Zobacz niżej dodatkową notatkę).
Uwaga
W przypadku uwierzytelniania typu nazwa użytkownika/hasło wymagany będzie identyfikator aplikacji i przekierowywanie URI. Ten dokument uwierzytelnienia OAuth zawiera wyjaśnienie, dlaczego w celu uwierzytelnienia należy utworzyć rejestrację aplikacji Dataverse.
W przypadku łączenia się przy użyciu uwierzytelniania nazwa użytkownika/hasło połączenie działa jako aplikacja łącząca się w imieniu użytkownika Dataverse.
Wdrażanie pakietu Power Platform
Powoduje wdrożenie pakietu w środowisku. Wdrożenie całego pakietu, w przeciwieństwie do korzystania z tylko jednego pliku rozwiązania, daje możliwość wdrożenia wielu rozwiązań, danych i kodu w środowisku.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment URL środowiska Power Platform
Punkt końcowy usługi, do którego chcesz wdrożyć pakiet (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi, do którego chcesz wdrożyć pakiet (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform. Więcej informacji: zobacz BuildTools.EnvironmentUrl pod Tworzenie środowiska Power Platform
PackageFile Plik pakietu
(Wymagane) Ścieżka i nazwa pliku zespołu pliku pakietu (.dll).
MaxAsyncWaitTime Maksymalny czas oczekiwania
Maksymalny czas oczekiwania w minutach na operację asynchroniczną; domyślnie 60 min (1 godz.), tak samo jak domyślnie dla zadań Azure DevOps.
Zarządzanie zadaniami w środowisku
Automatyzuj typowe zadania zarządzania cyklem życia środowiska (ELM).
Tworzenie środowiska Power Platform
Tworzy nowe środowisko. Utworzenie nowego środowiska powoduje również automatyczne utworzenie BuildTools.EnvironmentUrl.
Ważne
Gdy ustawione, BuildTools.EnvironmentUrl będzie używane jako domyślne połączenie serwisowe dla kolejnych zadań w potoku. Każde zadanie opisane w tym artykule wykorzystuje punkt końcowy z połączenia serwisowego tylko wtedy, gdy BuildTools.EnvironmentUrl nie jest ustawione.
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.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment URL środowiska Power Platform
Punkt końcowy usługi, w którym chcesz utworzyć środowisko (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi, w którym chcesz utworzyć środowisko (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
DisplayName Nazwa wyświetlana
(Wymagane) Nazwa wyświetlana utworzonego środowiska.
LocationName Region rozmieszczenia
(Wymagane) Region, w którym powinno zostać utworzone środowisko.
EnvironmentSku Typ środowiska
(Wymagane) Typ wystąpienia, które ma zostać wdrożone. Opcje to Sandbox, Produkcja, Próba i Próba oparta na subskrypcji.
AppsTemplate Aplikacje
W przypadku typu środowiska nietestowego obsługiwanymi aplikacjami są D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation i D365_Sales.
CurrencyName Waluta
(Wymagane) Waluta podstawowa dla utworzonego środowiska. Waluta nie może być aktualizowana po utworzeniu środowiska.
LanguageName Language
(Wymagane) Język podstawowy w środowisku.
DomainName Nazwa domeny
(Wymagane) Jest to ciąg specyficzny dla środowiska, który stanowi część adresu URL. Na przykład dla środowiska o następującym adresie URL: https://powerappsbuildtasks.crm.dynamics.com/, nazwa domeny to „powerappsbuildtasks”.
Uwaga: 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/.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment URL środowiska Power Platform
Punkt końcowy usługi, w którym chcesz usunąć środowisko (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi, w którym chcesz usunąć środowisko (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
Przypisz użytkowników Power Platform
Przypisz użytkownika do docelowego środowiska, używając określonej roli zabezpieczeń.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi dla środowiska, do którego chcesz przypisać użytkownika (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
User Nazwa użytkownika Power Platform
Identyfikator obiektu Microsoft Entra lub główna nazwa użytkownika, która ma zostać przypisana do środowiska docelowego.
Role Rola zabezpieczeń lub identyfikator
Nazwa lub identyfikator roli zabezpieczeń przypisane do użytkownika.
ApplicationUser Nazwa użytkownika aplikacji Power Platform
Określa, czy użytkownik wejściowy jest użytkownikiem aplikacji (true|false).
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment URL środowiska Power Platform
Punkt końcowy usługi, w którym chcesz zresetować środowisko (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi, w którym chcesz zresetować środowisko (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
Tworzenie kopii zapasowej środowiska Power Platform
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment URL środowiska Power Platform
Punkt końcowy usługi, w którym chcesz utworzyć kopię zapasową środowiska (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi, w którym chcesz utworzyć kopię zapasową środowiska (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
BackupLabel Etykieta kopii zapasowej
(Wymagane) Etykieta, która ma być przypisana do kopii zapasowej.
Kopiowanie środowiska Power Platform
Kopiuje środowisko do środowiska docelowego. Dostępne są dwa typy kopii: pełne i minimalne. Kopia pełna zawiera dane i metadane rozwiązania (dostosowania), a kopia minimalna zawiera tylko metadane rozwiązania, a nie faktyczne dane.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment URL środowiska Power Platform
Punkt końcowy usługi dla środowiska źródłowego, z którego chcesz kopiować (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi dla środowiska źródłowego, z którego chcesz kopiować (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
TargetEnvironmentUrl URL środowiska docelowego
(Wymagane) Adres URL docelowego środowiska, do którego ma zostać skopiowany program.
CopyType Typ kopii
Typ kopii do wykonania: FullCopy lub MinimalCopy
OverrideFriendlyName Zastąpić przyjazną nazwę
Zmień przyjazną nazwę środowiska docelowego na inną (true|false).
FriendlyName Przyjazna nazwa
Przyjazna nazwa środowiska docelowego.
SkipAuditData SkipAuditData
Określa, czy dane audytu mają być pomijane podczas operacji kopiowania. (true|false).
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformEnvironment URL środowiska Power Platform
Punkt końcowy usługi dla środowiska źródłowego, z którego chcesz przywracać (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi dla środowiska źródłowego, z którego chcesz przywracać (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
RestoreLatestBackup Ostatnia kopia zapasowa do przywrócenia
Czy ma być przywrócona najnowsza kopia zapasowa, czy podać element RestoreTimeStamp (true|false).
RestoreTimeStamp Data/godzina dla kopii zapasowej
Wartość określająca datę i godzinę wykonania kopii zapasowej w formacie „rrrr-mm-dd gg:mm” LUB ciąg „najnowsza”.
TargetEnvironmentUrl URL środowiska docelowego
(Wymagane) Adres URL docelowego środowiska, do którego ma zostać przywrócony.
FriendlyName Nazwa przywróconego środowiska
(Opcjonalna) Nazwa przywróconego środowiska.
DisableAdminMode Wyłącz tryb administratora
Czy wyłączyć tryb administracyjny (true|false).
Eksportowanie danych usługi Dataverse
Wyeksportuj dane ze środowiska przy użyciu dostępnego schematu.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi dla środowiska, z którego chcesz eksportować dane (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
SchemaFile Nazwa pliku schematu XML
Nazwa pliku schematu XML. Można go utworzyć przy użyciu narzędzia migracji konfiguracji.
DataFile Nazwa pliku danych
Nazwa pliku ZIP z danymi do eksportowania (plik ZIP).
Overwrite Zastąp zawartość
Zawartość witryny internetowej Power Pages portalu do zastąpienia (true|false).
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi dla środowiska, do którego chcesz importować dane (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
DataFile Nazwa pliku danych
Nazwa pliku skompresowanego (zip), plik danych do zaimportowania lub folder z plikami data-schema.xml i data.xml do zaimportowania.
Zadania związane z zarządzaniem Power Pages
Zadania do pracy z witryną internetową usługi Power Pages.
Pobierz portal Power Platform
Pobieranie zawartości witryny internetowej usługi Power Pages z poziomu bieżącego środowiska usługi Dataverse.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi dla środowiska , z którego chcesz pobierać zawartość (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
WebsiteId Identyfikator strony internetowej portalu
Identyfikator witryny internetowej usługi Power Pages do pobrania.
Overwrite Zastąp zawartość
Zawartość witryny internetowej Power Pages portalu do zastąpienia (true|false).
ModelVersion Model danych witryny
Wskazuje, czy dane witryny do przekazania będą używać standardowego (1) czy ulepszonego modelu danych (2). Wartość domyślna to „1”.
Przekaż portal Power Platform
Przekaż zawartość strony portalu Power Pages do aktualnego środowiska Dataverse.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi dla środowiska, do którego chcesz przekazać zawartość (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
UploadPath Ścieżka zawartości do przekazania
Ścieżka, z której zostanie przekazana zawartość witryny internetowej usługi Power Pages.
ModelVersion Model danych witryny
Wskazuje, czy dane witryny do przekazania będą używać standardowego (1) czy ulepszonego modelu danych (2). Wartość domyślna to „1”.
Katalog zadań Power Platform (wersja zapoznawcza)
Zadania te wykonują akcje względem katalogu w Power Platform i obejmują następujące elementy.
Uwaga
Obecnie zadania katalogowe dla Power Platform są w wersji zapoznawczej.
Zainstaluj produkt katalogowy
Zainstaluj element usługi Catalog w środowisku docelowym.
Parametry
opis
authenticationType Typ uwierzytelniania
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi dla środowiska, do którego chcesz przekazać zawartość (np. https://powerappsbuildtools.crm.dynamics.com). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
Environment URL środowiska docelowego
(Wymagane) Środowisko url, na które ukierunkowane jest to zadanie.
CatalogItemId Identyfikator produktu katalogowego do zainstalowania
(Wymagane) Produkt katalogowy do zainstalowania w środowisku docelowym.
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi dla środowiska, do którego chcesz przekazać zawartość (np. „https://powerappsbuildtools.crm.dynamics.com”). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
Environment URL środowiska docelowego
(Wymagane) Środowisko url, na które ukierunkowane jest to zadanie.
CatalogSubmissionFile Plik zgłoszenia katalogu
(Wymagane) Określ ścieżkę i nazwę pliku przesyłania katalogu.
UsePackageSolutionZipFile Typ pliku
Typ pliku: pakiet lub plik zip z rozwiązaniem.
SolutionZipFile Nazwa pliku zip z rozwiązaniem
Określ ścieżkę i nazwę pliku zip rozwiązania.
PollStatus Sprawdź stan ankiety
(Opcjonalnie) Odpytywanie w celu sprawdzenia statusu żądania (true|false).
Uzyskanie statusu żądania instalacji/przesłania katalogu.
Parametry
opis
authenticationType Typ uwierzytelniania
(Wymagane dla SPN) Określ PowerPlatformEnvironment dla połączenia typu nazwa użytkownika/hasło lub PowerPlatformSPN dla połączenia typu Service Principal/klucz tajny klienta.
PowerPlatformSPN Nazwa główna usługi Power Platform
Punkt końcowy usługi dla środowiska, do którego chcesz przekazać zawartość (np. „https://powerappsbuildtools.crm.dynamics.com”). Zdefiniowane w obszarze Połączenia usług w ustawieniach projektu przy użyciu typu połączenia Power Platform.
Environment URL środowiska docelowego
(Wymagane) Środowisko url, na które ukierunkowane jest to zadanie.
TrackingId Identyfikator śledzenia żądania
(Wymagane) Identyfikator śledzenia żądania.
RequestType Typ żądania
(Wymagane) Typ żądania. (Wartości: Zainstaluj | Prześlij).
Po zidentyfikowaniu czynności, które można wykonać przy użyciu narzędzi kompilacji, zobaczmy teraz, jak użyć tych narzędzi w ramach kompilacji i potoku wydawniczego. Informacje ogólne przedstawiono w poniższej sekcji. Zobaczmy więcej informacji o implementacji potoku przy użyciu narzędzi kompilacji w podsekcjach znajdujących się poniżej.
Aby dowiedzieć się więcej o tym, jak tworzyć te potoki i rzeczywiście tworzyć je za pomocą narzędzi kompilacji Microsoft Power Platform Build Tools, należy ukończyć Laboratorium narzędzi kompilacji build tools, które można pobrać z witryny GitHub.
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 produkcynego.
W tym samouczku pokazano, jak używać usługi Azure DevOps z platformą Power Platform. Kartaik pokaże nam, jak łatwo jest tworzyć potoki dla platformy Power Platform w usłudze Azure DevOps, tworzyć aplikację platformy Power Platform z potoku ciągłej integracji/ciągłego wdrażania, a następnie wdrażać je w docelowym środowisku wydania. Rozdziały 00:19 — Zapraszamy 01:28 — Dlaczego warto używać usługi Azure DevOps w środowisku z małą ilością kodu 02:15 — pokaz platformy Power Platform 04:01 — Uruchamianie aplik
Obejście problemu, który występuje, gdy rozwiązanie niezarządzane jest już zainstalowane i próbujesz zainstalować nowszą wersję w trybie zarządzanym w usłudze Microsoft Power Apps.
