🗂

【PowerShell】MicrosoftTeams管理センターより管理されているアプリの一覧を取得する。

2021/11/30に公開

はじめに

業務を進める上で、MicrosoftTeams管理センターより管理されているアプリの一覧を取得する機会があったため、本記事にてナレッジをご紹介します。
※Microsoftへ本内容について問い合わせも実施したので、そちらの内容も踏まえてアウトプットしたいと思います。

前提

  • Office365 E5の試用版を使用
  • MicrosoftTeamsのPowerShellモジュール導入済みの状態
  • PowerShellよりMicrosoftTeamsに接続済みの状態

※MicrosoftTeamsのPowerShellモジュール導入については、以下の記事を参照下さい。
【PowerShell】MicrosoftTeamsのコマンドレットを試す

取得したいデータ

MicrosoftTeams管理センター内の以下の場所になります。
「Teamsのアプリ」→「アプリを管理」のアプリ一覧

実行コマンド

通常の取得コマンド

コマンド
Get-TeamsApp

実行すると、アプリ一覧が表示される。

実行結果
PS C:\Users\owner> Get-TeamsApp

ExternalId Id                                                       DisplayName                    DistributionMethod
---------- --                                                       -----------                    ------------------
           14d6962d-6eeb-4f48-8890-de55454bb136                     Activity                       store
           20c3440d-c67e-4420-9f80-0e50c39693df                     Calling                        store
           2a84919f-59d8-4441-a975-2a8c2643b741                     Teams                          store
           34b01851-c13d-4604-bb3b-5de1ecbf0288                     Saved                          store
           5af6a76b-40fc-4ba1-af29-8f49b08e44fd                     Files                          store
           86fcd49b-61a2-4701-b771-54728cd291fb                     Chat                           store
           a2da8768-95d5-419e-9441-3b539865b118                     Search                         store
           ef56c0de-36fc-4ef8-b417-3d82ba9d073c                     Calendar                       store
           00001016-de05-492e-9106-4828fc8a8687                     Power Automate Actions         store
           040880f4-0c68-4c38-8821-d5efd2b6ddbe                     Milestones                     store
           0ae35b36-0fd7-422e-805b-d53af1579093                     SharePoint Pages               store
           0d820ecd-def2-4297-adad-78056cde7c78                     OneNote                        store
           14072831-8a2a-4f76-9294-057bf0b42a68                     Developer Portal               store
           15e4734f-39d1-4e4e-8a04-867adaa7e609                     Q&A                            store
           1850b8bb-76ac-411c-9637-08f7d1812d35                     Power Virtual Agents           store

csvとしてExportしたい場合

コマンド
Get-TeamsApp | Export-Csv "出力先のファイルのパス.csv" -Encoding UTF8 -NoTypeInformation

出力先のファイルのパスにcsvが出力される。

実行例
PS C:\Users\owner> Get-TeamsApp | Export-Csv "C:\Users\owner\Desktop\GetApp_20211130.csv" -Encoding UTF8 -NoTypeInformation
PS C:\Users\owner>

csvの結果は以下になります。

特定のアプリのみ取得したい場合

今回は、15Fiveというアプリケーションの情報を取得する。

コマンド
Get-TeamsApp | Out-String -Stream | Select-String "<対象アプリケーション>"
実行例
PS C:\Users\owner> Get-TeamsApp | Out-String -Stream | Select-String "15Five"

           7a310905-6af7-42d2-9bd5-de965a8a0a4a                     15Five                         store


PS C:\Users\owner>

※「ブロック済み」のアプリは上記のコマンドで取得できない。

実行例
PS C:\Users\owner> Get-TeamsApp | Out-String -Stream | Select-String "15Five"
PS C:\Users\owner>

Microsoftへの問い合わせで確認した内容

アプリの「状態」の部分をPowerShellで取得できないのか?
現在(2021/11/30)時点では、PowerShellを用いて取得する方法が実装されていないとのこと。

Discussion