Nhiệm vụ của Công cụ xây dựng Microsoft Power Platform
Các tác vụ xây dựng có sẵn được mô tả trong các phần sau. Sau đó, chúng tôi giới thiệu một số ví dụ về Quy trình Azure sử dụng các tác vụ này. Để biết thông tin về các công cụ xây dựng và cách tải chúng xuống, hãy xem Microsoft Power Platform Công cụ xây dựng cho quy trình Azure.
Nhiệm vụ trình trợ giúp
Các tác vụ trợ giúp có sẵn sẽ được mô tả tiếp theo.
Trình cài đặt công cụ Power Platform
Tác vụ này được yêu cầu phải được thêm một lần trước khi bất kỳ tác vụ Công cụ xây dựng Power Platform nào khác trong quy trình xây dựng và phát hành. Tác vụ này cài đặt một nhóm các công cụ dành riêng cho Power Platform theo yêu cầu của tác nhân để chạy tác vụ xây dựng Microsoft Power Platform. Tác vụ này không yêu cầu thêm bất kỳ cấu hình nào khi được thêm vào. Tác vụ này chứa các tham số cho phiên bản cụ thể của từng công cụ đang được cài đặt.
Để luôn cập nhật các phiên bản công cụ theo thời gian, hãy đảm bảo các tham số này tương ứng với các phiên bản của các công cụ được yêu cầu để quy trình hoạt động đúng.
Đoạn mã YAML (Trình thiết đặt)
# Installs default Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@0
displayName: 'Power Platform Tool Installer'
# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@0
displayName: 'Power Platform Tool Installer'
inputs:
DefaultVersion: false
XrmToolingPackageDeploymentVersion: 3.3.0.928
Tham số (Trình thiết đặt)
Tham số | Mô tả |
---|---|
DefaultVersion Sử dụng các phiên bản công cụ mặc định |
Đặt thành true để sử dụng phiên bản mặc định của tất cả các công cụ, nếu không false. Bắt buộc (và false) khi bất kỳ phiên bản công cụ nào được chỉ định. |
PowerAppsAdminVersion XrmToolingPackageDeploymentVersion MicrosoftPowerAppsCheckerVersion CrmSdkCoreToolsVersion Phiên bản công cụ |
Phiên bản cụ thể của công cụ để sử dụng. |
Power Platform WhoAmI
Xác minh một kết nối dịch vụ trong môi trường Power Platform bằng cách kết nối và thực hiện yêu cầu WhoAmI. Tác vụ này có thể hữu ích để bao gồm sớm trong quy trình, để xác minh kết nối trước khi bắt đầu xử lý.
Đoạn mã YAML (WhoAmI)
# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@0
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@0
displayName: 'Power Platform WhoAmI'
inputs:
# Username/password (no MFA support)
PowerPlatformEnvironment: 'My service connection'
Tham số (WhoAmI)
Tham số | Mô tả |
---|---|
authenticationType Loại xác thực |
(Tùy chọn) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ cho môi trường bạn muốn kết nối. Được xác định trong Kết nối dịch vụ trong Thiết lập dự án. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ cho môi trường bạn muốn kết nối. Được xác định trong Kết nối dịch vụ trong Thiết lập dự án. |
Kiểm tra chất lượng
Phần tiếp theo là các nhiệm vụ có sẵn để kiểm tra chất lượng của giải pháp.
Power Platform Checker
Tác vụ này chạy kiểm tra phân tích tĩnh trên các giải pháp của bạn dựa trên một bộ quy tắc thực hành tốt nhất để xác định bất kỳ mẫu vấn đề nào mà bạn có thể vô tình đưa vào khi xây dựng giải pháp của mình.
Đoạn mã YAML (Trình kiểm tra)
# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
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@0
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'
Tham số (Trình kiểm tra)
Tham số | Mô tả |
---|---|
PowerPlatformSPN Kết nối dịch vụ |
(Bắt buộc) Yêu cầu phải có kết nối với môi trường Microsoft Power Platform được cấp phép để sử dụng Bộ kiểm tra Power Platform. Kết nối dịch vụ được xác định trong Kết nối dịch vụ trong phần Cài đặt dự án sử dụng loại kết nối Power Platform. Thông tin thêm: xem BuildTools.EnvironmentUrl trong Power Platform Tạo môi trườngLưu ý: Phương thức xác thực chính của dịch vụ và tên người dùng/mật khẩu có sẵn cho tác vụ kiểm tra. Để biết thêm thông tin về cách đặt cấu hình yếu tố chính của dịch vụ được sử dụng với nhiệm vụ này, hãy xem Đặt cấu hình kết nối yếu tố chính của dịch vụ cho môi trường Power Platform. |
UseDefaultPACheckerEndpoint Sử dụng điểm cuối của Trình kiểm tra Power Platform mặc định |
Theo mặc định (true), vị trí địa lý của dịch vụ kiểm tra sử dụng cùng vị trí địa lý với môi trường mà bạn kết nối. |
CustomPACheckerEndpoint Điểm cuối của trình kiểm tra PAC tùy chỉnh |
Bắt buộc khi UseDefaultPACheckerEndpoint là false. Bạn có thể chỉ định một địa lý khác để sử dụng, ví dụ: https://japan.api.advisor.powerapps.com. Để biết danh sách các khu vực địa lý có sẵn, hãy xem Sử dụng Power Platform API trình kiểm tra. |
FileLocation Vị trí của tập tin để phân tích |
Bắt buộc khi tham chiếu tệp từ URL chữ ký truy cập chung (SAS) sasUriFile .Lưu ý: Điều quan trọng là phải tham chiếu tệp giải pháp đã xuất chứ không phải tệp nguồn đã giải nén trong kho lưu trữ của bạn. Có thể phân tích cả tệp giải pháp được quản lý và không được quản lý. |
FilesToAnalyzeSasUri Tệp SAS để phân tích |
Bắt buộc khi FileLocation được đặt thành sasUriFile . Nhập URI SAS. Bạn có thể thêm nhiều URI SAS thông qua danh sách được phân tách bằng dấu phẩy (,) hoặc dấu chấm phẩy (;). |
FilesToAnalyze Tệp cục bộ để phân tích |
Bắt buộc khi tệp SAS không được phân tích. Chỉ định đường dẫn và tên tệp của tệp zip cần phân tích. Có thể dùng ký tự đại diện. Ví dụ: enter **\*.zip cho tất cả các tệp zip trong tất cả các thư mục con. |
FilesToExclude Tệp cục bộ cần loại trừ |
Chỉ định tên của các tệp được loại trừ khỏi phân tích. Nếu có nhiều hơn một, hãy cung cấp thông qua danh sách được phân tách bằng dấu phẩy (,) hoặc dấu chấm phẩy (;). Danh sách này có thể bao gồm tên tệp đầy đủ hoặc tên có ký tự đại diện ở đầu hoặc ở cuối, chẳng hạn như * jquery hoặc form.js |
RulesToOverride Quy tắc ghi đè |
Mảng JSON chứa các quy tắc và cấp độ cần ghi đè. Các giá trị được chấp nhận cho OverrideLevel là: Critical, High, Medium, Low, Informational. Ví dụ: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
RuleSet Bộ quy tắc |
(Bắt buộc) Chỉ định bộ quy tắc sẽ áp dụng. Hai bộ quy tắc sau đây khả dụng:
|
ErrorLevel Mức độ lỗi |
Kết hợp với lỗi, tham số ngưỡng xác định mức độ nghiêm trọng của lỗi và cảnh báo được phép. Giá trị ngưỡng được hỗ trợ là <level>IssueCount, trong đó level=Critical, High, Medium, Low và Informational. |
ErrorThreshold Ngưỡng lỗi |
Xác định số lỗi (>=0) của một mức cụ thể được phép trình kiểm tra vượt qua các giải pháp đang được kiểm tra. |
FailOnPowerAppsCheckerAnalysisError Lỗi không thành công |
Khi true, không thành công nếu dữ liệu phân tích của trình kiểm tra Power Apps được trả về là Failed FinishedWithErrors. |
ArtifactDestinationName Tên thành phần lạ DevOps |
Chỉ định tên Azure Artifacts cho tệp .sarif của trình kiểm tra. |
Nhiệm vụ giải pháp
Tập hợp tác vụ này có thể tự động hóa các hành động giải pháp. Các tác vụ môi trường được nêu sau trong phần này nhằm tạo, sao chép hoặc khôi phục môi trường sẽ ghi đè các kết nối dịch vụ với môi trường mới được tạo. Những tác vụ này giúp thực hiện các tác vụ giải pháp dựa trên các môi trường được tạo theo yêu cầu.
Nhập giải pháp Power Platform
Nhập một giải pháp vào môi trường đích.
Đoạn mã YAML (Nhập)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
displayName: 'Power Platform Import Solution '
inputs:
PowerPlatformEnvironment: 'My service connection'
SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
HoldingSolution: true
OverwriteUnmanagedCustomizations: true
SkipProductUpdateDependencies: true
ConvertToManaged: true
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
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
Tham số (Nhập)
Tham số | Mô tả |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ mà bạn muốn nhập giải pháp vào (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ mà bạn muốn nhập giải pháp vào (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
SolutionInputFile Tệp đầu vào giải pháp |
(Bắt buộc) Đường dẫn và tên tệp của tệp .zip giải pháp để nhập vào môi trường đích (ví dụ: $(Build.ArtifactStagingDirectory)$(SolutionName).zip). Lưu ý: Các biến cung cấp cho bạn một cách thuận tiện để đưa bit dữ liệu chính vào nhiều phần trong quy trình. Xem Sử dụng các biến được xác định trước cho một danh sách toàn diện. |
HoldingSolution Nhập dưới dạng một giải pháp lưu giữ |
Tham số nâng cao (true|false) được dùng khi giải pháp cần được nâng cấp. Tham số này lưu trữ giải pháp trong Dataverse nhưng không nâng cấp giải pháp cho đến khi tác vụ Áp dụng bản nâng cấp giải pháp được chạy. |
OverwriteUnmanagedCustomizations Ghi đè các tùy chỉnh không được quản lý |
Chỉ định xem có ghi đè các mục tùy chỉnh không được quản lý hay không (true|false). |
SkipProductUpdateDependencies Bỏ qua phần phụ thuộc cập nhật sản phẩm |
Chỉ định xem có nên bỏ qua việc thực thi các phần phụ thuộc liên quan đến cập nhật sản phẩm hay không (true|false). |
ConvertToManaged Chuyển đổi thành được quản lý |
Chỉ định xem có nhập dưới dạng giải pháp được quản lý hay không (true|false). |
AsyncOperation Nhập không đồng bộ |
Nếu được chọn (true), hoạt động nhập sẽ được thực hiện không đồng bộ. Điều này được khuyến nghị cho các giải pháp lớn hơn vì nhiệm vụ này sẽ tự động hết thời gian chờ sau 4 phút. Việc chọn không đồng bộ sẽ thăm dò ý kiến và đợi cho đến khi đạt đến MaxAsyncWaitTime (true|false). |
MaxAsyncWaitTime Thời gian chờ tối đa |
Thời gian chờ tối đa tính bằng phút đối với hoạt động không đồng bộ; mặc định là 60 phút (1 giờ), giống như Azure DevOps mặc định cho các tác vụ. |
PublishWorkflows Kích hoạt các quy trình sau khi nhập |
Chỉ định xem có nên kích hoạt bất kỳ quy trình nào (dòng công việc) trong giải pháp sau khi nhập hay không (true|false). |
UseDeploymentSettingsFile Sử dụng tệp thiết đặt triển khai |
Có thể đặt tham chiếu kết nối và giá trị biến môi trường bằng tệp thiết đặt triển khai (true|false). |
DeploymentSettingsFile Tệp thiết đặt triển khai |
(Bắt buộc khi UseDeploymentSettingsFile =true) Đường dẫn và tên tệp của tệp thiết đặt triển khai. |
Power Platform Thêm thành phần giải pháp
Thêm thành phần giải pháp vào giải pháp không được quản lý.
YAML đoạn mã (Thêm)
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
Thông số (Thêm)
Tham số | Description |
---|---|
ComponentId ID của thành phần giải pháp |
Tên sơ đồ hoặc ID của thành phần để thêm vào giải pháp đích. |
ComponentType URL môi trường Power Platform |
Giá trị đại diện cho thành phần giải pháp mà bạn đang thêm. Xem Sử dụng các loại thành phần được xác định trước để biết danh sách đầy đủ các giá trị thành phần. |
SolutionUniqueName Tên giải pháp |
Tên duy nhất của giải pháp. |
AddRequiredComponents Mọi thành phần được yêu cầu từ giải pháp khác phụ thuộc vào thành phần giải pháp |
(Tùy chọn) Cho biết liệu các thành phần giải pháp khác được yêu cầu bởi thành phần giải pháp mà bạn đang thêm cũng có nên được thêm vào giải pháp không được quản lý hay không. |
Environment URL hoặc ID môi trường |
(Tùy chọn) URL hoặc ID môi trường của môi trường đích. |
Power Platform Áp dụng bản nâng cấp giải pháp
Nâng cấp giải pháp đã được nhập dưới dạng giải pháp lưu giữ.
Đoạn mã YAML (Nâng cấp)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@0
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@0
displayName: 'Power Platform Apply Solution Upgrade '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
MaxAsyncWaitTime: 45
Tham số (Nâng cấp)
Tham số | Mô tả |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ mà bạn muốn nâng cấp giải pháp lên (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ mà bạn muốn nâng cấp giải pháp lên (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
SolutionName Tên Giải pháp |
(Bắt buộc) Tên giải pháp áp dụng nâng cấp. Luôn sử dụng giải pháp Tên chứ không phải Tên hiển thị. |
AsyncOperation Nâng cấp không đồng bộ |
Nếu được chọn (true), hoạt động nâng cấp sẽ được thực hiện như một công việc hàng loạt không đồng bộ. Việc chọn không đồng bộ sẽ thăm dò ý kiến và đợi cho đến khi đạt đến MaxAsyncWaitTime. |
MaxAsyncWaitTime Thời gian chờ tối đa |
Thời gian chờ tối đa tính bằng phút đối với hoạt động không đồng bộ; mặc định là 60 phút (1 giờ), giống như Azure DevOps mặc định cho các tác vụ. |
Lưu ý
Các biến cung cấp cho bạn một cách thuận tiện để đưa các bit dữ liệu chính vào các phần khác nhau của quy trình. Xem Sử dụng các biến được xác định trước cho một danh sách toàn diện. Bạn có thể điền trước thông tin về tham chiếu kết nối và biến môi trường cho môi trường đích trong khi nhập giải pháp bằng cách sử dụng tệp thiết đặt triển khai.
Thông tin thêm: Điền sẵn tham chiếu kết nối và biến môi trường để triển khai tự độngXuất giải pháp Power Platform
Xuất giải pháp từ một môi trường nguồn.
Đoạn mã YAML (Xuất)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
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@0
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
Tham số (Xuất)
Tham số | Mô tả |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ mà bạn muốn nâng cấp giải pháp lên (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ mà bạn muốn nâng cấp giải pháp lên (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
SolutionName Tên Giải pháp |
(Bắt buộc) Tên của giải pháp cần xuất. Luôn sử dụng giải pháp Tên chứ không phải Tên hiển thị. |
SolutionOutputFile Tệp đầu ra giải pháp |
(Bắt buộc) Đường dẫn và tên tệp của tệp Solution.zip để xuất môi trường nguồn sang (ví dụ: $(Build.ArtifactStagingDirectory)$(SolutionName).zip ). Lưu ý: Các biến cung cấp cho bạn một cách thuận tiện để đưa bit dữ liệu chính vào nhiều phần trong quy trình. Xem Sử dụng các biến được xác định trước cho một danh sách toàn diện. |
AsyncOperation Xuất không đồng bộ |
Nếu được chọn (true), hoạt động xuất sẽ được thực hiện như một công việc hàng loạt không đồng bộ. Việc chọn không đồng bộ sẽ thăm dò ý kiến và đợi cho đến khi đạt đến MaxAsyncWaitTime. |
MaxAsyncWaitTime Thời gian chờ tối đa |
Thời gian chờ tối đa tính bằng phút đối với hoạt động không đồng bộ; mặc định là 60 phút (1 giờ), giống như Azure DevOps mặc định cho các tác vụ. |
Managed Xuất dưới dạng được quản lý |
Nếu được chọn (true), xuất giải pháp dưới dạng giải pháp được quản lý; nếu không thì xuất dưới dạng giải pháp không được quản lý. |
ExportAutoNumberingSettings Xuất thiết đặt đánh số tự động |
Xuất thiết đặt đánh số tự động (true|false). |
ExportCalendarSettings Xuất thiết đặt lịch |
Xuất thiết đặt lịch (true|false). |
ExportCustomizationSettings Xuất thiết đặt tùy chỉnh |
Xuất thiết đặt tùy chỉnh (true|false). |
ExportEmailTrackingSettings Xuất thiết đặt theo dõi email |
Xuất thiết đặt theo dõi email (true|false). |
ExportGeneralSettings Xuất thiết đặt chung |
Xuất thiết đặt chung (true|false). |
ExportIsvConfig Xuất cấu hình ISV |
Xuất cấu hình ISV (true|false). |
ExportMarketingSettings Xuất thiết đặt tiếp thị |
Xuất thiết đặt tiếp thị (true|false). |
ExportOutlookSynchronizationSettings Xuất thiết đặt đồng bộ hóa Outlook |
Xuất thiết đặt đồng bộ hóa Outlook (true|false). |
ExportRelationshipRoles Xuất vai trò của mối quan hệ |
Xuất vai trò của mối quan hệ (true|false). |
ExportSales Xuất doanh số bán hàng |
Xuất doanh số bán hàng (true|false). |
Giải pháp giải nén Power Platform
Lấy tệp giải pháp đã nén rồi giải nén thành nhiều tệp XML để hệ thống kiểm soát nguồn có thể dễ dàng đọc và quản lý các tệp này.
Đoạn mã YAML (Mở gói)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.unpack-solution.PowerPlatformUnpackSolution@0
displayName: 'Power Platform Unpack Solution '
inputs:
SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
SolutionTargetFolder: 'C:\Public'
SolutionType: Both
Tham số (Mở gói)
Tham số | Mô tả |
---|---|
SolutionInputFile Tệp đầu vào giải pháp |
(Bắt buộc) Đường dẫn và tên tệp của tệp solution.zip cần giải nén. |
SolutionTargetFolder Thư mục đích để giải nén giải pháp |
(Bắt buộc) Đường dẫn và thư mục đích bạn muốn giải nén giải pháp vào. |
SolutionType Loại giải pháp |
(Bắt buộc) Loại giải pháp bạn muốn giải nén. Các tùy chọn bao gồm: Không được quản lý (khuyên dùng), Quản lý và Cả hai. |
Giải pháp gói Power Platform
Gói một giải pháp được thể hiện trong kiểm soát nguồn vào tệp solution.zip có thể được nhập vào môi trường khác.
Đoạn mã YAML (Gói)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.pack-solution.PowerPlatformPackSolution@0
displayName: 'Power Platform Pack Solution '
inputs:
SolutionSourceFolder: 'C:\Public'
SolutionOutputFile: 'Contoso_sample_1_0_0_1_managed.zip'
SolutionType: Managed
Tham số (Gói)
Tham số | Mô tả |
---|---|
SolutionOutputFile Tệp đầu ra giải pháp |
(Bắt buộc) Đường dẫn và tên tệp của tệp solution.zip để đóng gói giải pháp vào. |
SolutionSourceFolder Thư mục nguồn của giải pháp để đóng gói |
(Bắt buộc) Đường dẫn và thư mục nguồn của giải pháp để đóng gói. |
SolutionType Loại giải pháp |
(Bắt buộc) Loại giải pháp bạn muốn đóng gói. Các tùy chọn bao gồm: Được quản lý (khuyên dùng), Không được quản lý và Cả hai. |
Power Platform Xóa giải pháp
Xóa giải pháp trong môi trường đích.
Đoạn mã YAML (Xóa)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-solution.PowerPlatformDeleteSolution@0
displayName: 'Power Platform Delete Solution '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
Tham số (Xóa)
Tham số | Mô tả |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ mà bạn muốn xóa giải pháp (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ mà bạn muốn xóa giải pháp (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
SolutionName Tên Giải pháp |
(Bắt buộc) Tên giải pháp cần xóa. Luôn sử dụng giải pháp Tên chứ không phải Tên hiển thị. |
Tùy chỉnh phát hành Power Platform
Phát hành tất cả các tùy chỉnh trong một môi trường.
Đoạn mã YAML (Phát hành)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.publish-customizations.PowerPlatformPublishCustomizations@0
displayName: 'Power Platform Publish Customizations '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
Tham số (Phát hành)
Tham số | Mô tả |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ mà bạn muốn xuất bản các tùy chỉnh (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ mà bạn muốn xuất bản các tùy chỉnh (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
Phiên bản giải pháp đã đặt Power Platform
Cập nhật phiên bản của một giải pháp.
Đoạn mã YAML (Phiên bản)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-solution-version.PowerPlatformSetSolutionVersion@0
displayName: 'Power Platform Set Solution Version '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
SolutionVersionNumber: 1.0.0.0
Tham số (Phiên bản)
Tham số | Mô tả |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ mà bạn muốn đặt phiên bản giải pháp (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ mà bạn muốn đặt phiên bản giải pháp (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
SolutionName Tên Giải pháp |
(Bắt buộc) Tên của giải pháp để đặt phiên bản cho. Luôn sử dụng giải pháp Tên chứ không phải Tên hiển thị. |
SolutionVersionNumber Số phiên bản giải pháp |
(Bắt buộc) Số phiên bản bạn muốn đặt. |
Mặc dù số phiên bản có thể được mã hóa cứng trong quy trình bán hàng, nhưng bạn nên sử dụng biến quy trình bán hàng Azure DevOps như BuildId. Quy trình này cung cấp các tùy chọn để xác định hình dạng chính xác của số phiên bản trong tab "Tùy chọn", ví dụ: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3
Sau đó, định nghĩa này sau đó có thể được dùng trong tác vụ Đặt phiên bản giải pháp bằng cách đặt thuộc tính Số phiên bản với: $(Build.BuildId) thay vì mã hóa cứng 20200824.0.0.2.
Ngoài ra, một tập lệnh tác vụ nội tuyến powershell $(Get-Date -Format yyyy.MM.dd.HHmm) được đặt thành biến trống có tên là SolutionVersion thành Ghi-Máy chủ ("##vso[task.setvariable variable=SolutionVersion;]$version"), Đặt Phiên bản Giải pháp là $(SolutionVersion).
Power Platform Đặt biến kết nối
Đặt các biến BuildTools.* để cung cấp quyền truy cập vào các tác vụ tập lệnh tùy chỉnh để sử dụng kết nối dịch vụ như một nguồn thông tin đáng tin cậy duy nhất.
YAML đoạn mã (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
Các tham số (SetConnectionVariables)
Tham số | Description |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ mà bạn muốn đặt biến kết nối. Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
timeoutInMinutes Thời gian chờ |
Chỉ định thời gian tối đa, tính bằng phút, mà một tác vụ được phép thực thi trước khi bị máy chủ hủy. Giá trị 0 biểu thị thời gian chờ vô hạn. |
retryCountOnTaskFailure Số lần thử lại nếu nhiệm vụ thất bại |
Chỉ định số lần thử lại cho tác vụ này sẽ xảy ra trong trường hợp tác vụ bị lỗi. Không được hỗ trợ cho các nhiệm vụ không có tác nhân. |
ApplicationId Id ứng dụng để đăng nhập |
(Bắt buộc đối với tên người dùng/mật khẩu) Id ứng dụng để sử dụng để đăng nhập (Xem ghi chú bổ sung bên dưới). |
RedirectUri URI chuyển hướng của ứng dụng cụ thể |
(Bắt buộc đối với tên người dùng/mật khẩu) URI chuyển hướng của ứng dụng được chỉ định. Cần thiết khi chỉ định Id ứng dụng. (Xem thêm ghi chú bên dưới). |
Lưu ý
Khi sử dụng loại xác thực tên người dùng/mật khẩu, Id ứng dụng và Uri chuyển hướng sẽ được yêu cầu. Tài liệu xác thực oauth này có giải thích lý do tại sao bạn cần tạo đăng ký ứng dụng để xác thực Dataverse. Khi bạn kết nối bằng xác thực tên người dùng/mật khẩu, kết nối sẽ hoạt động như một ứng dụng đang kết nối thay mặt người dùng Dataverse.
Gói triển khai Power Platform
Triển khai một gói sang một môi trường. Việc triển khai một gói trái ngược với một tệp giải pháp cung cấp một tùy chọn triển khai nhiều giải pháp, dữ liệu và mã vào một môi trường.
Đoạn mã YAML (Triển khai)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.deploy-package.PowerPlatformDeployPackage@0
displayName: 'Power Platform Deploy Package '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
PackageFile: 'C:\Users\Public\package.dll'
MaxAsyncWaitTime: 120
Tham số (Triển khai)
Tham số | Mô tả |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ mà bạn muốn triển khai gói vào (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ mà bạn muốn triển khai gói vào (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. Để biết thêm thông tin, hãy xem BuildTools.EnvironmentUrl trong phần Power Platform Tạo môi trường |
PackageFile Tệp gói |
(Bắt buộc) Đường dẫn và tên tệp của tập hợp tệp gói (.dll). |
MaxAsyncWaitTime Thời gian chờ tối đa |
Thời gian chờ tối đa tính bằng phút đối với hoạt động không đồng bộ; mặc định là 60 phút (1 giờ), giống như Azure DevOps mặc định cho các tác vụ. |
Nhiệm vụ quản lý môi trường
Tự động hóa các tác vụ Quản lý vòng đời môi trường (ELM) chung.
Tạo môi trường Power Platform
Tạo môi trường mới. Tạo môi trường mới cũng tự động tạo BuildTools.EnvironmentUrl
.
Quan trọng
Khi thiết lập, BuildTools.EnvironmentUrl
sẽ được sử dụng như kết nối dịch vụ mặc định cho các nhiệm vụ tiếp theo trong đường dẫn. Mỗi tác vụ được mô tả trong bài viết này chỉ sử dụng điểm cuối từ kết nối dịch vụ khi BuildTools.EnvironmentUrl
không được thiết lập.
Đoạn mã YAML (Tạo-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@0
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@0
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
Tham số (Tạo-env)
Tham số | Mô tả |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ mà bạn muốn tạo môi trường (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ mà bạn muốn tạo môi trường (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
DisplayName Tên hiển thị |
(Bắt buộc) Tên hiển thị của môi trường đã được tạo. |
LocationName Khu vực triển khai |
(Bắt buộc) Vùng mà môi trường nên được tạo vào. |
EnvironmentSku Loại môi trường |
(Bắt buộc) Loại phiên bản cần triển khai. Các tùy chọn là Hộp cát, Sản xuất, Bản dùng thử và SubscriptionBasedTrial. |
AppsTemplate Ứng dụng |
Đối với loại môi trường không dùng thử, các ứng dụng được hỗ trợ là D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation và D365_Sales. |
CurrencyName Tiền tệ |
(Bắt buộc) Đơn vị tiền tệ cơ sở cho môi trường được tạo. Không thể cập nhật đơn vị tiền tệ sau khi tạo môi trường. |
LanguageName Ngôn ngữ |
(Bắt buộc) Ngôn ngữ cơ sở trong môi trường. |
DomainName Tên Miền |
(Bắt buộc) Đây là chuỗi dành riêng cho môi trường tạo thành một phần của URL. Ví dụ: đối với môi trường có URL sau: https://powerappsbuildtasks.crm.dynamics.com/ , tên miền sẽ là 'powerappsbuildtasks'. Lưu ý: Nếu bạn nhập một tên miền đã được sử dụng, tác vụ sẽ nối một giá trị số vào tên miền này, bắt đầu bằng 0. Đối với ví dụ trên, URL có thể trở thànhhttps://powerappsbuildtasks0.crm.dynamics.com/ . |
Xóa môi trường Power Platform
Xóa môi trường.
Đoạn mã YAML (Xóa-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@0
displayName: 'Power Platform Delete Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
Tham số (Xóa-env)
Tham số | Mô tả |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ mà bạn muốn xóa môi trường (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ mà bạn muốn xóa môi trường (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
Power Platform Chỉ định người dùng
Chỉ định người dùng vào môi trường đích với vai trò bảo mật được chỉ định.
YAML đoạn mã (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
Tham số (AssignUser-env)
Tham số | Description |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ cho môi trường mà bạn muốn chỉ định người dùng (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
User Power Platform tên tài khoản |
Microsoft Entra ID đối tượng hoặc tên chính của người dùng để gán cho môi trường đích. |
Role Vai trò bảo mật tên hoặc ID |
Vai trò bảo mật tên hoặc ID được chỉ định cho người dùng. |
ApplicationUser Power Platform tên người dùng ứng dụng |
Chỉ định xem người dùng đầu vào có phải là người dùng ứng dụng hay không (true|false). |
Power Platform Đặt lại môi trường
Đặt lại một môi trường.
YAML đoạn mã (Đặt lại-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'
Thông số (Reset-env)
Tham số | Description |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ mà bạn muốn đặt lại môi trường (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ mà bạn muốn đặt lại môi trường (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
Power Platform Sao lưu môi trường
Thiết lập môi trường.
Đoạn mã YAML (Sao lưu-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.backup-environment.PowerPlatformBackupEnvironment@0
displayName: 'Power Platform Backup Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
BackupLabel: 'Full backup - $(Build.BuildNumber)'
Tham số (Sao lưu-env)
Tham số | Mô tả |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ mà bạn muốn sao lưu môi trường (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ mà bạn muốn sao lưu môi trường (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
BackupLabel Nhãn sao lưu |
(Bắt buộc) Nhãn được gán cho bản sao lưu. |
Power Platform Sao chép môi trường
Sao chép một môi trường vào một môi trường đích. Hai loại bản sao có sẵn: đầy đủ và tối thiểu. Một bản sao Đầy đủ bao gồm cả dữ liệu và siêu dữ liệu giải pháp (tùy chỉnh), trong khi một bản sao tối thiểu chỉ bao gồm siêu dữ liệu giải pháp và không phải dữ liệu thực tế.
Đoạn mã YAML (Sao chép-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@0
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@0
displayName: 'Power Platform Copy Environment '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
CopyType: MinimalCopy
OverrideFriendlyName: true
FriendlyName: 'Contoso Test'
DisableAdminMode: false
Tham số (Sao chép-env)
Tham số | Mô tả |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ cho môi trường nguồn mà bạn muốn sao chép từ đó (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ cho môi trường nguồn mà bạn muốn sao chép từ đó (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
TargetEnvironmentUrl URL môi trường đích |
(Bắt buộc) URL cho môi trường đích mà bạn muốn sao chép sang. |
CopyType Loại sao chép |
Loại bản sao để thực hiện: FullCopy hoặc MinimalCopy |
OverrideFriendlyName Ghi đè tên thân thiện |
Thay đổi tên dễ nhớ của môi trường đích thành một tên khác (true|false). |
FriendlyName Tên dễ nhớ |
Tên thân thiện của môi trường đích. |
DisableAdminMode Tắt chế độ quản trị |
Liệu có tắt chế độ quản trị hay không (true|false). |
Power Platform Khôi phục môi trường
Khôi phục một môi trường vào bản sao lưu đã được cung cấp.
YAML đoạn mã (Khôi phục-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'
Các tham số (Khôi phục-env)
Tham số | Description |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformEnvironment URL môi trường Power Platform |
Điểm cuối dịch vụ cho môi trường nguồn mà bạn muốn khôi phục từ đó (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ cho môi trường nguồn mà bạn muốn khôi phục từ đó (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
RestoreLatestBackup Bản sao lưu mới nhất để khôi phục |
Khôi phục bản sao lưu mới nhất hay cung cấp RestoreTimeStamp (true|false). |
RestoreTimeStamp Ngày giờ sao lưu |
DateTime của bản sao lưu ở định dạng "mm/dd/yyyy hh:mm" HOẶC chuỗi "mới nhất". |
TargetEnvironmentUrl URL môi trường đích |
(Bắt buộc) URL cho môi trường đích mà bạn muốn khôi phục. |
FriendlyName Tên của môi trường được khôi phục |
(Tùy chọn) Tên của môi trường được khôi phục. |
DisableAdminMode Tắt chế độ quản trị |
Liệu có tắt chế độ quản trị hay không (true|false). |
Xuất Dataverse Dữ liệu
Xuất dữ liệu từ một môi trường có lược đồ được cung cấp.
YAML đoạn mã (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
Tham số (exportdata-env)
Tham số | Description |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ cho môi trường mà bạn muốn xuất dữ liệu từ đó (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
SchemaFile Tên tệp XML lược đồ |
Tên tệp XML lược đồ. Nó có thể được tạo bằng công cụ Di chuyển cấu hình. |
DataFile Tên tệp dữ liệu |
Tên file cần xuất dữ liệu (file zip). |
Overwrite Ghi đè nội dung |
Power Pages nội dung trang web cần ghi đè (đúng|sai). |
Nhập Dataverse Dữ liệu
Nhập dữ liệu vào một môi trường.
YAML đoạn mã (nhập dữ liệu-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'
Tham số (importdata-env)
Tham số | Description |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ cho môi trường mà bạn muốn nhập dữ liệu (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
DataFile Tên tệp dữ liệu |
Tên tệp cho tệp dữ liệu zip) cần nhập hoặc thư mục có data-schema.xml và data.xml sẽ được nhập. |
Power Pages nhiệm vụ quản lý
Nhiệm vụ khi làm việc với một Power Pages trang web.
Power Platform Tải xuống PAPortal
Tải nội dung trang web Power Pages xuống từ môi trường Dataverse hiện tại.
YAML đoạn mã (tải xuống-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
Các thông số (download-paportal)
Tham số | Description |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ cho môi trường mà bạn muốn tải xuống nội dung từ đó (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
WebsiteId ID trang web cổng thông tin |
Power Pages ID trang web để tải xuống. |
Overwrite Ghi đè nội dung |
Power Pages nội dung trang web cần ghi đè (đúng|sai). |
ModelVersion Mô hình dữ liệu trang web |
Cho biết liệu dữ liệu trang web được tải lên sẽ sử dụng mô hình dữ liệu tiêu chuẩn (1 ) hay nâng cao (2 ). Giá trị mặc định là '1'. |
Power Platform Tải lên PAPortal
Tải Power Pages nội dung trang web lên môi trường Dataverse hiện tại.
YAML đoạn mã (tải lên-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'
Các tham số (tải lên-paportal)
Tham số | Description |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ cho môi trường mà bạn muốn tải nội dung lên (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
UploadPath Đường dẫn nội dung tải lên |
Đường dẫn nơi nội dung trang web Power Pages sẽ được tải lên. |
ModelVersion Mô hình dữ liệu trang web |
Cho biết liệu dữ liệu trang web được tải lên sẽ sử dụng mô hình dữ liệu tiêu chuẩn (1 ) hay nâng cao (2 ). Giá trị mặc định là '1'. |
Danh mục nhiệm vụ Power Platform (xem trước)
Các tác vụ này thực hiện các hành động đối với danh mục trong Power Platform và bao gồm các tác vụ sau.
Lưu ý
Hiện tại, các tác vụ danh mục dành cho Power Platform là bản phát hành xem trước .
Cài đặt mục danh mục
Cài đặt một mục danh mục vào môi trường đích.
Tham số | Description |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ cho môi trường mà bạn muốn tải nội dung lên (ví dụ: https://powerappsbuildtools.crm.dynamics.com ). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
Environment URL môi trường đích |
(Bắt buộc) Url môi trường mà nhiệm vụ này nhắm mục tiêu. |
CatalogItemId ID mục danh mục sẽ được cài đặt |
(Bắt buộc) Mục danh mục phải được cài đặt trên môi trường đích. |
TargetEnvironmentUrl URL môi trường đích |
(Bắt buộc) Url của môi trường đích để cài đặt mục danh mục vào (ví dụ: "https://YourOrg.crm.dynamics.com"). |
PollStatus Kiểm tra trạng thái cuộc thăm dò ý kiến |
(Tùy chọn) Thăm dò ý kiến để kiểm tra trạng thái yêu cầu của bạn (true|false). |
Các thông số (cài đặt danh mục)
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
Gửi phê duyệt danh mục
Gửi yêu cầu phê duyệt danh mục.
Tham số | Description |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ cho môi trường mà bạn muốn tải nội dung lên (ví dụ: "https://powerappsbuildtools.crm.dynamics.com"). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
Environment URL môi trường đích |
(Bắt buộc) Url môi trường mà nhiệm vụ này nhắm mục tiêu. |
CatalogSubmissionFile File gửi catalog |
(Bắt buộc) Chỉ định đường dẫn và tên file của file gửi catalog. |
UsePackageSolutionZipFile Loại tệp |
Loại tệp: tệp zip gói hoặc giải pháp. |
SolutionZipFile Tên tệp zip giải pháp |
Chỉ định đường dẫn và tên tệp của tệp zip giải pháp. |
PollStatus Kiểm tra trạng thái cuộc thăm dò ý kiến |
(Tùy chọn) Thăm dò ý kiến để kiểm tra trạng thái yêu cầu của bạn (true|false). |
Các thông số (gửi danh mục)
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
Trạng thái yêu cầu danh mục
Nhận trạng thái của yêu cầu cài đặt/gửi danh mục.
Tham số | Description |
---|---|
authenticationType Loại xác thực |
(Yêu cầu cho SPN) Chỉ định một trong hai PowerPlatformEnvironment cho kết nối tên người dùng/mật khẩu hoặc PowerPlatformSPN cho một kết nối Dịch vụ chính/mã bí mật máy khách. |
PowerPlatformSPN Tên dịch vụ chính Power Platform |
Điểm cuối dịch vụ cho môi trường mà bạn muốn tải nội dung lên (ví dụ: "https://powerappsbuildtools.crm.dynamics.com"). Được xác định trong phần Kết nối dịch vụ trong Thiết lập dự án sử dụng kiểu kết nối Power Platform. |
Environment URL môi trường đích |
(Bắt buộc) Url môi trường mà nhiệm vụ này nhắm mục tiêu. |
TrackingId Yêu cầu ID theo dõi |
(Bắt buộc) Yêu cầu ID theo dõi. |
RequestType Loại yêu cầu |
(Bắt buộc) Loại yêu cầu. (Giá trị: Cài đặt | Gửi). |
Các thông số (danh mục-trạng thái)
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
Xây dựng và phát hành quy trình
Bây giờ chúng tôi đã xác định những gì có thể được thực hiện bằng các công cụ xây dựng, hãy xem cách bạn có thể áp dụng các công cụ này cho các quy trình xây dựng và phát hành của mình. Một tổng quan về khái niệm được hiển thị dưới đây. Chúng ta hãy xem một số chi tiết về việc triển khai quy trình bằng cách sử dụng các nhiệm vụ của công cụ xây dựng trong các phần phụ tiếp theo.
Để tìm hiểu thêm về cách tạo các quy trình này và thực sự thực hiện việc tạo quy trình bằng cách sử dụng Công cụ xây dựng Microsoft Power Platform, hãy hoàn thành phòng thí nghiệm công cụ mà bạn có thể tải xuống từ GitHub.
Thông tin thêm về Quy trình Azure: Sử dụng Quy trình Azure
Xây dựng quy trình: Xuất một giải pháp từ môi trường phát triển (DEV)
Hình dưới đây cho thấy các tác vụ của công cụ xây dựng mà bạn có thể thêm vào một quy trình sẽ xuất giải pháp từ môi trường phát triển.
Xây dựng quy trình: Xây dựng giải pháp được quản lý
Hình dưới đây cho thấy các tác vụ của công cụ xây dựng mà bạn có thể thêm vào một quy trình sẽ xây dựng giải pháp được quản lý.
Quy trình phát hành: Triển khai đến môi trường sản xuất (SẢN XUẤT)
Hình dưới đây cho thấy các tác vụ của công cụ xây dựng mà bạn có thể thêm vào một quy trình sẽ triển khai môi trường sản xuất.
Xem thêm
Phản hồi
https://aka.ms/ContentUserFeedback.
Sắp ra mắt: Trong năm 2024, chúng tôi sẽ dần gỡ bỏ Sự cố với GitHub dưới dạng cơ chế phản hồi cho nội dung và thay thế bằng hệ thống phản hồi mới. Để biết thêm thông tin, hãy xem:Gửi và xem ý kiến phản hồi dành cho