Skip to content

teams report deviceusagedistributionusercounts

Get the number of Microsoft Teams unique users by device type.

Usage

m365 teams report deviceusagedistributionusercounts [options]

Options

-p, --period <period>
The length of time over which the report is aggregated. Supported values D7,D30,D90,D180
-f, --outputFile [outputFile]
Path to the file where the Microsoft Teams unique users by device type report should be stored in
-h, --help [help]
Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Examples

Gets the number of Microsoft Teams unique users by device type for the last week

m365 teams report deviceusagedistributionusercounts --period D7

Gets the number of Microsoft Teams unique users by device type for the last week and exports the report data in the specified path in text format

m365 teams report deviceusagedistributionusercounts --period D7 --output text > "deviceusagedistributionusercounts.txt"

Gets the number of Microsoft Teams unique users by device type for the last week and exports the report data in the specified path in json format

m365 teams report deviceusagedistributionusercounts --period D7 --output json > "deviceusagedistributionusercounts.json"

Response

[
  {
    "Report Refresh Date": "2022-10-24",
    "Web": "0",
    "Windows Phone": "0",
    "Android Phone": "0",
    "iOS": "0",
    "Mac": "0",
    "Windows": "1",
    "Chrome OS": "0",
    "Linux": "0",
    "Report Period": "7"
  }
]
Report Refresh Date,Web,Windows Phone,Android Phone,iOS,Mac,Windows,Chrome OS,Linux,Report Period
2022-10-24,0,0,0,0,0,1,0,0,7
Report Refresh Date,Web,Windows Phone,Android Phone,iOS,Mac,Windows,Chrome OS,Linux,Report Period
2022-10-24,0,0,0,0,0,1,0,0,7