Skip to content

teams report deviceusageuserdetail

Gets detail about Microsoft Teams device usage by user.

Usage

m365 teams report deviceusageuserdetail [options]

Options

-p, --period [period]
The length of time over which the report is aggregated. Supported values D7,D30,D90,D180
-d, --date [date]
The date for which you would like to view the users who performed any activity. Supported date format is YYYY-MM-DD.
-f, --outputFile [outputFile]
Path to the file where the Microsoft Teams device usage by user 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

Remarks

As this report is only available for the past 28 days, date parameter value should be a date from that range.

Examples

Gets information about Microsoft Teams device usage by user for the last week

m365 teams report deviceusageuserdetail --period D7

Gets information about Microsoft Teams device usage by user for July 1, 2019

m365 teams report deviceusageuserdetail --date 2019-07-01

Gets information about Microsoft Teams device usage by user for the last week and exports the report data in the specified path in text format

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

Gets information about Microsoft Teams device usage by user for the last week and exports the report data in the specified path in json format

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

Response

[
  {
    "Report Refresh Date": "2022-10-24",
    "User Id": "00000000-0000-0000-0000-000000000000",
    "User Principal Name": "77E5979DD60BA6EAA53E814DBEEEFA5F",
    "Last Activity Date": "",
    "Is Deleted": "False",
    "Deleted Date": "",
    "Used Web": "No",
    "Used Windows Phone": "No",
    "Used iOS": "No",
    "Used Mac": "No",
    "Used Android Phone": "No",
    "Used Windows": "No",
    "Used  Chrome OS": "No",
    "Used Linux": "No",
    "Is Licensed": "Yes",
    "Report Period": "7"
  }
]
Report Refresh Date,User Id,User Principal Name,Last Activity Date,Is Deleted,Deleted Date,Used Web,Used Windows Phone,Used iOS,Used Mac,Used Android Phone,Used Windows,Used  Chrome OS,Used Linux,Is Licensed,Report Period
2022-10-24,00000000-0000-0000-0000-000000000000,77E5979DD60BA6EAA53E814DBEEEFA5F,,False,,No,No,No,No,No,No,No,No,Yes,7
Report Refresh Date,User Id,User Principal Name,Last Activity Date,Is Deleted,Deleted Date,Used Web,Used Windows Phone,Used iOS,Used Mac,Used Android Phone,Used Windows,Used  Chrome OS,Used Linux,Is Licensed,Report Period
2022-10-24,00000000-0000-0000-0000-000000000000,77E5979DD60BA6EAA53E814DBEEEFA5F,,False,,No,No,No,No,No,No,No,No,Yes,7