npm - @pnp/cli-microsoft365 - Versions diffs - 10.5.0-beta.b872a3f → 10.5.0 - Mend

@pnp/cli-microsoft365 10.5.0-beta.b872a3f → 10.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (76) hide show

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

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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>