@pnp/cli-microsoft365 8.0.0-beta.e6f9331 → 8.1.0-beta.309a9b8

package/docs/docs/cmd/teams/meeting/meeting-attendancereport-get.mdx

@@ -0,0 +1,138 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# teams meeting attendancereport get
+
+Gets attendance report for a given meeting
+
+## Usage
+
+```sh
+m365 teams meeting attendancereport get [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --userId [userId]`
+: The id of the user, omit to get attendance report for the current signed in user. Use either  `id`, `userName` or `email`, but not multiple.
+
+`-n, --userName [userName]`
+: The name of the user, omit to get attendance report for the current signed in user. Use either `id`, `userName` or `email`, but not multiple.
+
+`--email [email]`
+: The email of the user, omit to get attendance report for the current signed in user. Use either `id`, `userName` or `email`, but not multiple.
+
+`-m, --meetingId <meetingId>`
+: The Id of the meeting.
+
+`-i, --id <id>`
+: The Id of the attendance report.
+```
+
+<Global />
+
+## Remarks
+
+:::warning
+
+To run this command with application permissions, tenant administrators must create an application access policy and grant it to a user. This authorizes the app configured in the policy to fetch online meetings and/or online meeting artifacts on behalf of that user. For more details, click [here](https://learn.microsoft.com/graph/cloud-communication-online-meeting-application-access-policy).
+
+:::
+
+:::note 
+
+This method doesn't support channel meetings.
+
+:::
+
+## Examples
+
+Gets the specified attendance report made for the current signed in user and Microsoft Teams meeting with given id.
+
+```sh
+m365 teams meeting attendancereport get --meetingId MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ --id a8634e64-3147-4a56-9b19-cc822e9c7972
+```
+
+Gets the specified attendance report made for the garthf@contoso.com and Microsoft Teams meeting with given id.
+
+```sh
+m365 teams meeting attendancereport list --userName garthf@contoso.com --meetingId MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ --id a8634e64-3147-4a56-9b19-cc822e9c7972
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "a8634e64-3147-4a56-9b19-cc822e9c7972",
+    "totalParticipantCount": 1,
+    "meetingStartDateTime": "2024-04-06T08:18:21.668Z",
+    "meetingEndDateTime": "2024-04-06T08:18:28.482Z",
+    "attendanceRecords": [
+      {
+        "id": "de36f75e-c103-410b-a18a-2bf6df06ac3b",
+        "emailAddress": "john@contoso.com",
+        "totalAttendanceInSeconds": 3,
+        "role": "Organizer",
+        "identity": {
+          "id": "de36f75e-c103-410b-a18a-2bf6df06ac3b",
+          "displayName": "John Doe",
+          "tenantId": "f1dd4023-a656-480a-8a0e-c1b1eec51e1e"
+        },
+        "attendanceIntervals": [
+          {
+            "joinDateTime": "2024-04-06T08:18:24.5069531Z",
+            "leaveDateTime": "2024-04-06T08:18:28.4820462Z",
+            "durationInSeconds": 3
+          }
+        ]
+      }
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  attendanceRecords    : [{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","emailAddress":"john@contoso.com","totalAttendanceInSeconds":3,"role":"Organizer","identity":{"id":"de36f75e-c103-410b-a18a-2bf6df06ac3b","displayName":"John Doe","tenantId":"f1dd4023-a656-480a-8a0e-c1b1eec51e1e"},"attendanceIntervals":[{"joinDateTime":"2024-04-06T08:18:24.5069531Z","leaveDateTime":"2024-04-06T08:18:28.4820462Z","durationInSeconds":3}]}]
+  id                   : a8634e64-3147-4a56-9b19-cc822e9c7972
+  meetingEndDateTime   : 2024-04-06T08:18:28.482Z
+  meetingStartDateTime : 2024-04-06T08:18:21.668Z
+  totalParticipantCount: 1
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,totalParticipantCount,meetingStartDateTime,meetingEndDateTime
+  a8634e64-3147-4a56-9b19-cc822e9c7972,1,2024-04-06T08:18:21.668Z,2024-04-06T08:18:28.482Z
+  ```
+
+  </TabItem>
+
+  <TabItem value="Markdown">
+
+  ```md
+  # teams meeting attendancereport get --meetingId "MSpmZTM2Zjc1ZS1jMTAzLTQxMGItYTE4YS0yYmY2ZGYwNmFjM2EqMCoqMTk6bWVldGluZ19NRGt4TnpSaE56UXRZekZtWlMwMFlqWTFMVGhoTVRFdFpUWTBOV1JqTnpoaFkyVTVAdGhyZWFkLnYy" --id "a8634e64-3147-4a56-9b19-cc822e9c7972"
+
+  Date: 09/04/2024
+
+  ## a8634e64-3147-4a56-9b19-cc822e9c7972
+
+  Property | Value
+  ---------|-------
+  id | a8634e64-3147-4a56-9b19-cc822e9c7972
+  totalParticipantCount | 1
+  meetingStartDateTime | 2024-04-06T08:18:21.668Z
+  meetingEndDateTime | 2024-04-06T08:18:28.482Z
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/teams/meeting/meeting-list.mdx

@@ -25,17 +25,21 @@ m365 teams meeting list [options]
 : Set to retrieve only meetings the user is organizer for.
 
 `-u, --userId [userId]`
-: The id of the user or shared mailbox, omit to retrieve meetings for current signed in user. Use either `id`, `userName` or `email`, but not multiple. Use only when using application permissions.
+: The id of the user or shared mailbox, omit to retrieve meetings for current signed in user. Use either `userId`, `userName` or `email`, but not multiple. Use only when using application permissions.
 
 `-n, --userName [userName]`
-: The name of the user or shared mailbox, omit to retrieve meetings for current signed in user. Use either `id`, `userName` or `email`, but not multiple. Use only when using application permissions.
+: The name of the user or shared mailbox, omit to retrieve meetings for current signed in user. Use either `userId`, `userName` or `email`, but not multiple. Use only when using application permissions.
 
 `--email [email]`
-: The email of the user or shared mailbox, omit to retrieve meetings for current signed in user. Use either `id`, `userName` or `email`, but not multiple. Use only when using application permissions.
+: The email of the user or shared mailbox, omit to retrieve meetings for current signed in user. Use either `userId`, `userName` or `email`, but not multiple. Use only when using application permissions.
 ```
 
 <Global />
 
+## Remarks
+
+To use application permission for this command, an [application access policy](https://learn.microsoft.com/en-us/graph/cloud-communication-online-meeting-application-access-policy) must be created and assigned to a user. This authorizes the app configured in the policy to retrieve online meetings on behalf of that user.
+
 ## Examples
 
 List all meetings of the currently logged in user between two specific dates

package/docs/docs/cmd/teams/message/message-remove.mdx

@@ -0,0 +1,64 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# teams message remove
+
+Removes a message from a channel in a Microsoft Teams team
+
+## Usage
+
+```sh
+m365 teams message remove [options]
+```
+
+## Options
+
+```md definition-list
+`--teamId [teamId]`
+: ID of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both.
+
+`--teamName [teamName]`
+: Name of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both.
+
+`--channelId [channelId]`
+: Channel ID of the Microsoft Teams team. Specify either `channelId` or `channelName` but not both.
+
+`--channelName [channelName]`
+: Channel name of the Microsoft Teams team. Specify either `channelId` or `channelName` but not both.
+
+`-i, --id <id>`
+: The ID of the Teams message.
+
+`-f, --force`
+: Don't prompt for confirmation.  
+```
+
+<Global />
+
+## Remarks
+
+
+:::info
+
+This command does only support delegated permissions.  
+
+:::
+
+You can only remove Microsoft Teams messages that you created yourself.
+
+## Examples
+
+Remove a message by using IDs
+
+```sh
+m365 teams message remove --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2 --id 1540747442203
+```
+
+Remove a message by using display names
+
+```sh
+m365 teams message remove --teamName Marketing --channelName Branding --id 1540747442203
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/teams/message/message-restore.mdx

@@ -0,0 +1,62 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# teams message restore
+
+Restores a deleted message from a channel in a Microsoft Teams team
+
+## Usage
+
+```sh
+m365 teams message restore [options]
+```
+
+## Options
+
+```md definition-list
+`--teamId [teamId]`
+: ID of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both.
+
+`--teamName [teamName]`
+:	Name of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both.
+
+`--channelId [channelId]`
+:	Channel ID of the Microsoft Teams team. Specify either `channelId` or `channelName` but not both.
+
+`--channelName [channelName]`
+:	Channel name of the Microsoft Teams team. Specify either `channelId` or `channelName` but not both.
+
+`-i, --id <id>`
+:	The ID of the Teams message.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+This command does only support delegated permissions.
+
+:::
+
+You can only restore Microsoft Teams messages that you created yourself.
+
+## Examples
+
+Restore a deleted message by using IDs
+
+```sh
+m365 teams message restore --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2 --id 1540747442203
+```
+
+Restore a deleted message by using display names
+
+```sh
+m365 teams message restore --teamName Marketing --channelName Branding --id 1540747442203
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/viva/engage/engage-community-add.mdx

@@ -0,0 +1,168 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# viva engage community add
+
+Creates a new community in Viva Engage
+
+## Usage
+
+```sh
+m365 viva engage community add [options]
+```
+
+## Options
+
+```md definition-list
+`--displayName <displayName>`
+: The name of the community. The maximum length is 255 characters.
+
+`--description <description>`
+: The description of the community. The maximum length is 1024 characters.
+
+`--privacy <privacy>`
+: Defines the privacy level of the community. The possible values are: `public`, `private`.
+
+`--adminEntraIds [adminEntraIds]`
+: Comma-separated list of Microsoft Entra IDs, assigning admin privileges to the designated individuals. Required when using application permissions. Specify either `adminEntraIds` or `adminEntraUserNames`, but not both.
+
+`--adminEntraUserNames [adminEntraUserNames]`
+: Comma-separated list of Microsoft Entra UPNs, assigning admin privileges to the designated individuals. Required when using application permissions. Specify either `adminEntraIds` or `adminEntraUserNames`, but not both.
+
+`--wait`
+: Wait for the operation to finish.
+```
+
+<Global />
+
+## Remarks
+
+:::warning
+
+This command is based on an API that is currently in preview and is subject to change once the API reaches general availability.
+
+:::
+
+Creating a community is limited to networks in Native mode only - legacy and external Yammer networks will not be able to use this API for community creation.
+
+## Examples
+
+Create a public community and wait for the community to be created
+
+```sh
+m365 viva engage community add --displayName "Software engineers" --description "A community for all software engineers" --privacy public --wait
+```
+
+Create a private community
+
+```sh
+m365 viva engage community add --displayName "Software engineers" --description "A community for all software engineers" --privacy private
+```
+
+Create a private community with owners
+
+```sh
+m365 viva engage community add --displayName "Software engineers" --description "A community for all software engineers" --privacy private --adminEntraUserNames "john.doe@contoso.onmicrosoft.com,jane.doe@contoso.onmicrosoft.com"
+```
+
+## Response
+
+### Standard response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  "https://graph.microsoft.com/beta/employeeExperience/engagementAsyncOperations('eyJfdHlwZSI6IkxvbmdSdW5uaW5nT3BlcmF0aW9uIiwiaWQiOiI4ZmM2NzEyZS0wMWY4LTQxN2YtYWNmMS1iZTJiYmMxY2FjNGQiLCJvcGVyYXRpb24iOiJDcmVhdGVDb21tdW5pdHkifQ')"
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  https://graph.microsoft.com/beta/employeeExperience/engagementAsyncOperations('eyJfdHlwZSI6IkxvbmdSdW5uaW5nT3BlcmF0aW9uIiwiaWQiOiI4ZmM2NzEyZS0wMWY4LTQxN2YtYWNmMS1iZTJiYmMxY2FjNGQiLCJvcGVyYXRpb24iOiJDcmVhdGVDb21tdW5pdHkifQ')
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  https://graph.microsoft.com/beta/employeeExperience/engagementAsyncOperations('eyJfdHlwZSI6IkxvbmdSdW5uaW5nT3BlcmF0aW9uIiwiaWQiOiI4ZmM2NzEyZS0wMWY4LTQxN2YtYWNmMS1iZTJiYmMxY2FjNGQiLCJvcGVyYXRpb24iOiJDcmVhdGVDb21tdW5pdHkifQ')
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  https://graph.microsoft.com/beta/employeeExperience/engagementAsyncOperations('eyJfdHlwZSI6IkxvbmdSdW5uaW5nT3BlcmF0aW9uIiwiaWQiOiI4ZmM2NzEyZS0wMWY4LTQxN2YtYWNmMS1iZTJiYmMxY2FjNGQiLCJvcGVyYXRpb24iOiJDcmVhdGVDb21tdW5pdHkifQ')
+  ```
+
+  </TabItem>
+</Tabs>
+
+### `wait` response
+
+When we make use of the option `wait` the response will differ. 
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "eyJfdHlwZSI6IkxvbmdSdW5uaW5nT3BlcmF0aW9uIiwiaWQiOiI2ODgxMGQ4ZS1lODk2LTRhNzEtYWM5NC02NGIyZThlMmMyOGUiLCJvcGVyYXRpb24iOiJDcmVhdGVDb21tdW5pdHkifQ",
+    "createdDateTime": "2024-04-10T12:16:18.0240578Z",
+    "lastActionDateTime": "2024-04-10T12:16:18.0240592Z",
+    "status": "succeeded",
+    "statusDetail": null,
+    "resourceLocation": "https://graph.microsoft.com/beta/employeeExperience/communities('eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxODQ4MTMxNTAyMDgifQ')",
+    "operationType": "createCommunity",
+    "resourceId": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxODQ4MTMxNTAyMDgifQ"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  createdDateTime   : 2024-04-10T12:45:03.4020639Z
+  id                : eyJfdHlwZSI6IkxvbmdSdW5uaW5nT3BlcmF0aW9uIiwiaWQiOiI5NzRkMjUzZS1jMGUzLTQ2YjgtYTkzMy0zZDZhODU1NGE0OWUiLCJvcGVyYXRpb24iOiJDcmVhdGVDb21tdW5pdHkifQ
+  lastActionDateTime: 2024-04-10T12:45:03.4020656Z
+  operationType     : createCommunity
+  resourceId        : eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxODQ4MTUwNTA3NTIifQ
+  resourceLocation  : https://graph.microsoft.com/beta/employeeExperience/communities('eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxODQ4MTUwNTA3NTIifQ')
+  status            : succeeded
+  statusDetail      : null
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,createdDateTime,lastActionDateTime,status,statusDetail,resourceLocation,operationType,resourceId
+  eyJfdHlwZSI6IkxvbmdSdW5uaW5nT3BlcmF0aW9uIiwiaWQiOiJiMDU0MjFmNC0zNzU5LTQ3NzgtOTVhYi01NzhiYjAzZGNiMWQiLCJvcGVyYXRpb24iOiJDcmVhdGVDb21tdW5pdHkifQ,2024-04-12T11:24:29.074105Z,2024-04-12T11:24:29.0741064Z,succeeded,,https://graph.microsoft.com/beta/employeeExperience/communities('eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxODUwMTc2NzE2ODAifQ'),createCommunity,eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxODUwMTc2NzE2ODAifQ
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # viva engage community add --displayName "Software engineers" --description "A community for all software engineers" --privacy "private" --wait "true"
+
+  Date: 10/04/2024
+
+  ## eyJfdHlwZSI6IkxvbmdSdW5uaW5nT3BlcmF0aW9uIiwiaWQiOiI5ZTgzMDRjMC1mZmY0LTRkODgtYTM4OS1mNDY0MmQ3OGZlMTciLCJvcGVyYXRpb24iOiJDcmVhdGVDb21tdW5pdHkifQ
+
+  Property | Value
+  ---------|-------
+  id | eyJfdHlwZSI6IkxvbmdSdW5uaW5nT3BlcmF0aW9uIiwiaWQiOiI5ZTgzMDRjMC1mZmY0LTRkODgtYTM4OS1mNDY0MmQ3OGZlMTciLCJvcGVyYXRpb24iOiJDcmVhdGVDb21tdW5pdHkifQ
+  createdDateTime | 2024-04-10T12:47:47.3488087Z
+  lastActionDateTime | 2024-04-10T12:47:47.3488107Z
+  status | succeeded
+  resourceLocation | https://graph.microsoft.com/beta/employeeExperience/communities('eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxODQ4MTUyMzkxNjgifQ')
+  operationType | createCommunity
+  resourceId | eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxODQ4MTUyMzkxNjgifQ
+  ```
+
+  </TabItem>
+</Tabs>