Skip to main content

viva engage report deviceusageuserdetail

Gets details about viva engage device usage by user

Usage​

m365 viva engage 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.

-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​

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

info

This command supports only csv and json output.

Examples​

Gets details about Viva Engage device usage by user for the last week

m365 viva engage report deviceusageuserdetail --period D7

Gets details about Viva Engage device usage by user for July 1, 2019

m365 viva engage report deviceusageuserdetail --date 2019-07-01

Gets details about Viva Engage device usage by user for the last week and exports the report data in the specified path in text format

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

Gets details about Viva Engage device usage by user for the last week and exports the report data in the specified path in json format

m365 viva engage report deviceusageuserdetail --period D7 --output json > "deviceusageuserdetail.json"

Response​

[
  {
    "Report Refresh Date": "2022-11-09",
    "User Principal Name": "0439A166C614C2E8C7B4075DC4752054",
    "Display Name": "2236A6E43D08F619FE695DF3B163A32F",
    "User State": "",
    "State Change Date": "",
    "Last Activity Date": "",
    "Used Web": "No",
    "Used Windows Phone": "No",
    "Used Android Phone": "No",
    "Used iPhone": "No",
    "Used iPad": "No",
    "Used Others": "No",
    "Report Period": "7"
  }
]
CTRL + M