Skip to main 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.

-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 options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

info

This command supports only csv and json output.

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"
  }
]
CTRL + M