Power Automate のクラウドフロー一覧を管理者が取得する方法

こんにちは、Power Platform サポートチームの竹内です。
本記事では、Power Automate のクラウドフローをテナント全体で効率的に管理するために、フローの一覧を取得する 3 つの方法を詳しくご案内します。

目次
1. 概要
2. クラウドフローの一覧を取得する方法
まとめ

1. 概要

Power Automate をご利用いただく際、管理者がテナント内で作成されたすべてのクラウドフローを把握することについて多くお問い合わせを頂いております。
本記事では、テナント全体のフローを一元的に把握するための具体的な方法を解説します。
なお、本記事は管理者 (グローバル管理者、Power Platform 管理者) が実行することを想定しております。

重要

本記事で紹介しているサンプルコードをご利用いただく際には、本記事末尾に記載のある免責事項を先にご確認ください。

2. クラウドフローの一覧を取得する方法

本記事では、クラウドフローの一覧を取得する具体的な方法として以下の3つを説明します。

テナントレベル分析
PowerShell スクリプト
Power Automate Management コネクタ

2-1. テナントレベルの分析を利用する

重要

この方法は事前にテナントレベルの分析を有効にする必要がございます。

有効にする方法については下記の公開情報をご参照ください。

テナントレベルでの分析 - Power Platform | Microsoft Learn

Note

この方法は削除済みのフローを取得することはできません。

Power Platform 管理センターにサインインします。
左側メニューの [分析] > [Power Automate] を選択します。
表示されるダッシュボードからフローの使用状況や一覧を確認できます。
特にテナント内のフロー一覧を取得する場合、[概要] > [在庫] タブをご確認ください。

テナントレベルの分析の詳細については下記の公開情報をご参照ください。
Power Automate のテナントレベルの分析 - Power Platform | Microsoft Learn

2-2. PowerShell を利用する

PowerShellを使用すると、詳細なフロー情報をCSV形式でエクスポートし、分析に役立てることができます。

PowerShell を管理者権限で開きます。
以下のコマンドを順番に実行します。

1
2
3

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Add-PowerAppsAccount # ここで管理者アカウントでログインしてください。
Get-AdminFlow | Export-Csv -Path "flows.csv" -Encoding UTF8

実行後に生成された flows.csv ファイルを利用し、フローの詳細を把握できます。
CSVファイルには作成者、フロー名、作成日などの詳細な情報が含まれています。

[!Note]
Power Platform の PowerShell コマンド実行についての詳細は下記の情報をご確認ください。
Power Apps と Power Automate の PowerShell サポート - Power Platform | Microsoft Learn
また、フロー一覧を取得するコマンドの詳細については下記の公開情報をご参照ください。
Get-AdminFlow (Microsoft.PowerApps.Administration.PowerShell) | Microsoft Learn

Note

この方法は削除後 28 日以内のフローを取得することができます。

各フローの詳細な情報の取得がご入用である場合、下記のコマンドに対象のフローの FlowName と、そのフローが存在する環境の EnvironmentName を代入の上、実行してください。

1	Get-AdminFlow -FlowName <FlowName> -EnvironmentName <EnvironmentName> \| %{$_ \| ConvertTo-Json -Depth 3}

下記画面のように、フローの詳細な情報を確認することができます。

また、共同所有者や実行専用ユーザーを含めた、フローに関係する人物を一覧化することがご入用である場合、下記の PowerShell コマンドのご利用をご検討ください。
Get-AdminFlowOwnerRole (Microsoft.PowerApps.Administration.PowerShell) | Microsoft Learn

上記コマンドを用いて、テナント内のフローにループ処理をする際のサンプルコードを下記に記載いたします。
ご要件に合わせてご利用をご検討ください。
※ご実行の前には本記事末尾の免責事項をご確認ください。

# 環境一覧を取得
$environments = Get-AdminPowerAppEnvironment
 
# 各環境のフローを取得し、オーナーロールを確認
foreach ($env in $environments) {
    $envName = $env.EnvironmentName
    Write-Output "Processing Environment: $envName"
    # フロー一覧を取得
    $flows = Get-AdminFlow -EnvironmentName $envName
    foreach ($flow in $flows) {
        $flowName = $flow.FlowName
        Write-Output "  Checking Flow: $flowName"
        # フローのオーナーロールを取得
        $ownerRoles = Get-AdminFlowOwnerRole -EnvironmentName $envName -FlowName $flowName
        # 結果を表示
        $ownerRoles | ForEach-Object {
            Write-Output "    Role: $($_.RoleType) | Principal: $($_.PrincipalObjectId)"
        }
    }
}

上記コードを実行すると、下記のように各フローについて、所有者や共同所有者、実行専用ユーザーをご確認することができます。

Note

テナント内のフロー数が多い場合、処理完了までに長時間を要する可能性がございます。

2-3. Power Automate Management コネクタを利用する

この方法はクラウドフローを用いて、テナント内のクラウドフローを一覧化することが可能です。

Power Automate で新規クラウドフローを作成します。
任意のトリガー（例:手動）を選択します。
アクションに「Power Automate Management」コネクタを追加し、「管理者としてフローの一覧を取得 (V2)」アクションを選びます。
取得対象の環境を選択してください。
アクション実行後、得られたフロー情報をExcelやメール通知など、適切な形で利用できます。

テナント内の全環境を対象としてクラウドフローを実行する場合、「自分の環境の一覧表示」アクションと組み合わせてください。
その場合、下記のように設定してください。

「それぞれに適用する」：outputs(‘自分の環境の一覧表示’)?[‘body/value’]
「管理者としてフローの一覧を取得 (V2)」：items(‘それぞれに適用する’)?[‘name’]

「Power Automate Management」コネクタの詳細は下記の公開情報をご覧ください。
Power Automate Management - Connectors | Microsoft Learn

また、フローの定義情報等の詳細情報までご入用である場合、「フローを管理者として取得」アクションを組み合わせることで実現可能です。

この方法は削除済みのフローを取得することはできません。

まとめ

上記三つの方法から、ご要件に応じて適切な方法をご選択いただき、ご利用ください。
本記事が適切な管理の一助となりましたら幸いでございます。

重要

===サンプルコード免責事項===

・本記事で紹介しているサンプルコードは説明のためのサンプルであり、お客様の要望を直接満たすためのご提供ではございません。

そのため、製品の実運用環境で使用されることを前提に提供されるものではありません。

・エラー処理などは含まれておりません。また、弊社にてその動作を保証するものではございません。

・サンプルコードおよびそれに関連するあらゆる情報は、”現状のまま” で

提供されるものであり、商品性や特定の目的への適合性に関する黙示の保証も含め、

明示、黙示を問わずいかなる保証も付されるものではありません。

ご使用の際には、十分にご検証いただき、ご使用くださいますようお願い申し上げます。

マイクロソフトは、お客様に対し、サンプルコードを使用および改変するための

非排他的かつ無償の権利ならびに本サンプルコードをオブジェクトコードの形式で

複製および頒布するための非排他的かつ無償の権利を許諾します。

但し、お客様は下記に同意するものとします。

(1) サンプルコードが組み込まれたお客様のソフトウェア製品のマーケティングのために

マイクロソフトの会社名、ロゴまたは商標を用いないこと

(2) サンプルコードが組み込まれたお客様のソフトウェア製品に有効な著作権表示をすること

(3) サンプルコードの使用または頒布から生じるあらゆる損害 (弁護士費用を含む) に

関する請求または訴訟について、マイクロソフトおよびマイクロソフトの取引業者に対し補償し、

損害を与えないこと

※ 本記事の内容は執筆時点の情報に基づいています。最新の情報については公式ドキュメントも合わせてご確認ください。

※本情報の内容（添付文書、リンク先などを含む）は、作成日時点でのものであり、予告なく変更される場合があります。

Japan Dynamics CRM & Power Platform Support Blog

日本マイクロソフトの Dynamics CRM & Power Platform テクニカルサポートチームより、情報をお届けします！

Power Automate のクラウドフロー一覧を管理者が取得する方法

1. 概要

2. クラウドフローの一覧を取得する方法

2-1. テナントレベルの分析を利用する

2-2. PowerShell を利用する

2-3. Power Automate Management コネクタを利用する

まとめ