Skip to main content

teams report deviceusageusercounts

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

Usage​

m365 teams report deviceusageusercounts [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 daily 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, md. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Examples​

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

m365 teams report deviceusageusercounts --period D7

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

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

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

m365 teams report deviceusageusercounts --period D7 --output json > "deviceusageusercounts.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 Date": "2022-10-24",
    "Report Period": "7"
  }
]
CTRL + M