@pnp/cli-microsoft365 7.11.0-beta.c513557 → 8.0.0-beta.3c404b8

package/docs/docs/cmd/spo/contenttype/contenttype-field-list.mdx

@@ -0,0 +1,172 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo contenttype field list
+
+Lists fields for a given site or list content type
+
+## Usage
+
+```sh
+m365 spo contenttype field list [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: Absolute URL of the site where the content type is located.  
+
+`-i, --contentTypeId [contentTypeId]`  
+: The ID of the content type for which to list fields. Specify either `contentTypeId` or `contentTypeName`.  
+
+`-n, --contentTypeName [contentTypeName]`  
+: The name of the content type for which to list fields. Specify either `contentTypeId` or `contentTypeName`.  
+
+`-l, --listTitle [listTitle]`
+: Optional title of the list where the content type is located. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listId [listId]`
+: Optional ID of the list where the content type is located. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Optional server- or web-relative URL of the list where the content type is located. Specify either `listTitle`, `listId` or `listUrl`.  
+
+`-p, --properties [properties]`
+: Comma-separated list of properties to retrieve. Will retrieve all properties if not specified.
+```
+
+<Global />
+
+## Examples
+
+Retrieves fields for the specified site content type.  
+
+```sh
+m365 spo contenttype field list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --contentTypeId "0x01"
+```
+
+Retrieves fields for the specified list content type in the Documents library.  
+
+```sh
+m365 spo contenttype field list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --contentTypeName "Document" --listTitle "Documents"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "AutoIndexed": false,
+      "CanBeDeleted": false,
+      "ClientSideComponentId": "00000000-0000-0000-0000-000000000000",
+      "ClientSideComponentProperties": null,
+      "ClientValidationFormula": null,
+      "ClientValidationMessage": null,
+      "CustomFormatter": null,
+      "DefaultFormula": null,
+      "DefaultValue": null,
+      "Description": "",
+      "Direction": "none",
+      "EnforceUniqueValues": false,
+      "EntityPropertyName": "Title",
+      "Filterable": true,
+      "FromBaseType": true,
+      "Group": "_Hidden",
+      "Hidden": false,
+      "Id": "fa564e0f-0c70-4ab9-b863-0177e6ddd247",
+      "Indexed": false,
+      "IndexStatus": 0,
+      "InternalName": "Title",
+      "IsModern": false,
+      "JSLink": "clienttemplates.js",
+      "PinnedToFiltersPane": false,
+      "ReadOnlyField": false,
+      "Required": true,
+      "SchemaXml": "<Field ID=\"{fa564e0f-0c70-4ab9-b863-0177e6ddd247}\" Name=\"Title\" SourceID=\"http://schemas.microsoft.com/sharepoint/v3\" StaticName=\"Title\" Group=\"_Hidden\" Type=\"Text\" DisplayName=\"Title\" Required=\"TRUE\" FromBaseType=\"TRUE\" DelayActivateTemplateBinding=\"GROUP,SPSPERS,SITEPAGEPUBLISHING\" Customization=\"\" ShowInNewForm=\"TRUE\" ShowInEditForm=\"TRUE\"></Field>",
+      "Scope": "/",
+      "Sealed": false,
+      "ShowInFiltersPane": 0,
+      "Sortable": true,
+      "StaticName": "Title",
+      "Title": "Title",
+      "FieldTypeKind": 2,
+      "TypeAsString": "Text",
+      "TypeDisplayName": "Single line of text",
+      "TypeShortDescription": "Single line of text",
+      "ValidationFormula": null,
+      "ValidationMessage": null,
+      "MaxLength": 255
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  Id                                    Title   InternalName  Hidden
+  ------------------------------------  ------  ------------  ------
+  5ee2dd25-d941-455a-9bdb-7f2c54aed11b  Title   Title         false
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  AutoIndexed,CanBeDeleted,ClientSideComponentId,ClientSideComponentProperties,ClientValidationFormula,ClientValidationMessage,CustomFormatter,DefaultFormula,DefaultValue,Description,Direction,EnforceUniqueValues,EntityPropertyName,Filterable,FromBaseType,Group,Hidden,Id,Indexed,IndexStatus,InternalName,IsModern,JSLink,PinnedToFiltersPane,ReadOnlyField,Required,SchemaXml,Scope,Sealed,ShowInFiltersPane,Sortable,StaticName,Title,FieldTypeKind,TypeAsString,TypeDisplayName,TypeShortDescription,ValidationFormula,ValidationMessage,EnableLookup
+  ,,00000000-0000-0000-0000-000000000000,,,,,,,,none,,ContentType,1,,_Hidden,,c042a256-787d-4a6f-8a8a-cf6ab767f12d,,0,ContentType,,,,,,"<Field ID=""{c042a256-787d-4a6f-8a8a-cf6ab767f12d}"" Name=""ContentType"" SourceID=""http://schemas.microsoft.com/sharepoint/v3"" StaticName=""ContentType"" Group=""_Hidden"" Type=""Computed"" DisplayName=""Content Type"" Sealed=""TRUE"" Sortable=""FALSE"" RenderXMLUsingPattern=""TRUE"" PITarget=""MicrosoftWindowsSharePointServices"" PIAttribute=""ContentTypeID"" DelayActivateTemplateBinding=""GROUP,SPSPERS,SITEPAGEPUBLISHING"" Customization=""""><FieldRefs><FieldRef ID=""{03e45e84-1992-4d42-9116-26f756012634}"" Name=""ContentTypeId"" /></FieldRefs><DisplayPattern><MapToContentType><Column Name=""ContentTypeId"" /></MapToContentType></DisplayPattern></Field>",/,1,0,,ContentType,Content Type,12,Computed,Computed,Computed,,,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo contenttype field list --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --contentTypeId "0x01"
+
+  Date: 10/04/2024
+
+  ## Title (fa564e0f-0c70-4ab9-b863-0177e6ddd247)
+
+  Property | Value
+  ---------|-------
+  AutoIndexed | false
+  CanBeDeleted | false
+  ClientSideComponentId | 00000000-0000-0000-0000-000000000000
+  Description |
+  Direction | none
+  EnforceUniqueValues | false
+  EntityPropertyName | Title
+  Filterable | true
+  FromBaseType | true
+  Group | \_Hidden
+  Hidden | false
+  Id | fa564e0f-0c70-4ab9-b863-0177e6ddd247
+  Indexed | false
+  IndexStatus | 0
+  InternalName | Title
+  IsModern | false
+  JSLink | clienttemplates.js
+  PinnedToFiltersPane | false
+  ReadOnlyField | false
+  Required | true
+  SchemaXml | <Field ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" Name="Title" SourceID="http://schemas.microsoft.com/sharepoint/v3" StaticName="Title" Group="\_Hidden" Type="Text" DisplayName="Title" Required="TRUE" FromBaseType="TRUE" DelayActivateTemplateBinding="GROUP,SPSPERS,SITEPAGEPUBLISHING" Customization="" ShowInNewForm="TRUE" ShowInEditForm="TRUE"></Field>
+  Scope | /
+  Sealed | false
+  ShowInFiltersPane | 0
+  Sortable | true
+  StaticName | Title
+  Title | Title
+  FieldTypeKind | 2
+  TypeAsString | Text
+  TypeDisplayName | Single line of text
+  TypeShortDescription | Single line of text
+  MaxLength | 255
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/contenttype/contenttype-list.mdx

@@ -88,9 +88,9 @@ m365 spo contenttype list --webUrl "https://contoso.sharepoint.com/sites/contoso
   <TabItem value="Text">
 
   ```text
-  StringId                                                                    Name                             Hidden  ReadOnly  Sealed                                                                           
-  --------------------------------------------------------------------------  -------------------------------  ------  --------  ------
-  0x01007926A45D687BA842B947286090B8F67D                                      PnP Alert                        false   false     false                                                                            0x01007CE30DD1206047728BAFD1C39A850120                                      Official Notice                  false   false     false                                                                            0x0100807FBAC5EB8A4653B8D24775195B5463                                      Phone Call Memo                  false   false     false
+  StringId                                Name       Hidden  ReadOnly  Sealed
+  --------------------------------------  ---------  ------  --------  ------
+  0x01007926A45D687BA842B947286090B8F67D  PnP Alert  false   false     false
   ```
 
   </TabItem>

package/docs/docs/cmd/spo/field/field-list.mdx

@@ -116,9 +116,9 @@ m365 spo field list --webUrl https://contoso.sharepoint.com/sites/contoso-sales
   <TabItem value="Text">
 
   ```text
-  Id                                    Title                                    Group                                   Hidden
-  ------------------------------------  ---------------------------------------  --------------------------------------  ------
-  5ee2dd25-d941-455a-9bdb-7f2c54aed11b  Start date-time                          PnP Columns                             false
+  Id                                    Title            InternalName           Hidden
+  ------------------------------------  ---------------  ---------------------  ------
+  5ee2dd25-d941-455a-9bdb-7f2c54aed11b  Start date-time  PnPAlertStartDateTime  false
   ```
 
   </TabItem>

package/docs/docs/cmd/spo/group/group-member-add.mdx

@@ -110,17 +110,21 @@ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --
   ```json
   [
     {
-      "AllowedRoles": [
-        0
-      ],
-      "CurrentRole": 0,
-      "DisplayName": "John Doe",
-      "Email": "john.doe@contoso.onmicrosoft.com",
-      "InvitationLink": null,
-      "IsUserKnown": true,
-      "Message": null,
-      "Status": true,
-      "User": "i:0#.f|membership|john.doe@contoso.onmicrosoft.com"
+      "Id": 11,
+      "IsHiddenInUI": false,
+      "LoginName": "i:0#.f|membership|adelev@contoso.onmicrosoft.com",
+      "Title": "Adele Vance",
+      "PrincipalType": 1,
+      "Email": "Adele.Vance@contoso.onmicrosoft.com",
+      "Expiration": "",
+      "IsEmailAuthenticationGuestUser": false,
+      "IsShareByEmailGuestUser": false,
+      "IsSiteAdmin": false,
+      "UserId": {
+        "NameId": "10032001f5ac2029",
+        "NameIdIssuer": "urn:federation:microsoftonline"
+      },
+      "UserPrincipalName": "adelev@contoso.onmicrosoft.com"
     }
   ]
   ```
@@ -129,39 +133,42 @@ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --
   <TabItem value="Text">
 
   ```text
-  DisplayName  Email
-  -----------  ---------------------------------
-  John Doe     john.doe@contoso.onmicrosoft.com
+  Title        UserPrincipalName
+  -----------  -------------------------------------
+  Adele Vance  Adele.Vance@contoso.onmicrosoft.com
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  DisplayName,Email
-  John Doe,john.doe@contoso.onmicrosoft.com
+  Id,IsHiddenInUI,LoginName,Title,PrincipalType,Email,Expiration,IsEmailAuthenticationGuestUser,IsShareByEmailGuestUser,IsSiteAdmin,UserPrincipalName
+  11,,i:0#.f|membership|adelev@contoso.onmicrosoft.com,Adele Vance,1,Adele.Vance@contoso.onmicrosoft.com,,,,,adelev@contoso.onmicrosoft.com
   ```
 
   </TabItem>
   <TabItem value="Markdown">
 
   ```md
-  # spo group member add --webUrl "https://contoso.sharepoint.com" --groupId "5" --aadGroupIds "f2fb2f10-cfd2-4054-8ffd-64533657a5ab"
+  # spo group member add --webUrl "https://contoso.sharepoint.com/sites/Marketing" --groupId "5" --userNames "AdeleV@contoso.onmicrosoft.com"
 
-  Date: 13/2/2023
+  Date: 10/07/2024
 
-  ## All Company Members
+  ## Adele Vance (11)
 
   Property | Value
   ---------|-------
-  CurrentRole | 0
-  DisplayName | All Company Members
-  Email | allcompany@contoso.onmicrosoft.com
-  InvitationLink | null
-  IsUserKnown | true
-  Message | null
-  Status | true
-  User | c:0o.c\|federateddirectoryclaimprovider\|f2fb2f10-cfd2-4054-8ffd-64533657a5ab
+  Id | 11
+  IsHiddenInUI | false
+  LoginName | i:0#.f\|membership\|adelev@contoso.onmicrosoft.com
+  Title | Adele Vance
+  PrincipalType | 1
+  Email | Adele.Vance@contoso.onmicrosoft.com
+  Expiration |
+  IsEmailAuthenticationGuestUser | false
+  IsShareByEmailGuestUser | false
+  IsSiteAdmin | false
+  UserPrincipalName | adelev@contoso.onmicrosoft.com
   ```
 
   </TabItem>

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/message/message-remove.mdx

@@ -0,0 +1,63 @@
+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
+
+You can only remove Microsoft Teams messages that you created yourself.  
+
+:::info
+
+This command does only support delegated permissions.  
+
+:::
+
+## 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/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>