次の方法で共有


Microsoft Power Platform CLI とは

Microsoft Power Platform CLI は、開発者と独立系ソフトウェア ベンダー (ISV) が、次に関連するMicrosoft Power Platformのさまざまな操作を実行できるようにする、シンプルなワンストップ開発者 CLI です。

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

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

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

Microsoft Power Platform CLI をインストールする

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

メソッド OS のサポート 説明
Visual Studio Code拡張子をインストールします Windows、Linux、macOS Windows 10、Windows 11、Linux、macOS のVisual Studio Code内の PowerShell ターミナル内でコマンドを使用できるようにします。

この方法を使用してインストールした場合、既定では、PAC CLI は Visual Studio Code ターミナル内でのみ利用可能です。ただし、コマンド プロンプト (CMD) や PowerShell ターミナルで PAC CLI を有効にすることで、Windows の他のターミナルでも使用することができます。
.NET ツールでインストール Windows、Linux、macOS Windows 10、Windows 11、Linux、macOS で PowerShell、CMD、または Bash シェル内でコマンドを使用できるようにします。

このインストール方法では、pac data または Windowsでのみ使用できる特定の pac パッケージ コマンド (deploy および show) を使用することはできません。
Windows MSI を使用してインストール Windowsのみ Windowsでのみ、Visual Studio Code内の PowerShell ターミナル内でコマンドを使用できるようにします。 このインストール メソッドを使用して、インストールされたバージョンを管理することができます。

注意

次のコマンドは、Windowsでのみ使用できます。

  • PAC データ
  • pacパッケージのデプロイ
  • pacパッケージ表示

Windowsでこれらのコマンドを使用するには、次のいずれかのインストール方法 (または両方) を使用して Power Platform CLI をインストールします。

これらのコマンドは、.NET Tool のみを使用してインストールする場合、Windowsでは使用できません。

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

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

  1. PowerShell ターミナルを開く:

    • Visual Studio Code拡張機能のみをインストールした場合は、Visual Studio Code PowerShell ターミナル ウィンドウを開きます。
    • .NET Tool を使用してインストールした場合は、Visual Studio Code PowerShell ターミナルまたは PowerShell ターミナルを開きます。
  2. プロンプトで を入力し、Enter をクリックします。

結果は次のようになります。

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

Power Platform CLI がインストールされていない場合、次のエラーが表示されます:

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.

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

コマンド プロンプト (Microsoft Windows) またはターミナル セッション (Linux の場合) を開き、「pac」と入力し、Enter キーを押します。

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

Microsoft PowerPlatform CLI
Version: 1.30.3+g0f0e0b9

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

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

注意

Visual Studio Code拡張機能では、認証プロファイルを表示および管理できます

テナントに接続する

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

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

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

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

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

pac auth create --environment "HR-Dev"

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

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

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

の例

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

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 には、pac completeのような コマンドがあります。

以下の手順で構成する場合、コマンドの先頭だけを入力し、タブ キーを使用して入力された入力を完了できます。

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

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

$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 も使用できます。 の代わりに を使用します

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

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

次の手順

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

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

参照

Microsoft Power Platform CLI リリース ノート
Microsoft Power Platform CLI コマンド グループ
Microsoft Power Platform CLIのトラブルシューティング
Power Apps コンポーネント フレームワーク