Power Apps と Power Automate の PowerShell サポート

[アーティクル]
03/11/2024

Power Platform 作成者と管理者向けの PowerShell コマンドレットを使用すると、現在手動でしか実行できない監視および管理タスクの多くを自動化できます。今日、Power Apps、Power Automate または Power Platform アクティビティセンターで手動のみ可能なタスク。

コマンドレット

Cmdlets は、PowerShell スクリプト言語で記述された関数です。これらの Power Apps cmdlets により、Web ブラウザーの管理ポータルに移動する必要がなく、ビジネスアプリケーションプラットフォームと対話ができます。

コマンドレットを他の PowerShell の機能と結合して、ワークフローを最適化できる複雑なスクリプトを記述できます。テナントの管理者でない場合も、コマンドレットを使用できますが、所有しているリソースに限定されます。管理ユーザーアカウントは、Admin で始まるコマンドレットを使用します。

コマンドレットは、2 つの異なるモジュールとして、PowerShell Gallery で使用可能です。

Power Apps管理モジュールについての情報は、Power Apps 管理モジュールの使用を開始するおよび Microsoft.PowerApps.Administration.PowerShell を参照してください。

Note

Dynamics 365 Government Community Cloud (GCC) レベル 2 のサポートについて

既定のエンドポイントは「prod」です。ユーザーが GCC 環境を対象とする PowerShell スクリプトを実行する場合は、-エンドポイントパラメーターを GCC Moderate の場合は「usgov」、GCC High の場合は「usgovhigh」、GCCDOD の場合は「dod」に変更する必要があります。

Add-PowerAppsAccount -Endpoint "usgov"

PowerShell を開始する

PowerShell を初めて使用する場合、PowerShell の検索と起動についてサポートが必要な場合は、PowerShell の使用開始に進んでください。 PowerShell または cmdlets の使用に関するヘルプが必要な場合は、PowerShell ヘルプシステムにアクセスしてください。

前提条件

この記事の PowerShell には、Windows PowerShell バージョン 5.x が必要です。マシンで実行されている PowerShell のバージョンを確認するには、次のコマンドを実行します。

$PSVersionTable.PSVersion

古いバージョンがある場合は、既存の Windows PowerShell のアップグレードを参照してください。

重要

このドキュメントで説明されているモジュールは .NET Framework を使用していますが、PowerShell 6.0 以降とは互換性がありません。これらの新しいバージョンでは .NET Core が使用されます。

モジュールのインストール

アプリ作成者用の PowerShell コマンドレットを実行するには:

管理者として PowerShell を実行します。

必要なモジュールをインポートします。

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber

または、コンピューターの管理者権限がない場合は、-Scope CurrentUser パラメーターを使用してインストールします。

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -Scope CurrentUser
Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber -Scope CurrentUser

レポジトリの InstallationPolicy 値の変更を承認するように求められたら、A と入力してモジュールごとに Enter を押し、すべてのモジュールに対して [A] Yes を承認します。

コマンドにアクセスする前に、次のコマンドを使って資格情報を提供します。資格情報は、再びサインインを求められるまで最長で約 8 時間更新されます。

# Opens a prompt to collect credentials (Microsoft Entra account and password).
Add-PowerAppsAccount

# Here is how you can pass in credentials (to avoid opening a prompt).
$pass = ConvertTo-SecureString "password" -AsPlainText -Force
Add-PowerAppsAccount -Username user@contoso.com -Password $pass

モジュールのアップデート

Get-Module を使用して、すべての PowerShell モジュールのバージョンを確認できます。

Get-Module

また、Update-Module を使用して、すべての PowerShell モジュールを最新に更新できます。

Update-Module

または、Get-Module と -Name パラメータを使用して Power Platform モジュールのバージョンを確認します。

Get-Module -Name "Microsoft.PowerApps.Administration.PowerShell"
Get-Module -Name "Microsoft.PowerApps.PowerShell"

Update-Module と -Name パラメータを使用して、Power Platform PowerShell モジュールを更新します

Update-Module -Name "Microsoft.PowerApps.Administration.PowerShell"
Update-Module -Name "Microsoft.PowerApps.PowerShell"

アプリ作成者用の Power Apps コマンドレット

前提条件

有効な Power Apps ライセンスを持つユーザーは、これらのコマンドレットの操作を実行できます。ただし、アクセスできるのは、アプリやフローなど、作成または共有されたリソースのみです。

コマンドレットリスト - 作成者のコマンドレット

注意

競合を回避するのに適切な接頭辞を追加するために、最新リリースで一部のコマンドレットの関数名を更新しました。変更内容の概要については、次のテーブルを参照してください。

パーパス	コマンドレット
Microsoft Dataverse ソリューションへのキャンバスアプリの追加	Set-PowerAppAsSolutionAware
環境の読み取りと更新	Get-AdminPowerAppEnvironment(以前の Get-PowerAppsEnvironment) Get-FlowEnvironment Restore-PowerAppEnvironment(以前の Restore-AppVersion)
キャンバスアプリの読み取り、更新、および削除	Get-AdminPowerApp(以前の Get-App) Remove-AdminPowerApp(以前の Remove-App) Publish-AdminPowerApp (以前の Publish-App)
キャンバスアプリのアクセス許可の読み取り、更新、および削除	Get-AdminPowerAppRoleAssignment(以前の Get-AppRoleAssignment) Remove-AdminPowerAppRoleAssignment(以前の Remove-AppRoleAssignment)
フローの読み取り、更新、および削除	Get-AdminFlow Enable-AdminFlow Disable-AdminFlow Remove-AdminFlow
フローのアクセス許可の読み取り、更新、および削除	Get-AdminFlowOwnerRole Set-AdminFlowOwnerRole Remove-AdminFlowOwnerRole
フロー承認の読み取りおよび応答	Get-AdminFlowApprovalRequest Remove-AdminFlowApprovals
接続の読み取りおよび削除	Get-AdminPowerAppConnection(以前の Get-Connection) Remove-AdminPowerAppConnection(以前の Remove-Connection)
接続のアクセス許可の読み取り、更新、および削除	Get-AdminPowerAppConnectionRoleAssignment(以前の Get-ConnectionRoleAssignment) Set-AdminPowerAppConnectionRoleAssignment(以前の Set-ConnectionRoleAssignment) Remove-AdminPowerAppConnectionRoleAssignment(以前の Remove-ConnectionRoleAssignment)
コネクタの読み取りおよび削除	Get-AdminPowerAppConnector(以前の Get-Connector) Remove-AdminPowerAppConnector(以前の Remove-Connector)
カスタムコネクタのアクセス許可の追加、読み取り、更新、削除	Get-AdminPowerAppConnectorRoleAssignment(以前の Get-ConnectorRoleAssignment) Get-PowerAppConnectorRoleAssignment(以前の Set-ConnectorRoleAssignment) Remove-PowerAppConnectorRoleAssignment(以前の Remove-ConnectorRoleAssignment)
読み取り、追加および削除のポリシー URL パターン	Get-PowerAppPolicyUrlPatterns New-PowerAppPolicyUrlPatterns Remove-PowerAppPolicyUrlPatterns
読み取り、登録および削除の管理アプリ	PowerAppManagementApp の取得 PowerAppManagementApp の取得新しい PowerAppManagementApp PowerAppManagementApp の削除
保護キーの読み取り、作成、更新、およびインポート	Get-PowerAppRetrieveAvailableTenantProtectionKeys Get-PowerAppGenerateProtectionKey Get-PowerAppRetrieveTenantProtectionKey New-PowerAppImportProtectionKey Set-PowerAppTenantProtectionKey

管理者向けの Power Apps コマンドレット

管理者向けの Power Apps と Power Automate コマンドレットの詳細については、Power Platform 管理者向けの PowerShell の使用を開始するを参照してください。

ヒント

Get-Help の後に CmdletName を使用して、例のリストを取得します。
ダッシュ - を入力した後、Tab を押して入力タグを順番に切り替えることができます。このフラグをコマンドレット名の後に配置します。

コマンドの例:

Get-Help Get-AdminPowerAppEnvironment
Get-Help Get-AdminPowerAppEnvironment -Examples
Get-Help Get-AdminPowerAppEnvironment -Detailed

操作の例

次は、新規および既存の Power Apps コマンドレットの使用方法を示す一般的なシナリオを示します。

環境コマンド
Power Apps コマンド
Power Automate コマンド
API 接続コマンド
データ損失防止 (DLP) ポリシーコマンド
DLP リソース免除コマンドレット
試用ライセンスのブロックコマンド

環境コマンド

これらのコマンドを使用して詳細情報を取得し、テナントの環境を更新します。

すべての環境の一覧の表示

Get-AdminPowerAppEnvironment

テナント間の各環境の一覧とそれぞれの詳細が返されます (たとえば、環境名 (guid)、表示名、場所、作成者など)。

既定の環境の詳細の表示

Get-AdminPowerAppEnvironment –Default

テナントの既定の環境の詳細のみが返されます。

特定の環境の詳細の表示

Get-AdminPowerAppEnvironment –EnvironmentName 'EnvironmentName'

注意

EnvironmentName フィールドは、DisplayName とは異なる一意識別子です (次の画像内の出力の 1 つ目および 2 つ目のフィールドを参照してください)。

Get-AdminEnvironment コマンド。

Power Apps のコマンド

これらの操作は、テナントの Power Apps データの読み取りおよび変更のために使用されます。

すべての Power Apps の一覧を表示します。

Get-AdminPowerApp

テナント間のすべての Power Apps の一覧とそれぞれの詳細が返されます (たとえば、アプリケーション名 (guid)、表示名、作成者など)。

入力された表示名と一致するすべての Power Apps の一覧の表示

Get-AdminPowerApp 'DisplayName'

このコマンドでは、表示名と一致するテナント内のすべての Power Apps を一覧表示します。

注意

スペースを含む入力値の周囲には、引用符を使用しますたとえば、"My App Name" を使用します。

パイプラインを使用して、ヒーローアプリアプリケーションを作成する

Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero

ヒーローアプリは、Power Apps モバイルプレーヤーのリストの一番上に表示されます。ヒーローアプリは 1 つのみ存在できます。

2 つのコマンドレットの間のパイプ| 文字は、関数がパイプに合わせて記述されていると仮定して、最初のコマンドレットの出力を受け取り、それを 2 番目のコマンドレットの入力値として渡します。

注意

アプリはヒーローに変更される前に、おすすめアプリである必要があります。

各ユーザーが所有するアプリの数の表示

Get-AdminPowerApp | Select –ExpandProperty Owner | Select –ExpandProperty displayname | Group

Power Apps コマンドレットを使用してネイティブ PowerShell 関数を結合することにより、さらにデータを操作できます。ここでは、Select 関数を使用して Get-AdminApp オブジェクトから所有者属性 (オブジェクト) を取り出します。パイプラインにより出力を別の Select 関数に渡すことにより、所有者オブジェクトの名前を取り出します。最後に、2 番目の Select 関数の出力を Group 関数に渡すと、各所有者のアプリ数のカウントを含むテーブルが返されます。

Get-AdminPowerApp コマンド。

各環境のアプリの数の表示

Get-AdminPowerApp | Select -ExpandProperty EnvironmentName | Group | %{ New-Object -TypeName PSObject -Property @{ DisplayName = (Get-AdminPowerAppEnvironment -EnvironmentName $_.Name | Select -ExpandProperty displayName); Count = $_.Count } }

Get-AdminPowerApp 環境。

Power Apps ユーザーの詳細のダウンロード

Get-AdminPowerAppsUserDetails -OutputFilePath '.\adminUserDetails.txt' –UserPrincipalName 'admin@bappartners.onmicrosoft.com'

上記のコマンドは、指定されたテキストファイル内の Power Apps ユーザーの詳細 (ユーザープリンシパル名を介して入力されたユーザーに関する基本的な使用状況) を保存します。その名前のファイルが存在ない場合は作成し、ファイルが存在する場合はそのテキストファイルを上書きします。

割り当てられたユーザーライセンスのリストをエクスポートする

Get-AdminPowerAppLicenses -OutputFilePath '<licenses.csv>'

テナントに割り当てられたすべてのユーザーライセンス (Power Apps および Power Automate) を表形式のビュー .csv ファイルにエクスポートします。エクスポートされたファイルには、セルフサービスサインアップの内部試用プランと、Microsoft Entra ID から生成されたプランが含まれます。内部試用プランは、Microsoft 365 管理センターの管理者には表示されません。

多数の Microsoft Power Platform ユーザーがある場合、エクスポートにはしばらく時間がかかることがあります。

Note

Get-AdminPowerAppLicenses コマンドレットの出力には、Power Platform サービス (例: Power Apps、Power Automate、Power Platform 管理センター) にアクセスしたユーザーのライセンスのみが含まれます。 Microsoft Entra ID にライセンスが (通常、Microsoft 365 管理センター経由で) 割り当てられていても、Power Platform サービスにアクセスしたことがないユーザーは、生成された .csv 出力にライセンスが含まれません。さらに、Power Platform のライセンスサービスではライセンスがキャッシュされるため、Microsoft Entra ID のライセンス割り当てを更新しても、最近サービスにアクセスしていないユーザーの場合、出力に反映されるまでに最大で 7 日かかる場合があります。

キャンバスアプリのオーナーとしてログインユーザーを設定する

Set-AdminPowerAppOwner –AppName 'AppName' -AppOwner $Global:currentSession.userId –EnvironmentName 'EnvironmentName'

PowerApp の所有者ロールを現在のユーザーに変更し、元の所有者を「閲覧可能」ロールタイプに置き換えます。

注意

AppName および EnvironmentName フィールドは表示名ではなく、一意識別子 (guids) です。

環境で削除されたキャンバスアプリのリストを表示する

Get-AdminDeletedPowerAppsList -EnvironmentName 'EnvironmentName'

このコマンドにより、最近削除されたすべてのキャンバスアプリが表示され、回復される可能性があります。

削除されたキャンバスアプリを回復する

Get-AdminRecoverDeletedPowerApp -AppName 'AppName' -EnvironmentName 'EnvironmentName'

このコマンドは、Get-AdminDeletedPowerAppsList コマンドレットを通じて検出可能なキャンバスアプリを回復します。 Get-AdminDeletedPowerAppsList に表示されないキャンバスアプリは回復できません。

SharePoint カスタムフォーム環境の指定

次のコマンドレットを使用して、デフォルト環境ではなく、SharePoint カスタムフォームを保存する環境を指定および検証するために使用できます。 SharePoint カスタムフォームの指定環境が変更された場合、これが、新しく作成されたカスタムフォームが保存される環境です。これらのコマンドレットが使用されているため、既存のカスタムフォームが異なる環境に自動的に移行されることはありません。ユーザーが指定された環境でカスタムフォームを作成できるようにするには、ユーザーが環境メーカーの役割を持っている必要があります。ユーザーには、Power Platform 管理センターで環境メーカーの役割を付与できます。

既定の環境ではない環境は削除できません。指定された SharePoint カスタムフォーム環境が削除された場合、カスタムフォームも一緒に削除されます。

Get-AdminPowerAppSharepointFormEnvironment

このコマンドにより、新しく作成された SharePoint カスタムフォームに現在指定されている環境の EnvironmentName が返されます。環境が指定されたことがない場合は、既定の環境が返されます。

Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName'

このコマンドは、規定環境ではなく、保存する新しく作成された SharePoint カスタムフォームの環境を指定します。既存のカスタムフォームは、新しく指定された環境に自動的に移行されません。運用環境のみを SharePoint カスタムフォームに対して指定できます。

Reset-AdminPowerAppSharepointFormEnvironment

これは、SharePoint カスタムフォームを保存するための指定された環境として規定の環境をリセットします。

$settings = Get-TenantSettings 
$settings.PowerPlatform.PowerApps.disableShareWithEveryone

この設定は、環境作成者ロールを持つユーザーがキャンバスアプリを組織に所属するすべてのユーザーと共有できるかどうかを制御します。設定が true に設定されている場合、管理者ロールを持つユーザーのみ (Dynamics 365 管理者、Power Platform サービス管理者、Microsoft Entra テナント管理者) は、組織内の全員とアプリを共有できます。

このテナント設定に関係なく、共有権限を持つ値の作成者は、任意のサイズのセキュリティグループとアプリを共有できることに注意してください。このコントロールは、共有時にすべてのユーザーの省略表記を使用できるかどうかを決定するだけです。

$settings = Get-TenantSettings 
$settings.powerPlatform.powerApps.disableShareWithEveryone = $True 
Set-TenantSettings -RequestBody $settings

組織のガバナンスエラーメッセージの内容を明らかにする

エラーメッセージに表示するガバナンスエラーメッセージの内容を指定すると、作成者がすべてのユーザーとアプリを共有する権限がないことを確認したときに表示されるエラーメッセージに含まれます。 PowerShell ガバナンスエラーメッセージの内容コマンドを参照してください。

インコンテキストフローをアプリに関連付ける

アプリのコンテキストにあるフローをアプリに関連付け、アプリとフローの間の依存関係を作成します。コンテキストフローの詳細については、どのような Power Automate 機能が Power Apps ライセンスに含まれていますか? を参照してください。

   Add-AdminFlowPowerAppContext -EnvironmentName <String> -FlowName <String> -AppName <String> [-ApiVersion <String>] [<CommonParameters>]

EnvironmentName と FlowName は、フロー URL に表示されます:

非ソリューションフローの場合、URLは次のようになります:
```
https://preview.flow.microsoft.com/manage/environments/839eace6-59ab-4243-97ec-a5b8fcc104e7/flows/6df8ec2d-3a2b-49ef-8e91-942b8be3202t/details
```
environments/ の後の GUID は、EnvironmentName、flows/ の後の GUID は FlowName です。

ソリューションフローの場合、URL は次のようになります:

https://us.flow.microsoft.com/manage/environments/66495a1d-e34e-e330-9baf-0be559e6900b/solutions/fd140aaf-4df4-11dd-bd17-0019b9312238/flows/53d829c4-a5db-4f9f-8ed8-4fb49da69ee1/details

environments/ の後の GUID は、EnvironmentName、flows/ の後の GUID は FlowName です。

キャンバスアプリの AppName は、キャンバスアプリの詳細ページで確認できます。
モデル駆動型アプリの AppName は、ソリューションエクスプローラーで確認できます。
例を参照するには、次を入力します: get-help Add-AdminFlowPowerAppContext -examples。
詳細を取得するには、次を入力します:get-help Add-AdminFlowPowerAppContext -detailed。
技術的な情報を取得するには、次を入力します:get-help Add-AdminFlowPowerAppContext -full。

アプリのコンテキストフローで削除

この PowerShell コマンドを使用して、フローとアプリの間の依存関係を削除します。 Remove-AdminFlowPowerAppContext は、特定のフローからアプリのコンテキストを削除します。

    Remove-AdminFlowPowerAppContext -EnvironmentName <String> -FlowName <String> -AppName <String> [-ApiVersion <String>] [<CommonParameters>]

    - To see the examples, type: "get-help Remove-AdminFlowPowerAppContext -examples".
    - For more information, type: "get-help Remove-AdminFlowPowerAppContext -detailed".
    - For technical information, type: "get-help Remove-AdminFlowPowerAppContext -full".

Power Automate のコマンド

これらの重要なコマンドを使用して、Power Automate に関連する管理を実行します。

管理者向けの Power Automate および Power Apps コマンドレットの詳細については Power Platform 管理者向けの PowerShell の使用を開始するを参照してください。

すべてのフローの表示

Get-AdminFlow

テナント内のすべてのフローの一覧が返されます。

フロー所有者のロールの詳細の表示

Get-AdminFlowOwnerRole –EnvironmentName 'EnvironmentName' –FlowName 'FlowName'

指定されたフローの所有者の詳細が返されます。

注意

環境および PowerApps のように、FlowName は、フローの表示名とは異なる一意識別子 (guid) です。

フローユーザーの詳細の表示

Get-AdminFlowUserDetails –UserId $Global:currentSession.userId

フローの使用状況に関するユーザーの詳細が返されます。この例では、PowerShell セッションの現在ログインしているユーザー ID を使用しています。

フローユーザーの詳細の削除

Remove-AdminFlowUserDetails –UserId 'UserId'

Microsoft のデータベースからフローユーザーの詳細を完全に削除します。入力されたユーザーが所有するフローすべては、ユーザーの詳細が消去される前に削除される必要があります。

注意

UserId フィールドは、Microsoft Entra ID>ユーザー>プロファイル>オブジェクト ID 下の Azure ポータルに表示されるユーザーの Microsoft Entra レコードのオブジェクト IDです。ここからこのデータにアクセスするには管理者である必要があります。

すべてのフローを CSV ファイルにエクスポートする

Get-AdminFlow | Export-Csv -Path '.\FlowExport.csv'

テナントのすべてのフローを表形式表示の .CSV ファイルにエクスポートします。

Dataverse ソリューションへのクラウドフローの追加

Add-AdminFlowsToSolution -EnvironmentName <String>

環境内のすべての非ソリューションフローを移行します。

パラメーターのバリエーションを使用すると、特定のフローのみを移行したり、特定のソリューションに追加したり、一度に設定された数のフローのみを移行したりすることができます。

技術的詳細については、Add-AdminFlowsToSolution を参照してください。

API 接続コマンド

テナントの API 接続の表示および管理を行います。

既定の環境のすべてのネイティブ接続を表示する

Get-AdminPowerAppEnvironment -Default | Get-AdminPowerAppConnection

既定の環境にあるすべての API 接続の一覧を表示します。ネイティブ接続は Power Apps の Dataverse>接続タブにあります。

テナントのすべてのカスタムコネクタの表示

Get-AdminPowerAppConnector

テナント内のすべてのカスタムコネクタの詳細の一覧が返されます。

注意

Get-AdminPowerAppConnector にソリューションにあるカスタムコネクタは一覧表示されません。これは既知の制限です。

データ損失防止 (DLP) ポリシーコマンド

このコマンドレットによってテナントの DLP ポリシーが制御されます。

DLP ポリシーの作成

New-DlpPolicy

サインインした管理者のテナントに対して新しい DLP ポリシーを作成します。

DLP オブジェクトのリストを取得する

Get-DlpPolicy

サインインした管理者のテナントに対してポリシーオブジェクトを取得します。

注意

PowerShell を使用して DLP ポリシーを表示する場合、コネクタの表示名は、DLP ポリシーが作成されたとき、またはコネクタがポリシー内で最後に移動されたときのものです。コネクタの表示名に対する新しい変更は反映されません。
PowerShell を使用して DLP ポリシーを表示する場合、移動されていない既定のグループ内の新しいコネクタは返されません。

これらの両方の既知の問題の回避策は、影響を受けるコネクタをポリシー内の別のグループに移動してから、正しいグループに戻すことです。これを行うと、各コネクタが正しい名前で表示されます。

DLP ポリシーの更新

Set-DlpPolicy

ポリシー表示名などのポリシーの詳細を更新します。

ポリシーの削除

Remove-DlpPolicy

DLP ポリシーを削除します。

DLP リソース免除コマンドレット

これらのコマンドレットを使用すると、特定のリソースを DLP ポリシーから免除、または免除解除できます。

DLP ポリシーの既存の免除リソースリストを取得する

Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName

DLP ポリシーの新しい免除リソースリストを作成する

New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources

DLP ポリシーの新しい免除リソースリストを更新する

Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources

DLP ポリシーの新しい免除リソースリストを削除する

Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName

DLP ポリシーからリソースを免除するには、次の情報が必要です:

テナント ID (GUID)
DLP ポリシー ID (GUID)
リソース ID (GUID で終わるもの)
リソースの種類

リソース ID とタイプは、PowerShell コマンドレットのアプリで使用する Get-PowerApp とフローで使用する Get-Flow で取得できます。

消去スクリプトの例

ID が f239652e-dd38-4826-a1de-90a2aea584d9 のフローと ID が 06002625-7154-4417-996e-21d7a60ad624 のアプリを除外するには、以下のコマンドレットを実行します:

1. PS D:\> $flow = Get-Flow -FlowName f239652e-dd38-4826-a1de-90a2aea584d9 
2. PS D:\> $app = Get-PowerApp -AppName 06002625-7154-4417-996e-21d7a60ad624 
3. PS D:\> $exemptFlow = [pscustomobject]@{ 
4. >>             id = $flow.Internal.id 
5. >>             type = $flow.Internal.type 
6. >>         } 
7. PS D:\> $exemptApp = [pscustomobject]@{ 
8. >>             id = $app.Internal.id 
9. >>             type = $app.Internal.type 
10. >>         } 
11. PS D:\> $exemptResources = [pscustomobject]@{ 
12. >>             exemptResources = @($exemptFlow, $exemptApp) 
13. >>         } 
14. PS D:\> New-PowerAppDlpPolicyExemptResources -TenantId b1c07da8-2ae2-47e7-91b8-d3418892f507 -PolicyName 65da474a-70aa-4a59-9ae1-65a2bebbf98a -NewDlpPolicyExemptResources $exemptResources 
15. 
16. exemptResources 
17. --------------- 
18. {@{id=/providers/Microsoft.ProcessSimple/environments/Default-b1c07da8-2ae2-47e7-91b8-d3418892f507/flows/f239652e-dd38-4826-a1de-90a2aea584d9; type=Microsoft.ProcessSimple/environments/flows}, @{id=/providers/Microsoft.PowerApps/apps/06002625-7154-4417-996e-21d7a60ad..

次のシナリオでの DLP 適用除外エクスペリエンス

#	シナリオ	経歴
1	ユーザーは、DLP に準拠していないが、DLP が除外されているアプリを起動します。	アプリの起動は、DLP 適用の有無にかかわらず続行されます。
2	開発者は、DLP に準拠していないが、DLP が除外されているアプリを保存します	DLP の適用除外の有無にかかわらず、DLP コンプライアンスはアプリの保存操作をブロックしません。 DLP の適用除外に関係なく、DLP 非準拠の警告が表示されます。
3	開発者は、DLP に準拠していないが、DLP が除外されているフローを保存します	DLP の適用除外の有無にかかわらず、DLP コンプライアンスはフローの保存操作をブロックしません。 DLP 非準拠の警告は表示されません。

ガバナンスエラーメッセージの内容コマンド

次のコマンドレットを使用すると、エンドユーザーを組織のガバナンス参考資料に誘導できます。このコマンドには、ガバナンスに関するドキュメントへのリンクと、ガバナンス制御によって要求された場合のガバナンス連絡先が含まれています。たとえば、ガバナンスエラーメッセージの内容が設定されている場合、Power Apps データ損失防止ポリシーの実行時適用メッセージに表示されます。

ガバナンスエラーメッセージの内容を設定する

New-PowerAppDlpErrorSettings -TenantId 'TenantId' -ErrorSettings @{  
  ErrorMessageDetails = @{ 
    enabled = $True  
    url = "https://contoso.org/governanceMaterial" 
  } 
  ContactDetails= @{  
    enabled = $True 
    email = "admin@contoso.com" 
  } 
}

ガバナンスエラーメッセージの URL と電子メールは、個別に表示することも、一緒に表示することもできます。 enabled フィールドで、ガバナンスエラーメッセージを有効または無効にできます。

ガバナンスエラーメッセージの内容シナリオ

#	シナリオ	空き時間
1	DLP に対応していない Power Apps で作成されたアプリをユーザーが起動する	一般に入手可能
2	開発者は Power Apps キャンバスアプリを共有しますが、共有権限がありません	一般に入手可能
3	開発者はすべてのユーザーに Power Apps キャンバスアプリを共有しますが、すべてのユーザーに共有する権限がありません	一般に入手可能
4	DLP に対応していない Power Apps で作成したアプリを作成者が保存する	一般に入手可能
5	DLP に準拠していない Power Automate フローを開発者が保存します	一般に入手可能
6	ユーザーは、Dataverse 環境に関連付けられたセキュリティグループへのセキュリティグループメンバーシップなしでアプリを起動します	一般に入手可能

ガバナンスエラーメッセージの内容を表示する

Get-PowerAppDlpErrorSettings -TenantId 'TenantId'

ガバナンスエラーメッセージの内容を更新する

Set-PowerAppDlpErrorSettings -TenantId 'TenantId' -ErrorSettings @{  
  ErrorMessageDetails = @{ 
    enabled = $True  
    url = "https://contoso.org/governanceMaterial" 
  } 
  ContactDetails= @{  
    enabled = $True 
    email = "admin@contoso.com" 
  } 
}

接続違反に対する DLP ポリシーの適用 - 環境

これらのコマンドレットを使用すると、環境またはテナントレベルで接続違反に対する DLP ポリシーを適用できます。

接続違反に対する DLP ポリシーの適用

環境内の接続に DLP ポリシーを適用できます。強制すると DLP ポリシーに違反する既存の接続が無効になり、以前に無効化され、DLP ポリシーに違反しなくなった接続が有効になります。

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName [Environment ID]

環境強制スクリプトの例

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName c4a07cd6-cb14-e987-b5a2-a1dd61346963

接続違反に対する DLP ポリシーの適用 - テナント

テナント内の接続に DLP ポリシーを強制できます。強制すると DLP ポリシーに違反する既存の接続が無効になり、以前に無効化され、DLP ポリシーに違反しなくなった接続が有効になります。

Start-DLPEnforcementOnConnectionsInTenant

試用ライセンスのブロックコマンド

コマンド:

Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans

許可された同意プランコマンドレットを使用して、テナントから特定の種類の同意プランへのアクセスを追加または削除できます。「内部」同意プランは、ユーザーが Power Apps/Power Automate ポータル/デスクトップ用 Power Automate からサインアップできる試用版ライセンスまたは開発者プランのいずれかです。 "アドホックサブスクリプション" または "バイラル" 同意プランは、ユーザーが https://signup.microsoft.com からサインアップできる試用版ライセンスです。管理者は Microsoft Entra ID または Microsoft 365 管理ポータルを使ってユーザーを割り当てることができます。

既定では、すべての種類の同意プランがテナントで許可されています。ただし、Power Platform 管理者は、ユーザーが自分自身に試用ライセンスを割り当てることをブロックしながら、ユーザーに代わって試用ライセンスを割り当てる機能を保持したい場合があります。このルールは、Remove-AllowedConsentPlans -Types "Internal" コマンドを使用して、Microsoft Entra ID の AllowAdHocSubscriptions の設定を無効にすることで実現できます。

重要

Remove-AllowedConsentPlans を使用している場合、指定したタイプの既存のすべての計画がテナント内のすべてのユーザーから削除されます。このコマンドは、そのタイプの今後の割り当てをすべてブロックします。 Power Platform 管理者が使用できるタイプのプランを再び有効にしたい場合、Add-AllowedConsentPlans を使用することができます。許可された同意プランの現在の状態を表示する場合は、Get-AllowedConsentPlans を使用できます。

質問がある場合

コメント、提案、質問がある場合、Power Apps コミュニティボードの管理で投稿してください。

参照

Power Apps 管理モジュールの使用を開始する。
Microsoft.PowerApps.Administration.PowerShell
プレビュー: プログラミングと拡張性の概要

Power Apps と Power Automate の PowerShell サポート

コマンドレット

PowerShell を開始する

前提条件

モジュールのインストール

モジュールのアップデート

アプリ作成者用の Power Apps コマンドレット

前提条件

コマンドレット リスト - 作成者のコマンドレット

管理者向けの Power Apps コマンドレット

ヒント

操作の例

環境コマンド

すべての環境の一覧の表示

既定の環境の詳細の表示

特定の環境の詳細の表示

Power Apps のコマンド

すべての Power Apps の一覧を表示します。

入力された表示名と一致するすべての Power Apps の一覧の表示

おすすめのアプリケーション

パイプラインを使用して、ヒーロー アプリ アプリケーションを作成する

各ユーザーが所有するアプリの数の表示

各環境のアプリの数の表示

Power Apps ユーザーの詳細のダウンロード

割り当てられたユーザー ライセンスのリストをエクスポートする

キャンバス アプリのオーナーとしてログイン ユーザーを設定する

環境で削除されたキャンバス アプリのリストを表示する

削除されたキャンバス アプリを回復する

SharePoint カスタム フォーム環境の指定

すべてのユーザーとアプリを共有する機能のテナント設定を表示する

すべてのユーザーとアプリを共有する機能のテナント設定を変更する

組織のガバナンス エラー メッセージの内容を明らかにする

イン コンテキスト フローをアプリに関連付ける

アプリのコンテキスト フローで削除

Power Automate のコマンド

すべてのフローの表示

フロー所有者のロールの詳細の表示

フロー ユーザーの詳細の表示

フロー ユーザーの詳細の削除

すべてのフローを CSV ファイルにエクスポートする

Dataverse ソリューションへのクラウド フローの追加

API 接続コマンド

既定の環境のすべてのネイティブ接続を表示する

テナントのすべてのカスタム コネクタの表示

データ損失防止 (DLP) ポリシー コマンド

DLP ポリシーの作成

DLP オブジェクトのリストを取得する

DLP ポリシーの更新

ポリシーの削除

DLP リソース免除コマンドレット

DLP ポリシーの既存の免除リソース リストを取得する

DLP ポリシーの新しい免除リソース リストを作成する

DLP ポリシーの新しい免除リソース リストを更新する

DLP ポリシーの新しい免除リソース リストを削除する

消去スクリプトの例

次のシナリオでの DLP 適用除外エクスペリエンス

ガバナンス エラー メッセージの内容コマンド

ガバナンス エラー メッセージの内容を設定する

ガバナンス エラー メッセージの内容シナリオ

ガバナンス エラー メッセージの内容を表示する

ガバナンス エラー メッセージの内容を更新する

接続違反に対する DLP ポリシーの適用 - 環境

接続違反に対する DLP ポリシーの適用

環境強制スクリプトの例

接続違反に対する DLP ポリシーの適用 - テナント

試用ライセンスのブロックコマンド

質問がある場合

参照

その他のリソース

コマンドレットリスト - 作成者のコマンドレット

パイプラインを使用して、ヒーローアプリアプリケーションを作成する

割り当てられたユーザーライセンスのリストをエクスポートする

キャンバスアプリのオーナーとしてログインユーザーを設定する

環境で削除されたキャンバスアプリのリストを表示する

削除されたキャンバスアプリを回復する

SharePoint カスタムフォーム環境の指定

組織のガバナンスエラーメッセージの内容を明らかにする

インコンテキストフローをアプリに関連付ける

アプリのコンテキストフローで削除

フローユーザーの詳細の表示

フローユーザーの詳細の削除

Dataverse ソリューションへのクラウドフローの追加

テナントのすべてのカスタムコネクタの表示

データ損失防止 (DLP) ポリシーコマンド

DLP ポリシーの既存の免除リソースリストを取得する

DLP ポリシーの新しい免除リソースリストを作成する

DLP ポリシーの新しい免除リソースリストを更新する

DLP ポリシーの新しい免除リソースリストを削除する

ガバナンスエラーメッセージの内容コマンド

ガバナンスエラーメッセージの内容を設定する

ガバナンスエラーメッセージの内容シナリオ

ガバナンスエラーメッセージの内容を表示する

ガバナンスエラーメッセージの内容を更新する