Microsoft Power Platform ビルド ツール タスク

次のセクションでは、実行可能な構築タスクについて説明します。 その後、これらのタスクを利用した Azure Pipelines の例を紹介します。 ビルド ツールとそのダウンロード方法については、Azure Pipelines 用 Microsoft Power Platform ビルドツール を参照してください。

ヘルパー タスク

利用可能なヘルパー タスクを次に示します。

Power Platform ツール インストーラー

このタスクは、ビルドおよびリリース パイプライン内の他の Power Platform Build Tools タスクの前に一度追加する必要があります。 このタスクは、エージェントが Microsoft Power Platform ビルド タスクを実行するために必要な、Power Platform 専用のツール一式をインストールします。 このタスクには、追加の構成は不要です。 このタスクには、インストールされる各ツールの特定のバージョン用のパラメー タが含まれます。

ツールのバージョンを常に最新の状態に保つには、これらのパラメーターが、パイプラインを適切に実行するために必要なツールのバージョンに対応していることを確認してください。

YAML スニペット (インストーラー)

# 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

パラメーター (インストーラー)

Power Platform WhoAmI

Power Platform 環境のサービス接続を、接続して WhoAmI リクエストを発行することで検証します。 このタスクは、パイプラインの早期に含めて、処理を開始する前に接続を確認する場合に便利です。

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'

パラメーター（WhoAmI）

品質チェック

次のセクションは、ソリューションの品質をチェックするために利用可能なタスクです。

Power Platform チェッカー

このタスクは、一連の最良の規則に対してソリューションの静的分析チェックを実行し、ソリューションの構築時に誤って導入した可能性のある問題パターンを特定します。

YAML スニペット (チェッカー)

# 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'

パラメーター (チェッカー)

ソリューション タスク

この一連のタスクにより、ソリューション アクションを自動化できます。 このセクションで後述する環境の作成、コピー、または復元を行う環境タスクは、新しく作成された環境とのサービス接続を上書きします。 これらのタスクにより、オンデマンドで作成された環境に対してソリューション タスクを実行できます。

Power Platform インポート ソリューション

ソリューションをターゲット環境にインポートします。

YAML スニペット (インポート)

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

パラメーター (インポート)

Power Platform ソリューション コンポーネントの追加

ソリューション コンポーネントをアンマネージド ソリューションに追加します。

YAML スニペット (追加)

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

パラメーター (追加)

Power Platform 適用ソリューションのアップグレード

保持ソリューションとしてインポートされたソリューションをアップグレードします。

YAML スニペット (アップグレード)

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

パラメーター (アップグレード)

Power Platform エクスポート ソリューション

ソース環境からソリューションをエクスポートします。

YAML スニペット (エクスポート)

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

パラメーター (エクスポート)

Power Platform アンパック ソリューション

圧縮されたソリューション ファイルを複数の XML ファイルに分解することで、これらのファイルをより簡単に読み取り、ソース管理システムで管理できるようにします。

YAML スニペット (アンパック)

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

パラメーター (アンパック)

Power Platform パック ソリューション

ソース コントロールに表示されているソリューションを solution.zip へと圧縮すると、このファイルを、他の環境へとインポートすることができます。

YAML スニペット (パック)

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

パラメーター (パック)

Power Platform 削除ソリューション

対象の環境でソリューションを削除します。

YAML スニペット (削除)

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'

パラメーター (削除)

Power Platform カスタマイズの公開

環境内のすべてのカスタマイズを公開します。

YAML スニペット (公開)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.publish-customizations.PowerPlatformPublishCustomizations@2
  displayName: 'Power Platform Publish Customizations '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '

パラメーター (公開)

Power Platform セット ソリューション バージョン

ソリューションのバージョンを更新します。

YAML スニペット (バージョン)

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

パラメーター (バージョン)

バージョン番号はパイプラインにハードコードすることも可能ですが、Azure DevOps パイプライン変数 (例: BuildId) の使用が推奨されます。 これにより、[オプション] タブでバージョン番号の正確な形状を定義するオプションが提供されます 例: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

この定義は、バージョン番号プロパティをハードコーディング 20200824.0.0.2 の代わりに $(Build.BuildId) で設定することにより、[ソリューション バージョンの設定] タスクで使用できます。

または、SolutionVersion という名前の空の変数が Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version") に、「ソリューション バージョンの設定」が $(SolutionVersion) に設定された PowerShell インライン タスク スクリプト $(Get-Date -Format yyyy.MM.dd.HHmm) 出力。

Power Platform による接続変数の設定

PowerPlatformSetConnectionVariables.BuildTools.*変数を設定して、サービス接続を信頼できる単一のソースとして使用するためのカスタム スクリプト タスクアクセスを提供します。

次の変数が設定されます。

• PowerPlatformSetConnectionVariables.BuildTools.TenantId
• PowerPlatformSetConnectionVariables.BuildTools.ApplicationId
• PowerPlatformSetConnectionVariables.BuildTools.ClientSecret
• PowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString

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

パラメータ (SetConnectionVariables)

Power Platform 展開パッケージ

パッケージを環境に展開します。 単一のソリューション ファイルではなくパッケージを展開することで、複数のソリューション、データ、およびコードを環境に展開することができます。

YAML スニペット (デプロイ)

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

パラメーター (デプロイ)

環境管理のタスク

一般的な Environment Lifecycle Management (ELM) タスクを自動化します。

Power Platform 環境の作成

新しい環境を作成します。 新しい環境を作成すると、BuildTools.EnvironmentUrl が自動的に作成されます。

YAML スニペット (Create-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@2
  displayName: 'Power Platform Create Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    DisplayName: 'First Coffee test'
    DomainName: firstcoffee

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@2
  displayName: 'Power Platform Create Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    DisplayName: 'First Coffee prod'
    EnvironmentSku: Production
    AppsTemplate: 'D365_CustomerService,D365_FieldService'
    LocationName: canada
    LanguageName: 1036
    CurrencyName: ALL
    DomainName: firstcoffee

パラメーター (Create-env)

Power Platform 削除環境

環境を削除します。

YAML スニペット (Delete-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@2
  displayName: 'Power Platform Delete Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'

パラメーター (Delete-env)

Power Platform 割り当てユーザー

指定したセキュリティ ロールを持つターゲット環境にユーザーを割り当てます。

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

パラメーター (AssignUser-env)

Power Platform 環境のリセット

環境のリセット。

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'

パラメーター (Reset-env)

Power Platform 環境のバックアップ

環境をバックアップします。

YAML スニペット (Backup-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.backup-environment.PowerPlatformBackupEnvironment@2
  displayName: 'Power Platform Backup Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    BackupLabel: 'Full backup - $(Build.BuildNumber)'

パラメーター (Backup-env)

Power Platform 環境のコピー

環境を対象の環境にコピーします。 次の2つの種類のコピーを利用できます : 完全コピー、最小コピー。 完全 コピーではデータとソリューションのメタデータ (カスタマイズ) の両方がコピーされますが、最小 コピーではソリューションのメタデータのみがコピーされ、実際のデータはコピーされません。

YAML スニペット (Copy-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@2
  displayName: 'Power Platform Copy Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@2
  displayName: 'Power Platform Copy Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    CopyType: MinimalCopy
    OverrideFriendlyName: true
    FriendlyName: 'Contoso Test'
    SkipAuditData: true
    MaxAsyncWaitTime: 60

パラメーター (Copy-env)

Power Platform 環境の復元

指定されたバックアップに環境を復元します。

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'

パラメーター (Restore-env)

Dataverse データのエクスポート

指定されたスキーマを使用して環境からデータをエクスポートします。

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

パラメーター (exportdata-env)

Dataverse データのインポート

データを環境にインポートします。

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'

パラメーター (importdata-env)

Power Pages Management タスク

Power Pages web サイトを操作するタスク。

Power Platform ダウンロード PAPortal

現在の Dataverse 環境から Power Pages Web サイトのコンテンツをダウンロードします。

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

パラメーター (download-paportal)

Power Platform アップロード PAPortal

現在の Dataverse 環境に Power Pages Web サイトのコンテンツをアップロードします。

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'

パラメーター (upload-paportal)

Power Platform タスクのカタログ (プレビュー)

これらのタスクは Power Platform のカタログに対して操作を実行し、以下の内容を含みます。

カタログ アイテムのインストール

ターゲット環境に Catalog の項目をインストールします。

パラメーター (カタログ インストール)

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

カタログ承認の送信

Catalog 承認要求を送信します。

パラメーター (カタログ送信)

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

カタログ要求の状態

カタログのインストール/送信リクエストの状態を取得します。

パラメーター (カタログの状態)

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

パイプラインを構築してリリースする

構築ツールを使用して何ができるかがわかったところで、これらのツールを構築およびリリース パイプラインに適用する方法を見てみましょう。 概念的な概要を以下に示します。 次のサブセクションで、ツール構成タスクを使用したパイプライン実装の詳細を案内します。

これらのパイプラインの作成についてさらに学習し、Microsoft Power Platform Build Tools を実際に使用してパイプライン作成を実践するには、GitHub からダウンロードできるビルドツール ラボを完了してください。

Azure Pipelines パイプラインの詳細については、Azure Pipelines を使用する を参照してください

パイプラインの構築: 開発環境 (DEV) からソリューションをエクスポートする

次の図は、開発環境からソリューションをエクスポートするパイプラインに追加できる構築ツール タスクを示しています。

パイプラインの構築: マネージド ソリューションを構築する

次の図は、マネージド ソリューションを構築するパイプラインに追加できる構築ツール タスクを示しています。

リリース パイプライン: 運用環境 (PROD) に展開する

次の図は、運用環境に展開するパイプラインに追加できる構築ツール タスクを示しています。

関連情報

Azure DevOps 用 Microsoft Power Platform Build Tools