Teams デバイスの一覧をMicrosoft Graph API で取得する

Microsoft Graph API を利用して Microsoft 365 テナントに紐づくデバイスの一覧を取得できます。

本ポストは、下記のMicrosoft 365 and Power Platform Community ブログを主に参考にしました。

Manage Teams Devices in Graph

Learn での関連ドキュメントです。

List teamworkDevices - Microsoft Graph beta

Get-MgTeamworkDevice (Microsoft.Graph.Teams)

本コマンドはGraph API のバージョンを1.0からBeta に変える必要がありました。

Get started with the Microsoft Graph PowerShell SDK

また、このコマンドを使うためのパーミッションは"TeamworkDevice.Read.All","TeamworkDevice.ReadWrite.All"　になります。
なお、Microsoft Teams Rooms on Android は「collaborationBar」、そのタッチコンソールは「touchConsole」とDeviceTypeでカテゴライズされます。

PS> Install-Module -Name Microsoft.Graph

Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change its
InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from
'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
PS > Import-Module Microsoft.Graph.Teams
PS > Select-MgProfile -Name "beta"
PS > Connect-MgGraph -Scopes "TeamworkDevice.Read.All","TeamworkDevice.ReadWrite.All"
Welcome To Microsoft Graph!
PS > Get-MgTeamworkDevice

Id                                   ActivityState CompanyAssetTag CreatedDateTime    DeviceType       HealthStatus Las
                                                                                                                    tMo
                                                                                                                    dif
                                                                                                                    ied
                                                                                                                    Dat
                                                                                                                    eTi
                                                                                                                    me
--                                   ------------- --------------- ---------------    ----------       ------------ ---
a57293ca-e186-487b-88f6-6b61331ac0b7 unknown                       2023/04/07 9:09:00 teamsDisplay     healthy      20…
55c5b648-06ac-4295-ada2-99395334a8b9 unknown                       2023/04/03 2:30:23 collaborationBar offline      20…
54e1bba4-e7bc-4863-a470-d5d3639b65a2 unknown                       2023/04/03 2:29:05 touchConsole     nonUrgent    20…
2fe8091a-8408-4036-82f4-3de57902da38 unknown                       2023/03/30 6:19:44 teamsDisplay     offline      20…

macOSで上記を試した場合

PS > $device = Get-MgTeamworkDevice -TeamworkDeviceId a57293ca-e186-487b-88f6-6b61331ac0b7
PS > $device.id
a57293ca-e186-487b-88f6-6b61331ac0b7
PS > $device.HardwareDetail

MacAddresses        Manufacturer Model  SerialNumber  UniqueId
------------        ------------ -----  ------------  --------
{WIFI:C463FB033D35} neatframe    nf21f1 nf12204000357 nf12204000357
PS > $device.CurrentUser

DisplayName Id                                   UserIdentityType
----------- --                                   ----------------
User 01     998cdff5-1614-4fb4-8895-2dddb93a811c aadUser

デバイスの再起動

PS > Restart-MgTeamworkDevice -TeamworkDeviceId a57293ca-e186-487b-88f6-6b61331ac0b7