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

package/docs/docs/cmd/teams/report/report-deviceusagedistributionusercounts.md

@@ -1,81 +0,0 @@
-# teams report deviceusagedistributionusercounts
-
-Get the number of Microsoft Teams unique users by device type. 
-
-## Usage
-
-```sh
-m365 teams report deviceusagedistributionusercounts [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 unique users by device type report should be stored in.
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Gets the number of Microsoft Teams unique users by device type for the last week.
-
-```sh
-m365 teams report deviceusagedistributionusercounts --period D7
-```
-
-Gets the number of Microsoft Teams unique users by device type for the last week and exports the report data in the specified path in text format.
-
-```sh
-m365 teams report deviceusagedistributionusercounts --period D7 --output text > "deviceusagedistributionusercounts.txt"
-```
-
-Gets the number of Microsoft Teams unique users by device type for the last week and exports the report data in the specified path in json format.
-
-```sh
-m365 teams report deviceusagedistributionusercounts --period D7 --output json > "deviceusagedistributionusercounts.json"
-```
-
-## Response
-
-=== "JSON"
-
-    ``` json
-    [
-      {
-        "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 Period": "7"
-      }
-    ]
-    ```
-
-=== "Text"
-
-    ``` text
-    Report Refresh Date,Web,Windows Phone,Android Phone,iOS,Mac,Windows,Chrome OS,Linux,Report Period
-    2022-10-24,0,0,0,0,0,1,0,0,7
-    ```
-
-=== "CSV"
-
-    ``` text
-    Report Refresh Date,Web,Windows Phone,Android Phone,iOS,Mac,Windows,Chrome OS,Linux,Report Period
-    2022-10-24,0,0,0,0,0,1,0,0,7
-    ```
-
-=== "Markdown"
-
-    ```md
-    Report Refresh Date,Web,Windows Phone,Android Phone,iOS,Mac,Windows,Chrome OS,Linux,Report Period
-    2022-10-24,0,0,0,0,0,1,0,0,7
-    ```

package/docs/docs/cmd/teams/report/report-deviceusageusercounts.md

@@ -1,82 +0,0 @@
-# teams report deviceusageusercounts
-
-Get the number of Microsoft Teams daily unique users by device type
-
-## Usage
-
-```sh
-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.
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Gets the number of Microsoft Teams daily unique users by device type for the last week.
-
-```sh
-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.
-
-```sh
-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.
-
-```sh
-m365 teams report deviceusageusercounts --period D7 --output json > "deviceusageusercounts.json"
-```
-
-## Response
-
-=== "JSON"
-
-    ``` json
-    [
-      {
-        "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"
-      }
-    ]
-    ```
-
-=== "Text"
-
-    ``` text
-    Report Refresh Date,Web,Windows Phone,Android Phone,iOS,Mac,Windows,Chrome OS,Linux,Report Date,Report Period
-    2022-10-24,0,0,0,0,0,1,0,0,2022-10-24,7
-    ```
-
-=== "CSV"
-
-    ``` text
-    Report Refresh Date,Web,Windows Phone,Android Phone,iOS,Mac,Windows,Chrome OS,Linux,Report Date,Report Period
-    2022-10-24,0,0,0,0,0,1,0,0,2022-10-24,7
-    ```
-
-=== "Markdown"
-
-    ```md
-    Report Refresh Date,Web,Windows Phone,Android Phone,iOS,Mac,Windows,Chrome OS,Linux,Report Date,Report Period
-    2022-10-24,0,0,0,0,0,1,0,0,2022-10-24,7
-    ```

package/docs/docs/cmd/teams/report/report-deviceusageuserdetail.md

@@ -1,100 +0,0 @@
-# teams report deviceusageuserdetail
-
-Gets detail about Microsoft Teams device usage by user
-
-## Usage
-
-```sh
-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.
-
---8<-- "docs/cmd/_global.md"
-
-## 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.
-
-```sh
-m365 teams report deviceusageuserdetail --period D7
-```
-
-Gets information about Microsoft Teams device usage by user for July 1, 2019.
-
-```sh
-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.
-
-```sh
-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.
-
-```sh
-m365 teams report deviceusageuserdetail --period D7 --output json > "deviceusageuserdetail.json"
-```
-
-## Response
-
-=== "JSON"
-
-    ``` json
-    [
-      {
-        "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"
-      }
-    ]
-    ```
-
-=== "Text"
-
-    ``` text
-    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
-    ```
-
-=== "CSV"
-
-    ``` text
-    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
-    ```
-
-=== "Markdown"
-
-    ```md
-    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
-    ```

package/docs/docs/cmd/teams/report/report-directroutingcalls.md

@@ -1,101 +0,0 @@
-# teams report directroutingcalls
-
-Get details about direct routing calls made within a given time period
-
-## Usage
-
-```sh
-m365 teams report directroutingcalls [options]
-```
-
-## Options
-
-`--fromDateTime <fromDateTime>`
-: The start of time range to query. UTC, inclusive.
-
-`--toDateTime [toDateTime]`
-: The end time range to query. UTC, inclusive. Defaults to today if omitted.
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-This command only works with app-only permissions. You will need to create your own Azure AD app with `CallRecords.Read.All` permission assigned. Instructions on how to create your own Azure AD app can be found at [Using your own Azure AD identity](../../../user-guide/using-own-identity.md)
-
-The difference between `fromDateTime` and `toDateTime` cannot exceed a period of 90 days.
-
-## Examples
-
-Get details about direct routing calls made between 2020-10-31 and today.
-
-```sh
-m365 teams report directroutingcalls --fromDateTime 2020-10-31
-```
-
-Get details about direct routing calls made between 2020-10-31 and 2020-12-31 and exports the report data in the specified path in text format.
-
-```sh
-m365 teams report directroutingcalls --fromDateTime 2020-10-31 --toDateTime 2020-12-31 --output text > "directroutingcalls.txt"
-```
-
-Get details about direct routing calls made between 2020-10-31 and 2020-12-31 and exports the report data in the specified path in json format.
-
-```sh
-m365 teams report directroutingcalls --fromDateTime 2020-10-31 --toDateTime 2020-12-31 --output json > "directroutingcalls.json"
-```
-
-## Response
-
-=== "JSON"
-
-    ``` json
-    {
-      "@odata.count": 1,
-      "value": [
-        {
-          "id": "9e8bba57-dc14-533a-a7dd-f0da6575eed1",
-          "correlationId": "c98e1515-a937-4b81-b8a8-3992afde64e0",
-          "userId": "db03c14b-06eb-4189-939b-7cbf3a20ba27",
-          "userPrincipalName": "richard.malk@contoso.com",
-          "userDisplayName": "Richard Malk",
-          "startDateTime": "2019-11-01T00:00:25.105Z",
-          "inviteDateTime": "2019-11-01T00:00:21.949Z",
-          "failureDateTime": "0001-01-01T00:00:00Z",
-          "endDateTime": "2019-11-01T00:00:30.105Z",
-          "duration": 5,
-          "callType": "ByotIn",
-          "successfulCall": true,
-          "callerNumber": "+12345678***",
-          "calleeNumber": "+01234567***",
-          "mediaPathLocation": "USWE",
-          "signalingLocation": "EUNO",
-          "finalSipCode": 0,
-          "callEndSubReason": 540000,
-          "finalSipCodePhrase": "BYE",
-          "trunkFullyQualifiedDomainName": "tll-audiocodes01.adatum.biz",
-          "mediaBypassEnabled": false
-        }
-      ]
-    }
-    ```
-
-=== "Text"
-
-    ``` text
-    id,calleeNumber,callerNumber,startDateTime
-    9e8bba57-dc14-533a-a7dd-f0da6575eed1,+01234567***,+12345678***,2019-11-01T00:00:25.105Z
-    ```
-
-=== "CSV"
-
-    ``` text
-    id,calleeNumber,callerNumber,startDateTime
-    9e8bba57-dc14-533a-a7dd-f0da6575eed1,+01234567***,+12345678***,2019-11-01T00:00:25.105Z
-    ```
-
-=== "Markdown"
-
-    ```md
-    id,calleeNumber,callerNumber,startDateTime
-    9e8bba57-dc14-533a-a7dd-f0da6575eed1,+01234567***,+12345678***,2019-11-01T00:00:25.105Z
-    ```

package/docs/docs/cmd/teams/report/report-pstncalls.md

@@ -1,105 +0,0 @@
-# teams report pstncalls
-
-Get details about PSTN calls made within a given time period
-
-## Usage
-
-```sh
-m365 teams report pstncalls [options]
-```
-
-## Options
-
-`--fromDateTime <fromDateTime>`
-: The start of time range to query. UTC, inclusive.
-
-`--toDateTime [toDateTime]`
-: The end time range to query. UTC, inclusive. Defaults to today if omitted.
-
---8<-- "docs/cmd/_global.md"
-
-## Remarks
-
-This command only works with app-only permissions. You will need to create your own Azure AD app with `CallRecords.Read.All` permission assigned. Instructions on how to create your own Azure AD app can be found at [Using your own Azure AD identity](../../../user-guide/using-own-identity.md)
-
-The difference between `fromDateTime` and `toDateTime` cannot exceed a period of 90 days.
-
-## Examples
-
-Get details about PSTN calls made between 2020-10-31 and today.
-
-```sh
-m365 teams report pstncalls --fromDateTime 2020-10-31
-```
-
-Get details about PSTN calls made between 2020-10-31 and 2020-12-31 and exports the report data in the specified path in text format.
-
-```sh
-m365 teams report pstncalls --fromDateTime 2020-10-31 --toDateTime 2020-12-31 --output text > "pstncalls.txt"
-```
-
-Get details about PSTN calls made between 2020-10-31 and 2020-12-31 and exports the report data in the specified path in json format.
-
-```sh
-m365 teams report pstncalls --fromDateTime 2020-10-31 --toDateTime 2020-12-31 --output json > "pstncalls.json"
-```
-
-## More information
-
-- List PSTN calls: [https://docs.microsoft.com/en-us/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0)
-
-## Response
-
-=== "JSON"
-
-    ``` json
-    {
-      "@odata.count": 1,
-      "value": [
-        {
-          "id": "9c4984c7-6c3c-427d-a30c-bd0b2eacee90",
-          "callId": "1835317186_112562680@61.221.3.176",
-          "userId": "db03c14b-06eb-4189-939b-7cbf3a20ba27",
-          "userPrincipalName": "richard.malk@contoso.com",
-          "userDisplayName": "Richard Malk",
-          "startDateTime": "2019-11-01T00:00:08.2589935Z",
-          "endDateTime": "2019-11-01T00:03:47.2589935Z",
-          "duration": 219,
-          "charge": 0.00,
-          "callType": "user_in",
-          "currency": "USD",
-          "calleeNumber": "+1234567890",
-          "usageCountryCode": "US",
-          "tenantCountryCode": "US",
-          "connectionCharge": 0.00,
-          "callerNumber": "+0123456789",
-          "destinationContext": null,
-          "destinationName": "United States",
-          "conferenceId": null,
-          "licenseCapability": "MCOPSTNU",
-          "inventoryType": "Subscriber"
-        }
-      ]
-  }
-    ```
-
-=== "Text"
-
-    ``` text
-    id,calleeNumber,callerNumber,startDateTime
-    9c4984c7-6c3c-427d-a30c-bd0b2eacee90,+1234567890,+0123456789,2019-11-01T00:00:08.2589935Z
-    ```
-
-=== "CSV"
-
-    ``` text
-    id,calleeNumber,callerNumber,startDateTime
-    9c4984c7-6c3c-427d-a30c-bd0b2eacee90,+1234567890,+0123456789,2019-11-01T00:00:08.2589935Z
-    ```
-
-=== "Markdown"
-
-    ```md
-    id,calleeNumber,callerNumber,startDateTime
-    9c4984c7-6c3c-427d-a30c-bd0b2eacee90,+1234567890,+0123456789,2019-11-01T00:00:08.2589935Z
-    ```

package/docs/docs/cmd/teams/report/report-useractivitycounts.md

@@ -1,85 +0,0 @@
-# teams report useractivitycounts
-
-Get the number of Microsoft Teams activities by activity type. The activity types are team chat messages, private chat messages, calls, and meetings
-
-## Usage
-
-```sh
-m365 teams report useractivitycounts [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 activities by activity type report should be stored in.
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Gets the number of Microsoft Teams activities by activity type for the last week.
-
-```sh
-m365 teams report useractivitycounts --period D7
-```
-
-Gets the number of Microsoft Teams activities by activity type for the last week and exports the report data in the specified path in text format.
-
-```sh
-m365 teams report useractivitycounts --period D7 --output text > "useractivitycounts.txt"
-```
-
-Gets the number of Microsoft Teams activities by activity type for the last week and exports the report data in the specified path in json format.
-
-```sh
-m365 teams report useractivitycounts --period D7 --output json > "useractivitycounts.json"
-```
-
-## Response
-
-=== "JSON"
-
-    ``` json
-    [
-      {
-        "Report Refresh Date": "2022-10-28",
-        "Report Date": "2022-10-28",
-        "Team Chat Messages": "0",
-        "Private Chat Messages": "0",
-        "Calls": "0",
-        "Meetings": "0",
-        "Meetings Organized Count": "0",
-        "Meetings Attended Count": "0",
-        "Audio Duration": "",
-        "Video Duration": "",
-        "Screen Share Duration": "",
-        "Post Messages": "0",
-        "Reply Messages": "0",
-        "Report Period": "7"
-      }
-    ]
-    ```
-
-=== "Text"
-
-    ``` text
-    Report Refresh Date,Report Date,Team Chat Messages,Private Chat Messages,Calls,Meetings,Meetings Organized Count,Meetings Attended Count,Audio Duration,Video Duration,Screen Share Duration,Post Messages,Reply Messages,Report Period
-    2022-10-28,2022-10-28,0,0,0,0,0,0,,,,0,0,7
-    ```
-
-=== "CSV"
-
-    ``` text
-    Report Refresh Date,Report Date,Team Chat Messages,Private Chat Messages,Calls,Meetings,Meetings Organized Count,Meetings Attended Count,Audio Duration,Video Duration,Screen Share Duration,Post Messages,Reply Messages,Report Period
-    2022-10-28,2022-10-28,0,0,0,0,0,0,,,,0,0,7
-    ```
-
-=== "Markdown"
-
-    ```md
-    Report Refresh Date,Report Date,Team Chat Messages,Private Chat Messages,Calls,Meetings,Meetings Organized Count,Meetings Attended Count,Audio Duration,Video Duration,Screen Share Duration,Post Messages,Reply Messages,Report Period
-    2022-10-28,2022-10-28,0,0,0,0,0,0,,,,0,0,7
-    ```

package/docs/docs/cmd/teams/report/report-useractivityusercounts.md

@@ -1,79 +0,0 @@
-# teams report useractivityusercounts
-
-Get the number of Microsoft Teams users by activity type. The activity types are number of teams chat messages, private chat messages, calls, or meetings
-
-## Usage
-
-```sh
-m365 teams report useractivityusercounts [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 users by activity type report should be stored in.
-
---8<-- "docs/cmd/_global.md"
-
-## Examples
-
-Gets the number of Microsoft Teams users by activity type for the last week.
-
-```sh
-m365 teams report useractivityusercounts --period D7
-```
-
-Gets the number of Microsoft Teams users by activity type for the last week and exports the report data in the specified path in text format.
-
-```sh
-m365 teams report useractivityusercounts --period D7 --output text > "useractivityusercounts.txt"
-```
-
-Gets the number of Microsoft Teams users by activity type for the last week and exports the report data in the specified path in json format.
-
-```sh
-m365 teams report useractivityusercounts --period D7 --output json > "useractivityusercounts.json"
-```
-
-## Response
-
-=== "JSON"
-
-    ``` json
-    [
-      {
-        "Report Refresh Date": "2022-10-28",
-        "Report Date": "2022-10-28",
-        "Team Chat Messages": "0",
-        "Private Chat Messages": "0",
-        "Calls": "0",
-        "Meetings": "0",
-        "Other Actions": "0",
-        "Report Period": "7"
-      }
-    ]
-    ```
-
-=== "Text"
-
-    ``` text
-    Report Refresh Date,Report Date,Team Chat Messages,Private Chat Messages,Calls,Meetings,Other Actions,Report Period
-    2022-10-28,2022-10-28,0,0,0,0,0,7
-    ```
-
-=== "CSV"
-
-    ``` text
-    Report Refresh Date,Report Date,Team Chat Messages,Private Chat Messages,Calls,Meetings,Other Actions,Report Period
-    2022-10-28,2022-10-28,0,0,0,0,0,7
-    ```
-
-=== "Markdown"
-
-    ```md
-    Report Refresh Date,Report Date,Team Chat Messages,Private Chat Messages,Calls,Meetings,Other Actions,Report Period
-    2022-10-28,2022-10-28,0,0,0,0,0,7
-    ```