Skip to main content

viva engage report deviceusagedistributionusercounts

Gets the number of users by device type

Usage​

m365 viva engage 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 users by device type for the last week

m365 viva engage report deviceusagedistributionusercounts --period D7

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

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

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

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

Response​

[
  {
    "Report Refresh Date": "2022-11-09",
    "Web": "77",
    "Windows Phone": "5",
    "Android Phone": "1",
    "iPhone": "7",
    "iPad": "6",
    "Other": "108",
    "Report Period": "7"
  }
]
CTRL + M