Ghi
Quyền truy cập vào trang này yêu cầu sự cho phép. Bạn có thể thử đăng nhập hoặc thay đổi thư mục.
Quyền truy cập vào trang này yêu cầu sự cho phép. Bạn có thể thử thay đổi thư mục.
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ề Azure Pipelines 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 xuống, hãy xem Microsoft Power Platform Công cụ xây dựng cho Azure Pipelines.
Nhiệm vụ trình trợ giúp
Các tác vụ trợ giúp có sẵn sẽ được mô tả ở phần sau.
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. Nhiệm vụ này không yêu cầu bất kỳ cấu hình nào khi được thêm vào. Nhiệm 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@2
displayName: 'Power Platform Tool Installer'
# Installs default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
displayName: 'Power Platform Tool Installer'
inputs:
AddToolsToPath: true
# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
displayName: 'Power Platform Tool Installer'
inputs:
DefaultVersion: false
XrmToolingPackageDeploymentVersion: 3.3.0.928
Tham số (Trình thiết đặt)
| Tham số | Mô tả |
|---|---|
DefaultVersionSử 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. |
AddToolsToPathThêm công cụ vào đường dẫn |
Thêm pac cli vào PATH biến môi trường. Cho phép bạn sử dụng pac cli từ các tác vụ tập lệnh mà không cần thiết lập đường dẫn theo cách thủ công. |
PowerAppsAdminVersionXrmToolingPackageDeploymentVersionMicrosoftPowerAppsCheckerVersionCrmSdkCoreToolsVersionPhiên bản công cụ |
Phiên bản cụ thể của công cụ để sử dụng. |
Nền tảng năng lượng 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@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'
Tham số (WhoAmI)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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 |
PowerPlatformEnvironmentURL 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 |
PowerPlatformSPNTê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 cung cấp các nhiệm vụ có sẵn để kiểm tra chất lượng của giải pháp.
Trình kiểm tra Power Platform
Nhiệm vụ này sẽ chạy kiểm tra phân tích tĩnh đối với các giải pháp của bạn theo một bộ quy tắc thực hành tốt nhất để xác định bất kỳ mô hình có 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@2
displayName: 'Power Platform Checker '
inputs:
PowerPlatformSPN: 'Dataverse service connection'
RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'
# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@2
displayName: 'Power Platform Checker '
inputs:
PowerPlatformSPN: 'Dataverse service connection'
UseDefaultPACheckerEndpoint: false
CustomPACheckerEndpoint: 'https://japan.api.advisor.powerapps.com/'
FileLocation: sasUriFile
FilesToAnalyzeSasUri: 'SAS URI'
FilesToAnalyze: '**\*.zip'
FilesToExclude: '**\*.tzip'
RulesToOverride: 'JSON array'
RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'
Tham số (Trình kiểm tra)
| Tham số | Mô tả |
|---|---|
PowerPlatformSPNKế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. Để biết thêm thông tin: hãy xem BuildTools.EnvironmentUrl trong Power Platform Tạo môi trườngLưu ý: Các phương pháp xác thực tên người dùng/mật khẩu và Nguyên tắc dịch vụ 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. |
UseDefaultPACheckerEndpointSử dụng điểm cuối của Trình kiểm tra Power Platform mặc định |
Theo mặc định (đúng), 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 địa lý khả dụng, hãy xem Sử dụng Power Platform Checker API. |
FileLocationVị trí của các tập tin để phân tích |
Bắt buộc khi tham chiếu tệp từ URL chữ ký truy cập được chia sẻ (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ý. |
FilesToAnalyzeSasUriTệ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 (;). |
FilesToAnalyzeTệp cục bộ để phân tích |
Cần thiết khi các 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ụ, nhập **\*.zip cho tất cả các tệp zip trong tất cả các thư mục con. |
FilesToExcludeTệ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 |
RulesToOverrideQuy 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"}] |
RuleSetBộ 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:
|
ErrorLevelMứ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. |
ErrorThresholdNgưỡ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. |
FailOnPowerAppsCheckerAnalysisErrorLỗ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. |
ArtifactDestinationNameTên thành phần lạ DevOps |
Chỉ định tên Azure Artifacts cho tệp kiểm tra .sarif. |
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 đè lên các kết nối dịch vụ với môi trường mới được tạo. Các tác vụ này giúp thực hiện các tác vụ giải pháp đối với 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@2
displayName: 'Power Platform Import Solution '
inputs:
PowerPlatformEnvironment: 'My service connection'
SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
HoldingSolution: true
OverwriteUnmanagedCustomizations: true
SkipProductUpdateDependencies: true
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
displayName: 'Power Platform Import Solution '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
AsyncOperation: true
MaxAsyncWaitTime: 60
PublishWorkflows: false
Tham số (Nhập)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformEnvironmentURL 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 |
PowerPlatformSPNTê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 |
SolutionInputFileTệ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 ý: Biến cung cấp cho bạn một cách thuận tiện để đưa các bit dữ liệu quan trọng vào nhiều phần khác nhau trong quy trình của bạn. Xem Sử dụng các biến được xác định trước cho một danh sách toàn diện. |
HoldingSolutionNhậ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. |
OverwriteUnmanagedCustomizationsGhi đè 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). |
SkipProductUpdateDependenciesBỏ 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). |
ConvertToManagedChuyển đổi thành được quản lý |
Đã lỗi thời. Hệ thống sẽ chuyển đổi các thành phần giải pháp không được quản lý thành được quản lý khi bạn nhập một giải pháp được quản lý. |
AsyncOperationNhậ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). |
MaxAsyncWaitTimeThờ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ụ. |
PublishWorkflowsKí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). |
UseDeploymentSettingsFileSử 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). |
DeploymentSettingsFileTệ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ý.
Đoạn mã YAML (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
Tham số (Thêm)
| Tham số | Mô tả |
|---|---|
ComponentIdID 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. |
ComponentTypeURL môi trường Power Platform |
Giá trị biểu thị thành phần giải pháp mà bạn đang thêm vào. 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. |
SolutionUniqueNameTên giải pháp |
Tên duy nhất của giải pháp. |
AddRequiredComponentsBất kỳ thành phần nào đượ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) Chỉ ra liệu các thành phần giải pháp khác mà thành phần giải pháp bạn đang thêm vào có cần được thêm vào giải pháp không được quản lý hay không. |
EnvironmentURL 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 mục tiêu. |
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@2
displayName: 'Power Platform Apply Solution Upgrade '
inputs:
PowerPlatformEnvironment: 'My service connection'
SolutionName: 'Contoso_sample'
AsyncOperation: false
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@2
displayName: 'Power Platform Apply Solution Upgrade '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
MaxAsyncWaitTime: 45
Tham số (Nâng cấp)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformEnvironmentURL 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 thà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 |
PowerPlatformSPNTê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 thà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 |
SolutionNameTê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ị. |
AsyncOperationNâ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. |
MaxAsyncWaitTimeThờ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ự động
Xuấ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@2
displayName: 'Power Platform Export Solution '
inputs:
PowerPlatformEnvironment: 'My service connection'
SolutionName: 'Contoso_sample'
SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
Managed: true
MaxAsyncWaitTime: 120
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@2
displayName: 'Power Platform Export Solution '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
Managed: true
MaxAsyncWaitTime: 120
ExportAutoNumberingSettings: true
ExportCalendarSettings: true
ExportCustomizationSettings: true
ExportEmailTrackingSettings: true
ExportGeneralSettings: true
ExportIsvConfig: true
ExportMarketingSettings: true
ExportOutlookSynchronizationSettings: true
ExportRelationshipRoles: true
ExportSales: true
Tham số (Xuất)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformEnvironmentURL 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 thà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 |
PowerPlatformSPNTê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 thà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 |
SolutionNameTê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ị. |
SolutionOutputFileTệ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 tới (ví dụ: $(Build.ArtifactStagingDirectory)$(SolutionName).zip ).
Lưu ý: Biến cung cấp cho bạn một cách thuận tiện để đưa các bit dữ liệu quan trọng vào nhiều phần khác nhau trong quy trình của bạn. Xem Sử dụng các biến được xác định trước cho một danh sách toàn diện. |
AsyncOperationXuấ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. |
MaxAsyncWaitTimeThờ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ụ. |
ManagedXuấ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ý. |
ExportAutoNumberingSettingsXuất thiết đặt đánh số tự động |
Xuất thiết đặt đánh số tự động (true|false). |
ExportCalendarSettingsXuất thiết đặt lịch |
Xuất thiết đặt lịch (true|false). |
ExportCustomizationSettingsXuất thiết đặt tùy chỉnh |
Xuất thiết đặt tùy chỉnh (true|false). |
ExportEmailTrackingSettingsXuất thiết đặt theo dõi email |
Xuất thiết đặt theo dõi email (true|false). |
ExportGeneralSettingsXuất thiết đặt chung |
Xuất thiết đặt chung (true|false). |
ExportIsvConfigXuất cấu hình ISV |
Xuất cấu hình ISV (true|false). |
ExportMarketingSettingsXuất thiết đặt tiếp thị |
Xuất thiết đặt tiếp thị (true|false). |
ExportOutlookSynchronizationSettingsXuất thiết đặt đồng bộ hóa Outlook |
Xuất thiết đặt đồng bộ hóa Outlook (true|false). |
ExportRelationshipRolesXuất vai trò của mối quan hệ |
Xuất vai trò của mối quan hệ (true|false). |
ExportSalesXuấ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@2
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ả |
|---|---|
SolutionInputFileTệ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. |
SolutionTargetFolderThư 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. |
SolutionTypeLoạ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@2
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ả |
|---|---|
SolutionOutputFileTệ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. |
SolutionSourceFolderThư 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. |
SolutionTypeLoạ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@2
displayName: 'Power Platform Delete Solution '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
Tham số (Xóa)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformEnvironmentURL 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 |
PowerPlatformSPNTê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 |
SolutionNameTê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@2
displayName: 'Power Platform Publish Customizations '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
Tham số (Phát hành)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformEnvironmentURL 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 |
PowerPlatformSPNTê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@2
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ả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformEnvironmentURL 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 |
PowerPlatformSPNTê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 |
SolutionNameTê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ị. |
SolutionVersionNumberSố 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 PowerPlatformSetConnectionVariables.BuildTools.* các biến để cung cấp quyền truy cập 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 tin cậy duy nhất.
Các biến sau được thiết lập:
PowerPlatformSetConnectionVariables.BuildTools.TenantIdPowerPlatformSetConnectionVariables.BuildTools.ApplicationIdPowerPlatformSetConnectionVariables.BuildTools.ClientSecretPowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString
Đoạn mã YAML (SetConnectionVariables)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-connection-variables.PowerPlatformSetConnectionVariables@2
displayName: 'Power Platform Set Connection Variables '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
timeoutInMinutes: 2
retryCountOnTaskFailure: 5
Tham số (SetConnectionVariables)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformSPNTê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 |
timeoutInMinutesThờ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 hiện trước khi bị máy chủ hủy. Giá trị bằng không biểu thị thời gian chờ vô hạn. |
retryCountOnTaskFailureSố lần thử lại nếu nhiệm vụ không thành công |
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ụ thất bại. Không được hỗ trợ cho các tác vụ không có tác nhân. |
ApplicationIdID ứng dụng để đăng nhập |
(Cần có 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). |
RedirectUriChuyển hướng URI của ứng dụng cụ thể |
(Cần thiết cho tên người dùng/mật khẩu) Chuyển hướng URI của ứng dụng đã chỉ định. Cần thiết khi chỉ định ID ứng dụng. (Xem ghi chú bổ sung 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, sẽ cần có ID ứng dụng và Uri chuyển hướng. Tài liệu xác thực oauth này 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 cho 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@2
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ả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformEnvironmentURL 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 |
PowerPlatformSPNTê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 |
PackageFileTệ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). |
MaxAsyncWaitTimeThờ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.
Bạn chỉ có thể cung cấp môi trường mới nếu giấy phép hoặc năng lực của bạn cho phép tạo thêm môi trường. Để biết thêm thông tin về cách xem dung lượng, xem Chi tiết trang dung lượng.
Đoạn mã YAML (Tạo-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@2
displayName: 'Power Platform Create Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
DisplayName: 'First Coffee test'
DomainName: firstcoffee
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@2
displayName: 'Power Platform Create Environment '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
DisplayName: 'First Coffee prod'
EnvironmentSku: Production
AppsTemplate: 'D365_CustomerService,D365_FieldService'
LocationName: canada
LanguageName: 1036
CurrencyName: ALL
DomainName: firstcoffee
Tham số (Tạo-env)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformEnvironmentURL 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. |
PowerPlatformSPNTê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. |
DisplayNameTên hiển thị |
(Bắt buộc) Tên hiển thị của môi trường đã được tạo. |
LocationNameKhu vực triển khai |
(Bắt buộc) Vùng mà môi trường nên được tạo vào. |
EnvironmentSkuLoạ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. |
CurrencyNameTiề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. |
LanguageNameNgôn ngữ |
(Bắt buộc) Ngôn ngữ cơ sở trong môi trường. |
DomainNameTê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 tên miền đã được sử dụng, tác vụ sẽ thêm một giá trị số vào tên miền, bắt đầu từ 0. Đối với ví dụ trên, URL có thể trở thành |
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@2
displayName: 'Power Platform Delete Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
Tham số (Xóa-env)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformEnvironmentURL 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. |
PowerPlatformSPNTê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 mục tiêu với vai trò bảo mật được chỉ định.
Đoạn mã YAML (AssignUser-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.assign-user.PowerPlatformAssignUser@2
displayName: 'Power Platform Assign User '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
User: EnvironmentUsername
Role: 'Environment Maker'
ApplicationUser: true
Tham số (AssignUser-env)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformSPNTê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. |
UserPower Platform tên người dùng |
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 mục tiêu. |
RoleTên hoặc ID vai trò bảo mật |
Tên hoặc ID vai trò bảo mật sẽ được chỉ định cho người dùng. |
ApplicationUserPower 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 (đúng | sai). |
Power Platform Thiết lập lại môi trường
Thiết lập lại môi trường.
Đoạn mã YAML (Reset-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.reset-environment.PowerPlatformResetEnvironment@2
displayName: 'Power Platform Reset Environment '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
CurrencyName: ALL
Purpose: 'Reset to PointInTime'
AppsTemplate: 'D365_CustomerService,D365_FieldService'
Tham số (Reset-env)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformEnvironmentURL 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. |
PowerPlatformSPNTê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@2
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ả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformEnvironmentURL 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. |
PowerPlatformSPNTê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. |
BackupLabelNhã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@2
displayName: 'Power Platform Copy Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@2
displayName: 'Power Platform Copy Environment '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
CopyType: MinimalCopy
OverrideFriendlyName: true
FriendlyName: 'Contoso Test'
SkipAuditData: true
MaxAsyncWaitTime: 60
Tham số (Sao chép-env)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformEnvironmentURL 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. |
PowerPlatformSPNTê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. |
TargetEnvironmentUrlURL 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. |
CopyTypeLoại sao chép |
Loại bản sao để thực hiện: FullCopy hoặc MinimalCopy |
OverrideFriendlyNameGhi đè 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). |
FriendlyNameTên dễ nhớ |
Tên thân thiện của môi trường đích. |
SkipAuditDataBỏ quaKiểm toánDữ liệu |
Có nên bỏ qua dữ liệu kiểm tra trong quá trình sao chép hay không. (đúng|sai). |
MaxAsyncWaitTimeThờ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ụ. |
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.
Đoạn mã YAML (Restore-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.restore-environment.PowerPlatformRestoreEnvironment@2
displayName: 'Power Platform Restore Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
RestoreLatestBackup: false
RestoreTimeStamp: '12/01/2022 09:00'
FriendlyName: 'Contoso Test'
Tham số (Restore-env)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformEnvironmentURL 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. |
PowerPlatformSPNTê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. |
RestoreLatestBackupSao lưu mới nhất để khôi phục |
Có nên khôi phục bản sao lưu mới nhất hay cung cấp RestoreTimeStamp (đúng|sai). |
RestoreTimeStampNgà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". |
TargetEnvironmentUrlURL 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. |
FriendlyNameTên của môi trường được phục hồi |
(Tùy chọn) Tên của môi trường được khôi phục. |
DisableAdminModeTắt chế độ quản trị |
Liệu có tắt chế độ quản trị hay không (true|false). |
Xuất dữ liệu Dataverse
Xuất dữ liệu từ môi trường có lược đồ được cung cấp.
Đoạn mã YAML (exportdata-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-data.PowerPlatformExportData@2
displayName: 'Power Platform Export Data '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
SchemaFile: 'C:\tempschema.xml'
DataFile: exportdata.zip
Overwrite: true
Tham số (exportdata-env)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformSPNTê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. |
SchemaFileTên tệp XML của lược đồ |
Tên tệp XML của lược đồ. Có thể tạo bằng công cụ Configuration Migration. |
DataFileTên tập tin dữ liệu |
Tên tệp dữ liệu cần xuất (tệp zip). |
OverwriteGhi đè 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ôi trường.
Đoạn mã YAML (importdata-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-data.PowerPlatformImportData@2
displayName: 'Power Platform Import Data '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
DataFile: 'C:\Data\Import.zip'
Tham số (importdata-env)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformSPNTê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. |
DataFileTên tập tin dữ liệu |
Tên tệp cho tệp dữ liệu nén zip cần nhập hoặc thư mục có chứa data-schema.xml và data.xml cần nhập. |
Power Pages nhiệm vụ quản lý
Các nhiệm vụ khi làm việc với một trang web. Power Pages
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.
Đoạn mã YAML (download-paportal)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.download-paportal.PowerPlatformDownloadPaportal@2
displayName: 'Power Platform Download PAPortal '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
DownloadPath: 'C:\portals'
WebsiteId: 'f88b70cc-580b-4f1a-87c3-41debefeb902'
Overwrite: true
Tham số (download-paportal)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformSPNTê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. |
WebsiteIdID trang web cổng thông tin |
Power Pages ID trang web để tải xuống. |
OverwriteGhi đè nội dung |
Power Pages nội dung trang web cần ghi đè (đúng|sai). |
ModelVersionMô hình dữ liệu trang web |
Chỉ ra liệu dữ liệu trang web được tải lên sẽ sử dụng mô hình dữ liệu chuẩn (1) hay mô hình dữ liệu nâng cao ( ).2 Giá trị mặc định là '1'. |
Power Platform Tải lên PAPortal
Tải nội dung trang web lên môi trường hiện tại. Power Pages Dataverse
Đoạn mã YAML (upload-paportal)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.upload-paportal.PowerPlatformUploadPaportal@2
displayName: 'Power Platform Upload PAPortal '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
UploadPath: 'C:\portals\starter-portal'
Tham số (upload-paportal)
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformSPNTê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. |
UploadPathTải lên đường dẫn nội dung |
Đường dẫn nơi nội dung trang web sẽ được tải lên. Power Pages |
ModelVersionMô hình dữ liệu trang web |
Chỉ ra liệu dữ liệu trang web được tải lên sẽ sử dụng mô hình dữ liệu chuẩn (1) hay mô hình dữ liệu nâng cao ( ).2 Giá trị mặc định là '1'. |
Danh mục cho Power Platform nhiệm vụ (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 mục sau.
Lưu ý
Hiện tại, các tác vụ trong danh mục 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ố | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformSPNTê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. |
EnvironmentURL môi trường đích |
(Bắt buộc) URL môi trường mà nhiệm vụ này nhắm tới. |
CatalogItemIdID mục danh mục cần cài đặt |
(Bắt buộc) Mục danh mục cần cài đặt trên môi trường mục tiêu. |
TargetEnvironmentUrlURL 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"). |
PollStatusKiểm tra trạng thái thăm dò |
(Tùy chọn) Khảo sát để kiểm tra trạng thái yêu cầu của bạn (đúng | sai). |
Tham số (catalog-install)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.install-catalog.PowerPlatformInstallCatalog@2
displayName: 'Power Platform Install Catalog '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
Environment: '$(BuildTools.EnvironmentUrl)'
CatalogItemId: '00000000-0000-0000-0000-000000000001'
TargetEnvironmentUrl: 'https://test.crm.dynamics.com/'
PollStatus: true
Nộp phê duyệt danh mục
Gửi yêu cầu phê duyệt danh mục.
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformSPNTê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. |
EnvironmentURL môi trường đích |
(Bắt buộc) URL môi trường mà nhiệm vụ này nhắm tới. |
CatalogSubmissionFileTệp gửi danh mục |
(Bắt buộc) Chỉ định đường dẫn và tên tệp của tệp gửi danh mục. |
UsePackageSolutionZipFileLoại tệp |
Loại tệp: tệp zip gói hoặc giải pháp. |
SolutionZipFileTê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. |
PollStatusKiểm tra trạng thái thăm dò |
(Tùy chọn) Khảo sát để kiểm tra trạng thái yêu cầu của bạn (đúng | sai). |
Tham số (catalog-submit)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.submit-catalog.PowerPlatformSubmitCatalog@2
displayName: 'Power Platform Submit Catalog '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
Environment: '$(BuildTools.EnvironmentUrl)'
CatalogSubmissionFile: submission.json
UsePackageSolutionZipFile: true
FileType: SolutionZipFile
SolutionZipFile: solution.zip
PollStatus: true
Trạng thái yêu cầu danh mục
Nhận trạng thái cài đặt/gửi yêu cầu danh mục.
| Tham số | Mô tả |
|---|---|
authenticationTypeLoạ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. |
PowerPlatformSPNTê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. |
EnvironmentURL môi trường đích |
(Bắt buộc) URL môi trường mà nhiệm vụ này nhắm tới. |
TrackingIdYêu cầu ID theo dõi |
(Bắt buộc) Yêu cầu ID theo dõi. |
RequestTypeLoại yêu cầu |
(Bắt buộc) Loại yêu cầu. (Giá trị: Cài đặt | Gửi). |
Tham số (trạng thái danh mục)
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ề Azure Pipelines: Sử dụng Azure Pipelines
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.