🐙
【PowerShell】MicrosoftTeamsのコマンドレットを試す
はじめに
PowerShellを用いて、MicrosoftTeamsの管理ポータルへアクセスする方法とMicrosoftTeamsのコマンドレットをいくつかアウトプットしたいと思います。
前提条件
- Office365へ登録済み
- 「Microsoft Windows 10 Pro」を使用
- .NET Frameworkは、バージョン4.8を使用
「.NET Framework」バージョン確認
PS C:\WINDOWS\system32> get-item 'HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full'
Hive: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4
Name Property
---- --------
Full CBS : 1
Install : 1
InstallPath : C:\Windows\Microsoft.NET\Framework64\v4.0.30319\
Release : 528372
Servicing : 0
TargetVersion : 4.0.0
Version : 4.8.04084
PS C:\WINDOWS\system32>
- PowerShellは、バージョン5.1を使用
PowerShellバージョン確認
PS C:\WINDOWS\system32> $PSVersionTable
Name Value
---- -----
PSVersion 5.1.19041.1237
PSEdition Desktop
PSCompatibleVersions {1.0, 2.0, 3.0, 4.0...}
BuildVersion 10.0.19041.1237
CLRVersion 4.0.30319.42000
WSManStackVersion 3.0
PSRemotingProtocolVersion 2.3
SerializationVersion 1.1.0.1
PS C:\WINDOWS\system32>
MicrosoftTeamsモジュールインストール手順
1.PowerShellを管理者権限にて起動する。
左下のWindowsボタンを右クリックし、PowerShellを管理者権限で起動する。
2.MicrosoftTeamsモジュールのインストールを実施する。
以下コマンドを実行する。
コマンド
Install-Module -Name MicrosoftTeams
コマンドを実行した場合、インストール実行するか確認されるため「Y」を選択。
3.MicrosoftTeamsモジュールのインストール確認
以下コマンドを実行する。
コマンド
Get-Module -Name MicrosoftTeams
MicrosoftTeamsモジュールが表示されることを確認する。
実行例
PS C:\WINDOWS\system32> Get-Module -Name MicrosoftTeams
ModuleType Version Name ExportedCommands
---------- ------- ---- ----------------
Script 2.6.0 MicrosoftTeams {Add-TeamUser, Connect-MicrosoftTeams, Disconnect-MicrosoftTeams, Get-MultiGeoRegion...}
PS C:\WINDOWS\system32>
※モジュールインストール時に以下エラーが表示された場合
エラー内容
警告: Unable to resolve package source 'https://www.powershellgallery.com/api/v2'.
こちらのページを参照して対応して下さい。
【PowerShell】「警告: Unable to resolve package source ~」と表示された場合の対応
MicrosoftTeamsへ接続
以下コマンドを実行する。
コマンド
Connect-MicrosoftTeams
以下のようなポップアップが表示されるため、Office365のアカウントを用いてログインを実施する。
ログインが完了すると、以下の実行結果が表示される。
実行例
PS C:\WINDOWS\system32> Connect-MicrosoftTeams
Account Environment Tenant TenantId
------- ----------- ------ --------
xxxxx@xxxxxxxxxxx.onmicrosoft.com AzureCloud xxxxx-xxxxx-xxxxx-xxxxx-xxxxx xxxxx-xxxxx-xxxxx-xxxxx-xxxxx
PS C:\WINDOWS\system32>
MicrosoftTeamsのコマンドレット
Teamの一覧を取得
コマンド
Get-Team
実行例
PS C:\WINDOWS\system32> Get-Team
GroupId DisplayName Visibility Archived MailNickName Description
------- ----------- ---------- -------- ------------ -----------
b412a3b4-cad3-4c4e-9ae2-7bdddaabc7eb TestTeam2 Private False TestTeam2
003924a7-cb62-447e-8c7d-8ea3d94d1632 TestTeam Private False TestTeam
PS C:\WINDOWS\system32>
特定のTeamの情報を取得
コマンド
Get-Team -GroupId <GroupId>
実行例
PS C:\WINDOWS\system32> Get-Team -GroupId b412a3b4-cad3-4c4e-9ae2-7bdddaabc7eb
GroupId DisplayName Visibility Archived MailNickName Description
------- ----------- ---------- -------- ------------ -----------
b412a3b4-cad3-4c4e-9ae2-7bdddaabc7eb TestTeam2 Private False TestTeam2
PS C:\WINDOWS\system32>
チームメンバーを取得する。
Teamに所属するチームメンバーを取得する。
コマンド
Get-Team -GroupId <GroupId>
実行例
PS C:\WINDOWS\system32> Get-TeamUser -GroupId b412a3b4-cad3-4c4e-9ae2-7bdddaabc7eb
UserId User Name Role
------ ---- ---- ----
xxxxx-xxxxx-xxxxx-xxxxx-xxxxx admin@xxxxxxxxx.onmicrosoft.com xxxxxx owner
xxxxx-xxxxx-xxxxx-xxxxx-xxxxx test1@xxxxxxxxx.work test 1 member
xxxxx-xxxxx-xxxxx-xxxxx-xxxxx test2@xxxxxxxxx.work test 2 member
PS C:\WINDOWS\system32>
最後に
今回は、以下についてご紹介しました。
- MicrosoftTeamsモジュールをPowerShellに導入する方法
- MicrosoftTeamsコマンドレットの基本的なコマンド
機会があれば、他のコマンドやスクリプトを作成して別記事でご紹介したいと思います。
Discussion