@pnp/cli-microsoft365 6.8.0 → 6.9.0-beta.1cd2525

package/docs/docs/cmd/tenant/report/report-activeusercounts.mdx

@@ -0,0 +1,95 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant report activeusercounts
+
+Gets the count of daily active users in the reporting period by product.
+
+## Usage
+
+```sh
+m365 tenant report activeusercounts [options]
+```
+
+## Options
+
+```md definition-list
+`-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.
+```
+
+<Global />
+
+## Examples
+
+Gets the count of daily active users in the reporting period by product for the last week
+
+```sh
+m365 tenant report activeusercounts --period D7
+```
+
+Gets the count of daily active users in the reporting period by product for the last week and exports the report data in the specified path in text format
+
+```sh
+m365 tenant report activeusercounts --period D7 --output text > "activeusercounts.txt"
+```
+
+Gets the count of daily active users in the reporting period by product for the last week and exports the report data in the specified path in json format
+
+```sh
+m365 tenant report activeusercounts --period D7 --output json > "activeusercounts.json"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "Report Refresh Date": "2022-10-25",
+      "Office 365": "1",
+      "Exchange": "5",
+      "OneDrive": "4",
+      "SharePoint": "3",
+      "Skype For Business": "2",
+      "Yammer": "3",
+      "Teams": "1",
+      "Report Date": "2022-10-19",
+      "Report Period": "7"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  Report Refresh Date,Office 365,Exchange,OneDrive,SharePoint,Skype For Business,Yammer,Teams,Report Date,Report Period
+  2022-10-25,1,5,4,3,2,3,1,2022-10-19,7
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  Report Refresh Date,Office 365,Exchange,OneDrive,SharePoint,Skype For Business,Yammer,Teams,Report Date,Report Period
+  2022-10-25,1,5,4,3,2,3,1,2022-10-19,7
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  Report Refresh Date,Office 365,Exchange,OneDrive,SharePoint,Skype For Business,Yammer,Teams,Report Date,Report Period
+  2022-10-25,1,5,4,3,2,3,1,2022-10-19,7
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/tenant/report/report-activeuserdetail.mdx

@@ -0,0 +1,122 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant report activeuserdetail
+
+Gets details about Microsoft 365 active users
+
+## Usage
+
+```sh
+m365 tenant report activeuserdetail [options]
+```
+
+## Options
+
+```md definition-list
+`-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`. Specify the date or period, but not both.
+
+`-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 report should be stored in.
+```
+
+<Global />
+
+## Remarks
+
+As this report is only available for the past 28 days, date parameter value should be a date from that range.
+
+## Examples
+
+Gets details about Microsoft 365 active users for the last week
+
+```sh
+m365 tenant report activeuserdetail --period D7
+```
+
+Gets details about Microsoft 365 active users for May 1, 2019
+
+```sh
+m365 tenant report activeuserdetail --date 2019-05-01
+```
+
+Gets details about Microsoft 365 active users for the last week and exports the report data in the specified path in text format
+
+```sh
+m365 tenant report activeuserdetail --period D7 --output text > "activeuserdetail.txt"
+```
+
+Gets details about Microsoft 365 active users for the last week and exports the report data in the specified path in json format
+
+```sh
+m365 tenant report activeuserdetail --period D7 --output json > "activeuserdetail.json"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "Report Refresh Date": "2022-10-23",
+      "User Principal Name": "0439A166C614C2E8C7B4075DC4752054",
+      "Display Name": "2236A6E43D08F619FE695DF3B163A32F",
+      "Is Deleted": "False",
+      "Deleted Date": "",
+      "Has Exchange License": "True",
+      "Has OneDrive License": "True",
+      "Has SharePoint License": "True",
+      "Has Skype For Business License": "True",
+      "Has Yammer License": "True",
+      "Has Teams License": "True",
+      "Exchange Last Activity Date": "2020-03-27",
+      "OneDrive Last Activity Date": "2020-03-27",
+      "SharePoint Last Activity Date": "2020-04-30",
+      "Skype For Business Last Activity Date": "2020-05-10",
+      "Yammer Last Activity Date": "2020-05-10",
+      "Teams Last Activity Date": "2020-05-10",
+      "Exchange License Assign Date": "2020-02-26",
+      "OneDrive License Assign Date": "2020-02-26",
+      "SharePoint License Assign Date": "2020-02-26",
+      "Skype For Business License Assign Date": "2020-02-26",
+      "Yammer License Assign Date": "2020-02-26",
+      "Teams License Assign Date": "2020-02-26",
+      "Assigned Products": "MICROSOFT 365 E5 DEVELOPER (WITHOUT WINDOWS AND AUDIO CONFERENCING)"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  Report Refresh Date,User Principal Name,Display Name,Is Deleted,Deleted Date,Has Exchange License,Has OneDrive License,Has SharePoint License,Has Skype For Business License,Has Yammer License,Has Teams License,Exchange Last Activity Date,OneDrive Last Activity Date,SharePoint Last Activity Date,Skype For Business Last Activity Date,Yammer Last Activity Date,Teams Last Activity Date,Exchange License Assign Date,OneDrive License Assign Date,SharePoint License Assign Date,Skype For Business License Assign Date,Yammer License Assign Date,Teams License Assign Date,Assigned Products
+  2022-10-23,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,False,,True,True,True,True,True,True,2020-09-12,2022-09-12,2021-10-30,2020-10-30,2019-04-21,2017-09-20,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,MICROSOFT 365 E5 DEVELOPER (WITHOUT WINDOWS AND AUDIO CONFERENCING)
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  Report Refresh Date,User Principal Name,Display Name,Is Deleted,Deleted Date,Has Exchange License,Has OneDrive License,Has SharePoint License,Has Skype For Business License,Has Yammer License,Has Teams License,Exchange Last Activity Date,OneDrive Last Activity Date,SharePoint Last Activity Date,Skype For Business Last Activity Date,Yammer Last Activity Date,Teams Last Activity Date,Exchange License Assign Date,OneDrive License Assign Date,SharePoint License Assign Date,Skype For Business License Assign Date,Yammer License Assign Date,Teams License Assign Date,Assigned Products
+  2022-10-23,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,False,,True,True,True,True,True,True,,2022-09-12,2020-09-12,2022-09-12,2021-10-30,2020-10-30,2019-04-21,2017-09-20,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,MICROSOFT 365 E5 DEVELOPER (WITHOUT WINDOWS AND AUDIO CONFERENCING)
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  Report Refresh Date,User Principal Name,Display Name,Is Deleted,Deleted Date,Has Exchange License,Has OneDrive License,Has SharePoint License,Has Skype For Business License,Has Yammer License,Has Teams License,Exchange Last Activity Date,OneDrive Last Activity Date,SharePoint Last Activity Date,Skype For Business Last Activity Date,Yammer Last Activity Date,Teams Last Activity Date,Exchange License Assign Date,OneDrive License Assign Date,SharePoint License Assign Date,Skype For Business License Assign Date,Yammer License Assign Date,Teams License Assign Date,Assigned Products
+  2022-10-23,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,False,,True,True,True,True,True,True,,2022-09-12,2020-09-12,2022-09-12,2021-10-30,2020-10-30,2019-04-21,2017-09-20,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,MICROSOFT 365 E5 DEVELOPER (WITHOUT WINDOWS AND AUDIO CONFERENCING)
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/tenant/report/report-office365activationcounts.mdx

@@ -0,0 +1,72 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant report office365activationcounts
+
+Get the count of Microsoft 365 activations on desktops and devices
+
+## Usage
+
+```sh
+m365 tenant report office365activationcounts [options]
+```
+
+## Options
+
+<Global />
+
+## Examples
+
+Get the count of Microsoft 365 activations on desktops and devices
+
+```sh
+m365 tenant report office365activationcounts
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "Report Refresh Date": "2022-10-25",
+      "Product Type": "MICROSOFT 365 APPS FOR ENTERPRISE",
+      "Windows": 5,
+      "Mac": 0,
+      "Android": 0,
+      "iOS": 0,
+      "Windows 10 Mobile": 0
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  Report Refresh Date,Product Type,Windows,Mac,Android,iOS,Windows 10 Mobile
+  2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,5,0,0,0,0
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  Report Refresh Date,Product Type,Windows,Mac,Android,iOS,Windows 10 Mobile
+  2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,5,0,0,0,0
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  Report Refresh Date,Product Type,Windows,Mac,Android,iOS,Windows 10 Mobile
+  2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,5,0,0,0,0
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/tenant/report/report-office365activationsusercounts.mdx

@@ -0,0 +1,70 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant report office365activationsusercounts
+
+Get the count of users that are enabled and those that have activated the Office subscription on desktop or devices or shared computers
+
+## Usage
+
+```sh
+m365 tenant report office365activationsusercounts [options]
+```
+
+## Options
+
+<Global />
+
+## Examples
+
+Get the count of users that are enabled and those that have activated the Office subscription on desktop or devices or shared computers
+
+```sh
+m365 tenant report office365activationsusercounts
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "Report Refresh Date": "2022-10-25",
+      "Product Type": "MICROSOFT 365 APPS FOR ENTERPRISE",
+      "Assigned": 24,
+      "Activated": 5,
+      "Shared Computer Activation": 0
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  Report Refresh Date,Product Type,Assigned,Activated,Shared Computer Activation
+  2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,24,5,0
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  Report Refresh Date,Product Type,Assigned,Activated,Shared Computer Activation
+  2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,24,5,0
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  Report Refresh Date,Product Type,Assigned,Activated,Shared Computer Activation
+  2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,24,5,0
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/tenant/report/report-office365activationsuserdetail.mdx

@@ -0,0 +1,76 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant report office365activationsuserdetail
+
+Get details about users who have activated Microsoft 365
+
+## Usage
+
+```sh
+m365 tenant report office365activationsuserdetail [options]
+```
+
+## Options
+
+<Global />
+
+## Examples
+
+Get details about users who have activated Microsoft 365
+
+```sh
+m365 tenant report office365activationsuserdetail
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "Report Refresh Date": "2022-10-25",
+      "User Principal Name": "554630B7593DDE8E04F27933A965D5B2",
+      "Display Name": "2BA57CC6348F53C9EE6347528301E896",
+      "Product Type": "MICROSOFT EXCEL ADVANCED ANALYTICS",
+      "Last Activated Date": "2021-01-10",
+      "Windows": 0,
+      "Mac": 0,
+      "Windows 10 Mobile": 0,
+      "iOS": 0,
+      "Android": 0,
+      "Activated On Shared Computer": "False"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  Report Refresh Date,User Principal Name,Display Name,Product Type,Last Activated Date,Windows,Mac,Windows 10 Mobile,iOS,Android,Activated On Shared Computer
+  2022-10-25,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,MICROSOFT 365 APPS FOR ENTERPRISE,2021-01-10,1,0,0,0,0,False
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  Report Refresh Date,User Principal Name,Display Name,Product Type,Last Activated Date,Windows,Mac,Windows 10 Mobile,iOS,Android,Activated On Shared Computer
+  2022-10-25,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,MICROSOFT 365 APPS FOR ENTERPRISE,2021-01-10,1,0,0,0,0,False
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  Report Refresh Date,User Principal Name,Display Name,Product Type,Last Activated Date,Windows,Mac,Windows 10 Mobile,iOS,Android,Activated On Shared Computer
+  2022-10-25,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,MICROSOFT 365 APPS FOR ENTERPRISE,2021-01-10,1,0,0,0,0,False
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/tenant/report/report-servicesusercounts.mdx

@@ -0,0 +1,101 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant report servicesusercounts
+
+Gets the count of users by activity type and service.
+
+## Usage
+
+```sh
+m365 tenant report servicesusercounts [options]
+```
+
+## Options
+
+```md definition-list
+`-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 report should be stored in.
+```
+
+<Global />
+
+## Examples
+
+Gets the count of users by activity type and service for the last week
+
+```sh
+m365 tenant report servicesusercounts --period D7
+```
+
+Gets the count of users by activity type and service for the last week and exports the report data in the specified path in text format
+
+```sh
+m365 tenant report servicesusercounts --period D7 --output text > "servicesusercounts.txt"
+```
+
+Gets the count of users by activity type and service for the last week and exports the report data in the specified path in json format
+
+```sh
+m365 tenant report servicesusercounts --period D7 --output json > "servicesusercounts.json"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "Report Refresh Date": "2022-10-23",
+      "Exchange Active": "1",
+      "Exchange Inactive": "23",
+      "OneDrive Active": "1",
+      "OneDrive Inactive": "23",
+      "SharePoint Active": "1",
+      "SharePoint Inactive": "23",
+      "Skype For Business Active": "0",
+      "Skype For Business Inactive": "24",
+      "Yammer Active": "0",
+      "Yammer Inactive": "24",
+      "Teams Active": "1",
+      "Teams Inactive": "23",
+      "Office 365 Active": "2",
+      "Office 365 Inactive": "22",
+      "Report Period": "7"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  Report Refresh Date,Exchange Active,Exchange Inactive,OneDrive Active,OneDrive Inactive,SharePoint Active,SharePoint Inactive,Skype For Business Active,Skype For Business Inactive,Yammer Active,Yammer Inactive,Teams Active,Teams Inactive,Office 365 Active,Office 365 Inactive,Report Period
+  2022-10-23,1,23,1,23,1,23,0,24,0,24,1,23,2,22,7
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  Report Refresh Date,Exchange Active,Exchange Inactive,OneDrive Active,OneDrive Inactive,SharePoint Active,SharePoint Inactive,Skype For Business Active,Skype For Business Inactive,Yammer Active,Yammer Inactive,Teams Active,Teams Inactive,Office 365 Active,Office 365 Inactive,Report Period
+  2022-10-23,1,23,1,23,1,23,0,24,0,24,1,23,2,22,7
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  Report Refresh Date,Exchange Active,Exchange Inactive,OneDrive Active,OneDrive Inactive,SharePoint Active,SharePoint Inactive,Skype For Business Active,Skype For Business Inactive,Yammer Active,Yammer Inactive,Teams Active,Teams Inactive,Office 365 Active,Office 365 Inactive,Report Period
+  2022-10-23,1,23,1,23,1,23,0,24,0,24,1,23,2,22,7
+  ```
+
+  </TabItem>
+</Tabs>
+