@pnp/cli-microsoft365 10.3.0-beta.cd20f0c → 10.3.0-beta.df85113

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 (68) hide show
  1. package/.eslintrc.cjs +2 -0
  2. package/README.md +11 -6
  3. package/allCommands.json +1 -1
  4. package/allCommandsFull.json +1 -1
  5. package/dist/config.js +2 -1
  6. package/dist/m365/commands/login.js +6 -6
  7. package/dist/m365/entra/commands/app/app-add.js +3 -0
  8. package/dist/m365/entra/commands/approleassignment/approleassignment-remove.js +1 -1
  9. package/dist/m365/entra/commands/group/group-list.js +3 -2
  10. package/dist/m365/entra/commands/pim/pim-role-assignment-remove.js +186 -0
  11. package/dist/m365/entra/commands/roledefinition/roledefinition-add.js +58 -0
  12. package/dist/m365/entra/commands/roledefinition/roledefinition-set.js +84 -0
  13. package/dist/m365/entra/commands/rolepermission/rolepermission-list.js +42 -0
  14. package/dist/m365/entra/commands.js +4 -0
  15. package/dist/m365/exo/commands/approleassignment/approleassignment-add.js +235 -0
  16. package/dist/m365/exo/commands.js +5 -0
  17. package/dist/m365/outlook/commands/mailbox/mailbox-settings-set.js +163 -0
  18. package/dist/m365/outlook/commands.js +1 -0
  19. package/dist/m365/pp/commands/website/website-get.js +60 -0
  20. package/dist/m365/pp/commands.js +2 -1
  21. package/dist/m365/spe/commands/container/container-activate.js +50 -0
  22. package/dist/m365/spe/commands.js +1 -0
  23. package/dist/m365/spo/commands/file/file-roleassignment-add.js +26 -2
  24. package/dist/m365/spo/commands/file/file-roleassignment-remove.js +26 -2
  25. package/dist/m365/spo/commands/folder/folder-roleassignment-add.js +27 -24
  26. package/dist/m365/spo/commands/folder/folder-roleassignment-remove.js +24 -7
  27. package/dist/m365/spo/commands/list/list-defaultvalue-clear.js +184 -0
  28. package/dist/m365/spo/commands/list/list-defaultvalue-list.js +140 -0
  29. package/dist/m365/spo/commands/list/list-defaultvalue-remove.js +181 -0
  30. package/dist/m365/spo/commands/list/list-defaultvalue-set.js +210 -0
  31. package/dist/m365/spo/commands/listitem/listitem-roleassignment-add.js +25 -7
  32. package/dist/m365/spo/commands/listitem/listitem-roleassignment-remove.js +22 -5
  33. package/dist/m365/spo/commands/web/web-roleassignment-add.js +22 -5
  34. package/dist/m365/spo/commands/web/web-roleassignment-remove.js +22 -5
  35. package/dist/m365/spo/commands.js +4 -0
  36. package/dist/m365/tenant/commands/people/people-pronouns-set.js +46 -0
  37. package/dist/m365/tenant/commands/report/report-settings-set.js +47 -0
  38. package/dist/m365/tenant/commands.js +2 -0
  39. package/dist/utils/customAppScope.js +29 -0
  40. package/dist/utils/entraServicePrincipal.js +46 -0
  41. package/dist/utils/powerPlatform.js +38 -0
  42. package/dist/utils/roleDefinition.js +23 -0
  43. package/dist/utils/validation.js +4 -0
  44. package/docs/docs/cmd/entra/app/app-add.mdx +1 -1
  45. package/docs/docs/cmd/entra/pim/pim-role-assignment-remove.mdx +197 -0
  46. package/docs/docs/cmd/entra/roledefinition/roledefinition-add.mdx +131 -0
  47. package/docs/docs/cmd/entra/roledefinition/roledefinition-set.mdx +64 -0
  48. package/docs/docs/cmd/entra/rolepermission/rolepermission-list.mdx +162 -0
  49. package/docs/docs/cmd/exo/approleassignment/approleassignment-add.mdx +170 -0
  50. package/docs/docs/cmd/outlook/mailbox/mailbox-settings-set.mdx +166 -0
  51. package/docs/docs/cmd/pp/website/website-get.mdx +153 -0
  52. package/docs/docs/cmd/spe/container/container-activate.mdx +34 -0
  53. package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +21 -4
  54. package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +21 -3
  55. package/docs/docs/cmd/spo/folder/folder-roleassignment-add.mdx +15 -3
  56. package/docs/docs/cmd/spo/folder/folder-roleassignment-remove.mdx +15 -3
  57. package/docs/docs/cmd/spo/list/list-defaultvalue-clear.mdx +62 -0
  58. package/docs/docs/cmd/spo/list/list-defaultvalue-list.mdx +110 -0
  59. package/docs/docs/cmd/spo/list/list-defaultvalue-remove.mdx +62 -0
  60. package/docs/docs/cmd/spo/list/list-defaultvalue-set.mdx +112 -0
  61. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx +15 -3
  62. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx +17 -5
  63. package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx +15 -3
  64. package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx +15 -3
  65. package/docs/docs/cmd/tenant/people/people-pronouns-set.mdx +82 -0
  66. package/docs/docs/cmd/tenant/report/report-settings-set.mdx +32 -0
  67. package/npm-shrinkwrap.json +54 -74
  68. package/package.json +9 -9
@@ -0,0 +1,153 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # pp website get
6
+
7
+ Gets information about the specified Power Pages website.
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 pp website get [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --url [url]`
19
+ : The URL of the website to retrieve. Specify either `url`, `name` or `id`.
20
+
21
+ `-n, --name [name]`
22
+ : The name of the website to retrieve. Specify either `url`, `name` or `id`.
23
+
24
+ `-i, --id [id]`
25
+ : The WebSite Id (GUID) of the website to retrieve. Specify either `url`, `name` or `id`.
26
+
27
+ `-e, --environmentName <environmentName>`
28
+ : The name of the environment from which to retrieve the Power Pages website.
29
+ ```
30
+
31
+ <Global />
32
+
33
+ ## Examples
34
+
35
+ Retrieve Demo Power Pages website by name in the given environment using `name`.
36
+
37
+ ```sh
38
+ m365 pp website get --name Demo --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
39
+ ```
40
+
41
+ Retrieve Demo Power Pages website by name in the given environment using `id`.
42
+
43
+ ```sh
44
+ m365 pp website get --id 4916bb2c-91e1-4716-91d5-b6171928fac9 --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
45
+ ```
46
+
47
+ Retrieve Demo Power Pages website by name in the given environment using `url`.
48
+
49
+ ```sh
50
+ m365 pp website get --url https://site-0uaq9.powerappsportals.com --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
51
+ ```
52
+
53
+ ## Response
54
+
55
+ <Tabs>
56
+ <TabItem value="JSON">
57
+
58
+ ```json
59
+ {
60
+ "@odata.metadata": "https://api.powerplatform.com/powerpages/environments/Default-727dc1e9-3cd1-4d1f-8102-ab5c936e52f0/websites/$metadata#Websites",
61
+ "id": "4916bb2c-91e1-4716-91d5-b6171928fac9",
62
+ "name": "Site 1",
63
+ "createdOn": "2024-10-27T12:00:03",
64
+ "templateName": "DefaultPortalTemplate",
65
+ "websiteUrl": "https://site-0uaq9.powerappsportals.com",
66
+ "tenantId": "727dc1e9-3cd1-4d1f-8102-ab5c936e52f0",
67
+ "dataverseInstanceUrl": "https://org0cd4b2b9.crm4.dynamics.com/",
68
+ "environmentName": "Contoso (default)",
69
+ "environmentId": "Default-727dc1e9-3cd1-4d1f-8102-ab5c936e52f0",
70
+ "dataverseOrganizationId": "2d58aeac-74d4-4939-98d1-e05a70a655ba",
71
+ "selectedBaseLanguage": 1033,
72
+ "customHostNames": [],
73
+ "websiteRecordId": "5eb107a6-5ac2-4e1c-a3b9-d5c21bbc10ce",
74
+ "subdomain": "site-0uaq9",
75
+ "packageInstallStatus": "Installed",
76
+ "type": "Trial",
77
+ "trialExpiringInDays": 86,
78
+ "suspendedWebsiteDeletingInDays": 93,
79
+ "packageVersion": "9.6.9.39",
80
+ "isEarlyUpgradeEnabled": false,
81
+ "isCustomErrorEnabled": true,
82
+ "applicationUserAadAppId": "3f57aca7-5051-41b2-989d-26da8af7a53e",
83
+ "ownerId": "33469a62-c3af-4cfe-b893-854eceab96da",
84
+ "status": "OperationComplete",
85
+ "siteVisibility": "private",
86
+ "dataModel": "Enhanced"
87
+ }
88
+ ```
89
+
90
+ </TabItem>
91
+ <TabItem value="Text">
92
+
93
+ ```text
94
+ id : 4916bb2c-91e1-4716-91d5-b6171928fac9
95
+ name : Site 1
96
+ siteVisibility: private
97
+ status : OperationComplete
98
+ subdomain : site-0uaq9
99
+ tenantId : 727dc1e9-3cd1-4d1f-8102-ab5c936e52f0
100
+ type : Trial
101
+ websiteUrl : https://site-0uaq9.powerappsportals.com
102
+ ```
103
+
104
+ </TabItem>
105
+ <TabItem value="CSV">
106
+
107
+ ```csv
108
+ @odata.metadata,id,name,createdOn,templateName,websiteUrl,tenantId,dataverseInstanceUrl,environmentName,environmentId,dataverseOrganizationId,selectedBaseLanguage,websiteRecordId,subdomain,packageInstallStatus,type,trialExpiringInDays,suspendedWebsiteDeletingInDays,packageVersion,isEarlyUpgradeEnabled,isCustomErrorEnabled,applicationUserAadAppId,ownerId,status,siteVisibility,dataModel
109
+ https://api.powerplatform.com/powerpages/environments/Default-727dc1e9-3cd1-4d1f-8102-ab5c936e52f0/websites/$metadata#Websites,4916bb2c-91e1-4716-91d5-b6171928fac9,Site 1,2024-10-27T12:00:03,DefaultPortalTemplate,https://site-0uaq9.powerappsportals.com,727dc1e9-3cd1-4d1f-8102-ab5c936e52f0,https://org0cd4b2b9.crm4.dynamics.com/,Contoso (default),Default-727dc1e9-3cd1-4d1f-8102-ab5c936e52f0,2d58aeac-74d4-4939-98d1-e05a70a655ba,1033,5eb107a6-5ac2-4e1c-a3b9-d5c21bbc10ce,site-0uaq9,Installed,Trial,86,93,9.6.9.39,0,1,3f57aca7-5051-41b2-989d-26da8af7a53e,33469a62-c3af-4cfe-b893-854eceab96da,OperationComplete,private,Enhanced
110
+ ```
111
+
112
+ </TabItem>
113
+ <TabItem value="Markdown">
114
+
115
+ ```md
116
+ # pp website get --debug "false" --verbose "false" --name "Site 1" --environmentName "Default-727dc1e9-3cd1-4d1f-8102-ab5c936e52f0"
117
+
118
+ Date: 27/10/2024
119
+
120
+ ## Site 1 (4916bb2c-91e1-4716-91d5-b6171928fac9)
121
+
122
+ Property | Value
123
+ ---------|-------
124
+ @odata.metadata | https://api.powerplatform.com/powerpages/environments/Default-727dc1e9-3cd1-4d1f-8102-ab5c936e52f0/websites/$metadata#Websites
125
+ id | 4916bb2c-91e1-4716-91d5-b6171928fac9
126
+ name | Site 1
127
+ createdOn | 2024-10-27T12:00:03
128
+ templateName | DefaultPortalTemplate
129
+ websiteUrl | https://site-0uaq9.powerappsportals.com
130
+ tenantId | 727dc1e9-3cd1-4d1f-8102-ab5c936e52f0
131
+ dataverseInstanceUrl | https://org0cd4b2b9.crm4.dynamics.com/
132
+ environmentName | Contoso (default)
133
+ environmentId | Default-727dc1e9-3cd1-4d1f-8102-ab5c936e52f0
134
+ dataverseOrganizationId | 2d58aeac-74d4-4939-98d1-e05a70a655ba
135
+ selectedBaseLanguage | 1033
136
+ websiteRecordId | 5eb107a6-5ac2-4e1c-a3b9-d5c21bbc10ce
137
+ subdomain | site-0uaq9
138
+ packageInstallStatus | Installed
139
+ type | Trial
140
+ trialExpiringInDays | 86
141
+ suspendedWebsiteDeletingInDays | 93
142
+ packageVersion | 9.6.9.39
143
+ isEarlyUpgradeEnabled | false
144
+ isCustomErrorEnabled | true
145
+ applicationUserAadAppId | 3f57aca7-5051-41b2-989d-26da8af7a53e
146
+ ownerId | 33469a62-c3af-4cfe-b893-854eceab96da
147
+ status | OperationComplete
148
+ siteVisibility | private
149
+ dataModel | Enhanced
150
+ ```
151
+
152
+ </TabItem>
153
+ </Tabs>
@@ -0,0 +1,34 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spe container activate
6
+
7
+ Activates a container
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spe container activate [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-i, --id <id>`
19
+ : The Id of the container instance.
20
+ ```
21
+
22
+ <Global />
23
+
24
+ ## Examples
25
+
26
+ Activates a container.
27
+
28
+ ```sh
29
+ m365 spe container activate --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z"
30
+ ```
31
+
32
+ ## Response
33
+
34
+ The command won't return a response on success.
@@ -26,10 +26,16 @@ m365 spo file roleassignment add [options]
26
26
  : The SharePoint Id of the principal. It may be either a user id or group id to add a role assignment for. Specify either `upn`, `groupName`, or `principalId` but not multiple.
27
27
 
28
28
  `--upn [upn]`
29
- : The upn/email of user to assign role to. Specify either `upn`, `groupName`, or `principalId` but not multiple.
29
+ : The upn/email of user to assign role to. Specify either `upn`, `groupName`, `entraGroupId`, `entraGroupName`, or `principalId` but not multiple.
30
30
 
31
31
  `--groupName [groupName]`
32
- : The group name of the SharePoint group Specify either `upn`, `groupName`, or `principalId` but not multiple.
32
+ : The group name of the SharePoint group Specify either `upn`, `groupName`, `entraGroupId`, `entraGroupName`, or `principalId` but not multiple. This option is only used for SharePoint Online groups.
33
+
34
+ `--entraGroupId [entraGroupId]`
35
+ : ID of the Microsoft Entra group to add. Specify either `upn`, `groupName`, `entraGroupId`, `entraGroupName`, or `principalId` but not multiple.
36
+
37
+ `--entraGroupName [entraGroupName]`
38
+ : Display name of the Microsoft Entra group to add. Specify either `upn`, `groupName`, `entraGroupId`, `entraGroupName`, or `principalId` but not multiple.
33
39
 
34
40
  `--roleDefinitionId [roleDefinitionId]`
35
41
  : ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
@@ -54,12 +60,23 @@ Adds a role assignment to a file with a specified site-relative URL for a specif
54
60
  m365 spo file roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --fileUrl "Shared Documents/Test1.docx" --upn "testuser@tenant.onmicrosoft.com" --roleDefinitionName "Full Control"
55
61
  ```
56
62
 
57
- Adds a role assignment to a file with a specified server-relative URL the for a specific group and a role definition name.
63
+ Adds a role assignment to a file with a specified server-relative URL the for a specific SharePoint Online group and a role definition name.
58
64
 
59
65
  ```sh
60
- m365 spo file roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --fileUrl "/sites/project-x/documents/Test1.docx" --upn "testuser@tenant.onmicrosoft.com" --roleDefinitionName "Read"
66
+ m365 spo file roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --fileUrl "/sites/project-x/documents/Test1.docx" --groupName "Sales Group" --roleDefinitionName "Read"
61
67
  ```
62
68
 
69
+ Adds a role assignment to a file with a specified site-relative URL for a specific Entra Group Id and a role definition name.
70
+
71
+ ```sh
72
+ m365 spo file roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --fileUrl "Shared Documents/Test1.docx" --entraGroupId 3c97e01e-978d-417b-a196-b6a3e37fa873 --roleDefinitionName "Full Control"
73
+ ```
74
+
75
+ Adds a role assignment to a file with a specified site-relative URL for a specific Entra Group Name and a role definition name.
76
+
77
+ ```sh
78
+ m365 spo file roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --fileUrl "Shared Documents/Test1.docx" --entraGroupName "Marketing Memebers" --roleDefinitionName "Full Control"
79
+ ```
63
80
  ## Response
64
81
 
65
82
  The command won't return a response on success.
@@ -23,13 +23,19 @@ m365 spo file roleassignment remove [options]
23
23
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
24
24
 
25
25
  `--principalId [principalId]`
26
- : The SharePoint Id of the principal. It may be either a user id or group id. Specify either `upn`, `groupName`, or `principalId` but not multiple.
26
+ : The SharePoint Id of the principal. It may be either a user id or group id. Specify either `upn`, `groupName`, `entraGroupId`, `entraGroupName`, or `principalId` but not multiple.
27
27
 
28
28
  `--upn [upn]`
29
- : The upn/email of the user. Specify either `upn`, `groupName`, or `principalId` but not multiple.
29
+ : The upn/email of the user. Specify either `upn`, `groupName`, `entraGroupId`, `entraGroupName`, or `principalId` but not multiple.
30
30
 
31
31
  `--groupName [groupName]`
32
- : The group name of the SharePoint group Specify either `upn`, `groupName`, or `principalId` but not multiple.
32
+ : The group name of the SharePoint group Specify either `upn`, `groupName`, `entraGroupId`, `entraGroupName`, or `principalId` but not multiple. This option is only used for SharePoint Online groups.
33
+
34
+ `--entraGroupId [entraGroupId]`
35
+ : ID of the Microsoft Entra group to remove. Specify either `upn`, `groupName`, `entraGroupId`, `entraGroupName`, or `principalId` but not multiple.
36
+
37
+ `--entraGroupName [entraGroupName]`
38
+ : Display name of the Microsoft Entra group to remove. Specify either `upn`, `groupName`, `entraGroupId`, `entraGroupName`, or `principalId` but not multiple.
33
39
 
34
40
  `-f, --force`
35
41
  : Don't prompt for confirmation.
@@ -57,6 +63,18 @@ Remove a role assignment by group name from a file by id.
57
63
  m365 spo file roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --fileId "b2307a39-e878-458b-bc90-03bc578531d6" --groupName "saleGroup"
58
64
  ```
59
65
 
66
+ Remove a role assignment by entra group id from a file by id without prompt
67
+
68
+ ```sh
69
+ m365 spo file roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --fileId "b2307a39-e878-458b-bc90-03bc578531d6" --entraGroupId 3c97e01e-978d-417b-a196-b6a3e37fa873 --force
70
+ ```
71
+
72
+ Remove a role assignment by entra group name from a file by id.
73
+
74
+ ```sh
75
+ m365 spo file roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --fileId "b2307a39-e878-458b-bc90-03bc578531d6" --entraGroupName "Marketing Members"
76
+ ```
77
+
60
78
  ## Response
61
79
 
62
80
  The command won't return a response on success.
@@ -20,13 +20,19 @@ m365 spo folder roleassignment add [options]
20
20
  : The server- or site-relative decoded URL of the folder.
21
21
 
22
22
  `--principalId [principalId]`
23
- : The SharePoint principal id. It may be either an user id or group id for which the role assignment will be addd. Specify either `upn`, `groupName` or `principalId` but not multiple.
23
+ : The SharePoint principal id. It may be either an user id or group id for which the role assignment will be addd. Specify either `upn`, `groupName`, `principalId`, `entraGroupId` or `entraGroupName` but not multiple.
24
24
 
25
25
  `--upn [upn]`
26
- : The upn/email of the user. Specify either `upn`, `groupName` or `principalId` but not multiple.
26
+ : The upn/email of the user. Specify either `upn`, `groupName`, `principalId`, `entraGroupId` or `entraGroupName` but not multiple.
27
27
 
28
28
  `--groupName [groupName]`
29
- : The Microsoft Entra or SharePoint group name. Specify either `upn`, `groupName` or `principalId` but not multiple.
29
+ : The SharePoint group name. Specify either `upn`, `groupName`, `principalId`, `entraGroupId` or `entraGroupName` but not multiple.
30
+
31
+ `--entraGroupId [entraGroupId]`
32
+ : ID of the Microsoft Entra group to add. Specify either `upn`, `groupName`, `principalId`, `entraGroupId` or `entraGroupName` but not multiple.
33
+
34
+ `--entraGroupName [entraGroupName]`
35
+ : Display name of the Microsoft Entra group to add. Specify either `upn`, `groupName`, `principalId`, `entraGroupId` or `entraGroupName` but not multiple.
30
36
 
31
37
  `--roleDefinitionId [roleDefinitionId]`
32
38
  : ID of the role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
@@ -63,6 +69,12 @@ Add the role assignment to the root folder based on the upn and role definition
63
69
  m365 spo folder roleassignment add --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --folderUrl "/Shared Documents" --upn "test@contoso.onmicrosoft.com" --roleDefinitionName "Edit"
64
70
  ```
65
71
 
72
+ Add the role assignment to the specified folder based on the Entra Group Id and role definition id.
73
+
74
+ ```sh
75
+ m365 spo folder roleassignment add --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --folderUrl "/Shared Documents/FolderPermission" --entraGroupId "27ae47f1-48f1-46f3-980b-d3c1470e398d" --roleDefinitionId 1073741827
76
+ ```
77
+
66
78
  ## Response
67
79
 
68
80
  The command won't return a response on success.
@@ -20,13 +20,19 @@ m365 spo folder roleassignment remove [options]
20
20
  : The server- or site-relative decoded URL of the folder.
21
21
 
22
22
  `--principalId [principalId]`
23
- : The SharePoint principal id. It may be either an user id or group id for which the role assignment will be removed. Specify either `upn`, `groupName` or `principalId` but not multiple.
23
+ : The SharePoint principal id. It may be either an user id or group id for which the role assignment will be removed. Specify either `upn`, `groupName`, `principalId`, `entraGroupId` or `entraGroupName` but not multiple.
24
24
 
25
25
  `--upn [upn]`
26
- : The upn/email of the user. Specify either `upn`, `groupName` or `principalId` but not multiple.
26
+ : The upn/email of the user. Specify either `upn`, `groupName`, `principalId`, `entraGroupId` or `entraGroupName` but not multiple.
27
27
 
28
28
  `--groupName [groupName]`
29
- : The Microsoft Entra or SharePoint group name. Specify either `upn`, `groupName` or `principalId` but not multiple.
29
+ : The SharePoint group name. Specify either `upn`, `groupName`, `principalId`, `entraGroupId` or `entraGroupName` but not multiple.
30
+
31
+ `--entraGroupId [entraGroupId]`
32
+ : ID of the Microsoft Entra group to remove. Specify either `upn`, `groupName`, `principalId`, `entraGroupId` or `entraGroupName` but not multiple.
33
+
34
+ `--entraGroupName [entraGroupName]`
35
+ : Display name of the Microsoft Entra group to remove. Specify either `upn`, `groupName`, `principalId`, `entraGroupId` or `entraGroupName` but not multiple.
30
36
 
31
37
  `-f, --force`
32
38
  : Don't prompt for confirmation when removing the role assignment.
@@ -60,6 +66,12 @@ Remove the role assignment from the specified folder based on the upn.
60
66
  m365 spo folder roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --folderUrl "/Shared Documents/FolderPermission" --upn "test@contoso.onmicrosoft.com"
61
67
  ```
62
68
 
69
+ Remove the role assignment from the specified folder based on the Entra group id.
70
+
71
+ ```sh
72
+ m365 spo folder roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --folderUrl "/Shared Documents/FolderPermission" --entraGroupId "27ae47f1-48f1-46f3-980b-d3c1470e398d"
73
+ ```
74
+
63
75
  ## Response
64
76
 
65
77
  The command won't return a response on success.
@@ -0,0 +1,62 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # spo list defaultvalue clear
4
+
5
+ Clears default column values for a specific document library
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 spo list defaultvalue clear [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `-u, --webUrl <webUrl>`
17
+ : URL of the site where the list is located.
18
+
19
+ `-i, --listId [listId]`
20
+ : ID of the list. Specify either `listTitle`, `listId`, or `listUrl`.
21
+
22
+ `-t, --listTitle [listTitle]`
23
+ : Title of the list. Specify either `listTitle`, `listId`, or `listUrl`.
24
+
25
+ `--listUrl [listUrl]`
26
+ : Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl`.
27
+
28
+ `--fieldName [fieldName]`
29
+ : Internal name of the field to clear over the entire list. Specify either `fieldName` or `folderUrl`, but not both.
30
+
31
+ `--folderUrl [folderUrl]`
32
+ : Clear all fields of a specific folder by specifying a server- or site-relative URL. Specify either `fieldName` or `folderUrl`, but not both.
33
+
34
+ `-f, --force`
35
+ : Don't prompt for confirmation.
36
+ ```
37
+
38
+ <Global />
39
+
40
+ ## Examples
41
+
42
+ Remove all default column values from a library
43
+
44
+ ```sh
45
+ m365 spo list defaultvalue clear --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos
46
+ ```
47
+
48
+ Clear a field from all folders of a library
49
+
50
+ ```sh
51
+ m365 spo list defaultvalue clear --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --field Company
52
+ ```
53
+
54
+ Clear all fields from a specific folder in a library
55
+
56
+ ```sh
57
+ m365 spo list defaultvalue clear --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --folderUrl "/sites/Marketing/Logos/Contoso"
58
+ ```
59
+
60
+ ## Response
61
+
62
+ The command won't return a response on success.
@@ -0,0 +1,110 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spo list defaultvalue list
6
+
7
+ Retrieves default column values for a specific document library
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo list defaultvalue list [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --webUrl <webUrl>`
19
+ : URL of the site where the list is located.
20
+
21
+ `-i, --listId [listId]`
22
+ : ID of the list. Specify either `listTitle`, `listId`, or `listUrl`.
23
+
24
+ `-t, --listTitle [listTitle]`
25
+ : Title of the list. Specify either `listTitle`, `listId`, or `listUrl`.
26
+
27
+ `--listUrl [listUrl]`
28
+ : Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl`.
29
+
30
+ `--folderUrl [folderUrl]`
31
+ : Only get default column values from a specific folder.
32
+ ```
33
+
34
+ <Global />
35
+
36
+ ## Examples
37
+
38
+ List all default column values of a list specified by title
39
+
40
+ ```sh
41
+ m365 spo list defaultvalue list --webUrl https://contoso.sharepoint.com/sites/marketing --listTitle "Project Documents"
42
+ ```
43
+
44
+ List all default column values of a list specified by ID
45
+
46
+ ```sh
47
+ m365 spo list defaultvalue list --webUrl https://contoso.sharepoint.com/sites/marketing --listId 12345678-90ab-cdef-1234-567890abcdef
48
+ ```
49
+
50
+ List all default column values of a list specified by server relative URL
51
+
52
+ ```sh
53
+ m365 spo list defaultvalue list --webUrl https://contoso.sharepoint.com/sites/marketing --listUrl "/sites/marketing/Project Documents"
54
+ ```
55
+
56
+ List all default column values of a specific folder in a list specified by site relative URLs
57
+
58
+ ```sh
59
+ m365 spo list defaultvalue list --webUrl https://contoso.sharepoint.com/sites/marketing --listUrl "/Project Documents" --folderUrl "/Project Documents/Archive"
60
+ ```
61
+
62
+ ## Response
63
+
64
+ <Tabs>
65
+ <TabItem value="JSON">
66
+
67
+ ```json
68
+ [
69
+ {
70
+ "fieldName": "Countries",
71
+ "fieldValue": "19;#Belgium|442affc2-7fab-4f33-9590-330403a579c2",
72
+ "folderUrl": "/sites/Marketing/Project Documents"
73
+ }
74
+ ]
75
+ ```
76
+
77
+ </TabItem>
78
+ <TabItem value="Text">
79
+
80
+ ```text
81
+ fieldName fieldValue folderUrl
82
+ --------- ------------------------------------------------ ----------------------------------
83
+ Countries 19;#Belgium|442affc2-7fab-4f33-9590-330403a579c2 /sites/Marketing/Project Documents
84
+ ```
85
+
86
+ </TabItem>
87
+ <TabItem value="CSV">
88
+
89
+ ```csv
90
+ fieldName,fieldValue,folderUrl
91
+ Countries,19;#Belgium|442affc2-7fab-4f33-9590-330403a579c2,/sites/Marketing/Project Documents
92
+ ```
93
+
94
+ </TabItem>
95
+ <TabItem value="Markdown">
96
+
97
+ ```md
98
+ # spo list defaultvalue list --webUrl "https://contoso.sharepoint.com/sites/marketing" --listUrl "/Project Documents"
99
+
100
+ Date: 20/10/2024
101
+
102
+ Property | Value
103
+ ---------|-------
104
+ fieldName | Countries
105
+ fieldValue | 19;#Belgium\|442affc2-7fab-4f33-9590-330403a579c2
106
+ folderUrl | /sites/Marketing/Project Documents
107
+ ```
108
+
109
+ </TabItem>
110
+ </Tabs>
@@ -0,0 +1,62 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # spo list defaultvalue remove
4
+
5
+ Removes a specific default column value for a specific document library
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 spo list defaultvalue remove [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `-u, --webUrl <webUrl>`
17
+ : URL of the site where the list is located.
18
+
19
+ `-i, --listId [listId]`
20
+ : ID of the list. Specify either `listTitle`, `listId`, or `listUrl`.
21
+
22
+ `-t, --listTitle [listTitle]`
23
+ : Title of the list. Specify either `listTitle`, `listId`, or `listUrl`.
24
+
25
+ `--listUrl [listUrl]`
26
+ : Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl`.
27
+
28
+ `--fieldName <fieldName>`
29
+ : Internal name of the field.
30
+
31
+ `--folderUrl [folderUrl]`
32
+ : Server- or site-relative URL of a specific folder to remove the field from. By default, the root folder of the list is used.
33
+
34
+ `-f, --force`
35
+ : Don't prompt for confirmation.
36
+ ```
37
+
38
+ <Global />
39
+
40
+ ## Examples
41
+
42
+ Remove a default column value from the root folder of the list
43
+
44
+ ```sh
45
+ m365 spo list defaultvalue remove --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName Company
46
+ ```
47
+
48
+ Remove a column default value from a specific folder using web-relative URL
49
+
50
+ ```sh
51
+ m365 spo list defaultvalue remove --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl '/Logos' --fieldName Company --folderUrl '/Logos/Branding'
52
+ ```
53
+
54
+ Remove a column default value from a specific folder by server relative URL
55
+
56
+ ```sh
57
+ m365 spo list defaultvalue remove --webUrl https://contoso.sharepoint.com/sites/Marketing --listId fc6d514f-e7da-47d4-b48b-f72e2fb9c82a --field Company --folderUrl '/sites/Marketing/Logos/Branding'
58
+ ```
59
+
60
+ ## Response
61
+
62
+ The command won't return a response on success.