@pnp/cli-microsoft365 7.5.0 → 7.6.0-beta.480812d

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 (209) hide show
  1. package/.eslintrc.cjs +3 -0
  2. package/README.md +1 -1
  3. package/allCommands.json +1 -1
  4. package/allCommandsFull.json +1 -1
  5. package/dist/Auth.js +12 -10
  6. package/dist/AuthServer.js +1 -1
  7. package/dist/cli/cli.js +1 -1
  8. package/dist/config.js +2 -2
  9. package/dist/m365/app/commands/app-get.js +1 -1
  10. package/dist/m365/app/commands/app-open.js +1 -1
  11. package/dist/m365/app/commands/permission/permission-add.js +2 -2
  12. package/dist/m365/app/commands/permission/permission-list.js +2 -2
  13. package/dist/m365/cli/commands/cli-consent.js +2 -2
  14. package/dist/m365/cli/commands/cli-reconsent.js +3 -3
  15. package/dist/m365/commands/login.js +1 -1
  16. package/dist/m365/entra/commands/administrativeunit/administrativeunit-add.js +1 -0
  17. package/dist/m365/entra/commands/administrativeunit/administrativeunit-get.js +1 -0
  18. package/dist/m365/entra/commands/administrativeunit/administrativeunit-list.js +1 -0
  19. package/dist/m365/entra/commands/administrativeunit/administrativeunit-member-add.js +1 -0
  20. package/dist/m365/entra/commands/administrativeunit/administrativeunit-member-get.js +1 -0
  21. package/dist/m365/entra/commands/administrativeunit/administrativeunit-member-list.js +1 -0
  22. package/dist/m365/entra/commands/administrativeunit/administrativeunit-remove.js +1 -0
  23. package/dist/m365/entra/commands/app/app-add.js +7 -6
  24. package/dist/m365/entra/commands/app/app-get.js +4 -3
  25. package/dist/m365/entra/commands/app/app-list.js +1 -0
  26. package/dist/m365/entra/commands/app/app-permission-add.js +3 -2
  27. package/dist/m365/entra/commands/app/app-permission-list.js +1 -1
  28. package/dist/m365/entra/commands/app/app-remove.js +5 -4
  29. package/dist/m365/entra/commands/app/app-role-add.js +6 -5
  30. package/dist/m365/entra/commands/app/app-role-list.js +4 -3
  31. package/dist/m365/entra/commands/app/app-role-remove.js +6 -5
  32. package/dist/m365/entra/commands/app/app-set.js +8 -7
  33. package/dist/m365/entra/commands/approleassignment/approleassignment-add.js +2 -1
  34. package/dist/m365/entra/commands/approleassignment/approleassignment-list.js +1 -0
  35. package/dist/m365/entra/commands/approleassignment/approleassignment-remove.js +1 -0
  36. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-add.js +1 -0
  37. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-get.js +1 -0
  38. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-list.js +1 -0
  39. package/dist/m365/entra/commands/group/group-get.js +1 -0
  40. package/dist/m365/entra/commands/group/group-list.js +1 -0
  41. package/dist/m365/entra/commands/group/group-remove.js +1 -0
  42. package/dist/m365/entra/commands/group/group-user-list.js +1 -0
  43. package/dist/m365/entra/commands/groupsetting/groupsetting-add.js +1 -0
  44. package/dist/m365/entra/commands/groupsetting/groupsetting-get.js +1 -0
  45. package/dist/m365/entra/commands/groupsetting/groupsetting-list.js +1 -0
  46. package/dist/m365/entra/commands/groupsetting/groupsetting-remove.js +1 -0
  47. package/dist/m365/entra/commands/groupsetting/groupsetting-set.js +1 -0
  48. package/dist/m365/entra/commands/groupsettingtemplate/groupsettingtemplate-get.js +1 -0
  49. package/dist/m365/entra/commands/groupsettingtemplate/groupsettingtemplate-list.js +1 -0
  50. package/dist/m365/entra/commands/license/license-list.js +1 -0
  51. package/dist/m365/entra/commands/m365group/m365group-add.js +1 -0
  52. package/dist/m365/entra/commands/m365group/m365group-conversation-list.js +1 -0
  53. package/dist/m365/entra/commands/m365group/m365group-conversation-post-list.js +1 -0
  54. package/dist/m365/entra/commands/m365group/m365group-get.js +1 -0
  55. package/dist/m365/entra/commands/m365group/m365group-list.js +1 -0
  56. package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-clear.js +1 -0
  57. package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-list.js +1 -0
  58. package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-remove.js +1 -0
  59. package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-restore.js +1 -0
  60. package/dist/m365/entra/commands/m365group/m365group-remove.js +1 -0
  61. package/dist/m365/entra/commands/m365group/m365group-renew.js +1 -0
  62. package/dist/m365/entra/commands/m365group/m365group-set.js +1 -0
  63. package/dist/m365/entra/commands/m365group/m365group-teamify.js +1 -0
  64. package/dist/m365/entra/commands/m365group/m365group-user-add.js +1 -0
  65. package/dist/m365/entra/commands/m365group/m365group-user-list.js +1 -0
  66. package/dist/m365/entra/commands/m365group/m365group-user-remove.js +1 -0
  67. package/dist/m365/entra/commands/m365group/m365group-user-set.js +1 -0
  68. package/dist/m365/entra/commands/oauth2grant/oauth2grant-add.js +1 -0
  69. package/dist/m365/entra/commands/oauth2grant/oauth2grant-list.js +1 -0
  70. package/dist/m365/entra/commands/oauth2grant/oauth2grant-remove.js +1 -0
  71. package/dist/m365/entra/commands/oauth2grant/oauth2grant-set.js +1 -0
  72. package/dist/m365/entra/commands/policy/policy-list.js +1 -0
  73. package/dist/m365/entra/commands/siteclassification/siteclassification-disable.js +1 -0
  74. package/dist/m365/entra/commands/siteclassification/siteclassification-enable.js +1 -0
  75. package/dist/m365/entra/commands/siteclassification/siteclassification-get.js +1 -0
  76. package/dist/m365/entra/commands/siteclassification/siteclassification-set.js +1 -0
  77. package/dist/m365/entra/commands/user/user-add.js +1 -0
  78. package/dist/m365/entra/commands/user/user-get.js +1 -0
  79. package/dist/m365/entra/commands/user/user-guest-add.js +1 -0
  80. package/dist/m365/entra/commands/user/user-hibp.js +1 -0
  81. package/dist/m365/entra/commands/user/user-license-add.js +1 -0
  82. package/dist/m365/entra/commands/user/user-license-list.js +1 -0
  83. package/dist/m365/entra/commands/user/user-license-remove.js +1 -0
  84. package/dist/m365/entra/commands/user/user-list.js +1 -0
  85. package/dist/m365/entra/commands/user/user-password-validate.js +1 -0
  86. package/dist/m365/entra/commands/user/user-recyclebinitem-clear.js +1 -0
  87. package/dist/m365/entra/commands/user/user-recyclebinitem-list.js +1 -0
  88. package/dist/m365/entra/commands/user/user-recyclebinitem-remove.js +2 -1
  89. package/dist/m365/entra/commands/user/user-recyclebinitem-restore.js +1 -0
  90. package/dist/m365/entra/commands/user/user-remove.js +1 -0
  91. package/dist/m365/entra/commands/user/user-set.js +1 -0
  92. package/dist/m365/entra/commands/user/user-signin-list.js +1 -0
  93. package/dist/m365/outlook/commands/message/message-remove.js +113 -0
  94. package/dist/m365/outlook/commands.js +1 -0
  95. package/dist/m365/pp/commands/managementapp/managementapp-add.js +7 -7
  96. package/dist/m365/purview/commands/threatassessment/threatassessment-add.js +123 -0
  97. package/dist/m365/purview/commands/threatassessment/threatassessment-list.js +104 -0
  98. package/dist/m365/purview/commands.js +3 -1
  99. package/dist/m365/spfx/commands/project/DeployWorkflow.js +111 -0
  100. package/dist/m365/spfx/commands/project/project-azuredevops-pipeline-add.js +183 -0
  101. package/dist/m365/spfx/commands/project/project-azuredevops-pipeline-model.js +2 -0
  102. package/dist/m365/spfx/commands/project/project-github-workflow-add.js +3 -4
  103. package/dist/m365/spfx/commands.js +1 -0
  104. package/dist/m365/spo/commands/folder/FolderColor.js +19 -0
  105. package/dist/m365/spo/commands/folder/folder-add.js +46 -17
  106. package/dist/m365/spo/commands/folder/folder-set.js +118 -0
  107. package/dist/m365/spo/commands/group/group-member-add.js +2 -2
  108. package/dist/m365/spo/commands/group/group-member-remove.js +1 -1
  109. package/dist/m365/spo/commands/site/site-apppermission-add.js +2 -2
  110. package/dist/m365/spo/commands/site/site-recyclebinitem-restore.js +66 -27
  111. package/dist/m365/spo/commands/tenant/tenant-settings-set.js +1 -1
  112. package/dist/m365/spo/commands/user/user-remove.js +93 -16
  113. package/dist/m365/spo/commands.js +1 -0
  114. package/dist/m365/teams/commands/tab/tab-get.js +1 -1
  115. package/dist/utils/spo.js +1 -1
  116. package/docs/docs/cmd/app/app-get.mdx +10 -10
  117. package/docs/docs/cmd/app/app-open.mdx +6 -6
  118. package/docs/docs/cmd/app/permission/permission-add.mdx +2 -2
  119. package/docs/docs/cmd/app/permission/permission-list.mdx +5 -5
  120. package/docs/docs/cmd/cli/cli-consent.mdx +2 -2
  121. package/docs/docs/cmd/cli/cli-reconsent.mdx +6 -6
  122. package/docs/docs/cmd/entra/app/app-permission-add.mdx +6 -6
  123. package/docs/docs/cmd/entra/approleassignment/approleassignment-add.mdx +1 -1
  124. package/docs/docs/cmd/entra/approleassignment/approleassignment-list.mdx +4 -4
  125. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-add.mdx +1 -1
  126. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-get.mdx +1 -1
  127. package/docs/docs/cmd/entra/group/group-user-add.mdx +7 -7
  128. package/docs/docs/cmd/entra/oauth2grant/oauth2grant-add.mdx +1 -1
  129. package/docs/docs/cmd/entra/oauth2grant/oauth2grant-list.mdx +1 -1
  130. package/docs/docs/cmd/entra/oauth2grant/oauth2grant-remove.mdx +1 -1
  131. package/docs/docs/cmd/entra/oauth2grant/oauth2grant-set.mdx +1 -1
  132. package/docs/docs/cmd/external/connection/connection-add.mdx +2 -2
  133. package/docs/docs/cmd/file/file-add.mdx +1 -1
  134. package/docs/docs/cmd/graph/schemaextension/schemaextension-add.mdx +2 -2
  135. package/docs/docs/cmd/graph/schemaextension/schemaextension-set.mdx +1 -1
  136. package/docs/docs/cmd/login.mdx +18 -18
  137. package/docs/docs/cmd/outlook/message/message-remove.mdx +67 -0
  138. package/docs/docs/cmd/pa/app/app-owner-set.mdx +1 -1
  139. package/docs/docs/cmd/pa/app/app-permission-ensure.mdx +3 -3
  140. package/docs/docs/cmd/pa/app/app-permission-remove.mdx +3 -3
  141. package/docs/docs/cmd/planner/plan/plan-add.mdx +1 -1
  142. package/docs/docs/cmd/planner/roster/roster-add.mdx +5 -5
  143. package/docs/docs/cmd/planner/roster/roster-get.mdx +7 -7
  144. package/docs/docs/cmd/planner/roster/roster-member-add.mdx +4 -4
  145. package/docs/docs/cmd/planner/roster/roster-member-get.mdx +4 -4
  146. package/docs/docs/cmd/planner/roster/roster-member-list.mdx +2 -2
  147. package/docs/docs/cmd/planner/roster/roster-member-remove.mdx +5 -5
  148. package/docs/docs/cmd/planner/roster/roster-plan-list.mdx +1 -1
  149. package/docs/docs/cmd/planner/roster/roster-remove.mdx +2 -2
  150. package/docs/docs/cmd/planner/task/task-add.mdx +1 -1
  151. package/docs/docs/cmd/planner/task/task-get.mdx +1 -1
  152. package/docs/docs/cmd/planner/task/task-list.mdx +1 -1
  153. package/docs/docs/cmd/planner/task/task-remove.mdx +1 -1
  154. package/docs/docs/cmd/planner/task/task-set.mdx +1 -1
  155. package/docs/docs/cmd/pp/environment/environment-get.mdx +1 -1
  156. package/docs/docs/cmd/pp/environment/environment-list.mdx +1 -1
  157. package/docs/docs/cmd/pp/managementapp/managementapp-add.mdx +9 -9
  158. package/docs/docs/cmd/purview/auditlog/auditlog-list.mdx +1 -1
  159. package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-get.mdx +1 -1
  160. package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-list.mdx +1 -1
  161. package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-policysettings-list.mdx +1 -1
  162. package/docs/docs/cmd/purview/threatassessment/threatassessment-add.mdx +131 -0
  163. package/docs/docs/cmd/purview/threatassessment/threatassessment-list.mdx +110 -0
  164. package/docs/docs/cmd/request.mdx +1 -1
  165. package/docs/docs/cmd/spfx/project/project-azuredevops-pipeline-add.mdx +87 -0
  166. package/docs/docs/cmd/spfx/project/project-github-workflow-add.mdx +2 -2
  167. package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +3 -3
  168. package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +2 -2
  169. package/docs/docs/cmd/spo/folder/folder-add.mdx +38 -0
  170. package/docs/docs/cmd/spo/folder/folder-roleassignment-add.mdx +1 -1
  171. package/docs/docs/cmd/spo/folder/folder-roleassignment-remove.mdx +1 -1
  172. package/docs/docs/cmd/spo/folder/folder-set.mdx +88 -0
  173. package/docs/docs/cmd/spo/group/group-member-add.mdx +2 -2
  174. package/docs/docs/cmd/spo/group/group-member-remove.mdx +3 -3
  175. package/docs/docs/cmd/spo/list/list-roleassignment-add.mdx +3 -3
  176. package/docs/docs/cmd/spo/list/list-roleassignment-remove.mdx +2 -2
  177. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx +8 -8
  178. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx +2 -2
  179. package/docs/docs/cmd/spo/site/site-apppermission-add.mdx +2 -2
  180. package/docs/docs/cmd/spo/site/site-apppermission-set.mdx +2 -2
  181. package/docs/docs/cmd/spo/site/site-recyclebinitem-restore.mdx +29 -5
  182. package/docs/docs/cmd/spo/tenant/tenant-settings-set.mdx +89 -89
  183. package/docs/docs/cmd/spo/user/user-ensure.mdx +1 -1
  184. package/docs/docs/cmd/spo/user/user-remove.mdx +40 -9
  185. package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx +3 -3
  186. package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx +2 -2
  187. package/docs/docs/cmd/teams/channel/channel-member-remove.mdx +1 -1
  188. package/docs/docs/cmd/teams/channel/channel-member-set.mdx +1 -1
  189. package/docs/docs/cmd/teams/chat/chat-member-remove.mdx +3 -3
  190. package/docs/docs/cmd/teams/report/report-directroutingcalls.mdx +1 -1
  191. package/docs/docs/cmd/teams/report/report-pstncalls.mdx +1 -1
  192. package/docs/docs/cmd/teams/tab/tab-get.mdx +19 -12
  193. package/docs/docs/cmd/tenant/security/security-alerts-list.mdx +1 -1
  194. package/docs/docs/cmd/viva/engage/engage-group-list.mdx +1 -1
  195. package/docs/docs/cmd/viva/engage/engage-group-user-add.mdx +1 -1
  196. package/docs/docs/cmd/viva/engage/engage-group-user-remove.mdx +1 -1
  197. package/docs/docs/cmd/viva/engage/engage-message-add.mdx +1 -1
  198. package/docs/docs/cmd/viva/engage/engage-message-get.mdx +1 -1
  199. package/docs/docs/cmd/viva/engage/engage-message-like-set.mdx +1 -1
  200. package/docs/docs/cmd/viva/engage/engage-message-list.mdx +1 -1
  201. package/docs/docs/cmd/viva/engage/engage-message-remove.mdx +1 -1
  202. package/docs/docs/cmd/viva/engage/engage-network-list.mdx +1 -1
  203. package/docs/docs/cmd/viva/engage/engage-search.mdx +1 -1
  204. package/docs/docs/cmd/viva/engage/engage-user-get.mdx +1 -1
  205. package/docs/docs/cmd/viva/engage/engage-user-list.mdx +1 -1
  206. package/npm-shrinkwrap.json +64 -60
  207. package/package.json +12 -12
  208. package/dist/m365/spo/commands/folder/folder-rename.js +0 -72
  209. package/docs/docs/cmd/spo/folder/folder-rename.mdx +0 -44
@@ -16,40 +16,40 @@ m365 pp managementapp add [options]
16
16
 
17
17
  ```md definition-list
18
18
  `--appId [appId]`
19
- : Application (client) ID of the Azure AD application registration to register as a management app. Specify either `appId`, `objectId` or `name`
19
+ : Application (client) ID of the Microsoft Entra application registration to register as a management app. Specify either `appId`, `objectId` or `name`
20
20
 
21
21
  `--objectId [objectId]`
22
- : Object ID of the Azure AD application registration to register as a management app. Specify either `appId`, `objectId` or `name`
22
+ : Object ID of the Microsoft Entra application registration to register as a management app. Specify either `appId`, `objectId` or `name`
23
23
 
24
24
  `--name [name]`
25
- : Name of the Azure AD application registration to register as a management app. Specify either `appId`, `objectId` or `name`
25
+ : Name of the Microsoft Entra application registration to register as a management app. Specify either `appId`, `objectId` or `name`
26
26
  ```
27
27
 
28
28
  <Global />
29
29
 
30
30
  ## Remarks
31
31
 
32
- To execute this command the first time you'll need sign in using the Microsoft Azure PowerShell app registration. You can do this by executing `m365 login --appId 1950a258-227b-4e31-a9cf-717495945fc2`. To register the Azure AD app registration that CLI for Microsoft 365 uses by default, execute `m365 pp managementapp add--appId 31359c7f-bd7e-475c-86db-fdb8c937548e`.
32
+ To execute this command the first time you'll need sign in using the Microsoft Azure PowerShell app registration. You can do this by executing `m365 login --appId 1950a258-227b-4e31-a9cf-717495945fc2`. To register the Microsoft Entra app registration that CLI for Microsoft 365 uses by default, execute `m365 pp managementapp add--appId 31359c7f-bd7e-475c-86db-fdb8c937548e`.
33
33
 
34
- For best performance use the `appId` option to reference the Azure AD application registration to update. If you use `objectId` or `name`, this command will first need to find the corresponding `appId` for that application.
34
+ For best performance use the `appId` option to reference the Microsoft Entra application registration to update. If you use `objectId` or `name`, this command will first need to find the corresponding `appId` for that application.
35
35
 
36
- If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
36
+ If the command finds multiple Microsoft Entra application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
37
37
 
38
38
  ## Examples
39
39
 
40
- Register CLI for Microsoft 365 as a management application for the Power Platform
40
+ Register CLI for Microsoft 365 as a management application for the Power Platform.
41
41
 
42
42
  ```sh
43
43
  m365 pp managementapp add --appId 31359c7f-bd7e-475c-86db-fdb8c937548e
44
44
  ```
45
45
 
46
- Register Azure AD application with the specified object ID as a management application for the Power Platform
46
+ Register a Microsoft Entra application with the specified object ID as a management application for the Power Platform.
47
47
 
48
48
  ```sh
49
49
  m365 pp managementapp add --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
50
50
  ```
51
51
 
52
- Register Azure AD application named _My app_ as a management application for the Power Platform
52
+ Register a Microsoft Entra application named _My app_ as a management application for the Power Platform.
53
53
 
54
54
  ```sh
55
55
  m365 pp managementapp add --name "My app"
@@ -49,7 +49,7 @@ Retrieving audit logs is an intensive process, especially for large or active te
49
49
 
50
50
  When you specify a value for `contentType`, consider the following:
51
51
 
52
- - `AzureActiveDirectory` includes all Azure AD audit logs.
52
+ - `AzureActiveDirectory` includes all Microsoft Entra ID audit logs.
53
53
  - `Exchange` includes all Exchange audit logs.
54
54
  - `SharePoint` includes all SharePoint audit logs.
55
55
  - `General` includes all other workloads not included in the previous content types.
@@ -19,7 +19,7 @@ m365 purview sensitivitylabel get [options]
19
19
  : The Id of the sensitivity label.
20
20
 
21
21
  `--userId [userId]`
22
- : User's Azure AD ID. Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
22
+ : User's Microsoft Entra ID. Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
23
23
 
24
24
  `--userName [userName]`
25
25
  : User's UPN (user principal name, e.g. johndoe@example.com). Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
@@ -16,7 +16,7 @@ m365 purview sensitivitylabel list [options]
16
16
 
17
17
  ```md definition-list
18
18
  `--userId [userId]`
19
- : User's Azure AD ID. Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
19
+ : User's Microsoft Entra ID. Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
20
20
 
21
21
  `--userName [userName]`
22
22
  : User's UPN (user principal name, e.g. johndoe@example.com). Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
@@ -16,7 +16,7 @@ m365 purview sensitivitylabel policysettings list [options]
16
16
 
17
17
  ```md definition-list
18
18
  `--userId [userId]`
19
- : User's Azure AD ID. Optionally specify this if you want to get a list of policy settings for a sensitivity label that the user has access to. Specify either `userId` or `userName` but not both.
19
+ : User's Microsoft Entra ID. Optionally specify this if you want to get a list of policy settings for a sensitivity label that the user has access to. Specify either `userId` or `userName` but not both.
20
20
 
21
21
  `--userName [userName]`
22
22
  : User's UPN (user principal name, e.g. johndoe@example.com). Optionally specify this if you want to get a list of policy settings for a sensitivity label that the user has access to. Specify either `userId` or `userName` but not both.
@@ -0,0 +1,131 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # purview threatassessment add
6
+
7
+ Create a threat assessment
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 purview threatassessment add [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-t, --type <type>`
19
+ : The type of threat assessment to retrieve. Supports `file` and `url`.
20
+
21
+ `-e, --expectedAssessment <expectedAssessment>`
22
+ : The expected assessment from submitter. Possible values are: `block` and `unblock`.
23
+
24
+ `-c, --category <category>`
25
+ : The threat category. Possible values are: `spam`, `phishing`, `malware`.
26
+
27
+ `-p, --path [path]`
28
+ : Local path to the file to upload. Can only be used for threat assessment with type `file`.
29
+
30
+ `-u, --url [url]`
31
+ : The URL string. Can only be used for threat assessment with type `url`.
32
+ ```
33
+
34
+ <Global />
35
+
36
+ ## Remarks
37
+
38
+ :::info
39
+
40
+ This command currently only supports delegated permissions.
41
+
42
+ :::
43
+
44
+ ## Examples
45
+
46
+ Create a file threat assessment
47
+
48
+ ```sh
49
+ m365 purview threatassessment add --type file --expectedAssessment block --category malware --fileName 'test.txt' --path 'C:\Path\To\File.txt'
50
+ ```
51
+
52
+ Create a url threat assessment
53
+
54
+ ```sh
55
+ m365 purview threatassessment add --type url --expectedAssessment block --category phishing --url 'http://contoso.com'
56
+ ```
57
+
58
+ ## Response
59
+
60
+ <Tabs>
61
+ <TabItem value="JSON">
62
+
63
+ ```json
64
+ {
65
+ "id": "b0e69f1c-adda-4df2-2906-08dc2caa6b3f",
66
+ "createdDateTime": "2024-02-13T15:42:43.5131654Z",
67
+ "contentType": "file",
68
+ "expectedAssessment": "block",
69
+ "category": "malware",
70
+ "status": "pending",
71
+ "requestSource": "administrator",
72
+ "fileName": "test.txt",
73
+ "contentData": "dGVzdC50eHQ=",
74
+ "createdBy": {
75
+ "user": {
76
+ "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
77
+ "displayName": "John Doe"
78
+ }
79
+ }
80
+ }
81
+ ```
82
+
83
+ </TabItem>
84
+ <TabItem value="Text">
85
+
86
+ ```text
87
+ category : malware
88
+ contentData : dGVzdC50eHQ=
89
+ contentType : file
90
+ createdBy : {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
91
+ createdDateTime : 2024-02-13T16:15:00.4125206Z
92
+ expectedAssessment: block
93
+ fileName : test.txt
94
+ id : be1223c4-4e92-4a4c-8c16-08dc2caeedba
95
+ requestSource : administrator
96
+ status : pending
97
+ ```
98
+
99
+ </TabItem>
100
+ <TabItem value="CSV">
101
+
102
+ ```csv
103
+ id,createdDateTime,contentType,expectedAssessment,category,status,requestSource,fileName,contentData
104
+ d31eb5f5-ecd5-4a8e-fb2a-08dc2caf00a8,2024-02-13T16:15:32.1741098Z,file,block,malware,pending,administrator,test.txt,dGVzdC50eHQ=
105
+ ```
106
+
107
+ </TabItem>
108
+ <TabItem value="Markdown">
109
+
110
+ ```md
111
+ # purview threatassessment add --type "file" --expectedAssessment "block" --category "malware" --path "C:\temp\test.txt"
112
+
113
+ Date: 13/02/2024
114
+
115
+ ## e3524baf-6ea6-4fab-68af-08dc2caf0ae3
116
+
117
+ Property | Value
118
+ ---------|-------
119
+ id | e3524baf-6ea6-4fab-68af-08dc2caf0ae3
120
+ createdDateTime | 2024-02-13T16:15:49.3342383Z
121
+ contentType | file
122
+ expectedAssessment | block
123
+ category | malware
124
+ status | pending
125
+ requestSource | administrator
126
+ fileName | test.txt
127
+ contentData | dGVzdC50eHQ=
128
+ ```
129
+
130
+ </TabItem>
131
+ </Tabs>
@@ -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
+ # purview threatassessment list
6
+
7
+ Get a list of threat assessments
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 purview threatassessment list [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-t, --type [type]`
19
+ : The type of threat assessment to retrieve. Allowed values are `mail`, `file`, `emailFile` and `url`.
20
+ ```
21
+
22
+ <Global />
23
+
24
+ ## Examples
25
+
26
+ Get a list of threat assessments
27
+
28
+ ```sh
29
+ m365 purview threatassessment list
30
+ ```
31
+
32
+ Get a list of threat assessments of type _mail_
33
+
34
+ ```sh
35
+ m365 purview threatassessment list --type mail
36
+ ```
37
+
38
+ ## Response
39
+
40
+ <Tabs>
41
+ <TabItem value="JSON">
42
+
43
+ ```json
44
+ [
45
+ {
46
+ "type": "mail",
47
+ "id": "49c5ef5b-1f65-444a-e6b9-08d772ea2059",
48
+ "createdDateTime": "2019-11-27T03:30:18.6890937Z",
49
+ "contentType": "mail",
50
+ "expectedAssessment": "block",
51
+ "category": "spam",
52
+ "status": "pending",
53
+ "requestSource": "administrator",
54
+ "recipientEmail": "john@contoso.onmicrosoft.com",
55
+ "destinationRoutingReason": "notJunk",
56
+ "messageUri": "https://graph.microsoft.com/v1.0/users/c52ce8db-3e4b-4181-93c4-7d6b6bffaf60/messages/AAMkADU3MWUxOTU0LWNlOTEt=",
57
+ "createdBy": {
58
+ "user": {
59
+ "id": "c52ce8db-3e4b-4181-93c4-7d6b6bffaf60",
60
+ "displayName": "John Doe"
61
+ }
62
+ }
63
+ }
64
+ ];
65
+ ```
66
+
67
+ </TabItem>
68
+ <TabItem value="Text">
69
+
70
+ ```text
71
+ id type category
72
+ ------------------------------------ ----------- --------
73
+ 49c5ef5b-1f65-444a-e6b9-08d772ea2059 mail spam
74
+ ```
75
+
76
+ </TabItem>
77
+ <TabItem value="CSV">
78
+
79
+ ```csv
80
+ id,type,category
81
+ 49c5ef5b-1f65-444a-e6b9-08d772ea2059,mail,spam
82
+ ```
83
+
84
+ </TabItem>
85
+ <TabItem value="Markdown">
86
+
87
+ ```md
88
+ # purview threatassessment list
89
+
90
+ Date: 16/2/2023
91
+
92
+ ## a47e428c-a7bd-4cf2-f061-08db0f58b736
93
+
94
+ Property | Value
95
+ ---------|-------
96
+ type | mail
97
+ id | 49c5ef5b-1f65-444a-e6b9-08d772ea2059
98
+ createdDateTime | 2019-11-27T03:30:18.6890937Z
99
+ contentType | mail
100
+ expectedAssessment | block
101
+ category | spam
102
+ status | pending
103
+ recipientEmail | john@contoso.onmicrosoft.com
104
+ destinationRoutingReason | notJunk
105
+ messageUri | https://graph.microsoft.com/v1.0/users/c52ce8db-3e4b-4181-93c4-7d6b6bffaf60/messages/AAMkADU3MWUxOTU0LWNlOTEt=
106
+ createdBy | {"user":{"id":"c52ce8db-3e4b-4181-93c4-7d6b6bffaf60","displayName":"John Doe"}}
107
+ ```
108
+
109
+ </TabItem>
110
+ </Tabs>
@@ -22,7 +22,7 @@ m365 request [options]
22
22
  : The HTTP request method. Accepted values are `get`, `post`, `put`, `patch`, `delete`, `head`, `options`. The default value is `get`.
23
23
 
24
24
  `-r, --resource [resource]`
25
- : The resource uri for which the CLI should acquire a token from AAD in order to access the service.
25
+ : The resource uri for which the CLI should acquire a token from Microsoft Entra ID in order to access the service.
26
26
 
27
27
  `-b, --body [body]`
28
28
  : The request body. Optionally use `@example.json` to load the body from a file.
@@ -0,0 +1,87 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # spfx project azuredevops pipeline add
4
+
5
+ Adds a Azure DevOps Pipeline for a SharePoint Framework project
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 spfx project azuredevops pipeline add [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `-n, --name [name]`
17
+ : Name of the pipeline run that will be created. If none is specified a default name generated by Azure DevOps will be used
18
+
19
+ `-b, --branchName [branchName]`
20
+ : Specify the branch name which should trigger the workflow on push. If none is specified a default will be used which is 'main'
21
+
22
+ `-l, --loginMethod [loginMethod]`
23
+ : Specify the login method used for the login action. Possible options are: `user`, `application`. Default `application`
24
+
25
+ `-s, --scope [scope]`
26
+ : Scope of the app catalog: `tenant`, `sitecollection`. Default is `tenant`
27
+
28
+ `-u, --siteUrl [siteUrl]`
29
+ : The URL of the site collection where the solution package will be added. Required if scope is set to `sitecollection`
30
+
31
+ `--skipFeatureDeployment`
32
+ : When specified the app will be added to all sites. When deployed to the site app catalog it will be added to all sub-sites of that site.
33
+ ```
34
+
35
+ <Global />
36
+
37
+ ## Remarks
38
+
39
+ The `spfx project azuredevops pipeline add` will create a workflow .yml file in the `.azuredevops/pipelines` directory in your project. If such directory does not exist the command will automatically create it.
40
+
41
+ The command will not create the Azure DevOps pipeline. You will need to manually create it in Azure DevOps. The command will only create the workflow file which you can then push to your repo and create a new yaml pipline based on it.
42
+
43
+ For the `application` login method the command does not register an Entra application nor does it create the required certificate. In order to proceed, obtain (create) a self-signed certificate and register a new Entra application with certificate authentication. After that you will need to fill the following variables, or what is more preferable, create a dedicated variable group to store those properties:
44
+
45
+ - `CertificateBase64Encoded` - base 64 encoded certificate. Use either `CertificateBase64Encoded` or `CertificateSecureFileId` but not both
46
+ - `CertificateSecureFileId` - id of a certificate file in the secure files section of the DevOps library. `.pfx` file. Use either `CertificateBase64Encoded` or `CertificateSecureFileId` but not both
47
+ - `CertificatePassword` - certificate password. This applies only if the certificate is encoded which is the recommended approach
48
+ - `EntraAppId` - client id of the registered Entra application
49
+
50
+ This use case is perfect in a production context as it does not create any dependencies on an account
51
+
52
+ For the `user` login method you will need to fill the following variables, or what is more preferable, create a dedicated variable group to store those properties:
53
+
54
+ - `UserName` - user email
55
+ - `Password` - password
56
+
57
+ This method is perfect to test your workflow, in a dev context, for personal usage. It will not work for accounts with MFA.
58
+
59
+ :::info
60
+
61
+ Run this command in the SPFx solution folder.
62
+
63
+ :::
64
+
65
+ ## Examples
66
+
67
+ Adds an Azure DevOps Pipeline for a SharePoint Framework project triggered on push to main
68
+
69
+ ```sh
70
+ m365 spfx project azuredevops pipeline add
71
+ ```
72
+
73
+ Adds an Azure DevOps Pipeline for a SharePoint Framework project with `user` login method triggered on push to main
74
+
75
+ ```sh
76
+ m365 spfx project azuredevops pipeline add --loginMethod "user"
77
+ ```
78
+
79
+ Adds an Azure DevOps Pipeline for a SharePoint Framework project with deployment to a site collection app catalog
80
+
81
+ ```sh
82
+ m365 spfx project azuredevops pipeline add --scope "sitecollection" --siteUrl "https://some.sharepoint.com/sites/someSite"
83
+ ```
84
+
85
+ ## Response
86
+
87
+ The command won't return a response on success.
@@ -44,9 +44,9 @@ m365 spfx project github workflow add [options]
44
44
 
45
45
  The `spfx project github workflow add` will create a workflow .yml file in the `.github/workflows` directory in your project. If such directory does not exist the command will automatically create it.
46
46
 
47
- For the `application` login method the command does not register AAD application nor create the required certificate. In order for you to proceed you will need to first obtain (create) a self-signed certificate and register a new AAD application with certificate authentication. After that in GitHub repo settings, you will need to create the following secrets:
47
+ For the `application` login method the command does not register a Microsoft Entra application nor create the required certificate. In order for you to proceed you will need to first obtain (create) a self-signed certificate and register a new Microsoft Entra application with certificate authentication. After that in GitHub repo settings, you will need to create the following secrets:
48
48
 
49
- - `APP_ID` - client id of the registered AAD application
49
+ - `APP_ID` - client id of the registered Microsoft Entra application
50
50
  - `CERTIFICATE_ENCODED` - application's encoded certificate
51
51
  - `CERTIFICATE_PASSWORD` - certificate password. This applies only if the certificate is encoded which is the recommended approach
52
52
 
@@ -26,16 +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
- : 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`, or `principalId` but not multiple.
30
30
 
31
31
  `--groupName [groupName]`
32
- : The group name of Azure AD or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
32
+ : The group name of Microsoft Entra or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
33
33
 
34
34
  `--roleDefinitionId [roleDefinitionId]`
35
35
  : ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
36
36
 
37
37
  `--roleDefinitionName [roleDefinitionName]`
38
- : Enter the name of a role definition, like 'Contribute', 'Read', etc. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
38
+ : The name of a role definition, like 'Contribute', 'Read', etc. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
39
39
  ```
40
40
 
41
41
  <Global />
@@ -26,10 +26,10 @@ m365 spo file roleassignment remove [options]
26
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.
27
27
 
28
28
  `--upn [upn]`
29
- : 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`, or `principalId` but not multiple.
30
30
 
31
31
  `--groupName [groupName]`
32
- : The group name of an Azure AD or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
32
+ : The group name of a Microsoft Entra or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
33
33
 
34
34
  `-f, --force`
35
35
  : Don't prompt for confirmation.
@@ -23,10 +23,36 @@ m365 spo folder add [options]
23
23
 
24
24
  `-n, --name <name>`
25
25
  : Name of the new folder to be created.
26
+
27
+ `--color [color]`
28
+ : Visual color of the folder. Valid values are a color name or a number. Check remarks for more info.
26
29
  ```
27
30
 
28
31
  <Global />
29
32
 
33
+ ## Remarks
34
+
35
+ When you specify a value for `color`, consider the following:
36
+
37
+ | Color | Number value | String value |
38
+ |--------------|--------------|--------------|
39
+ | Yellow | 0 | yellow |
40
+ | Dark red | 1 | darkRed |
41
+ | Dark orange | 2 | darkOrange |
42
+ | Dark green | 3 | darkGreen |
43
+ | Dark teal | 4 | darkTeal |
44
+ | Dark blue | 5 | darkBlue |
45
+ | Dark purple | 6 | darkPurple |
46
+ | Dark pink | 7 | darkPink |
47
+ | Grey | 8 | grey |
48
+ | Light red | 9 | lightRed |
49
+ | Light orange | 10 | lightOrange |
50
+ | Light green | 11 | lightGreen |
51
+ | Light teal | 12 | lightTeal |
52
+ | Light blue | 13 | lightBlue |
53
+ | Light purple | 14 | lightPurple |
54
+ | Light pink | 15 | lightPink |
55
+
30
56
  ## Examples
31
57
 
32
58
  Creates folder in a specific library within the site.
@@ -41,6 +67,18 @@ Creates folder in a specific folder within the site.
41
67
  m365 spo folder add --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/sites/project-x/Shared Documents/Reports' --name 'Financial reports'
42
68
  ```
43
69
 
70
+ Create a folder with a dark blue look
71
+
72
+ ```sh
73
+ m365 spo folder add --webUrl https://contoso.sharepoint.com --parentFolder '/ProjectFiles' --name 'Project-x' --color 5
74
+ ```
75
+
76
+ Create a folder with a light teal look
77
+
78
+ ```sh
79
+ m365 spo folder add --webUrl https://contoso.sharepoint.com --url '/ProjectFiles/Project-x' --color lightTeal
80
+ ```
81
+
44
82
  ## Response
45
83
 
46
84
  <Tabs>
@@ -26,7 +26,7 @@ m365 spo folder roleassignment add [options]
26
26
  : The upn/email of the user. Specify either `upn`, `groupName` or `principalId` but not multiple.
27
27
 
28
28
  `--groupName [groupName]`
29
- : The Azure AD or SharePoint group name. Specify either `upn`, `groupName` or `principalId` but not multiple.
29
+ : The Microsoft Entra or SharePoint group name. Specify either `upn`, `groupName` or `principalId` but not multiple.
30
30
 
31
31
  `--roleDefinitionId [roleDefinitionId]`
32
32
  : ID of the role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
@@ -26,7 +26,7 @@ m365 spo folder roleassignment remove [options]
26
26
  : The upn/email of the user. Specify either `upn`, `groupName` or `principalId` but not multiple.
27
27
 
28
28
  `--groupName [groupName]`
29
- : The Azure AD or SharePoint group name. Specify either `upn`, `groupName` or `principalId` but not multiple.
29
+ : The Microsoft Entra or SharePoint group name. Specify either `upn`, `groupName` or `principalId` but not multiple.
30
30
 
31
31
  `-f, --force`
32
32
  : Don't prompt for confirmation when removing the role assignment.
@@ -0,0 +1,88 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # spo folder set
4
+
5
+ Updates a folder
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 spo folder set [options]
11
+ ```
12
+
13
+ ## Alias
14
+
15
+ ```sh
16
+ m365 spo folder rename [options]
17
+ ```
18
+
19
+ ## Options
20
+
21
+ ```md definition-list
22
+ `-u, --webUrl <webUrl>`
23
+ : The URL of the site where the folder is located.
24
+
25
+ `--url <url>`
26
+ : The server- or site-relative decoded URL of the folder.
27
+
28
+ `-n, --name [name]`
29
+ : New name for the folder.
30
+
31
+ `--color [color]`
32
+ : Visual color of the folder. Valid values are a color name or a number. Check remarks for more info.
33
+ ```
34
+
35
+ <Global />
36
+
37
+ ## Remarks
38
+
39
+ When you specify a value for `color`, consider the following:
40
+
41
+ | Color | Number value | String value |
42
+ |--------------|--------------|--------------|
43
+ | Yellow | 0 | yellow |
44
+ | Dark red | 1 | darkRed |
45
+ | Dark orange | 2 | darkOrange |
46
+ | Dark green | 3 | darkGreen |
47
+ | Dark teal | 4 | darkTeal |
48
+ | Dark blue | 5 | darkBlue |
49
+ | Dark purple | 6 | darkPurple |
50
+ | Dark pink | 7 | darkPink |
51
+ | Grey | 8 | grey |
52
+ | Light red | 9 | lightRed |
53
+ | Light orange | 10 | lightOrange |
54
+ | Light green | 11 | lightGreen |
55
+ | Light teal | 12 | lightTeal |
56
+ | Light blue | 13 | lightBlue |
57
+ | Light purple | 14 | lightPurple |
58
+ | Light pink | 15 | lightPink |
59
+
60
+ ## Examples
61
+
62
+ Set the folder name to 'My Folder 2'
63
+
64
+ ```sh
65
+ m365 spo folder set --webUrl https://contoso.sharepoint.com/sites/project-x --url '/Shared Documents/My Folder 1' --name 'My Folder 2'
66
+ ```
67
+
68
+ Set the folder name to 'My folder 2'
69
+
70
+ ```sh
71
+ m365 spo folder set --webUrl https://contoso.sharepoint.com/sites/project-x --url '/sites/project-x/Shared Documents/My Folder 1' --name 'My Folder 2'
72
+ ```
73
+
74
+ Set the folder color to dark blue
75
+
76
+ ```sh
77
+ m365 spo folder set --webUrl https://contoso.sharepoint.com --url '/ProjectFiles/Project-x' --color 5
78
+ ```
79
+
80
+ Set the folder color to light teal
81
+
82
+ ```sh
83
+ m365 spo folder set --webUrl https://contoso.sharepoint.com --url '/ProjectFiles/Project-x' --color lightTeal
84
+ ```
85
+
86
+ ## Response
87
+
88
+ The command won't return a response on success.
@@ -37,13 +37,13 @@ m365 spo group member add [options]
37
37
  : The object Id of the Entra 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`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
38
38
 
39
39
  `--aadGroupIds [aadGroupIds]`
40
- : (deprecated. Use `entraGroupIds` instead) 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`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
40
+ : (deprecated. Use `entraGroupIds` instead) The object ID of the Microsoft Entra 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`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
41
41
 
42
42
  `--entraGroupNames [entraGroupNames]`
43
43
  : The name of the Entra 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`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
44
44
 
45
45
  `--aadGroupNames [aadGroupNames]`
46
- : (deprecated. Use `entraGroupNames` instead) 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`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
46
+ : (deprecated. Use `entraGroupNames` instead) The name of the Microsoft Entra 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`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
47
47
  ```
48
48
 
49
49
  <Global />