Microsoft Teams Tips: PowerShellによるチームの参加者一覧取得と参加者追加

PowerShell を使うことで、チームの参加者一覧を取得したり、参加者を追加したりすることができます。

■ 準備 (以下は Windows 版での説明ですが、Mac 版の Powershell でも同様のコマンドです。)

1. Windows PowerShell を右クリックし、[管理者として実行] をクリック。
    ※ UAC (User Account Control) プロンプトで [はい] をクリック (設定によってはプロンプトなし)

2. Windows PowerShell 内で次のコマンドレットを入力し [Enter] キーを押す。

    Install-Module MicrosoftTeams

※ インストール済みの場合は、警告表示が出る。

3. Windows PowerShell を Microsoft Teams に接続するにあたって、以下のコマンドレットを実行。

    Connect-MicrosoftTeams

( Connect-MicrosoftTeamsを実行すると、"The term 'Connect-MicrosoftTeams' is not recognized as ~"というエラーが出る場合は、3の前に、

    Import-Module -Name MicrosoftTeams

の実行が必要な場合があります。また、PowerShellを一旦終了させて再度起動させるとうまく行くことがあります。)

4. サインイン画面が表示されたら、「該当チームの所有者」のアカウントにて、サインイン。

    (学生用テナントで授業に使うチームのメンバ一覧を取得する場合は、アカウントは
       ユーザID@edu.cc.saga-u.ac.jp
    になるので注意)

※ 以後、PowerShell を Microsoft Teams に接続するには、項番 3、4 の手順のみで接続が可能。

■  チームに登録されたメンバ一覧を取得する

1. (自分が所有する)チームのグループIDを確認するために、以下のコマンドレットを実行。

    Get-Team -User <自分のアカウント名>

2. グループIDで指定されたチームのメンバ一覧を表示するには、以下のコマンドレットを実行。

    Get-TeamUser -GroupId <グループID>

■  チームにメンバを登録する

1. (自分が所有する)チームのグループIDを確認するために、以下のコマンドレットを実行。

    Get-Team -User <自分のアカウント名>

2. グループIDで指定されたチームにメンバ一を追加するには、以下のコマンドレットを実行。<アカウント名>のユーザを、参加者(Member)または所有者(Owner)として追加。

    Add-TeamUser -GroupId <グループID> -User <アカウント名> -Role <Member/Owner>


---------