@pnp/cli-microsoft365 7.0.0-beta.c2db9df → 7.0.0-beta.e15bb2d

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 (73) hide show
  1. package/dist/m365/aad/commands/app/app-set.js +4 -4
  2. package/dist/m365/aad/commands/approleassignment/approleassignment-add.js +4 -4
  3. package/dist/m365/aad/commands/approleassignment/approleassignment-remove.js +4 -4
  4. package/dist/m365/aad/commands/group/group-remove.js +98 -0
  5. package/dist/m365/aad/commands/m365group/m365group-add.js +9 -3
  6. package/dist/m365/aad/commands.js +1 -0
  7. package/dist/m365/graph/commands/subscription/subscription-add.js +5 -5
  8. package/dist/m365/planner/commands/bucket/bucket-add.js +4 -1
  9. package/dist/m365/planner/commands/bucket/bucket-get.js +4 -1
  10. package/dist/m365/planner/commands/bucket/bucket-list.js +4 -1
  11. package/dist/m365/planner/commands/bucket/bucket-remove.js +4 -1
  12. package/dist/m365/planner/commands/bucket/bucket-set.js +4 -1
  13. package/dist/m365/planner/commands/plan/plan-add.js +4 -1
  14. package/dist/m365/planner/commands/plan/plan-get.js +4 -1
  15. package/dist/m365/planner/commands/plan/plan-list.js +4 -1
  16. package/dist/m365/planner/commands/plan/plan-remove.js +4 -1
  17. package/dist/m365/planner/commands/plan/plan-set.js +4 -1
  18. package/dist/m365/planner/commands/roster/roster-get.js +4 -1
  19. package/dist/m365/planner/commands/roster/roster-member-add.js +4 -1
  20. package/dist/m365/planner/commands/roster/roster-member-get.js +4 -1
  21. package/dist/m365/planner/commands/roster/roster-member-list.js +4 -1
  22. package/dist/m365/planner/commands/roster/roster-member-remove.js +4 -1
  23. package/dist/m365/planner/commands/roster/roster-plan-list.js +4 -1
  24. package/dist/m365/planner/commands/roster/roster-remove.js +4 -1
  25. package/dist/m365/planner/commands/task/task-add.js +4 -1
  26. package/dist/m365/planner/commands/task/task-checklistitem-add.js +4 -1
  27. package/dist/m365/planner/commands/task/task-checklistitem-list.js +4 -1
  28. package/dist/m365/planner/commands/task/task-checklistitem-remove.js +4 -1
  29. package/dist/m365/planner/commands/task/task-get.js +4 -1
  30. package/dist/m365/planner/commands/task/task-list.js +4 -1
  31. package/dist/m365/planner/commands/task/task-reference-add.js +4 -1
  32. package/dist/m365/planner/commands/task/task-reference-list.js +4 -1
  33. package/dist/m365/planner/commands/task/task-reference-remove.js +4 -1
  34. package/dist/m365/planner/commands/task/task-remove.js +4 -1
  35. package/dist/m365/planner/commands/task/task-set.js +4 -1
  36. package/dist/m365/spfx/commands/project/project-doctor/{doctor-1.18.0-rc.1.js → doctor-1.18.0.js} +1 -1
  37. package/dist/m365/spfx/commands/project/project-doctor.js +1 -1
  38. package/dist/m365/spfx/commands/project/project-upgrade/{upgrade-1.18.0-rc.1.js → upgrade-1.18.0.js} +26 -26
  39. package/dist/m365/spfx/commands/project/project-upgrade.js +13 -15
  40. package/dist/m365/spfx/commands/spfx-doctor.js +1 -1
  41. package/dist/m365/spo/commands/file/file-get.js +2 -2
  42. package/dist/m365/spo/commands/file/file-remove.js +2 -2
  43. package/dist/m365/spo/commands/file/file-version-clear.js +2 -2
  44. package/dist/m365/spo/commands/file/file-version-get.js +2 -2
  45. package/dist/m365/spo/commands/file/file-version-list.js +2 -2
  46. package/dist/m365/spo/commands/file/file-version-remove.js +2 -2
  47. package/dist/m365/spo/commands/file/file-version-restore.js +2 -2
  48. package/dist/m365/spo/commands/group/group-member-add.js +24 -24
  49. package/dist/m365/spo/commands/page/page-set.js +13 -2
  50. package/dist/m365/spo/commands/site/site-commsite-enable.js +34 -5
  51. package/dist/m365/teams/commands/app/app-remove.js +49 -15
  52. package/dist/m365/teams/commands/channel/channel-member-add.js +8 -8
  53. package/docs/docs/cmd/aad/app/app-set.mdx +15 -15
  54. package/docs/docs/cmd/aad/approleassignment/approleassignment-add.mdx +9 -9
  55. package/docs/docs/cmd/aad/approleassignment/approleassignment-remove.mdx +10 -10
  56. package/docs/docs/cmd/aad/group/group-remove.mdx +44 -0
  57. package/docs/docs/cmd/aad/m365group/m365group-add.mdx +13 -3
  58. package/docs/docs/cmd/graph/subscription/subscription-add.mdx +10 -10
  59. package/docs/docs/cmd/spfx/project/project-upgrade.mdx +1 -1
  60. package/docs/docs/cmd/spo/file/file-get.mdx +2 -2
  61. package/docs/docs/cmd/spo/file/file-remove.mdx +2 -2
  62. package/docs/docs/cmd/spo/file/file-version-clear.mdx +2 -2
  63. package/docs/docs/cmd/spo/file/file-version-get.mdx +2 -2
  64. package/docs/docs/cmd/spo/file/file-version-list.mdx +2 -2
  65. package/docs/docs/cmd/spo/file/file-version-remove.mdx +2 -2
  66. package/docs/docs/cmd/spo/file/file-version-restore.mdx +2 -2
  67. package/docs/docs/cmd/spo/group/group-member-add.mdx +27 -27
  68. package/docs/docs/cmd/spo/list/list-contenttype-remove.mdx +1 -1
  69. package/docs/docs/cmd/spo/page/page-set.mdx +23 -0
  70. package/docs/docs/cmd/spo/site/site-commsite-enable.mdx +11 -2
  71. package/docs/docs/cmd/teams/app/app-remove.mdx +9 -6
  72. package/docs/docs/cmd/teams/channel/channel-member-add.mdx +4 -4
  73. package/package.json +2 -1
@@ -0,0 +1,44 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # aad group remove
4
+
5
+ Removes an Azure AD group
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 aad group remove [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `-i, --id [id]`
17
+ : The ID of the Azure AD group. Specify either `id` or `displayName` but not both.
18
+
19
+ `-n, --displayName [displayName]`
20
+ : The display name of the Azure AD group. Specify either `id` or `displayName` but not both.
21
+
22
+ `-f, --force`
23
+ : Don't prompt for confirmation.
24
+ ```
25
+
26
+ <Global />
27
+
28
+ ## Examples
29
+
30
+ Remove an Azure AD group by display name
31
+
32
+ ```sh
33
+ m365 aad group remove --displayName Developers
34
+ ```
35
+
36
+ Remove an Azure AD group by ID
37
+
38
+ ```sh
39
+ m365 aad group remove --id 016bf125-195b-43c5-a1a0-28ccd3192c6d
40
+ ```
41
+
42
+ ## Response
43
+
44
+ The command won't return a response on success.
@@ -30,8 +30,8 @@ m365 aad m365group add [options]
30
30
  `--members [members]`
31
31
  : Comma-separated list of Microsoft 365 Group members
32
32
 
33
- `--isPrivate`
34
- : Specify, if the Microsoft 365 Group should be private. If not specified, will create a public group (default)
33
+ `--visibility [visibility]`
34
+ : Specifies the group join policy and group content visibility for groups. Possible values are: `Private`, `Public`, or `HiddenMembership`. Defaults to `Public`.
35
35
 
36
36
  `--allowMembersToPost [allowMembersToPost]`
37
37
  : Set if only group members should be able to post conversations to the group
@@ -53,9 +53,19 @@ m365 aad m365group add [options]
53
53
 
54
54
  ## Remarks
55
55
 
56
+ You cannot change the group type when you choose `HiddenMembership` visibility. HiddenMembership can be set only for Microsoft 365 groups, when the groups are created. It can't be updated later.
57
+
56
58
  When specifying the path to the logo image you can use both relative and absolute paths. Note, that ~ in the path, will not be resolved and will most likely result in an error.
57
59
  If an invalid user is provided in the comma-separated list of Owners or Members, the command operation will fail and the Microsoft 365 Group will not be created.
58
60
 
61
+ Group visibility options:
62
+
63
+ Value | Description
64
+ -------|-------------
65
+ Public | Anyone can join the group without needing owner permission. Anyone can view the attributes of the group. Anyone can see the members of the group.
66
+ Private | Owner permission is needed to join the group. Anyone can view the attributes of the group. Anyone can see the members of the group.
67
+ HiddenMembership | Owner permission is needed to join the group. Guest users cannot view the attributes of the group. Non-members cannot see the members of the group. Administrators (global, company, user, and helpdesk) can view the membership of the group. The group appears in the global address book (GAL).
68
+
59
69
  ## Examples
60
70
 
61
71
  Create a public Microsoft 365 Group
@@ -67,7 +77,7 @@ m365 aad m365group add --displayName Finance --description "This is the Contoso
67
77
  Create a private Microsoft 365 Group
68
78
 
69
79
  ```sh
70
- m365 aad m365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --isPrivate
80
+ m365 aad m365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --visibility Private
71
81
  ```
72
82
 
73
83
  Create a public Microsoft 365 Group and set specified users as its owners
@@ -16,19 +16,19 @@ m365 graph subscription add [options]
16
16
 
17
17
  ```md definition-list
18
18
  `-r, --resource <resource>`
19
- : The resource that will be monitored for changes
19
+ : The resource that will be monitored for changes.
20
20
 
21
- `-c, --changeType <changeType>`
22
- : The type of change in the subscribed resource that will raise a notification. The supported values are: `created`, `updated`, `deleted`. Multiple values can be combined using a comma-separated list
21
+ `-c, --changeTypes <changeTypes>`
22
+ : The type of change in the subscribed resource that will raise a notification. The supported values are: `created`, `updated`, `deleted`. Multiple values can be combined using a comma-separated list.
23
23
 
24
24
  `-u, --notificationUrl <notificationUrl>`
25
- : The URL of the endpoint that will receive the notifications. This URL must use the HTTPS protocol
25
+ : The URL of the endpoint that will receive the notifications. This URL must use the HTTPS protocol.
26
26
 
27
27
  `-e, --expirationDateTime [expirationDateTime]`
28
- : The date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. If not specified, the maximum allowed expiration for the specified resource will be used
28
+ : The date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. If not specified, the maximum allowed expiration for the specified resource will be used.
29
29
 
30
30
  `-s, --clientState [clientState]`
31
- : The value of the clientState property sent by the service in each notification. The maximum length is 128 characters
31
+ : The value of the clientState property sent by the service in each notification. The maximum length is 128 characters.
32
32
  ```
33
33
 
34
34
  <Global />
@@ -52,19 +52,19 @@ To subscribe to change notifications of Outlook contacts, events, or messages in
52
52
  Create a subscription
53
53
 
54
54
  ```sh
55
- m365 graph subscription add --resource "me/mailFolders('Inbox')/messages" --changeType "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
55
+ m365 graph subscription add --resource "me/mailFolders('Inbox')/messages" --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
56
56
  ```
57
57
 
58
58
  Create a subscription on multiple change types
59
59
 
60
60
  ```sh
61
- m365 graph subscription add --resource groups --changeType updated,deleted --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
61
+ m365 graph subscription add --resource groups --changeTypes "updated,deleted" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
62
62
  ```
63
63
 
64
64
  Create a subscription using the maximum allowed expiration for Group resources
65
65
 
66
66
  ```sh
67
- m365 graph subscription add --resource groups --changeType "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient"
67
+ m365 graph subscription add --resource groups --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient"
68
68
  ```
69
69
 
70
70
  ## Response
@@ -125,7 +125,7 @@ m365 graph subscription add --resource groups --changeType "updated" --notificat
125
125
  <TabItem value="Markdown">
126
126
 
127
127
  ```md
128
- # graph subscription add --resource "groups" --changeType "updated" --notificationUrl "https://webhook.azurewebsites.net/api/changeNotificationHook" --expirationDateTime "2023-05-23T18:23:45.935Z" --clientState "some secret value"
128
+ # graph subscription add --resource "groups" --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/changeNotificationHook" --expirationDateTime "2023-05-23T18:23:45.935Z" --clientState "some secret value"
129
129
 
130
130
  Date: 2023-05-22
131
131
 
@@ -35,7 +35,7 @@ m365 spfx project upgrade [options]
35
35
 
36
36
  ## Remarks
37
37
 
38
- The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.17.4).
38
+ The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.18.0).
39
39
 
40
40
  This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
41
41
 
@@ -15,10 +15,10 @@ m365 spo file get [options]
15
15
  ## Options
16
16
 
17
17
  ```md definition-list
18
- `-w, --webUrl <webUrl>`
18
+ `-u, --webUrl <webUrl>`
19
19
  : The URL of the site where the file is located
20
20
 
21
- `-u, --url [url]`
21
+ `--url [url]`
22
22
  : The server- or site-relative decoded URL of the file to retrieve. Specify either `url` or `id` but not both
23
23
 
24
24
  `-i, --id [id]`
@@ -19,13 +19,13 @@ m365 spo page template remove
19
19
  ## Options
20
20
 
21
21
  ```md definition-list
22
- `-w, --webUrl <webUrl>`
22
+ `-u, --webUrl <webUrl>`
23
23
  : URL of the site where the file to remove is located
24
24
 
25
25
  `-i, --id [id]`
26
26
  : The ID of the file to remove. Specify either `id` or `url` but not both
27
27
 
28
- `-u, --url [url]`
28
+ `--url [url]`
29
29
  : The server- or site-relative decoded URL of the file to remove. Specify either `id` or `url` but not both
30
30
 
31
31
  `--recycle`
@@ -13,10 +13,10 @@ m365 spo file version clear [options]
13
13
  ## Options
14
14
 
15
15
  ```md definition-list
16
- `-w, --webUrl <webUrl>`
16
+ `-u, --webUrl <webUrl>`
17
17
  : The URL of the site where the file is located
18
18
 
19
- `-u, --fileUrl [fileUrl]`
19
+ `--fileUrl [fileUrl]`
20
20
  : The server- or site-relative decoded URL of the file. Specify either `fileUrl` or `fileId` but not both
21
21
 
22
22
  `-i, --fileId [fileId]`
@@ -15,13 +15,13 @@ m365 spo file version get [options]
15
15
  ## Options
16
16
 
17
17
  ```md definition-list
18
- `-w, --webUrl <webUrl>`
18
+ `-u, --webUrl <webUrl>`
19
19
  : The URL of the site where the file is located
20
20
 
21
21
  `--label <label>`
22
22
  : Label of version which will be retrieved
23
23
 
24
- `-u, --fileUrl [fileUrl]`
24
+ `--fileUrl [fileUrl]`
25
25
  : The server- or site-relative decoded URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
26
26
 
27
27
  `-i, --fileId [fileId]`
@@ -15,10 +15,10 @@ m365 spo file version list [options]
15
15
  ## Options
16
16
 
17
17
  ```md definition-list
18
- `-w, --webUrl <webUrl>`
18
+ `-u, --webUrl <webUrl>`
19
19
  : The URL of the site where the file is located
20
20
 
21
- `-u, --fileUrl [fileUrl]`
21
+ `--fileUrl [fileUrl]`
22
22
  : The server- or site-relative decoded URL of the file. Specify either `fileUrl` or `fileId` but not both
23
23
 
24
24
  `-i, --fileId [fileId]`
@@ -13,13 +13,13 @@ m365 spo file version remove [options]
13
13
  ## Options
14
14
 
15
15
  ```md definition-list
16
- `-w, --webUrl <webUrl>`
16
+ `-u, --webUrl <webUrl>`
17
17
  : The URL of the site where the file is located
18
18
 
19
19
  `--label <label>`
20
20
  : Label of version which will be removed
21
21
 
22
- `-u, --fileUrl [fileUrl]`
22
+ `--fileUrl [fileUrl]`
23
23
  : The server- or site-relative decoded URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
24
24
 
25
25
  `-i, --fileId [fileId]`
@@ -13,13 +13,13 @@ m365 spo file version restore [options]
13
13
  ## Options
14
14
 
15
15
  ```md definition-list
16
- `-w, --webUrl <webUrl>`
16
+ `-u, --webUrl <webUrl>`
17
17
  : The URL of the site where the file is located
18
18
 
19
19
  `--label <label>`
20
20
  : Label of version which will be restored
21
21
 
22
- `-u, --fileUrl [fileUrl]`
22
+ `--fileUrl [fileUrl]`
23
23
  : The server- or site-relative decoded URL of the file whose version will be restored. Specify either `fileUrl` or `fileId` but not both
24
24
 
25
25
  `-i, --fileId [fileId]`
@@ -16,72 +16,72 @@ m365 spo group member add [options]
16
16
 
17
17
  ```md definition-list
18
18
  `-u, --webUrl <webUrl>`
19
- : URL of the site where the SharePoint group is available
19
+ : URL of the site where the SharePoint group is available.
20
20
 
21
21
  `--groupId [groupId]`
22
- : Id of the SharePoint Group to which the user needs to be added, specify either `groupId` or `groupName`
22
+ : Id of the SharePoint Group to which the user needs to be added, specify either `groupId` or `groupName`.
23
23
 
24
24
  `--groupName [groupName]`
25
- : Name of the SharePoint Group to which the user needs to be added, specify either `groupId` or `groupName`
25
+ : Name of the SharePoint Group to which the user needs to be added, specify either `groupId` or `groupName`.
26
26
 
27
- `--userName [userName]`
28
- : User's UPN (user principal name, eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma-separated (e.g. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
27
+ `--userNames [userNames]`
28
+ : User's UPN (user principal name, eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma-separated (e.g. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userIds`, `userNames`, `emails`, `aadGroupIds` or `aadGroupNames`.
29
29
 
30
- `--email [email]`
31
- : User's email (eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma-separated (e.g. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
30
+ `--emails [emails]`
31
+ : User's email (eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma-separated (e.g. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userIds`, `userNames`, `emails`, `aadGroupIds` or `aadGroupNames`.
32
32
 
33
- `--userId [userId]`
34
- : The user Id of the user to add as a member. (Id of the site user, for example: 14) If multiple users need to be added, the Ids have to be comma-separated. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
33
+ `--userIds [userIds]`
34
+ : The user Id of the user to add as a member. (Id of the site user, for example: 14) If multiple users need to be added, the Ids have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds` or `aadGroupNames`.
35
35
 
36
- `--aadGroupId [aadGroupId]`
37
- : The object Id of the Azure AD group to add as a member. If multiple groups need to be added, the Ids have to be comma-separated. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
36
+ `--aadGroupIds [aadGroupIds]`
37
+ : The object Id of the Azure AD group to add as a member. If multiple groups need to be added, the Ids have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds` or `aadGroupNames`.
38
38
 
39
- `--aadGroupName [aadGroupName]`
40
- : The name of the Azure AD group to add as a member. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
39
+ `--aadGroupNames [aadGroupNames]`
40
+ : The name of the Azure AD group to add as a member. If multiple groups need to be added, they have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds` or `aadGroupNames`.
41
41
  ```
42
42
 
43
43
  <Global />
44
44
 
45
45
  ## Remarks
46
46
 
47
- For the `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName` options you can specify multiple values by separating them with a comma. If one of the specified entries is not valid, the command will fail with an error message showing the list of invalid values.
47
+ For the `userIds`, `userNames`, `emails`, `aadGroupIds` or `aadGroupNames` options you can specify multiple values by separating them with a comma. If one of the specified entries is not valid, the command will fail with an error message showing the list of invalid values.
48
48
 
49
49
  ## Examples
50
50
 
51
- Add a user with the userName parameter to a SharePoint group with the groupId parameter
51
+ Add a user with the userNames parameter to a SharePoint group with the groupId parameter
52
52
 
53
53
  ```sh
54
- m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userName "Alex.Wilber@contoso.com"
54
+ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userNames "Alex.Wilber@contoso.com"
55
55
  ```
56
56
 
57
- Add multiple users with the userName parameter to a SharePoint group with the groupId parameter
57
+ Add multiple users with the userNames parameter to a SharePoint group with the groupId parameter
58
58
 
59
59
  ```sh
60
- m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userName "Alex.Wilber@contoso.com, Adele.Vance@contoso.com"
60
+ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userNames "Alex.Wilber@contoso.com, Adele.Vance@contoso.com"
61
61
  ```
62
62
 
63
- Add a user with the email parameter to a SharePoint group with the groupName parameter
63
+ Add a user with the emails parameter to a SharePoint group with the groupName parameter
64
64
 
65
65
  ```sh
66
- m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Owners" --email "Alex.Wilber@contoso.com"
66
+ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Owners" --emails "Alex.Wilber@contoso.com"
67
67
  ```
68
68
 
69
- Add multiple users with the email parameter to a SharePoint group with the groupName parameter
69
+ Add multiple users with the emails parameter to a SharePoint group with the groupName parameter
70
70
 
71
71
  ```sh
72
- m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Owners" --email "Alex.Wilber@contoso.com, Adele.Vance@contoso.com"
72
+ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupName "Contoso Site Owners" --emails "Alex.Wilber@contoso.com, Adele.Vance@contoso.com"
73
73
  ```
74
74
 
75
- Add a user with the userId parameter to a SharePoint group with the groupId parameter
75
+ Add a user with the userIds parameter to a SharePoint group with the groupId parameter
76
76
 
77
77
  ```sh
78
- m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userId 5
78
+ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userIds 5
79
79
  ```
80
80
 
81
- Add multiple users with the userId parameter to a SharePoint group with the groupId parameter
81
+ Add multiple users with the userIds parameter to a SharePoint group with the groupId parameter
82
82
 
83
83
  ```sh
84
- m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userId "5,12"
84
+ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userIds "5,12"
85
85
  ```
86
86
 
87
87
  Add multiple users with the aadUserId parameter to a SharePoint group with the groupId parameter
@@ -140,7 +140,7 @@ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --
140
140
  <TabItem value="Markdown">
141
141
 
142
142
  ```md
143
- # spo group member add --webUrl "https://contoso.sharepoint.com" --groupId "5" --aadGroupId "f2fb2f10-cfd2-4054-8ffd-64533657a5ab"
143
+ # spo group member add --webUrl "https://contoso.sharepoint.com" --groupId "5" --aadGroupIds "f2fb2f10-cfd2-4054-8ffd-64533657a5ab"
144
144
 
145
145
  Date: 13/2/2023
146
146
 
@@ -51,7 +51,7 @@ m365 spo list contenttype remove --webUrl https://contoso.sharepoint.com/sites/p
51
51
  Remove content type with a specific id from the list retrieved by server relative URL in a specific site. This will not prompt for confirmation.
52
52
 
53
53
  ```sh
54
- m365 spo list contenttype remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'sites/project-x/Documents' --contentTypeId 0x010109010053EE7AEB1FC54A41B4D9F66ADBDC312A --force
54
+ m365 spo list contenttype remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'sites/project-x/Documents' --id 0x010109010053EE7AEB1FC54A41B4D9F66ADBDC312A --force
55
55
  ```
56
56
 
57
57
  ## Response
@@ -42,6 +42,9 @@ m365 spo page set [options]
42
42
 
43
43
  `--title [title]`
44
44
  : The title to set for the page.
45
+
46
+ `--content [content]`
47
+ : JSON string containing page content
45
48
  ```
46
49
 
47
50
  <Global />
@@ -52,6 +55,20 @@ If you try to create a page with a name of a page that already exists, you will
52
55
 
53
56
  If you choose to promote the page using the `promoteAs` option or enable page comments, you will see the result only after publishing the page.
54
57
 
58
+ Running this command from the Windows Command Shell (cmd.exe) or PowerShell for Windows OS XP, 7, 8, 8.1 without bash installed might require additional formatting for command options that have JSON, XML or JavaScript values because the command shell treat quotes differently. For example, this is how you can add page content from the Windows cmd.exe:
59
+
60
+ ```sh
61
+ m365 spo page set --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --content '[{\"controlType\": 4,\"id\": \"42b8afe8-dafe-4c11-bfbf-df5ef5b1feb7\",\"position\": {\"layoutIndex\": 1,\"zoneIndex\": 1,\"sectionIndex\": 1,\"sectionFactor\": 12,\"controlIndex\": 1},\"addedFromPersistedData\": true,\"innerHTML\":\"<p>Hello World</p>\"}]'
62
+ ```
63
+
64
+ Note, how the content option has escaped double quotes `'[{\"controlType\": 4,\"id\": \"42b8afe8-dafe-4c11-bfbf-df5ef5b1feb7\",\"position\": {\"layoutIndex\": 1,\"zoneIndex\": 1,\"sectionIndex\": 1,\"sectionFactor\": 12,\"controlIndex\": 1},\"addedFromPersistedData\": true,\"innerHTML\":\"<p>Hello World</p>\"}]'` compared to execution from bash `''[{"controlType": 4,"id": "42b8afe8-dafe-4c11-bfbf-df5ef5b1feb7","position": {"layoutIndex": 1,"zoneIndex": 1,"sectionIndex": 1,"sectionFactor": 12,"controlIndex": 1},"addedFromPersistedData": true,"innerHTML":"<p>Hello World</p>"}]'`.
65
+
66
+ :::caution Escaping JSON in PowerShell
67
+
68
+ When using the `--content` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.
69
+
70
+ :::
71
+
55
72
  ## Examples
56
73
 
57
74
  Change the layout of the existing page to _Article_
@@ -102,6 +119,12 @@ Set page description
102
119
  m365 spo page set --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --description "Description to add for the page"
103
120
  ```
104
121
 
122
+ Set page content
123
+
124
+ ```sh
125
+ m365 spo page set --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --content '[{\"controlType\": 4,\"id\": \"42b8afe8-dafe-4c11-bfbf-df5ef5b1feb7\",\"position\": {\"layoutIndex\": 1,\"zoneIndex\": 1,\"sectionIndex\": 1,\"sectionFactor\": 12,\"controlIndex\": 1},\"addedFromPersistedData\": true,\"innerHTML\":\"<p>Hello World</p>\"}]'
126
+ ```
127
+
105
128
  ## Response
106
129
 
107
130
  The command won't return a response on success.
@@ -17,7 +17,10 @@ m365 spo site commsite enable [options]
17
17
  : The URL of the site to enable communication site features on
18
18
 
19
19
  `-i, --designPackageId [designPackageId]`
20
- : The ID of the site design to apply when enabling communication site features. Allowed values are `96c933ac-3698-44c7-9f4a-5fd17d71af9e` (Topic = default), `6142d2a0-63a5-4ba0-aede-d9fefca2c767` (Showcase), `f6cc5403-0d63-442e-96c0-285923709ffc` (Blank)
20
+ : The ID of the site design to apply when enabling communication site features. Specify designPackageId or designPackage but not both.
21
+
22
+ `-p, --designPackage [designPackage]`
23
+ : The site design to apply when enabling communication site features. Valid values are: Topic, Showcase, or Blank. Defaults to Topic. Specify designPackageId or designPackage but not both.
21
24
  ```
22
25
 
23
26
  <Global />
@@ -38,12 +41,18 @@ Enable communication site features on an existing site
38
41
  m365 spo site commsite enable --url https://contoso.sharepoint.com
39
42
  ```
40
43
 
41
- Enable communication site features on an existing site and apply Showcase design package
44
+ Enable communication site features on an existing site and apply the Showcase design package using its ID.
42
45
 
43
46
  ```sh
44
47
  m365 spo site commsite enable --url https://contoso.sharepoint.com --designPackageId 6142d2a0-63a5-4ba0-aede-d9fefca2c767
45
48
  ```
46
49
 
50
+ Enable communication site features on an existing site and apply the Showcase design package using its friendly name.
51
+
52
+ ```sh
53
+ m365 spo site commsite enable --url https://contoso.sharepoint.com --designPackage Showcase
54
+ ```
55
+
47
56
  ## Response
48
57
 
49
58
  The command won't return a response on success.
@@ -13,11 +13,14 @@ m365 teams app remove [options]
13
13
  ## Options
14
14
 
15
15
  ```md definition-list
16
- `-i, --id <id>`
17
- : ID of the Teams app to remove. Needs to be available in your organization\'s app catalog.
16
+ `-i, --id [id]`
17
+ : ID of the Teams app to remove. Needs to be available in your organization\'s app catalog. Specify either `id` or `name`.
18
+
19
+ `-n, --name [name]`
20
+ : Name of the Teams app to remove. Needs to be available in your organization\'s app catalog. Specify either `id` or `name`.
18
21
 
19
22
  `-f, --force`
20
- : Don't prompt for confirming removing the app
23
+ : Don't prompt for confirming removing the app.
21
24
  ```
22
25
 
23
26
  <Global />
@@ -28,16 +31,16 @@ You can only remove a Teams app as a global administrator.
28
31
 
29
32
  ## Examples
30
33
 
31
- Remove the Teams app with ID _83cece1e-938d-44a1-8b86-918cf6151957_ from the organization's app catalog. Will prompt for confirmation before actually removing the app.
34
+ Remove the Teams app by ID from the organization's app catalog. Will prompt for confirmation before actually removing the app.
32
35
 
33
36
  ```sh
34
37
  m365 teams app remove --id 83cece1e-938d-44a1-8b86-918cf6151957
35
38
  ```
36
39
 
37
- Remove the Teams app with ID _83cece1e-938d-44a1-8b86-918cf6151957_ from the organization's app catalog. Don't prompt for confirmation.
40
+ Remove the Teams app by name from the organization's app catalog. Don't prompt for confirmation.
38
41
 
39
42
  ```sh
40
- m365 teams app remove --id 83cece1e-938d-44a1-8b86-918cf6151957 --force
43
+ m365 teams app remove --name HelloWorld --force
41
44
  ```
42
45
 
43
46
  ## Response
@@ -25,10 +25,10 @@ m365 teams channel member add [options]
25
25
  `--channelName [channelName]`
26
26
  : The display name of the Microsoft Teams team channel. Specify either `channelId` or `channelName`, but not both.
27
27
 
28
- `--userId [userId]`
28
+ `--userIds [userIds]`
29
29
  : The user's ID or principal name. You can also pass a comma-separated list of userIds.
30
30
 
31
- `--userDisplayName [userDisplayName]`
31
+ `--userDisplayNames [userDisplayNames]`
32
32
  : The display name of a user. You can also pass a comma-separated list of display names.
33
33
 
34
34
  `--owner`
@@ -48,13 +48,13 @@ You can only add members and owners of a team to a private channel.
48
48
  Add members to a channel based on their id or user principal name
49
49
 
50
50
  ```sh
51
- m365 teams channel member add --teamId 47d6625d-a540-4b59-a4ab-19b787e40593 --channelId 19:586a8b9e36c4479bbbd378e439a96df2@thread.skype --userId "85a50aa1-e5b8-48ac-b8ce-8e338033c366,john.doe@contoso.com"
51
+ m365 teams channel member add --teamId 47d6625d-a540-4b59-a4ab-19b787e40593 --channelId 19:586a8b9e36c4479bbbd378e439a96df2@thread.skype --userIds "85a50aa1-e5b8-48ac-b8ce-8e338033c366,john.doe@contoso.com"
52
52
  ```
53
53
 
54
54
  Add owners to a channel based on their display names
55
55
 
56
56
  ```sh
57
- m365 teams channel member add --teamName "Human Resources" --channelName "Private Channel" --userDisplayName "Anne Matthews,John Doe" --owner
57
+ m365 teams channel member add --teamName "Human Resources" --channelName "Private Channel" --userDisplayNames "Anne Matthews,John Doe" --owner
58
58
  ```
59
59
 
60
60
  ## Response
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pnp/cli-microsoft365",
3
- "version": "7.0.0-beta.c2db9df",
3
+ "version": "7.0.0-beta.e15bb2d",
4
4
  "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
5
5
  "license": "MIT",
6
6
  "main": "./dist/api.js",
@@ -144,6 +144,7 @@
144
144
  "Kesavanarayanan, Sudharsan <10280385+sudharsank@users.noreply.github.com>",
145
145
  "Khalil, Bassem <bk@bassems-air.home>",
146
146
  "Kirkham, Don <donkirkham@live.com>",
147
+ "Kornet, Michał <kornetmichal@gmail.com>",
147
148
  "Kumar, Shantha <34408892+ktskumar@users.noreply.github.com>",
148
149
  "Kurian, Cyril C <cyril.kurian2@gmail.com>",
149
150
  "Lamber, Patrick <patrick@nubo.eu>",