@pnp/cli-microsoft365 10.3.0-beta.ea113b7 → 10.3.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 (33) hide show
  1. package/.eslintrc.cjs +1 -0
  2. package/allCommands.json +1 -1
  3. package/allCommandsFull.json +1 -1
  4. package/dist/config.js +2 -1
  5. package/dist/m365/entra/commands/app/app-add.js +3 -0
  6. package/dist/m365/entra/commands/roledefinition/roledefinition-add.js +58 -0
  7. package/dist/m365/entra/commands/roledefinition/roledefinition-set.js +84 -0
  8. package/dist/m365/entra/commands/rolepermission/rolepermission-list.js +42 -0
  9. package/dist/m365/entra/commands.js +3 -0
  10. package/dist/m365/outlook/commands/mailbox/mailbox-settings-set.js +163 -0
  11. package/dist/m365/outlook/commands.js +1 -0
  12. package/dist/m365/spe/commands/container/container-activate.js +50 -0
  13. package/dist/m365/spe/commands.js +1 -0
  14. package/dist/m365/spo/commands/list/list-defaultvalue-clear.js +184 -0
  15. package/dist/m365/spo/commands/list/list-defaultvalue-remove.js +181 -0
  16. package/dist/m365/spo/commands/list/list-defaultvalue-set.js +210 -0
  17. package/dist/m365/spo/commands.js +3 -0
  18. package/dist/m365/tenant/commands/people/people-pronouns-set.js +46 -0
  19. package/dist/m365/tenant/commands/report/report-settings-set.js +47 -0
  20. package/dist/m365/tenant/commands.js +2 -0
  21. package/docs/docs/cmd/entra/app/app-add.mdx +1 -1
  22. package/docs/docs/cmd/entra/roledefinition/roledefinition-add.mdx +131 -0
  23. package/docs/docs/cmd/entra/roledefinition/roledefinition-set.mdx +64 -0
  24. package/docs/docs/cmd/entra/rolepermission/rolepermission-list.mdx +162 -0
  25. package/docs/docs/cmd/outlook/mailbox/mailbox-settings-set.mdx +166 -0
  26. package/docs/docs/cmd/spe/container/container-activate.mdx +34 -0
  27. package/docs/docs/cmd/spo/list/list-defaultvalue-clear.mdx +62 -0
  28. package/docs/docs/cmd/spo/list/list-defaultvalue-remove.mdx +62 -0
  29. package/docs/docs/cmd/spo/list/list-defaultvalue-set.mdx +112 -0
  30. package/docs/docs/cmd/tenant/people/people-pronouns-set.mdx +82 -0
  31. package/docs/docs/cmd/tenant/report/report-settings-set.mdx +32 -0
  32. package/npm-shrinkwrap.json +54 -74
  33. package/package.json +10 -10
@@ -0,0 +1,64 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # entra roledefinition set
4
+
5
+ Updates a custom Microsoft Entra ID role definition
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 entra roledefinition set [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `-i, --id [id]`
17
+ : The id of the role definition to be updated. Specify either `id` or `displayName`, but not both.
18
+
19
+ `-n, --displayName [displayName]`
20
+ : The display name of the role definition to be updated. Specify either `id` or `displayName`, but not both.
21
+
22
+ `--newDisplayName [newDisplayName]`
23
+ : Updated display name for the role definition.
24
+
25
+ `-d, --description [description]`
26
+ : Updated description for the role definition.
27
+
28
+ `-e, --enabled [enabled]`
29
+ : Indicates if the role is enabled for the assignment.
30
+
31
+ `a-, --allowedResourceActions [allowedResourceActions]`
32
+ : Updated comma-separated list of resource actions allowed for the role.
33
+
34
+ `-v, --version [version]`
35
+ : Updated version of the role definition.
36
+ ```
37
+
38
+ <Global />
39
+
40
+ ## Remarks
41
+
42
+ Use the `m365 entra rolepermission list --resourceNamespace microsoft.directory` command to get a list of available resource actions.
43
+
44
+ ## Examples
45
+
46
+ Update a custom Microsoft Entra ID role specified by the id
47
+
48
+ ```sh
49
+ m365 entra roledefinition set --id fadbc488-151d-4431-9143-6abbffae759f --newDisplayName 'Application Remover' --description 'Allows to remove any Entra ID application' --allowedResourceActions 'microsoft.directory/applications/delete'
50
+ ```
51
+
52
+ Update a custom Microsoft Entra ID role specified by the display name
53
+
54
+ ```sh
55
+ m365 entra roledefinition set --displayName 'Application Remover' --version '1.0' --enabled true --allowedResourceActions 'microsoft.directory/applications/delete,microsoft.directory/applications/owners/update'
56
+ ```
57
+
58
+ ## Response
59
+
60
+ The command won't return a response on success
61
+
62
+ ## More information
63
+
64
+ - https://learn.microsoft.com/graph/api/rbacapplication-post-roledefinitions
@@ -0,0 +1,162 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # entra rolepermission list
6
+
7
+ Lists all Microsoft Entra ID role permissions
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 entra rolepermission list [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-n, --resourceNamespace [resourceNamespace]`
19
+ : The namespace of the resource for which to retrieve role permissions.
20
+
21
+ `-p, --privileged`
22
+ : Retrieve only sensitive role permissions.
23
+ ```
24
+
25
+ <Global />
26
+
27
+ ## Remarks
28
+
29
+ :::warning
30
+
31
+ The command is based on an API that is currently in preview and is subject to change once the API reached general availability.
32
+
33
+ :::
34
+
35
+ ## Examples
36
+
37
+ Get a list of role permissions
38
+
39
+ ```sh
40
+ m365 entra rolepermission list --resourceNamespace 'microsoft.directory'
41
+ ```
42
+
43
+ Get a list of sensitive role permissions
44
+
45
+ ```sh
46
+ m365 entra rolepermission list --resourceNamespace 'microsoft.directory' --privileged
47
+ ```
48
+
49
+ ## Response
50
+
51
+ <Tabs>
52
+ <TabItem value="JSON">
53
+
54
+ ```json
55
+ [
56
+ {
57
+ "actionVerb": null,
58
+ "description": "Create and delete access reviews, and read and update all properties of access reviews in Microsoft Entra ID",
59
+ "id": "microsoft.directory-accessReviews-allProperties-allTasks",
60
+ "isPrivileged": false,
61
+ "name": "microsoft.directory/accessReviews/allProperties/allTasks",
62
+ "resourceScopeId": null
63
+ },
64
+ {
65
+ "actionVerb": "GET",
66
+ "description": "Read all properties of access reviews",
67
+ "id": "microsoft.directory-accessReviews-allProperties-read-get",
68
+ "isPrivileged": false,
69
+ "name": "microsoft.directory/accessReviews/allProperties/read",
70
+ "resourceScopeId": null
71
+ },
72
+ {
73
+ "actionVerb": null,
74
+ "description": "Manage access reviews of application role assignments in Microsoft Entra ID",
75
+ "id": "microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks",
76
+ "isPrivileged": false,
77
+ "name": "microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks",
78
+ "resourceScopeId": null
79
+ },
80
+ {
81
+ "actionVerb": "GET",
82
+ "description": "Read all properties of access reviews of application role assignments in Microsoft Entra ID",
83
+ "id": "microsoft.directory-accessReviews-definitions.applications-allProperties-read-get",
84
+ "isPrivileged": false,
85
+ "name": "microsoft.directory/accessReviews/definitions.applications/allProperties/read",
86
+ "resourceScopeId": null
87
+ }
88
+ ]
89
+ ```
90
+
91
+ </TabItem>
92
+ <TabItem value="Text">
93
+
94
+ ```text
95
+ id name actionVerb isPrivileged
96
+ -------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- ---------- ------------
97
+ microsoft.directory-accessReviews-allProperties-allTasks microsoft.directory/accessReviews/allProperties/allTasks null false
98
+ microsoft.directory-accessReviews-allProperties-read-get microsoft.directory/accessReviews/allProperties/read GET false
99
+ microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks null false
100
+ microsoft.directory-accessReviews-definitions.applications-allProperties-read-get microsoft.directory/accessReviews/definitions.applications/allProperties/read GET false
101
+ ```
102
+
103
+ </TabItem>
104
+ <TabItem value="CSV">
105
+
106
+ ```csv
107
+ actionVerb,description,id,isPrivileged,name,resourceScopeId
108
+ ,"Create and delete access reviews, and read and update all properties of access reviews in Microsoft Entra ID",microsoft.directory-accessReviews-allProperties-allTasks,0,microsoft.directory/accessReviews/allProperties/allTasks,
109
+ GET,Read all properties of access reviews,microsoft.directory-accessReviews-allProperties-read-get,0,microsoft.directory/accessReviews/allProperties/read,
110
+ ,Manage access reviews of application role assignments in Microsoft Entra ID,microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks,0,microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks,
111
+ GET,Read all properties of access reviews of application role assignments in Microsoft Entra ID,microsoft.directory-accessReviews-definitions.applications-allProperties-read-get,0,microsoft.directory/accessReviews/definitions.applications/allProperties/read,
112
+ ```
113
+
114
+ </TabItem>
115
+ <TabItem value="Markdown">
116
+
117
+ ```md
118
+ # entra rolepermission list --resourceNamespace "microsoft.directory"
119
+
120
+ Date: 1/16/2025
121
+
122
+ ## microsoft.directory/accessReviews/allProperties/allTasks (microsoft.directory-accessReviews-allProperties-allTasks)
123
+
124
+ Property | Value
125
+ ---------|-------
126
+ description | Create and delete access reviews, and read and update all properties of access reviews in Microsoft Entra ID
127
+ id | microsoft.directory-accessReviews-allProperties-allTasks
128
+ isPrivileged | false
129
+ name | microsoft.directory/accessReviews/allProperties/allTasks
130
+
131
+ ## microsoft.directory/accessReviews/allProperties/read (microsoft.directory-accessReviews-allProperties-read-get)
132
+
133
+ Property | Value
134
+ ---------|-------
135
+ actionVerb | GET
136
+ description | Read all properties of access reviews
137
+ id | microsoft.directory-accessReviews-allProperties-read-get
138
+ isPrivileged | false
139
+ name | microsoft.directory/accessReviews/allProperties/read
140
+
141
+ ## microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks (microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks)
142
+
143
+ Property | Value
144
+ ---------|-------
145
+ description | Manage access reviews of application role assignments in Microsoft Entra ID
146
+ id | microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks
147
+ isPrivileged | false
148
+ name | microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks
149
+
150
+ ## microsoft.directory/accessReviews/definitions.applications/allProperties/read (microsoft.directory-accessReviews-definitions.applications-allProperties-read-get)
151
+
152
+ Property | Value
153
+ ---------|-------
154
+ actionVerb | GET
155
+ description | Read all properties of access reviews of application role assignments in Microsoft Entra ID
156
+ id | microsoft.directory-accessReviews-definitions.applications-allProperties-read-get
157
+ isPrivileged | false
158
+ name | microsoft.directory/accessReviews/definitions.applications/allProperties/read
159
+ ```
160
+
161
+ </TabItem>
162
+ </Tabs>
@@ -0,0 +1,166 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # outlook mailbox settings set
6
+
7
+ Updates user mailbox settings
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 outlook mailbox settings set [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-i, --userId [userId]`
19
+ : The ID of the Microsoft Entra user to update mailbox settings for. Either `userId` or `userName` is required when using application permissions.
20
+
21
+ `-n, --userName [userName]`
22
+ : The UPN of the Microsoft Entra user to update mailbox settings for. Either `userId` or `userName` is required when using application permissions.
23
+
24
+ `--dateFormat [dateFormat]`
25
+ : The date format for the user's mailbox. Example: `dd.MM.yyyy`.
26
+
27
+ `--timeFormat [timeFormat]`
28
+ : The time format for the user's mailbox. Example: `H:mm`.
29
+
30
+ `--timeZone [timeZone]`
31
+ : The default time zone for the user's mailbox. Should follow [Windows time zone name](https://learn.microsoft.com/windows-hardware/manufacture/desktop/default-time-zones?view=windows-11#time-zones) or [IANA time zone identifier](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List). Example: `Central Europe Standard Time`.
32
+
33
+ `--language [language]`
34
+ : The preferred language for the user. Should follow [ISO 639-1 Code](https://learn.microsoft.com/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a). Example: `en-US`.
35
+
36
+ `--delegateMeetingMessageDeliveryOptions [delegateMeetingMessageDeliveryOptions]`
37
+ : Specifies who can receive meeting messages and meeting responses. Allowed values are `sendToDelegateOnly`, `sendToDelegateAndPrincipal`, or `sendToDelegateAndInformationToPrincipal`.
38
+
39
+ `--workingDays [workingDays]`
40
+ : The days of the week on which the user works, separated by a comma. Allowed values are `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`, or `sunday`.
41
+
42
+ `--workingHoursStartTime [workingHoursStartTime]`
43
+ : The time of the day that the user starts working. Example: `09:00`.
44
+
45
+ `--workingHoursEndTime [workingHoursEndTime]`
46
+ : The time of the day that the user stops working. Example: `17:00`.
47
+
48
+ `--workingHoursTimeZone [workingHoursTimeZone]`
49
+ : The name of a time zone to which the working hours apply. Should follow [Windows time zone name](https://learn.microsoft.com/windows-hardware/manufacture/desktop/default-time-zones?view=windows-11#time-zones) or [IANA time zone identifier](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List). Example: `Central Europe Standard Time`.
50
+
51
+ `--autoReplyExternalAudience [autoReplyExternalAudience]`
52
+ : Specifies external audience who will receive reply message. Allowed values are `none`, `contactsOnly`, or `all`.
53
+
54
+ `--autoReplyExternalMessage [autoReplyExternalMessage]`
55
+ : The reply message for the external audience.
56
+
57
+ `--autoReplyInternalMessage [autoReplyInternalMessage]`
58
+ : The reply message for the audience from the signed-in user's organization.
59
+
60
+ `--autoReplyStartDateTime [autoReplyStartDateTime]`
61
+ : The date and time that automatic replies are set to begin. Example: `2025-01-06T11:00:00.0000000`.
62
+
63
+ `--autoReplyStartTimeZone [autoReplyStartTimeZone]`
64
+ : The time zone that automatic replies are set to begin.
65
+
66
+ `--autoReplyEndDateTime [autoReplyEndDateTime]`
67
+ : The date and time that automatic replies are set to end. Example: `2025-01-07T11:00:00.0000000`.
68
+
69
+ `--autoReplyEndTimeZone [autoReplyEndTimeZone]`
70
+ : The time zone that automatic replies are set to end.
71
+
72
+ `--autoReplyStatus [autoReplyStatus]`
73
+ : The status for automatic replies. Allowed values are `disabled`, `alwaysEnabled`, or `scheduled`.
74
+ ```
75
+
76
+ <Global />
77
+
78
+ ## Examples
79
+
80
+ Update date, time format and time zone of the signed-in user.
81
+
82
+ ```sh
83
+ m365 outlook mailbox settings set --dateFormat 'dd.MM.yyyy' --timeFormat 'H:mm' --timeZone 'Central Europe Standard Time' --language 'en-US'
84
+ ```
85
+
86
+ Update working hours of a user specified by id
87
+
88
+ ```sh
89
+ m365 outlook mailbox settings set --userId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --workingDays 'monday,tuesday,thursday,friday' --workingHoursStartTime '08:00' --workingHoursEndTime '16:30' --workingHoursTimeZone 'Central Europe Standard Time'
90
+ ```
91
+
92
+ Set scheduled automatic replies for the internal audience of a user specified by UPN
93
+
94
+ ```sh
95
+ m365 outlook mailbox settings set --userName john.doe@contoso.com --autoReplyExternalAudience none --autoReplyInternalMessage 'On vacation' --autoReplyStartDateTime '2024-08-05T08:00:00.0000000' --autoReplyStartTimeZone 'Central Europe Standard Time' --autoReplyEndDateTime '2024-08-09T16:00:00.0000000' --autoReplyEndTimeZone 'Central Europe Standard Time' --autoReplyStatus scheduled
96
+ ```
97
+
98
+ ## Response
99
+
100
+ The command returns the updated properties of the user mailbox settings.
101
+
102
+ <Tabs>
103
+ <TabItem value="JSON">
104
+
105
+ ```json
106
+ {
107
+ "timeZone": "Central Europe Standard Time",
108
+ "timeFormat": "H:mm",
109
+ "dateFormat": "dd.MM.yyyy",
110
+ "language": {
111
+ "locale": "en-US",
112
+ "displayName": "English (United States)"
113
+ },
114
+ "workingHours": {
115
+ "daysOfWeek": [
116
+ "monday",
117
+ "tuesday",
118
+ "wednesday",
119
+ "thursday",
120
+ "friday"
121
+ ],
122
+ "startTime": "08:00:00.0000000",
123
+ "endTime": "16:30:00.0000000",
124
+ "timeZone": {
125
+ "name": "Central Europe Standard Time"
126
+ }
127
+ }
128
+ }
129
+ ```
130
+
131
+ </TabItem>
132
+ <TabItem value="Text">
133
+
134
+ ```text
135
+ dateFormat : dd.MM.yyyy
136
+ language : {"locale":"en-US","displayName":"English (United States)"}
137
+ timeFormat : H:mm
138
+ timeZone : Central Europe Standard Time
139
+ workingHours: {"daysOfWeek":["monday","tuesday","wednesday","thursday","friday"],"startTime":"08:00:00.0000000","endTime":"16:30:00.0000000","timeZone":{"name":"Central Europe Standard Time"}}
140
+ ```
141
+
142
+ </TabItem>
143
+ <TabItem value="CSV">
144
+
145
+ ```csv
146
+ dateFormat,timeZone,timeFormat
147
+ dd.MM.yyy,Central Europe Standard Time,H:mm
148
+ ```
149
+
150
+ </TabItem>
151
+ <TabItem value="Markdown">
152
+
153
+ ```md
154
+ # outlook mailbox settings set --dateFormat "dd.MM.yyyy" --timeFormat "H:mm" --timeZone "Central Europe Standard Time" --language "en-US" --workingDays "monday,tuesday,wednesday,thursday,friday" --workingHoursStartTime "08:00:00.0000000" --workingHoursEndTime "16:30:00.0000000" --workingHoursTimeZone "Central Europe Standard Time"
155
+
156
+ Date: 1/6/2025
157
+
158
+ Property | Value
159
+ ---------|-------
160
+ dateFormat | dd.MM.yyyy
161
+ timeZone | Central Europe Standard Time
162
+ timeFormat | H:mm
163
+ ```
164
+
165
+ </TabItem>
166
+ </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.
@@ -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,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.
@@ -0,0 +1,112 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # spo list defaultvalue set
4
+
5
+ Sets default column values for a specific document library
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 spo list defaultvalue set [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
+ `--fieldValue <fieldValue>`
32
+ : Default value of the field.
33
+
34
+ `--folderUrl [folderUrl]`
35
+ : Set the value for a specific folder by specifying a server- or site-relative URL. By default, the root folder of the list is used.
36
+ ```
37
+
38
+ <Global />
39
+
40
+ # Remarks
41
+
42
+ :::note
43
+
44
+ Due to limitations in SharePoint Online, setting default column values for folders with a `#` or `%` character in their path is not supported.
45
+
46
+ :::
47
+
48
+ ## Examples
49
+
50
+ Set a default folder value on the root folder of a list for a text field
51
+
52
+ ```sh
53
+ m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName Company --fieldValue Contoso
54
+ ```
55
+
56
+ Set a default folder value for a taxonomy field on a specific folder
57
+
58
+ ```sh
59
+ m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --folderUrl "/sites/Marketing/Logos/Contoso" --fieldName Country --fieldValue "-1;#Belgium|442affc2-7fab-4f33-9590-330403a579c2"
60
+ ```
61
+
62
+ Set a default folder value for a multi-taxonomy field on a specific folder
63
+
64
+ ```sh
65
+ m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl /sites/marketing/Logos --folderUrl "/sites/Marketing/Logos/Contoso" --fieldName Countries --fieldValue "-1;#Belgium|442affc2-7fab-4f33-9590-330403a579c2;#-1;#France|14888324-5c48-46db-b748-215cbe24eb4c"
66
+ ```
67
+
68
+ Set a default folder value for a date field to today
69
+
70
+ ```sh
71
+ m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listId 3540460d-cb6e-4bc5-8380-bc1844401ee3 --fieldName Published --fieldValue "[today]"
72
+ ```
73
+
74
+ Set a default folder value for a date field
75
+
76
+ ```sh
77
+ m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName Published --fieldValue "2020-05-03T11:00:00Z"
78
+ ```
79
+
80
+ Set a default folder value for a choice field
81
+
82
+ ```sh
83
+ m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl /sites/marketing/Logos --fieldName FileType --fieldValue Logo
84
+ ```
85
+
86
+ Set a default folder value for a multi-choice field
87
+
88
+ ```sh
89
+ m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName FileTypes --fieldValue "Logo;#Brand"
90
+ ```
91
+
92
+ Set a default folder value for a yes/no field using site-relative list URL
93
+
94
+ ```sh
95
+ m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl /Logos --fieldName Active --fieldValue 1
96
+ ```
97
+
98
+ Set a default folder value for a user field
99
+
100
+ ```sh
101
+ m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listId 3540460d-cb6e-4bc5-8380-bc1844401ee3 --fieldName Responsible --fieldValue "1;#john.doe@contoso.com"
102
+ ```
103
+
104
+ Set a default folder value for a multi-user field
105
+
106
+ ```sh
107
+ m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listId 3540460d-cb6e-4bc5-8380-bc1844401ee3 --fieldName Responsible --fieldValue "1;#john.doe@contoso.com;#2;#adele.vance@contoso.com"
108
+ ```
109
+
110
+ ## Response
111
+
112
+ The command won't return a response on success.