現場担当者向けの PowerShell を使用して、現場の静的チームを大規模にデプロイする

概要

組織は多数のチームを使用して、現場の従業員間のコミュニケーションとコラボレーションを推進していますか? この記事は、大規模なチームを作成して管理する必要がある場合に適しています。

PowerShell を使用すると、最大 500 チームをデプロイし、一度にチームごとに最大 25 人のユーザーを追加できます。 既存のチームのユーザーを大規模に追加および削除することもできます。 このソリューションを使用して、組織の規模のニーズを満たし、デプロイ時間を大幅に短縮します。

Teams を大規模に展開すると、次のことが可能になります。

• 事前構築済みのテンプレートまたは独自のカスタム テンプレートを使用してチームを作成します。
• 所有者またはメンバーとしてチームにユーザーを追加します。
• 既存のチームにユーザーを追加または削除して、大規模なチームを管理します。
• 完了、状態、エラー (存在する場合) など、電子メールで通知を受け取ります。 展開するチームの各バッチの状態について、最大 5 人のユーザーに通知することができます。 チームの所有者とメンバーは、チームに追加されると自動的に通知されます。

この記事では、Teams を大規模に展開する方法について説明します。

チームを設定してデプロイする

次の手順に従って、一度に最大 500 チームをデプロイします。

手順 1: CSV ファイルを準備する

デプロイするチームのバッチごとに 2 つの CSV ファイルを作成します。

• 作成するチームを定義する CSV ファイル。 このファイルにはタイトル行が必要で、最初の列から始まる次の順序で、これらの必須列を含める必要があります。

  列名	説明
  チーム名	チームの名前。
  既存のチーム ID	既存のチームにユーザーを追加または削除する場合は、チームのチーム ID を指定します。
  Visibility	チームがパブリック (組織内のすべてのユーザーが参加可能) かプライベート (ユーザーが参加するにはチーム所有者の承認が必要) かどうか。 オプションは パブリック と プライベートです。
  チーム テンプレート ID	事前構築済みまたはカスタム テンプレートからチームを作成する場合は、チーム テンプレート ID を指定します。 事前構築済みのチーム テンプレートと ID の一覧については、「 Teams 管理センターでの チーム テンプレートの概要」を参照してください。 標準の既定のチーム テンプレートを使用する場合は、この空白のままにします。

• 追加するユーザーを各チームにマップする CSV ファイル。 このファイルにはタイトル行が必要で、最初の列から始まる次の順序で、これらの必須列を含める必要があります。

  列名	説明
  ユーザーの完全な名前	ユーザーの表示名。
  ユーザー UPN または ID	ユーザーのユーザー プリンシパル名 (UPN) または ID。 たとえば、「 averyh@contoso.com 」のように入力します。
  チーム名	チームの名前。
  ActionType	ユーザーをチームに追加するか、チームから削除するか。 オプションは、 AddMember と RemoveMemberです。
  所有者またはメンバー	ユーザーがチーム所有者かチーム メンバーか。 オプションは、 Owner と Memberです。

  注:

  この CSV ファイルでは、展開 現場の動的チーム エクスペリエンスを通じて Teams 管理センターで作成した動的な現場チームを含め、任意のチームのチーム所有者として複数のユーザーを割り当てることもできます。

例

次の例を使用して、CSV ファイルを作成します。 ここでは、ファイル、Teams.csv、Users.csv という名前を付けました。

Teams.csv

Users.csv

手順 2: 環境を設定する

最新バージョンの Teams PowerShell モジュールをインストールして接続するには、次の手順に従います。

1. PowerShell バージョン 7 以降をインストールします。 詳細なガイダンスについては、「Windows への PowerShell のインストール」を参照してください。

2. 管理者モードで PowerShell を実行します。

3. 以前にインストールされた Teams PowerShell モジュールをアンインストールするには、次を実行します。

   Uninstall-module -Name MicrosoftTeams -Force -Allversions
   

   エラー メッセージが表示された場合は、既に設定されています。 次の手順に進みます。

4. Teams PowerShell モジュールの最新バージョンをダウンロードしてインストールします。 バージョン 4.7.0 (プレビュー) 以降を実行している必要があります。

5. Teams に接続するには、次を実行します。

   Connect-MicrosoftTeams
   

   メッセージが表示されたら、管理者の資格情報を使用してサイン インします。

6. Teams PowerShell モジュールのコマンドの一覧を取得するには、次のコマンドを実行します。

   Get-Command -Module MicrosoftTeams
   

   New-CsBatchTeamsDeployment と Get-CsBatchTeamsDeploymentStatus が一覧表示されていることを確認します。

手順 3: チームをデプロイする

CSV ファイルを作成し、環境を設定したら、チームをデプロイする準備ができました。

New-CsBatchTeamsDeployment コマンドレットを使用して、作成するチームのバッチを送信します。 バッチごとにオーケストレーション ID が生成されます。 その後、 Get-CsBatchTeamsDeploymentStatus コマンドレットを使用して、各バッチの進行状況と状態を追跡できます。

1. 次を実行して、チームのバッチをデプロイします。 このコマンドでは、CSV ファイルへのパスと、この展開について通知する最大 5 人の受信者の電子メール アドレスを指定します。

   New-CsBatchTeamsDeployment -TeamsFilePath "Your CSV file path" -UsersFilePath "Your CSV file path" -UsersToNotify "Email addresses" 
   

   受信者は、展開の状態に関する電子メール通知を受け取ります。 電子メールには、送信したバッチのオーケストレーション ID と、発生した可能性があるエラーが含まれます。

   例:

   New-CsBatchTeamsDeployment -TeamsFilePath "C:\dscale\Teams.csv" -UsersFilePath "C:\dscale\Users.csv" -UsersToNotify "adminteams@contoso.com,adelev@contoso.com"
   

2. 次を実行して、送信したバッチの状態を確認します。

   Get-CsBatchTeamsDeploymentStatus -OrchestrationId "OrchestrationId"
   

現場チームの使用状況に関する分析を取得する

Teams 管理センターの Teams 使用状況レポート には、Teams の使用状況アクティビティの概要が表示されます。 レポートを使用すると、アクティブ ユーザー、アクティブ チャネル、開催された会議の合計、最終アクティビティの日付、その他の情報など、現場チームの使用状況の詳細を表示できます。

1. Teams 管理センターの左側のナビゲーションで、[Analytics & レポート>Usage レポート] を選択します。

2. [ レポートの表示 ] タブの [ レポート] で、[ Teams の使用状況] を選択します。

3. [ 日付範囲] で、7 日、30 日、90 日、または 180 日の日付範囲を選択します。 次に、[レポートの実行] を選択します。

4. 右上隅の [Excel にエクスポート>テーブルをCSV としてエクスポートする] を選択します。

5. 現場のチーム ID に基づいてスプレッドシートをフィルター処理します。

   注:

   チームをデプロイすると、現場のチーム ID が PowerShell 出力に一覧表示されます。

関連記事

• New-CsBatchTeamsDeployment
• Get-CsBatchTeamsDeploymentStatus
• Teams PowerShell の概要
• 現場での展開を開始する場所について説明します
• 組織に最適な現場チーム ソリューションを見つける方法