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ường

Lư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 UseDefaultPACheckerEndpointfalse. 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:
  • Trình kiểm tra giải pháp: Bộ quy tắc này giống với bộ quy tắc được chạy từ Power Apps cổng của nhà sản xuất.
  • AppSource: Bộ quy tắc mở rộng được sử dụng để chứng nhận một ứng dụng trước khi nó có thể được xuất bản lên AppSource.
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ự độ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@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ý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ý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.

Chỉ có thể cấp phép môi trường mới nếu giấy phép hoặc dung lượng của bạn cho phép tạo ra các môi trường bổ sung. Để 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@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ử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.

Xuất giải pháp từ môi trường phát triển (DEV).

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

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.

Triển khai đến môi trường sản xuất (PROD).

Xem thêm

Microsoft Power Platform Build Tools cho Azure DevOps