Microsoft Power Platform CLI とは?

Microsoft Power Platform CLI は、シンプルなワンストップの開発者/ISV 向け CLI です。開発者はこの CLI を使用して、次に関連する Microsoft Power Platform のさまざまな操作を実行できます:

• 環境のライフサイクル
• 認証
• Microsoft Dataverse 環境
• ソリューション パッケージ
• Power Pages
• コードコンポーネント
• その他...

フィードバックを提供する

PAC CLI のフィードバックを表示および送信するには、github.com/microsoft/powerplatform-build-tools/discussions を使用します。

Microsoft Power Platform CLI のインストール

Power Platform CLI をスインストールする方法は 3 つあります。 同じコンピューターで、複数のインストール メソッドを使用できます。

Power Platform CLI が既にインストールされているかどうかを確認します

使用しているオペレーション システムに応じて、Power Platform CLI がインストールされているかどうかを判断する方法。

Name            : pac.exe
CommandType     : Application
Definition      : C:\Users\you\.dotnet\tools\pac.exe
Extension       : .exe
Path            : C:\Users\you\.dotnet\tools\pac.exe
FileVersionInfo : File:             C:\Users\you\.dotnet\tools\pac.exe
                  InternalName:     pac.dll
                  OriginalFilename: pac.dll
                  FileVersion:      1.29.11
                  FileDescription:  Microsoft Power Platform CLI
                  Product:          Microsoft Power Platform©
                  ProductVersion:   1.29.11+g9e2b163
                  Debug:            False
                  Patched:          False
                  PreRelease:       False
                  PrivateBuild:     False
                  SpecialBuild:     False
                  Language:         Language Neutral

Get-Command: The term 'pac' is not recognized as a name of a cmdlet, function, script file, or executable program.
Check the spelling of the name, or if a path was included, verify that the path is correct and try again.

/home/you/.dotnet/tools/pac

Power Platform CLI のどのバージョンがインストールされているかを確認する

コマンド プロンプト (Microsoft Windows) か、ターミナル セッション (Linux) を開いて、pac を入力してから Enterをクリックします。

次のように表示され、バージョンが 2 行目に表示されます。

Microsoft PowerPlatform CLI
Version: 1.30.3+g0f0e0b9

認証プロファイルを管理する

ほとんどの PAC CLI コマンドは、リソースへのアクセスが認証されている必要があります。 認証プロファイルを作成して使用する必要があります。

テナントに接続する

pac auth 作成コマンドを使用して、テナントに接続する。 pac auth create を実行すると、マシン上に認証プロファイルが作成されます。 使用できる認証プロファイルは複数持つことができます。 複数の認証プロファイルを持つと、複数のテナントで作業する際に便利です。 たとえば、会社が複数のテナントを使用している場合 (開発、運営、テスト用に) や、複数の顧客に対応しているコンサルタントなどの場合です。

pac auth create コマンドには、便利なパラメータがいくつかあります。

• --environment パラメーターを使用すると、自動的に適切な環境に接続できます。 --environment パラメーターを削除すると既定の環境に接続されますが、--environment パラメーターを追加すると異なる環境に接続することができます。 環境 ID、URL、一意の名前、または名前の一部を値として使用できます。

• インタラクティブなエクスペリエンスを使用することができない環境では、--deviceCode パラメーターを追加することで、まだ接続できることを確認できます。 たとえば GitHub Codespaces では、pac auth createを実行したときに、--deviceCode パラメーターが自動的に追加されます。

例

HR-Dev 環境に接続するには、以下の例を使用できます。

pac auth create --environment "HR-Dev"

他の認証プロファイルに切り替える

複数の認証プロファイルがある場合は、pac auth list コマンドと pac auth select コマンドを使用して、簡単に切り替えることができます。

pac auth list コマンドは、マシン上に認証プロファイルをすべて一覧表示します。 pac auth select コマンドは、異なるコマンドを選択します。

pac auth list 例

すべての認証プロファイルを一覧表示するには、次の例を使用します。

pac auth list

pac auth list コマンドを実行して、認証プロファイルをすべて返します。

Index Active Kind      Name Friendly Name                   Url                                 User                                     Cloud  Type
[1]   *      UNIVERSAL      Personal Productivity (Default) https://x.crm.dynamics.com/         user@contoso.onmicrosoft.com             Public User

インデックス値を使用して他の認証プロファイルを選択します。

pac auth select --index 2

PowerShell でタブ補完を有効にする

Power Platform CLI には、.NET CLI の complete コマンド に似た pac complete コマンドがあります。

以下の手順に使用して構成すると、コマンドの先頭だけを入力してから、Tab キーを使用して入力を完了できます。

PAC CLI の PowerShell にタブ補完を追加するには、変数 $PROFILE に保存されているプロファイルを作成または編集します。 詳細については、プロファイルの作成方法 と プロファイルと実行ポリシー を参照してください。

以下のコードをプロファイルに追加します:

$scriptblock = {
    param($wordToComplete, $commandAst, $cursorPosition)

    &pac complete -s "$($commandAst.ToString())" | ForEach-Object {
        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
    }
}

Register-ArgumentCompleter -Native -CommandName pac -ScriptBlock $scriptblock

その他のシェル

これは bash、zsh、fish、nushell でも使用できます。 dotnet complete の代わりに pac complete を使用します

US ソブリン クラウドの可用性

Microsoft Power Platform CLI は、GCC および GCC High (US ソブリン クラウド) リージョンで使用できます。 サポート対象の米国ソブリン クラウド環境について調べる際は、pac auth create コマンドの --cloudを参照してください。

次の手順

そのコマンドについて説明します。 サポートされているコマンドの完全なリストの場合、pac help コマンドか pac <subcommand> help コマンド - たとえばpac solution helpを実行します。

または、ドキュメントでコマンドの一覧を表示します。

参照

Microsoft Power Platform CLIリリースノート
Microsoft Power Platform CLIコマンド グループ
Power Apps コンポーネントフレームワーク