@pnp/cli-microsoft365 10.4.0 → 10.5.0-beta.31351d1

package/docs/docs/cmd/todo/task/task-get.mdx

@@ -29,13 +29,13 @@ m365 todo task get [options]
 
 ## Examples
 
-Gets a specific task from a Microsoft To Do tasks list based on the name of the list and the task id
+Gets a specific task from a Microsoft To Do tasks list based on the name of the list and the task id.
 
 ```sh
 m365 todo task get --listName "My task list" --id "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA="
 ```
 
-Gets a specific task from a Microsoft To Do tasks list based on the id of the list and the task id
+Gets a specific task from a Microsoft To Do tasks list based on the id of the list and the task id.
 
 ```sh
 m365 todo task get --listId "AQMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MAAuAAADMN-7V4K8g0q_adetip1DygEAxMBBaLl1lk_dAn8KkjfXKQABF-BAgwAAAA==" --id "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA="
@@ -68,8 +68,13 @@ m365 todo task get --listId "AQMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM
   <TabItem value="Text">
 
   ```text
+  body                : {"content":"","contentType":"text"}
+  categories          : []
   createdDateTime     : 2022-10-23T14:05:09.2673009Z
+  hasAttachments      : false
   id                  : AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=
+  importance          : normal
+  isReminderOn        : false
   lastModifiedDateTime: 2022-10-23T14:15:11.3180312Z
   status              : notStarted
   title               : Stay healthy

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

@@ -0,0 +1,67 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# viva engage community user add
+
+Adds a user to a specific Microsoft 365 Viva Engage community
+
+## Usage
+
+```sh
+m365 viva engage community user add [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --communityId [communityId]`
+: The ID of the Viva Engage community. Specify `communityId`, `communityDisplayName` or `entraGroupId`.
+
+`-n, --communityDisplayName [communityDisplayName]`
+: The display name of the Viva Engage community. Specify `communityId`, `communityDisplayName` or `entraGroupId`.
+
+`--entraGroupId [entraGroupId]`
+: The ID of the Microsoft 365 group. Specify `communityId`, `communityDisplayName` or `entraGroupId`.
+
+`--ids [ids]`
+: Microsoft Entra IDs of users. You can pass a comma-separated list of multiple IDs. Specify either `ids` or `userNames` but not both.
+
+`--userNames [userNames]`
+: The user principal names of users. You can pass a comma-separated list of multiple UPNs. Specify either `ids` or `userNames` but not both.
+
+`-r, --role <role>`
+: The role to be assigned to the new users. Valid values: `Admin`, `Member`.
+```
+
+<Global />
+
+## Examples
+
+Add a single user specified by ID as a member to a community specified by display name.
+
+```sh
+m365 viva engage community user add --communityDisplayName "All company" --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
+```
+
+Add multiple users specified by ID as members to a community specified by ID.
+
+```sh
+m365 viva engage community user add --communityId eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIzNjAyMDAxMTAwOSJ9 --ids "098b9f52-f48c-4401-819f-29c33794c3f5,f1e06e31-3abf-4746-83c2-1513d71f38b8" --role Member
+```
+
+Add a single user specified by UPN as an admin to a community specified by display name.
+
+```sh
+m365 viva engage community user add --communityDisplayName "All company" --userNames john.doe@contoso.com --role Admin
+```
+
+Adds multiple users specified by UPN as admins to a community specified by its group ID.
+
+```sh
+m365 viva engage community user add --entraGroupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --userNames "john.doe@contoso.com,adele.vance@contoso.com" --role Admin
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/viva/engage/engage-community-user-remove.mdx

@@ -0,0 +1,55 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# viva engage community user remove
+
+Removes a specified user from a Microsoft 365 Viva Engage community
+
+## Usage
+
+```sh
+m365 viva engage community user remove [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --communityId [communityId]`
+: The ID of the Viva Engage community. Specify `communityId`, `communityDisplayName` or `entraGroupId`.
+
+`-n, --communityDisplayName [communityDisplayName]`
+: The display name of the Viva Engage community. Specify `communityId`, `communityDisplayName` or `entraGroupId`.
+
+`--entraGroupId [entraGroupId]`
+: The ID of the Microsoft 365 group. Specify `communityId`, `communityDisplayName` or `entraGroupId`.
+
+`--id [id]`
+: Microsoft Entra ID of the user. Specify either `id` or `userName` but not both.
+
+`--userName [userName]`
+: The user principal name of the user. Specify either `id` or `userName` but not both.
+
+`-f, --force`
+: Don't prompt for confirming removing the user from the specified Viva Engage community.
+```
+
+<Global />
+
+## Examples
+
+Remove a user specified by ID as a member from a community specified by display name.
+
+```sh
+m365 viva engage community user remove --communityDisplayName "All company" --id 098b9f52-f48c-4401-819f-29c33794c3f5
+```
+
+Remove a user specified by UPN from a community specified by its group ID without confirmation.
+
+```sh
+m365 viva engage community user remove --entraGroupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --userName john.doe@contoso.com --force
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -16,19 +16,19 @@ m365 viva engage message add [options]
 
 ```md definition-list
 `-b, --body <body>`
-: The text of the message body
+: The text of the message body.
 
 `--groupId [groupId]`
-: Post the message to this group, specified by ID. If this is set then the networkId is inferred from it. You must either specify `groupId`, `repliedToId`, or `directToUserIds` to send the message
+: Post the message to this group, specified by ID. If this is set then the networkId is inferred from it. You must either specify `groupId`, `repliedToId`, or `directToUserIds` to send the message.
 
 `-r, --repliedToId [repliedToId]`
-: The message ID this message is in reply to. If this is set then groupId and networkId are inferred from it. You must either specify `groupId`, `repliedToId`, or `directToUserIds` to send the message
+: The message ID this message is in reply to. If this is set then groupId and networkId are inferred from it. You must either specify `groupId`, `repliedToId`, or `directToUserIds` to send the message.
 
 `-d, --directToUserIds [directToUserIds]`
-: Send a private message to one or more users, specified by ID. Alternatively, you can use the Viva Engage network e-mail addresses instead of the IDs. You must either specify `groupId`, `repliedToId`, or `directToUserIds` to send the message
+: Send a private message to one or more users, specified by ID. Alternatively, you can use the Viva Engage network e-mail addresses instead of the IDs. You must either specify `groupId`, `repliedToId`, or `directToUserIds` to send the message.
 
 `--networkId [networkId]`
-: Specify the network to post a message
+: Specify the network to post a message.
 ```
 
 <Global />
@@ -43,37 +43,37 @@ In order to use this command, you need to grant the Microsoft Entra application
 
 ## Examples
 
-Replies to a message with the ID 1231231231
+Replies to a message with the ID 1231231231.
 
 ```sh
 m365 viva engage message add --body "Hello everyone!" --repliedToId 1231231231
 ```
 
-Sends a private conversation to the user with the ID 1231231231
+Sends a private conversation to the user with the ID 1231231231.
 
 ```sh
 m365 viva engage message add --body "Hello everyone!" --directToUserIds 1231231231
 ```
 
-Sends a private conversation to multiple users by ID
+Sends a private conversation to multiple users by ID.
 
 ```sh
 m365 viva engage message add --body "Hello everyone!" --directToUserIds "1231231231,1121312"
 ```
 
-Sends a private conversation to the user with several e-mail addresses
+Sends a private conversation to the user with several e-mail addresses.
 
 ```sh
 m365 viva engage message add --body "Hello everyone!" --directToUserIds "pl@nubo.eu,sc@nubo.eu"
 ```
 
-Posts a message to the group with the ID 12312312312
+Posts a message to the group with the ID 12312312312.
 
 ```sh
 m365 viva engage message add --body "Hello everyone!" --groupId 12312312312
 ```
 
-Posts a message to the group with the ID 12312312312 in the network 11112312
+Posts a message to the group with the ID 12312312312 in the network 11112312.
 
 ```sh
 m365 viva engage message add --body "Hello everyone!" --groupId 12312312312 --networkId 11112312
@@ -126,7 +126,32 @@ m365 viva engage message add --body "Hello everyone!" --groupId 12312312312 --ne
   <TabItem value="Text">
 
   ```text
-  id: 2000337648877569
+  attachments         : []
+  body                : {"parsed":"Hello everyone!","plain":"Hello everyone!","rich":"Hello everyone!"}
+  chat_client_sequence: null
+  client_type         : O365 Api Auth
+  client_url          : https://api.yammer.com
+  content_excerpt     : Hello everyone!
+  created_at          : 2022/11/11 20:59:56 +0000
+  delegate_id         : null
+  direct_message      : false
+  group_created_id    : 31158067201
+  group_id            : 31158067201
+  id                  : 2000337346863105
+  language            : null
+  liked_by            : {"count":0,"names":[]}
+  message_type        : update
+  network_id          : 5897756673
+  notified_user_ids   : []
+  privacy             : public
+  replied_to_id       : null
+  sender_id           : 36425097217
+  sender_type         : user
+  supplemental_reply  : false
+  system_message      : false
+  thread_id           : 2000337346863105
+  url                 : https://www.yammer.com/api/v1/messages/2000337346863105
+  web_url             : https://www.yammer.com/contoso.onmicrosoft.com/messages/2000337346863105
   ```
 
   </TabItem>

package/docs/docs/cmd/viva/engage/engage-message-get.mdx

@@ -31,13 +31,13 @@ In order to use this command, you need to grant the Microsoft Entra application
 
 ## Examples
 
-Returns the Viva Engage message with the id 1239871123
+Returns the Viva Engage message with the id 1239871123.
 
 ```sh
 m365 viva engage message get --id 1239871123
 ```
 
-Returns the Viva Engage message with the id 1239871123 in JSON format
+Returns the Viva Engage message with the id 1239871123 in JSON format.
 
 ```sh
 m365 viva engage message get --id 1239871123 --output json
@@ -89,17 +89,31 @@ m365 viva engage message get --id 1239871123 --output json
   <TabItem value="Text">
 
   ```text
-  content_excerpt: Hello everyone!
-  created_at     : 2022/11/11 21:00:20 +0000
-  direct_message : false
-  group_id       : 31158067201
-  id             : 2000337749565441
-  message_type   : update
-  privacy        : public
-  replied_to_id  : null
-  sender_id      : 36425097217
-  system_message : false
-  thread_id      : 2000337749565441
+  attachments         : []
+  body                : {"parsed":"Hello everyone!","plain":"Hello everyone!","rich":"Hello everyone!"}
+  chat_client_sequence: null
+  client_type         : O365 Api Auth
+  client_url          : https://api.yammer.com
+  content_excerpt     : Hello everyone!
+  created_at          : 2022/11/11 21:00:20 +0000
+  delegate_id         : null
+  direct_message      : false
+  group_id            : 31158067201
+  id                  : 2000337749565441
+  language            : no
+  liked_by            : {"count":0,"names":[]}
+  message_type        : update
+  network_id          : 5897756673
+  notified_user_ids   : []
+  privacy             : public
+  replied_to_id       : null
+  sender_id           : 36425097217
+  sender_type         : user
+  supplemental_reply  : false
+  system_message      : false
+  thread_id           : 2000337749565441
+  url                 : https://www.yammer.com/api/v1/messages/2000337749565441
+  web_url             : https://www.yammer.com/contoso.onmicrosoft.com/messages/2000337749565441
   ```
 
   </TabItem>

package/docs/docs/cmd/viva/engage/engage-user-get.mdx

@@ -146,20 +146,62 @@ m365 viva engage user get --email john.smith@contoso.com --output json
   <TabItem value="Text">
 
   ```text
-  email    : johndoe@contoso.onmicrosoft.com
-  full_name: johndoe
-  id       : 172006440961
-  job_title:
-  state    : active
-  url      : https://www.yammer.com/api/v1/users/172006440961
+  type                     : user
+  id                       : 172006440961
+  network_id               : 5897756673
+  state                    : active
+  job_title                : 
+  location                 : null
+  interests                : null
+  summary                  : null
+  expertise                : null
+  full_name                : johndoe
+  activated_at             : 2021/10/08 11:45:32 +0000
+  auto_activated           : false
+  show_ask_for_photo       : true
+  first_name               : 
+  last_name                : 
+  network_name             : Contoso
+  network_domains          : [contoso.onmicrosoft.com]
+  url                      : https://www.yammer.com/api/v1/users/172006440961
+  web_url                  : https://www.yammer.com/contoso.onmicrosoft.com/users/172006440961
+  name                     : admvalo
+  mugshot_url              : https://mugshot0eu-1.assets-yammer.com/mugshot/images/no_photo.png?P1=1668205841&P2=104&P3=1&P4=rnM2FPGOQRZja018qxAFshyyDKKH5SoUXkdpCeizRsdD7Ggb9sLSsdEaq-icgk8g-QTHFd0Te4e1gWAZTGEQekSQop6G6zDcipIVbZMJStEzfKKUpSPckcXnRhfiI55yq5AOLhVcH2PP_ZBFF-0KXMaP8Hy4dGDIRzmnUGhFuik0yjNBoGaYL86ltEaDMQdpS6rS3lmIMzLPGEMfr30vethAxRT7SKBbNYxZ9iPxO6TY26cYCfv0VyyMQkGGviPU4__EVjOoklhD_AqFGFGHtRTcsafpKOxCE70Z-nUpIPbYCel3las7w105u4SvPPC00Q5LUMDynUvzPiR4-vbWPg&size=48x48
+  mugshot_redirect_url     : https://www.yammer.com/mugshot/images/redirect/48x48/no_photo.png
+  mugshot_url_template     : https://mugshot0eu-1.assets-yammer.com/mugshot/images/no_photo.png?P1=1668205841&P2=104&P3=1&P4=rnM2FPGOQRZja018qxAFshyyDKKH5SoUXkdpCeizRsdD7Ggb9sLSsdEaq-icgk8g-QTHFd0Te4e1gWAZTGEQekSQop6G6zDcipIVbZMJStEzfKKUpSPckcXnRhfiI55yq5AOLhVcH2PP_ZBFF-0KXMaP8Hy4dGDIRzmnUGhFuik0yjNBoGaYL86ltEaDMQdpS6rS3lmIMzLPGEMfr30vethAxRT7SKBbNYxZ9iPxO6TY26cYCfv0VyyMQkGGviPU4__EVjOoklhD_AqFGFGHtRTcsafpKOxCE70Z-nUpIPbYCel3las7w105u4SvPPC00Q5LUMDynUvzPiR4-vbWPg&size={width}x{height}
+  mugshot_redirect_url_template: https://www.yammer.com/mugshot/images/redirect/{width}x{height}/no_photo.png
+  birth_date               : 
+  birth_date_complete      : 
+  timezone                 : Pacific Time (US & Canada)
+  external_urls            : []
+  admin                    : true
+  verified_admin           : true
+  m365_yammer_admin        : false
+  supervisor_admin         : false
+  o365_tenant_admin        : true
+  can_broadcast            : true
+  department               : null
+  email                    : johndoe@contoso.onmicrosoft.com
+  guest                    : false
+  aad_guest                : false
+  can_view_delegations     : false
+  can_create_new_network   : false
+  can_browse_external_networks: false
+  reaction_accent_color    : none
+  significant_other        : 
+  kids_names               : 
+  previous_companies       : []
+  schools                  : []
+  show_invite_lightbox     : false
+  age_bucket               : notSet
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  id,full_name,email,job_title,state,url
-  172006440961,admvalo,johndoe@contoso.onmicrosoft.com,,active,https://www.yammer.com/api/v1/users/172006440961
+  type,id,network_id,state,job_title,location,interests,summary,expertise,full_name,activated_at,auto_activated,show_ask_for_photo,first_name,last_name,network_name,network_domains,url,web_url,name,mugshot_url,mugshot_redirect_url,mugshot_url_template,mugshot_redirect_url_template,birth_date,birth_date_complete,timezone,external_urls,admin,verified_admin,m365_yammer_admin,supervisor_admin,o365_tenant_admin,can_broadcast,department,email,guest,aad_guest,can_view_delegations,can_create_new_network,can_browse_external_networks,reaction_accent_color,significant_other,kids_names,previous_companies,schools,show_invite_lightbox,age_bucket
+  user,172006440961,5897756673,active,,,null,null,null,johndoe,"2021/10/08 11:45:32 +0000",false,true,,,Contoso,"[contoso.onmicrosoft.com]","https://www.yammer.com/api/v1/users/172006440961","https://www.yammer.com/contoso.onmicrosoft.com/users/172006440961",admvalo,"https://mugshot0eu-1.assets-yammer.com/mugshot/images/no_photo.png?P1=1668205841&P2=104&P3=1&P4=rnM2FPGOQRZja018qxAFshyyDKKH5SoUXkdpCeizRsdD7Ggb9sLSsdEaq-icgk8g-QTHFd0Te4e1gWAZTGEQekSQop6G6zDcipIVbZMJStEzfKKUpSPckcXnRhfiI55yq5AOLhVcH2PP_ZBFF-0KXMaP8Hy4dGDIRzmnUGhFuik0yjNBoGaYL86ltEaDMQdpS6rS3lmIMzLPGEMfr30vethAxRT7SKBbNYxZ9iPxO6TY26cYCfv0VyyMQkGGviPU4__EVjOoklhD_AqFGFGHtRTcsafpKOxCE70Z-nUpIPbYCel3las7w105u4SvPPC00Q5LUMDynUvzPiR4-vbWPg&size=48x48","https://www.yammer.com/mugshot/images/redirect/48x48/no_photo.png","https://mugshot0eu-1.assets-yammer.com/mugshot/images/no_photo.png?P1=1668205841&P2=104&P3=1&P4=rnM2FPGOQRZja018qxAFshyyDKKH5SoUXkdpCeizRsdD7Ggb9sLSsdEaq-icgk8g-QTHFd0Te4e1gWAZTGEQekSQop6G6zDcipIVbZMJStEzfKKUpSPckcXnRhfiI55yq5AOLhVcH2PP_ZBFF-0KXMaP8Hy4dGDIRzmnUGhFuik0yjNBoGaYL86ltEaDMQdpS6rS3lmIMzLPGEMfr30vethAxRT7SKBbNYxZ9iPxO6TY26cYCfv0VyyMQkGGviPU4__EVjOoklhD_AqFGFGHtRTcsafpKOxCE70Z-nUpIPbYCel3las7w105u4SvPPC00Q5LUMDynUvzPiR4-vbWPg&size={width}x{height}","https://www.yammer.com/mugshot/images/redirect/{width}x{height}/no_photo.png",,"",Pacific Time (US & Canada),[],true,true,false,false,true,true,null,johndoe@contoso.onmicrosoft.com,false,false,false,false,false,none,,,[],[],false,notSet
   ```
 
   </TabItem>