Power Platform 管理者用 PowerShell の概要

Power Platform 管理者用 PowerShell コマンドレットは、Microsoft Power Platform 環境、Power Apps、および Power Automate フローを管理するために設計されています。 これらのリソースと対話する自動化されたツールを構築する場合は、Power Platform 管理者用 PowerShell を使用してください。

この記事は、PowerShell モジュールの使用を開始するのに役立ち、その背後にある主要な概念を説明します。

インストール

PowerShell モジュールを使い始める最も簡単な方法は、ローカル コンピューターにそれをインストールすることです。 インストールの手順に従ってモジュールをインポートするか、以前にインストールした可能性のある古いバージョンを更新します。

Microsoft Power Platform にサインインする

Add-PowerAppsAccount コマンドレットを使用して対話的にサインインします。

Add-PowerAppsAccount -Endpoint prod

または、クライアント ID とシークレットまたは証明書を使用してサインインすることもできます。 これを行うには、サービス プリンシパルを作成する必要があります。

$appId = "CLIENT_ID_FROM_AZURE_APP"
$secret = "SECRET_FROM_AZURE_APP"
$tenantId = "TENANT_ID_FROM_AZURE_APP"

Add-PowerAppsAccount -Endpoint prod -TenantID $tenantId -ApplicationId $appId -ClientSecret $secret -Verbose

前提条件

コマンドレットで管理操作を実行するには、次のものが必要です。

  • これらのロールのいずれか—グローバル管理者、Microsoft Azure Active Directory グローバル管理者、または Dynamics 365 管理者—は、Power Apps 管理 PowerShell コマンドレットにアクセスできます。 これらのロールには、Power Apps 管理 PowerShell コマンドレットへの管理アクセス許可に対する Power Apps プランは必要ではありません。 ただし、これらの管理者は PowerShell コマンドレットを使用する前に、少なくとも一度は Power Platform 管理センターにサインインする必要があります。 実行されていない場合、コマンドレットは認証エラーで失敗します。

  • 別のユーザーのリソースを検索する必要がある場合は、Microsoft 365 グローバル管理者、Azure Active Directory グローバル管理者、または Dynamics 365 管理者の権限が必要です。 環境管理者は、アクセス許可を持つ環境および環境リソースにのみアクセスできます。

  • Dataverse for Teams 環境の場合、Microsoft Teams でチームのオーナーではない環境を管理するには、Microsoft 365 グローバル管理者、Azure Active Directory グローバル管理者、または Power Platform 管理者である必要があります。