Get-TeamAllChannel コマンドレットの使用

2022年8月3日

すべてのチームのすべてのチャネルのレポートを作成する

Microsoft Teams PowerShell モジュールのバージョン 4.6 には、 Get-TeamAllChannel コマンドレットは、管理者がチーム内のすべてのチャネル (通常、プライベート、および共有) の完全な一覧を取得できるように新しくリリースされました。私は新しいコマンドレットがどれほど有用であるかを見て、それを Get-MgTeamChannel Microsoft Graph PowerShell SDK のコマンドレットは、Microsoft が新しいチャネル用に Teams Wiki を自動プロビジョニングしなくなることを報告している記事の Wiki タブを使用してチャネルを報告するために使用しました。

新しいコマンドレットをテストする最も簡単な方法は、スクリプトで実用化することですので、簡単なスクリプトを作成しました。

すべてのチームを検索します。
チームをループして、各チームのチャネルのセットを見つけます。
PowerShell リストオブジェクトにチャネルの詳細を設定します。
いくつかの出力を生成します。

できます GitHub からスクリプトをダウンロードする.それは特に複雑ではありません。本番環境でテストされていないコードを使用しないことに関する通常の免責事項が適用されますが、このコードで大きな問題が発生するとは思わない。

パフォーマンス

私が最初に気づいたのは、 ゲットチーム コマンドレット (4.6 モジュールから) は、 Get-MgGroup コマンドレット。私はこれを指摘した前の記事内ですが、使用時に利用可能な追加の速度 Get-MgGroup かなり厳しいです。テナントには 87 チームしかなく、2 つのコマンドレットを使用した結果は、 測定コマンド コマンドレット:

Measure-Command {Get-MgGroup -Filter "resourceProvisioningOptions/Any(x:x eq 'Team')" -All} | Select TotalSeconds

TotalSeconds
------------
   0.3131487

Measure-Command {Get-Team} | Select TotalSeconds

TotalSeconds
------------
  11.4137458

余分な速度は、少数のチームを処理するときにスクリプトにあまり影響しません。それは数字がマウントされるので、私は一緒に行くことを選択します Get-MgGroup.あなたが使用したい場合は、 ゲットチーム コマンドレットを使用すると、代わりにそのコマンドレットを使用するようにスクリプトを更新できます。その場合は、コマンドレットがグループ識別子に異なるプロパティ名を使用するため、必ず呼び出しを次のように修正してください。 ゲットチームオールチャン使用するネル $Team.グループID 代わりに $Team.Id.

Get-TeamAllChannel Basics

チーム内のすべてのチャンネルを表示するには、次のコマンドを実行します。 Get-TeamAllChannel チーム(グループ)識別子を渡します。

Get-TeamAllChannel -GroupId b647d5ff-3bda-4333-b768-7990084569b6 

Id             : 19:44ecfd5231b44f4baf7bf664c7048e8e@thread.tacv2
DisplayName    : Project Hydra
Description    : Discussions about the Hydra Project
MembershipType : Private
HostTeamId     : b647d5ff-3bda-4333-b768-7990084569b6
TenantId       : a662313f-14fc-43a2-9a7a-d2e27f4f3478

Id             : 19:5-aYUE7mEEoAmK8gzNZDfT6aTmsyh5DXKAWLNP45aks1@thread.tacv2
DisplayName    : ?Teams Practices and Architecture
Description    : Discussions about the most productive practices and architectural decisions in
                 Microsoft Teams deployments
MembershipType : Shared
HostTeamId     : b647d5ff-3bda-4333-b768-7990084569b6
TenantId       : a662313f-14fc-43a2-9a7a-d2e27f4f3478

Id             : 19:7d98ec1299da4b35ada086daf162e441@thread.tacv2
DisplayName    : Announcements ?
Description    : Use this channel to make important team and event announcements.
MembershipType : Standard
HostTeamId     : b647d5ff-3bda-4333-b768-7990084569b6
TenantId       : a662313f-14fc-43a2-9a7a-d2e27f4f3478

Id             : 19:97a16096725040ad84c35430f2ab2c89@thread.tacv2
DisplayName    : General
Description    : Everything you need to know about Office 365
MembershipType : Standard
HostTeamId     : b647d5ff-3bda-4333-b768-7990084569b6
TenantId       : a662313f-14fc-43a2-9a7a-d2e27f4f3478

特定のタイプのチャンネルのみを表示するには、 メンバーシップの種類 パラメーター：

 Get-TeamAllChannel -GroupId b647d5ff-3bda-4333-b768-7990084569b6 -MembershipType Shared


Id             : 19:5-aYUE7mEEoAmK8gzNZDfT6aTmsyh5DXKAWLNP45aks1@thread.tacv2
DisplayName    : ?Teams Practices and Architecture
Description    : Discussions about the most productive practices and architectural decisions in
                 Microsoft Teams deployments
MembershipType : Shared
HostTeamId     : b647d5ff-3bda-4333-b768-7990084569b6
TenantId       : a662313f-14fc-43a2-9a7a-d2e27f4f3478

Id             : 19:9zvayMx_MW8kWr_gULHIUFyzRBh-ULhb4mBqajGehwQ1@thread.tacv2
DisplayName    : Project Opportunities
Description    :
MembershipType : Shared
HostTeamId     : b647d5ff-3bda-4333-b768-7990084569b6
TenantId       : a662313f-14fc-43a2-9a7a-d2e27f4f3478

テナント名の解決

マイクロソフトは、一般;共有チャネルの可用性 7月19日に。ここまでで、すべての商用クラウドテナントが共有チャンネルまた、テナント間の共有を設定して、他の Microsoft 365 組織のユーザーと共同作業を行うことができます。の出力 Get-TeamAllChannel コマンドレットには、共有チャネルをホストするテナントの識別子が含まれていますが、ほとんどのユーザーは頭の中でテナント識別子を認識できないため、スクリプトはテナント識別子を人間に優しい表示名に解決する必要があります。たとえば、e662313f-14fc-43a2-9a7a-d2e27f4f3478 は IT プロフェッショナル向け Office 365 になります。

Azure AD サインインログを使用してテナントでホストされている共有チャネルへのアクセスを追跡する方法を説明する記事で、このパスを前に行ったことがあるので、コードを再利用して findTenantInformationByTenantId テナント名を検索するためのグラフ API。このスクリプトでは、各チャネルのホストテナント名を報告するだけでなく、チャネルをホストしているテナントのセットも概要に一覧表示されます (図 1)。

図 1: Get-TeamAllChannel コマンドレットを使用してスクリプトを実行し、Teams チャネルを報告する

Get-TeamAllChannel は迅速かつシンプルです

ザ Get-TeamAllChannel コマンドレットは簡単に使用できます。その主な利点は、コマンドレットが 1 回の操作ですべてのチャネルを一覧表示することです。その出力には、管理者が各チャネルについて知りたい最も重要なデータが含まれています。全 Get-TeamAllChannel 標準への素晴らしい強化です チームチャネルを取得 コマンドレット。

PowerShell モジュールにMicrosoft Teams表示される新しいコマンドレットなどの開発を最新の状態に保つには、 Office 365 for IT プロフェッショナル 電子ブック。毎月の更新により、サブスクライバーは Office 365 全体で発生する最も重要な変更を確実に理解できます。

未分類

Posted by admin