@pnp/cli-microsoft365 10.9.0-beta.bc13e90 → 10.10.0-beta.3dc1bcf

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 (114) hide show
  1. package/.devcontainer/Dockerfile +1 -1
  2. package/.devproxy/api-specs/sharepoint-admin.yaml +67 -0
  3. package/.devproxy/api-specs/sharepoint.yaml +230 -0
  4. package/.devproxy/devproxyrc.json +48 -0
  5. package/.devproxy/generate-openapi-spec.json +24 -0
  6. package/.devproxy/spo-csom-types.json +54 -0
  7. package/.eslintrc.cjs +8 -0
  8. package/Dockerfile +3 -3
  9. package/allCommands.json +1 -1
  10. package/allCommandsFull.json +1 -1
  11. package/dist/cli/cli.js +1 -1
  12. package/dist/m365/entra/commands/m365group/m365group-get.js +16 -3
  13. package/dist/m365/entra/commands/m365group/m365group-list.js +7 -1
  14. package/dist/m365/entra/commands/pim/pim-role-assignment-eligibility-list.js +9 -3
  15. package/dist/m365/entra/commands/pim/pim-role-assignment-list.js +9 -3
  16. package/dist/m365/entra/commands/pim/pim-role-request-list.js +9 -3
  17. package/dist/m365/file/commands/file-copy.js +2 -2
  18. package/dist/m365/file/commands/file-move.js +1 -1
  19. package/dist/m365/flow/commands/flow-list.js +14 -7
  20. package/dist/m365/flow/commands/run/run-get.js +1 -1
  21. package/dist/m365/graph/commands/subscription/subscription-add.js +10 -3
  22. package/dist/m365/planner/commands/tenant/tenant-settings-list.js +0 -3
  23. package/dist/m365/pp/commands/solution/solution-publisher-list.js +8 -1
  24. package/dist/m365/purview/commands/threatassessment/threatassessment-get.js +9 -2
  25. package/dist/m365/spo/commands/contenttype/contenttype-add.js +3 -65
  26. package/dist/m365/spo/commands/contenttype/contenttype-field-remove.js +5 -50
  27. package/dist/m365/spo/commands/contenttype/contenttype-field-set.js +4 -48
  28. package/dist/m365/spo/commands/contenttype/contenttype-set.js +8 -58
  29. package/dist/m365/spo/commands/contenttype/contenttype-sync.js +2 -2
  30. package/dist/m365/spo/commands/file/file-move.js +8 -2
  31. package/dist/m365/spo/commands/folder/folder-sharinglink-add.js +1 -1
  32. package/dist/m365/spo/commands/folder/folder-sharinglink-clear.js +1 -1
  33. package/dist/m365/spo/commands/folder/folder-sharinglink-get.js +1 -1
  34. package/dist/m365/spo/commands/folder/folder-sharinglink-list.js +1 -1
  35. package/dist/m365/spo/commands/folder/folder-sharinglink-remove.js +1 -1
  36. package/dist/m365/spo/commands/folder/folder-sharinglink-set.js +1 -1
  37. package/dist/m365/spo/commands/hubsite/hubsite-get.js +14 -5
  38. package/dist/m365/spo/commands/hubsite/hubsite-list.js +9 -2
  39. package/dist/m365/spo/commands/listitem/listitem-batch-set.js +3 -27
  40. package/dist/m365/spo/commands/page/Page.js +16 -1
  41. package/dist/m365/spo/commands/page/clientsidepages.js +49 -17
  42. package/dist/m365/spo/commands/page/page-add.js +1 -1
  43. package/dist/m365/spo/commands/page/page-clientsidewebpart-add.js +2 -8
  44. package/dist/m365/spo/commands/page/page-control-remove.js +99 -0
  45. package/dist/m365/spo/commands/page/page-control-set.js +1 -1
  46. package/dist/m365/spo/commands/page/page-header-set.js +9 -40
  47. package/dist/m365/spo/commands/page/page-publish.js +2 -10
  48. package/dist/m365/spo/commands/page/page-section-add.js +2 -8
  49. package/dist/m365/spo/commands/page/page-set.js +1 -1
  50. package/dist/m365/spo/commands/site/site-admin-add.js +1 -12
  51. package/dist/m365/spo/commands/tenant/tenant-site-list.js +16 -5
  52. package/dist/m365/spo/commands/term/term-list.js +10 -3
  53. package/dist/m365/spo/commands.js +1 -0
  54. package/dist/m365/teams/commands/chat/chat-member-add.js +10 -4
  55. package/dist/m365/viva/commands/engage/engage-community-remove.js +99 -0
  56. package/dist/m365/viva/commands/engage/engage-network-list.js +8 -2
  57. package/dist/m365/viva/commands.js +1 -0
  58. package/dist/utils/md.js +3 -3
  59. package/dist/utils/spo.js +87 -3
  60. package/docs/docs/cmd/_global.mdx +1 -1
  61. package/docs/docs/cmd/entra/m365group/m365group-get.mdx +8 -5
  62. package/docs/docs/cmd/entra/m365group/m365group-list.mdx +14 -12
  63. package/docs/docs/cmd/entra/pim/pim-role-assignment-eligibility-list.mdx +7 -4
  64. package/docs/docs/cmd/entra/pim/pim-role-assignment-list.mdx +9 -6
  65. package/docs/docs/cmd/entra/pim/pim-role-request-list.mdx +7 -4
  66. package/docs/docs/cmd/flow/flow-list.mdx +8 -5
  67. package/docs/docs/cmd/flow/run/run-get.mdx +1 -1
  68. package/docs/docs/cmd/graph/subscription/subscription-add.mdx +6 -3
  69. package/docs/docs/cmd/planner/bucket/bucket-add.mdx +19 -0
  70. package/docs/docs/cmd/planner/bucket/bucket-get.mdx +19 -0
  71. package/docs/docs/cmd/planner/bucket/bucket-list.mdx +19 -0
  72. package/docs/docs/cmd/planner/bucket/bucket-remove.mdx +21 -0
  73. package/docs/docs/cmd/planner/bucket/bucket-set.mdx +21 -0
  74. package/docs/docs/cmd/planner/plan/plan-add.mdx +19 -0
  75. package/docs/docs/cmd/planner/plan/plan-get.mdx +19 -0
  76. package/docs/docs/cmd/planner/plan/plan-list.mdx +19 -0
  77. package/docs/docs/cmd/planner/plan/plan-remove.mdx +21 -0
  78. package/docs/docs/cmd/planner/plan/plan-set.mdx +19 -0
  79. package/docs/docs/cmd/planner/roster/roster-add.mdx +19 -0
  80. package/docs/docs/cmd/planner/roster/roster-get.mdx +19 -0
  81. package/docs/docs/cmd/planner/roster/roster-member-add.mdx +19 -0
  82. package/docs/docs/cmd/planner/roster/roster-member-get.mdx +19 -0
  83. package/docs/docs/cmd/planner/roster/roster-member-list.mdx +19 -0
  84. package/docs/docs/cmd/planner/roster/roster-member-remove.mdx +21 -0
  85. package/docs/docs/cmd/planner/roster/roster-plan-list.mdx +19 -0
  86. package/docs/docs/cmd/planner/roster/roster-remove.mdx +21 -0
  87. package/docs/docs/cmd/planner/task/task-add.mdx +19 -0
  88. package/docs/docs/cmd/planner/task/task-checklistitem-add.mdx +19 -0
  89. package/docs/docs/cmd/planner/task/task-checklistitem-list.mdx +19 -0
  90. package/docs/docs/cmd/planner/task/task-checklistitem-remove.mdx +21 -0
  91. package/docs/docs/cmd/planner/task/task-get.mdx +27 -0
  92. package/docs/docs/cmd/planner/task/task-list.mdx +19 -0
  93. package/docs/docs/cmd/planner/task/task-reference-add.mdx +19 -0
  94. package/docs/docs/cmd/planner/task/task-reference-list.mdx +19 -0
  95. package/docs/docs/cmd/planner/task/task-reference-remove.mdx +21 -0
  96. package/docs/docs/cmd/planner/task/task-remove.mdx +21 -0
  97. package/docs/docs/cmd/planner/task/task-set.mdx +19 -0
  98. package/docs/docs/cmd/planner/tenant/tenant-settings-list.mdx +44 -7
  99. package/docs/docs/cmd/planner/tenant/tenant-settings-set.mdx +43 -8
  100. package/docs/docs/cmd/pp/solution/solution-publisher-list.mdx +7 -4
  101. package/docs/docs/cmd/purview/threatassessment/threatassessment-get.mdx +7 -4
  102. package/docs/docs/cmd/spo/file/file-move.mdx +4 -1
  103. package/docs/docs/cmd/spo/hubsite/hubsite-get.mdx +6 -3
  104. package/docs/docs/cmd/spo/hubsite/hubsite-list.mdx +7 -4
  105. package/docs/docs/cmd/spo/list/list-add.mdx +1 -1
  106. package/docs/docs/cmd/spo/list/list-set.mdx +2 -2
  107. package/docs/docs/cmd/spo/page/page-control-remove.mdx +56 -0
  108. package/docs/docs/cmd/spo/tenant/tenant-site-list.mdx +10 -7
  109. package/docs/docs/cmd/spo/term/term-list.mdx +7 -4
  110. package/docs/docs/cmd/teams/chat/chat-member-add.mdx +6 -3
  111. package/docs/docs/cmd/viva/engage/engage-community-remove.mdx +61 -0
  112. package/docs/docs/cmd/viva/engage/engage-network-list.mdx +7 -4
  113. package/npm-shrinkwrap.json +112 -97
  114. package/package.json +17 -14
@@ -18,13 +18,30 @@ m365 planner tenant settings list [options]
18
18
 
19
19
  ## Remarks
20
20
 
21
- :::info
21
+ After executing the command `planner tenant settings set`, it can take some time for all changes to propagate across the tenant. Because of this, executing this command right away can return some unexpected results.
22
22
 
23
- To use this command you must be a global administrator.
23
+ ## Permissions
24
24
 
25
- :::
25
+ <Tabs>
26
+ <TabItem value="Delegated">
26
27
 
27
- After executing the command `planner tenant settings set`, it can take some time for all changes to propagate across the tenant. Because of this, executing this command right away can return some unexpected results.
28
+ | Resource | Permissions |
29
+ |-----------------|-------------|
30
+ | Microsoft Graph | email |
31
+
32
+ :::info
33
+
34
+ To use this command you must be a **global administrator**.
35
+
36
+ :::
37
+
38
+ </TabItem>
39
+ <TabItem value="Application">
40
+
41
+ This command does not support application permissions.
42
+
43
+ </TabItem>
44
+ </Tabs>
28
45
 
29
46
  ## Examples
30
47
 
@@ -47,7 +64,17 @@ m365 planner tenant settings list
47
64
  "allowTenantMoveWithDataLoss": false,
48
65
  "allowTenantMoveWithDataMigration": false,
49
66
  "allowRosterCreation": true,
50
- "allowPlannerMobilePushNotifications": true
67
+ "allowPlannerMobilePushNotifications": true,
68
+ "allowFileRecommendations": true,
69
+ "enforceClientLicenseCheck": false,
70
+ "allowDataFlowToDataverse": true,
71
+ "allowPlannerCopilot": true,
72
+ "disallowedSharedWithContainerTypes": [
73
+ {
74
+ "hostContainerType": "group",
75
+ "sharedWithContainerType": "roster"
76
+ }
77
+ ]
51
78
  }
52
79
  ```
53
80
 
@@ -56,10 +83,16 @@ m365 planner tenant settings list
56
83
 
57
84
  ```txt
58
85
  allowCalendarSharing : true
86
+ allowDataFlowToDataverse : true
87
+ allowFileRecommendations : true
88
+ allowPlannerCopilot : true
59
89
  allowPlannerMobilePushNotifications: true
60
90
  allowRosterCreation : true
61
91
  allowTenantMoveWithDataLoss : false
62
92
  allowTenantMoveWithDataMigration : false
93
+ disallowedSharedWithContainerTypes : [{"hostContainerType":"group","sharedWithContainerType":"roster"}]
94
+ enforceClientLicenseCheck : false
95
+ id : 1
63
96
  isPlannerAllowed : true
64
97
  ```
65
98
 
@@ -67,8 +100,8 @@ m365 planner tenant settings list
67
100
  <TabItem value="CSV">
68
101
 
69
102
  ```csv
70
- isPlannerAllowed,allowCalendarSharing,allowTenantMoveWithDataLoss,allowTenantMoveWithDataMigration,allowRosterCreation,allowPlannerMobilePushNotifications
71
- 1,1,,,1,1
103
+ id,isPlannerAllowed,allowCalendarSharing,allowTenantMoveWithDataLoss,allowTenantMoveWithDataMigration,allowRosterCreation,allowPlannerMobilePushNotifications,allowFileRecommendations,enforceClientLicenseCheck,allowDataFlowToDataverse,allowPlannerCopilot
104
+ 1,1,1,0,0,1,1,1,0,1,1
72
105
  ```
73
106
 
74
107
  </TabItem>
@@ -90,6 +123,10 @@ m365 planner tenant settings list
90
123
  allowTenantMoveWithDataMigration | false
91
124
  allowRosterCreation | true
92
125
  allowPlannerMobilePushNotifications | true
126
+ allowFileRecommendations | true
127
+ enforceClientLicenseCheck | false
128
+ allowDataFlowToDataverse | true
129
+ allowPlannerCopilot | true
93
130
  ```
94
131
 
95
132
  </TabItem>
@@ -36,13 +36,28 @@ m365 planner tenant settings set [options]
36
36
 
37
37
  <Global />
38
38
 
39
- ## Remarks
39
+ ## Permissions
40
40
 
41
- :::info
41
+ <Tabs>
42
+ <TabItem value="Delegated">
43
+
44
+ | Resource | Permissions |
45
+ |-----------------|-------------|
46
+ | Microsoft Graph | email |
47
+
48
+ :::info
42
49
 
43
- To use this command you must be a global administrator.
50
+ To use this command you must be a **global administrator**.
44
51
 
45
- :::
52
+ :::
53
+
54
+ </TabItem>
55
+ <TabItem value="Application">
56
+
57
+ This command does not support application permissions.
58
+
59
+ </TabItem>
60
+ </Tabs>
46
61
 
47
62
  ## Examples
48
63
 
@@ -77,7 +92,17 @@ m365 planner tenant settings set --isPlannerAllowed true --allowRosterCreation f
77
92
  "allowTenantMoveWithDataLoss": false,
78
93
  "allowTenantMoveWithDataMigration": false,
79
94
  "allowRosterCreation": true,
80
- "allowPlannerMobilePushNotifications": true
95
+ "allowPlannerMobilePushNotifications": true,
96
+ "allowFileRecommendations": true,
97
+ "enforceClientLicenseCheck": false,
98
+ "allowDataFlowToDataverse": true,
99
+ "allowPlannerCopilot": true,
100
+ "disallowedSharedWithContainerTypes": [
101
+ {
102
+ "hostContainerType": "group",
103
+ "sharedWithContainerType": "roster"
104
+ }
105
+ ]
81
106
  }
82
107
  ```
83
108
 
@@ -86,10 +111,16 @@ m365 planner tenant settings set --isPlannerAllowed true --allowRosterCreation f
86
111
 
87
112
  ```txt
88
113
  allowCalendarSharing : true
114
+ allowDataFlowToDataverse : true
115
+ allowFileRecommendations : true
116
+ allowPlannerCopilot : true
89
117
  allowPlannerMobilePushNotifications: true
90
118
  allowRosterCreation : true
91
119
  allowTenantMoveWithDataLoss : false
92
120
  allowTenantMoveWithDataMigration : false
121
+ disallowedSharedWithContainerTypes : [{"hostContainerType":"group","sharedWithContainerType":"roster"}]
122
+ enforceClientLicenseCheck : false
123
+ id : 1
93
124
  isPlannerAllowed : true
94
125
  ```
95
126
 
@@ -97,15 +128,15 @@ m365 planner tenant settings set --isPlannerAllowed true --allowRosterCreation f
97
128
  <TabItem value="CSV">
98
129
 
99
130
  ```csv
100
- isPlannerAllowed,allowCalendarSharing,allowTenantMoveWithDataLoss,allowTenantMoveWithDataMigration,allowRosterCreation,allowPlannerMobilePushNotifications
101
- 1,1,,,1,1
131
+ id,isPlannerAllowed,allowCalendarSharing,allowTenantMoveWithDataLoss,allowTenantMoveWithDataMigration,allowRosterCreation,allowPlannerMobilePushNotifications,allowFileRecommendations,enforceClientLicenseCheck,allowDataFlowToDataverse,allowPlannerCopilot
132
+ 1,1,1,0,0,1,1,1,0,1,1
102
133
  ```
103
134
 
104
135
  </TabItem>
105
136
  <TabItem value="Markdown">
106
137
 
107
138
  ```md
108
- # planner tenant settings list
139
+ # planner tenant settings set --isPlannerAllowed true
109
140
 
110
141
  Date: 4/2/2023
111
142
 
@@ -120,6 +151,10 @@ m365 planner tenant settings set --isPlannerAllowed true --allowRosterCreation f
120
151
  allowTenantMoveWithDataMigration | false
121
152
  allowRosterCreation | true
122
153
  allowPlannerMobilePushNotifications | true
154
+ allowFileRecommendations | true
155
+ enforceClientLicenseCheck | false
156
+ allowDataFlowToDataverse | true
157
+ allowPlannerCopilot | true
123
158
  ```
124
159
 
125
160
  </TabItem>
@@ -16,10 +16,13 @@ m365 pp solution publisher list [options]
16
16
 
17
17
  ```md definition-list
18
18
  `-e, --environmentName <environmentName>`
19
- : The name of the environment
19
+ : The name of the environment.
20
20
 
21
21
  `--includeMicrosoftPublishers`
22
- : Include the Microsoft Publishers
22
+ : (deprecated. Use option `withMicrosoftPublishers` instead) Include the Microsoft Publishers.
23
+
24
+ `--withMicrosoftPublishers`
25
+ : Include the Microsoft Publishers.
23
26
 
24
27
  `--asAdmin`
25
28
  : Run the command as admin for environments you do not have explicitly assigned permissions to.
@@ -29,13 +32,13 @@ m365 pp solution publisher list [options]
29
32
 
30
33
  ## Examples
31
34
 
32
- List all publishers in a specific environment
35
+ List all publishers in a specific environment.
33
36
 
34
37
  ```sh
35
38
  m365 pp solution publisher list --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
36
39
  ```
37
40
 
38
- List all publishers in a specific environment as Admin
41
+ List all publishers in a specific environment as Admin.
39
42
 
40
43
  ```sh
41
44
  m365 pp solution publisher list --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin
@@ -19,6 +19,9 @@ m365 purview threatassessment get [options]
19
19
  : The Id of the threat assessment.
20
20
 
21
21
  `--includeResults`
22
+ : (deprecated. Use option `withResults` instead) Include the threat assessment results.
23
+
24
+ `--withResults`
22
25
  : Include the threat assessment results.
23
26
  ```
24
27
 
@@ -35,7 +38,7 @@ m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e
35
38
  Get a threat assessment including results.
36
39
 
37
40
  ```sh
38
- m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --includeResults
41
+ m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --withResults
39
42
  ```
40
43
 
41
44
  ## Response
@@ -118,9 +121,9 @@ m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --in
118
121
  </TabItem>
119
122
  </Tabs>
120
123
 
121
- ### `includeResults` response
124
+ ### `withResults` response
122
125
 
123
- When we make use of the option `includeResults` the response will differ.
126
+ When we make use of the option `withResults` the response will differ.
124
127
 
125
128
  <Tabs>
126
129
  <TabItem value="JSON">
@@ -184,7 +187,7 @@ When we make use of the option `includeResults` the response will differ.
184
187
  <TabItem value="Markdown">
185
188
 
186
189
  ```md
187
- # purview threatassessment get --id "8aaba0ac-ec4d-4e62-5774-08db16c68731" --includeResults "true"
190
+ # purview threatassessment get --id "8aaba0ac-ec4d-4e62-5774-08db16c68731" --withResults "true"
188
191
 
189
192
  Date: 25/02/2023
190
193
 
@@ -34,6 +34,9 @@ m365 spo file move [options]
34
34
  : Behavior when a file or folder with the same name is already present at the destination. Allowed values: `fail`, `replace`, `rename`. Defaults to `fail`.
35
35
 
36
36
  `--includeItemPermissions`
37
+ : (deprecated. Use option `withItemPermissions` instead) Ensure that item-level permissions are preserved during the move.
38
+
39
+ `--withItemPermissions`
37
40
  : Ensure that item-level permissions are preserved during the move.
38
41
 
39
42
  `--bypassSharedLock`
@@ -75,7 +78,7 @@ m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sou
75
78
  Move a file referenced by its ID to another document library and retain item-level permissions.
76
79
 
77
80
  ```sh
78
- m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --includeItemPermissions
81
+ m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --withItemPermissions
79
82
  ```
80
83
 
81
84
  ## Response
@@ -25,6 +25,9 @@ m365 spo hubsite get [options]
25
25
  : URL of the hub site. Specify either `id`, `title`, or `url` but not multiple.
26
26
 
27
27
  `--includeAssociatedSites`
28
+ : (deprecated. Use option `withAssociatedSites` instead) Include the associated sites in the result (only in JSON output).
29
+
30
+ `--withAssociatedSites`
28
31
  : Include the associated sites in the result (only in JSON output)
29
32
  ```
30
33
 
@@ -53,7 +56,7 @@ m365 spo hubsite get --url 'https://contoso.sharepoint.com/sites/HubSite'
53
56
  Get information about the hub site with specific ID, including its associated sites. Associated site info is only shown in JSON output.
54
57
 
55
58
  ```sh
56
- m365 spo hubsite get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --includeAssociatedSites --output json
59
+ m365 spo hubsite get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --withAssociatedSites --output json
57
60
  ```
58
61
 
59
62
  ## Response
@@ -147,9 +150,9 @@ m365 spo hubsite get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --includeAssociat
147
150
  </TabItem>
148
151
  </Tabs>
149
152
 
150
- ### `includeAssociatedSites` response
153
+ ### `withAssociatedSites` response
151
154
 
152
- When we make use of the option `includeAssociatedSites` the response will differ. This command can only be executed using --output json or an error will be thrown.
155
+ When we make use of the option `withAssociatedSites` the response will differ. This command can only be executed using --output json or an error will be thrown.
153
156
 
154
157
  <Tabs>
155
158
  <TabItem value="JSON">
@@ -16,6 +16,9 @@ m365 spo hubsite list [options]
16
16
 
17
17
  ```md definition-list
18
18
  `-i, --includeAssociatedSites`
19
+ : (deprecated. Use option `withAssociatedSites` instead) Include the associated sites in the result (only in JSON output).
20
+
21
+ `--withAssociatedSites`
19
22
  : Include the associated sites in the result (only in JSON output).
20
23
  ```
21
24
 
@@ -36,7 +39,7 @@ m365 spo hubsite list
36
39
  List hub sites, including their associated sites, in the current tenant. Associated site info is only shown in JSON output.
37
40
 
38
41
  ```sh
39
- m365 spo hubsite list --includeAssociatedSites --output json
42
+ m365 spo hubsite list --withAssociatedSites --output json
40
43
  ```
41
44
 
42
45
  ## Response
@@ -119,9 +122,9 @@ m365 spo hubsite list --includeAssociatedSites --output json
119
122
  </TabItem>
120
123
  </Tabs>
121
124
 
122
- ### `includeAssociatedSites` response
125
+ ### `withAssociatedSites` response
123
126
 
124
- When we make use of the option `includeAssociatedSites` the response will differ.
127
+ When we make use of the option `withAssociatedSites` the response will differ.
125
128
 
126
129
  <Tabs>
127
130
  <TabItem value="JSON">
@@ -176,7 +179,7 @@ When we make use of the option `includeAssociatedSites` the response will differ
176
179
  <TabItem value="Markdown">
177
180
 
178
181
  ```md
179
- # spo hubsite list --includeAssociatedSites "true"
182
+ # spo hubsite list --withAssociatedSites "true"
180
183
 
181
184
  Date: 2/20/2023
182
185
 
@@ -127,7 +127,7 @@ m365 spo list add [options]
127
127
  : Boolean value that specifies whether the list is hidden. Valid values are `true`, `false`.
128
128
 
129
129
  `--includedInMyFilesScope [includedInMyFilesScope]`
130
- : Specifies whether this list is accessible to an app principal that has been granted an OAuth scope that contains the string myfiles by a case-insensitive comparison when the current user is a site collection administrator of the personal site that contains the list.
130
+ : Specifies whether this list is accessible to an app principal that has been granted an OAuth scope that contains the string "myfiles" by a case-insensitive comparison when the current user is a site collection administrator of the personal site that contains the list.
131
131
 
132
132
  `--irmEnabled [irmEnabled]`
133
133
  : Gets or sets a Boolean value that specifies whether Information Rights Management (IRM) is enabled for the list.
@@ -14,7 +14,7 @@ m365 spo list set [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-u, --webUrl <webUrl>`
17
- : URL of the site
17
+ : URL of the site.
18
18
 
19
19
  `--id [id]`
20
20
  : ID of the list. Specify either `id`, `title`, or `url` but not multiple.
@@ -128,7 +128,7 @@ m365 spo list set [options]
128
128
  : Boolean value that specifies whether the list is hidden. Valid values are `true`, `false`.
129
129
 
130
130
  `--includedInMyFilesScope [includedInMyFilesScope]`
131
- : Specifies whether this list is accessible to an app principal that has been granted an OAuth scope that contains the string myfiles by a case-insensitive comparison when the current user is a site collection administrator of the personal site that contains the list.
131
+ : Specifies whether this list is accessible to an app principal that has been granted an OAuth scope that contains the string "myfiles" by a case-insensitive comparison when the current user is a site collection administrator of the personal site that contains the list.
132
132
 
133
133
  `--irmEnabled [irmEnabled]`
134
134
  : Gets or sets a Boolean value that specifies whether Information Rights Management (IRM) is enabled for the list.
@@ -0,0 +1,56 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # spo page control remove
4
+
5
+ Removes a control from a modern page
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 spo page control remove [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `-u, --webUrl <webUrl>`
17
+ : URL of the site where the page is located.
18
+
19
+ `-n, --pageName <pageName>`
20
+ : Name of the page where the control is located.
21
+
22
+ `-i, --id <id>`
23
+ : The ID of the control to be removed.
24
+
25
+ `--draft`
26
+ : Save the page as draft instead of republishing it.
27
+
28
+ `-f, --force`
29
+ : Don't prompt for confirmation.
30
+ ```
31
+
32
+ <Global />
33
+
34
+ ## Examples
35
+
36
+ Remove a control from a SharePoint page, with confirmation
37
+
38
+ ```sh
39
+ m365 spo page control remove --webUrl https://contoso.sharepoint.com/sites/Marketing --pageName home.aspx --id b3d6ebc9-6c7b-4e1e-99c1-4c08b682e8c1
40
+ ```
41
+
42
+ Remove a control from a SharePoint page and don't republish the page
43
+
44
+ ```sh
45
+ m365 spo page control remove --webUrl https://contoso.sharepoint.com/sites/Marketing --pageName "home.aspx" --id b3d6ebc9-6c7b-4e1e-99c1-4c08b682e8c1 --draft
46
+ ```
47
+
48
+ Remove a control from a SharePoint page, that is located in a folder
49
+
50
+ ```sh
51
+ m365 spo page control remove --webUrl https://contoso.sharepoint.com/sites/Marketing --pageName "Archive/home.aspx" --id b3d6ebc9-6c7b-4e1e-99c1-4c08b682e8c1
52
+ ```
53
+
54
+ ## Response
55
+
56
+ The command won't return a response on success.
@@ -28,9 +28,12 @@ m365 spo site list
28
28
  : type of sites to list. To be used with values like `GROUP#0` and `SITEPAGEPUBLISHING#0`. Specify either `type` or `webTemplate`, but not both.
29
29
 
30
30
  `--filter [filter]`
31
- : filter to apply when retrieving sites
31
+ : filter to apply when retrieving sites.
32
32
 
33
33
  `--includeOneDriveSites`
34
+ : (deprecated. Use option `withOneDriveSites` instead) use this switch to include OneDrive sites in the result when retrieving sites. Do not specify the `type` or `webTemplate` options when using this.
35
+
36
+ `--withOneDriveSites`
34
37
  : use this switch to include OneDrive sites in the result when retrieving sites. Do not specify the `type` or `webTemplate` options when using this.
35
38
  ```
36
39
 
@@ -52,34 +55,34 @@ To use this command you have to have permissions to access the tenant admin site
52
55
 
53
56
  ## Examples
54
57
 
55
- List all sites in the currently connected tenant
58
+ List all sites in the currently connected tenant.
56
59
 
57
60
  ```sh
58
61
  m365 spo tenant site list
59
62
  ```
60
63
 
61
- List all group connected team sites in the currently connected tenant
64
+ List all group connected team sites in the currently connected tenant.
62
65
 
63
66
  ```sh
64
67
  m365 spo tenant site list --type TeamSite
65
68
  ```
66
69
 
67
- List all communication sites in the currently connected tenant
70
+ List all communication sites in the currently connected tenant.
68
71
 
69
72
  ```sh
70
73
  m365 spo tenant site list --type CommunicationSite
71
74
  ```
72
75
 
73
- List all group connected team sites that contain _project_ in the URL
76
+ List all group connected team sites that contain _project_ in the URL.
74
77
 
75
78
  ```sh
76
79
  m365 spo tenant site list --type TeamSite --filter "Url -like 'project'"
77
80
  ```
78
81
 
79
- List all sites in the currently connected tenant including OneDrive sites
82
+ List all sites in the currently connected tenant including OneDrive sites.
80
83
 
81
84
  ```sh
82
- m365 spo tenant site list --includeOneDriveSites
85
+ m365 spo tenant site list --withOneDriveSites
83
86
  ```
84
87
 
85
88
  ## Response
@@ -31,6 +31,9 @@ m365 spo term list [options]
31
31
  : Name of the term set for which to retrieve terms. Specify `termSetId` or `termSetName` but not both.
32
32
 
33
33
  `--includeChildTerms`
34
+ : (deprecated. Use option `withChildTerms` instead) If specified, child terms are loaded as well.
35
+
36
+ `--withChildTerms`
34
37
  : If specified, child terms are loaded as well.
35
38
  ```
36
39
 
@@ -69,7 +72,7 @@ m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetI
69
72
  List taxonomy terms from the term group and term set with the given ID including child terms if any are found.
70
73
 
71
74
  ```sh
72
- m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetId 0e8f395e-ff58-4d45-9ff7-e331ab728bec --includeChildTerms
75
+ m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetId 0e8f395e-ff58-4d45-9ff7-e331ab728bec --withChildTerms
73
76
  ```
74
77
 
75
78
  ## Response
@@ -162,9 +165,9 @@ m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetI
162
165
  </TabItem>
163
166
  </Tabs>
164
167
 
165
- ### `includeChildTerms` response
168
+ ### `withChildTerms` response
166
169
 
167
- When we make use of the option `includeChildTerms` the response will differ.
170
+ When we make use of the option `withChildTerms` the response will differ.
168
171
 
169
172
  <Tabs>
170
173
  <TabItem value="JSON">
@@ -245,7 +248,7 @@ When we make use of the option `includeChildTerms` the response will differ.
245
248
  <TabItem value="Markdown">
246
249
 
247
250
  ```md
248
- # spo term list --termGroupName "PnPTermSets" --termSetName "PnP-Organizations" --includeChildTerms "true"
251
+ # spo term list --termGroupName "PnPTermSets" --termSetName "PnP-Organizations" --withChildTerms "true"
249
252
 
250
253
  Date: 5/8/2023
251
254
 
@@ -26,10 +26,13 @@ m365 teams chat member add [options]
26
26
  : The role for the user to add. Valid values are: `owner`, `guest`. Defaults to `owner`.
27
27
 
28
28
  `--visibleHistoryStartDateTime [visibleHistoryStartDateTime]`
29
- : Include chat history until a certain point in time. Specify either `visibleHistoryStartDateTime`, `includeAllHistory`, or neither.
29
+ : Include chat history until a certain point in time. Specify either `visibleHistoryStartDateTime`, `includeAllHistory`, `withAllHistory` or neither.
30
30
 
31
31
  `--includeAllHistory`
32
- : Include all chat history. Specify either `visibleHistoryStartDateTime`, `includeAllHistory`, or neither.
32
+ : (deprecated. Use option `withChildTerms` instead) Include all chat history. Specify either `visibleHistoryStartDateTime`, `includeAllHistory`, `withAllHistory` or neither.
33
+
34
+ `--withAllHistory`
35
+ : Include all chat history. Specify either `visibleHistoryStartDateTime`, `includeAllHistory`, `withAllHistory` or neither.
33
36
  ```
34
37
 
35
38
  <Global />
@@ -58,7 +61,7 @@ m365 teams chat member add --chatId 19:8b081ef6-4792-4def-b2c9-c363a1bf41d5_5031
58
61
  Add a guest member by UPN to a Teams chat and share all chat history.
59
62
 
60
63
  ```sh
61
- m365 teams chat member add --chatId 19:8b081ef6-4792-4def-b2c9-c363a1bf41d5_5031bb31-22c0-4f6f-9f73-91d34ab2b32d@unq.gbl.spaces --userName nelson.wilke@fabrikam.com --role guest --includeAllHistory
64
+ m365 teams chat member add --chatId 19:8b081ef6-4792-4def-b2c9-c363a1bf41d5_5031bb31-22c0-4f6f-9f73-91d34ab2b32d@unq.gbl.spaces --userName nelson.wilke@fabrikam.com --role guest --withAllHistory
62
65
  ```
63
66
 
64
67
  ## Response
@@ -0,0 +1,61 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # viva engage community remove
4
+
5
+ Removes a Viva Engage community
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 viva engage community remove [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `-i, --id [id]`
17
+ : The id of the community. Specify either `id`, `displayName` or `entraGroupId`, but not multiple.
18
+
19
+ `-n, --displayName [displayName]`
20
+ : The name of the community. Specify either `id`, `displayName` or `entraGroupId`, but not multiple.
21
+
22
+ `--entraGroupId [entraGroupId]`
23
+ : The id of the Microsoft 365 group associated with the community. Specify either `id`, `displayName` or `entraGroupId`, but not multiple.
24
+
25
+ `-f, --force`
26
+ : Don't prompt for confirmation.
27
+ ```
28
+
29
+ <Global />
30
+
31
+ ## Remarks
32
+
33
+ :::info
34
+
35
+ When the Viva Engage community is removed, all the associated Microsoft 365 content, including the M365 group, the document library, OneNote notebook, and Planner plan is deleted.
36
+
37
+ :::
38
+
39
+ ## Examples
40
+
41
+ Remove a community specified by id without prompting
42
+
43
+ ```sh
44
+ m365 viva engage community remove --id eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9 --force
45
+ ```
46
+
47
+ Remove a community specified by name and prompt for confirmation
48
+
49
+ ```sh
50
+ m365 viva engage community remove --displayName 'Software Engineers'
51
+ ```
52
+
53
+ Remove a community specified by Entra group id and prompt for confirmation
54
+
55
+ ```sh
56
+ m365 viva engage community remove --entraGroupId '0bed8b86-5026-4a93-ac7d-56750cc099f1'
57
+ ```
58
+
59
+ ## Response
60
+
61
+ The command won't return a response on success
@@ -16,7 +16,10 @@ m365 viva engage network list [options]
16
16
 
17
17
  ```md definition-list
18
18
  `--includeSuspended`
19
- : Include the networks in which the user is suspended
19
+ : (deprecated. Use option `withSuspended` instead) Include the networks in which the user is suspended.
20
+
21
+ `--withSuspended`
22
+ : Include the networks in which the user is suspended.
20
23
  ```
21
24
 
22
25
  <Global />
@@ -31,16 +34,16 @@ In order to use this command, you need to grant the Microsoft Entra application
31
34
 
32
35
  ## Examples
33
36
 
34
- Returns the current user's networks
37
+ Returns the current user's networks.
35
38
 
36
39
  ```sh
37
40
  m365 viva engage network list
38
41
  ```
39
42
 
40
- Returns the current user's networks including the networks in which the user is suspended
43
+ Returns the current user's networks including the networks in which the user is suspended.
41
44
 
42
45
  ```sh
43
- m365 viva engage network list --includeSuspended
46
+ m365 viva engage network list --withSuspended
44
47
  ```
45
48
 
46
49
  ## Response