トップ > Microsoft Teams > Microsoft Teamsのチャネルに関するPowerShellコマンド

Microsoft Teamsのチャネルに関するPowerShellコマンド

Microsoft Teams Teams PowerShell

Microsoft Teams PowerShellを利用することで、PowerShellコマンドでMicrosoft Teamsを管理することが可能となります。

本記事では、Microsoft Teamsのチャネル一括作成や削除、チャネルへのメンバーの一括追加や削除のコマンドについて記載します。

前提条件

本記事のコマンドを実行する場合、Microsoft Teams PowerShellモジュールがインストールされている必要があります。

インストールされていない場合は、以下のリンクからインストールしてください。

learn.microsoft.com

チャネル一括作成

複数のチームに対して、複数のチャネルを一括で作成します。

CSVファイルの用意

1．作成するチャネルをCSVファイルとしてまとめます。各列については以下の通りです。

  • GroupID
    • 「Get-Team」コマンドを実行することで取得可能
  •  DisplayName
    • 作成するチャネル名
  • MembershipType
    • チャネルの種類を指定
      • プライベートチャネル：Private
      • 標準チャネル：Standard
      • 共有チャネル：Shared
  • Owner
    • チャネルの所有者を設定するパラメータ
    • プライベートチャネルもしくは共有チャネルのみ、本パラメータを指定

CSVファイルの作成例

2．ファイルの種類を「CSV UTF-8」とし、任意の場所に保存します。

コマンド実行

1．Windows PowerShellを管理者として起動します。

2．以下コマンドを実行し、Microsoft Teamsへ接続します。

Connect-MicrosotTeams

3．以下コマンドを実行し、チャネルを作成します。

Import-Csv -Path "Csv ファイルの保存先\ファイル名.csv" | Foreach {New-TeamChannel -GroupId $_.GroupId -DisplayName $_.DisplayName -MembershipType $_.MembershipType}

4．チャネルが作成されたことを確認します。

チャネル一括削除

複数のチームに対して、複数のチャネルを一括で削除します。

CSVファイルの用意

1．削除するチャネルをCSVファイルとしてまとめます。各列については以下の通りです。

  • GroupID
    • 「Get-Team」コマンドを実行することで取得可能
  • DisplayName
    • 削除するチャネル名

2．ファイルの種類を「CSV UTF-8」とし、任意の場所に保存します。

コマンド実行

1．Windows PowerShellを管理者として起動します。

2．以下コマンドを実行し、Microsoft Teamsへ接続します。

Connect-MicrosoftTeams

3．以下コマンドを実行します。

Import-Csv -Path "Csv ファイルの保存先\ファイル名.csv" | Foreach {Remove-TeamChannel -GroupId $_.GroupId -DisplayName $_.DisplayName}

4．チャネルが削除されたことを確認します。

メンバー一括追加

複数のチャネルに対して、メンバーを一括で追加します。

CSVファイルの用意

1．メンバーを追加するチャネルをCSVファイルとしてまとめます。各列については以下の通りです。

  • GroupID
    • 「Get-Team」コマンドを実行することで取得可能
  • DisplayName
    • メンバーを追加するチャネル名
  • UserEmailAddress
    • 追加するメンバーのUPN

2．ファイルの種類を「CSV UTF-8」とし、任意の場所に保存します。

コマンド実行

1．Windows PowerShellを管理者として起動します。

2．以下コマンドを実行し、Microsoft Teamsへ接続します。

Connect-MicrosoftTeams

3．以下コマンドを実行します。

Import-Csv -Path "Csv ファイルの保存先\ファイル名.csv" | Foreach {Add-TeamChannelUser -GroupId $_.GroupId -DisplayName $_.DisplayName -User $_.UserEmailAddress}

4．チャネルにメンバーが追加されたことを確認します。

メンバー一括削除

複数のチャネルに対して、メンバーを一括で削除します。

CSVファイルの用意

1．メンバーを削除するチャネルをCSVファイルとしてまとめます。各列については以下の通りです。

  • GroupID
    • 「Get-Team」コマンドを実行することで取得可能
  • DisplayName
    • メンバーを削除するチャネル名
  • UserEmailAddress
    • 削除するメンバーのUPN

2．ファイルの種類を「CSV UTF-8」とし、任意の場所に保存します。

コマンド実行

1．Windows PowerShellを管理者として起動します。

2．以下コマンドを実行し、Microsoft Teamsへ接続します。

Connect-MicrosoftTeams

3．以下コマンドを実行します。

Import-Csv -Path "Csv ファイルの保存先\ファイル名.csv" | Foreach {Remove-TeamChannelUser -GroupId $_.GroupId -DisplayName $_.DisplayName -User $_.UserEmailAddress}

4．チャネルからメンバーが削除されたことを確認します。

まとめ

本記事では、Microsoft Teamsのチャネルの一括作成や削除、チャネルへのメンバーの一括追加や削除のコマンドについて記載しました。

ぜひ参考にしてみてください。

執筆担当者プロフィール
石澤 聖也

石澤 聖也（日本ビジネスシステムズ株式会社）

主にMicrosoft 365系を扱っています。趣味は筋トレと映画鑑賞。

担当記事一覧