@pnp/cli-microsoft365 7.5.0-beta.d4d820f → 7.6.0-beta.443bfd8

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 (191) hide show
  1. package/.devcontainer/Dockerfile +2 -2
  2. package/.eslintrc.cjs +9 -2
  3. package/.mocharc.json +3 -5
  4. package/Dockerfile +2 -5
  5. package/README.md +2 -2
  6. package/allCommands.json +1 -1
  7. package/allCommandsFull.json +1 -1
  8. package/dist/Auth.js +181 -77
  9. package/dist/AuthServer.js +3 -3
  10. package/dist/Command.js +8 -5
  11. package/dist/auth/FileTokenStorage.js +4 -1
  12. package/dist/cli/cli.js +1 -1
  13. package/dist/m365/base/AppCommand.js +2 -2
  14. package/dist/m365/base/PowerAppsCommand.js +2 -2
  15. package/dist/m365/base/PowerAutomateCommand.js +2 -2
  16. package/dist/m365/base/PowerPlatformCommand.js +2 -2
  17. package/dist/m365/base/SpoCommand.js +3 -3
  18. package/dist/m365/base/{YammerCommand.js → VivaEngageCommand.js} +2 -2
  19. package/dist/m365/cli/commands/cli-consent.js +5 -3
  20. package/dist/m365/cli/commands/cli-doctor.js +5 -5
  21. package/dist/m365/commands/ConnectionDetails.js +2 -0
  22. package/dist/m365/commands/login.js +26 -48
  23. package/dist/m365/commands/logout.js +2 -2
  24. package/dist/m365/commands/request.js +2 -2
  25. package/dist/m365/commands/status.js +15 -23
  26. package/dist/m365/connection/commands/connection-list.js +47 -0
  27. package/dist/m365/connection/commands/connection-remove.js +67 -0
  28. package/dist/m365/connection/commands/connection-set.js +56 -0
  29. package/dist/m365/connection/commands/connection-use.js +51 -0
  30. package/dist/m365/connection/commands.js +8 -0
  31. package/dist/m365/entra/aadCommands.js +3 -0
  32. package/dist/m365/entra/commands/administrativeunit/administrativeunit-member-remove.js +153 -0
  33. package/dist/m365/entra/commands/app/app-add.js +2 -2
  34. package/dist/m365/entra/commands/app/app-get.js +1 -1
  35. package/dist/m365/entra/commands/app/app-list.js +1 -1
  36. package/dist/m365/entra/commands/app/app-permission-add.js +1 -1
  37. package/dist/m365/entra/commands/app/app-permission-list.js +182 -0
  38. package/dist/m365/entra/commands/app/app-remove.js +1 -1
  39. package/dist/m365/entra/commands/app/app-role-add.js +1 -1
  40. package/dist/m365/entra/commands/app/app-role-list.js +1 -1
  41. package/dist/m365/entra/commands/app/app-role-remove.js +1 -1
  42. package/dist/m365/entra/commands/app/app-set.js +1 -1
  43. package/dist/m365/entra/commands/{sp/sp-add.js → enterpriseapp/enterpriseapp-add.js} +18 -18
  44. package/dist/m365/entra/commands/{sp/sp-get.js → enterpriseapp/enterpriseapp-get.js} +19 -19
  45. package/dist/m365/entra/commands/{sp/sp-list.js → enterpriseapp/enterpriseapp-list.js} +13 -13
  46. package/dist/m365/entra/commands/group/group-add.js +224 -0
  47. package/dist/m365/entra/commands/group/group-user-add.js +145 -0
  48. package/dist/m365/entra/commands/m365group/m365group-report-activitygroupcounts.js +1 -1
  49. package/dist/m365/entra/commands/user/user-get.js +38 -38
  50. package/dist/m365/entra/commands/user/user-license-list.js +1 -1
  51. package/dist/m365/entra/commands/user/user-registrationdetails-list.js +224 -0
  52. package/dist/m365/entra/commands/user/user-set.js +2 -2
  53. package/dist/m365/entra/commands.js +17 -0
  54. package/dist/m365/external/commands/connection/connection-doctor.js +2 -1
  55. package/dist/m365/file/commands/convert/convert-pdf.js +1 -1
  56. package/dist/m365/file/commands/file-copy.js +151 -0
  57. package/dist/m365/file/commands.js +1 -0
  58. package/dist/m365/outlook/commands/mail/mail-send.js +1 -1
  59. package/dist/m365/outlook/commands/message/message-get.js +1 -1
  60. package/dist/m365/pa/commands/app/app-permission-ensure.js +1 -1
  61. package/dist/m365/pa/commands/app/app-permission-remove.js +1 -1
  62. package/dist/m365/planner/commands/roster/roster-plan-list.js +1 -1
  63. package/dist/m365/purview/commands/auditlog/auditlog-list.js +1 -1
  64. package/dist/m365/purview/commands/sensitivitylabel/sensitivitylabel-get.js +1 -1
  65. package/dist/m365/purview/commands/sensitivitylabel/sensitivitylabel-list.js +1 -1
  66. package/dist/m365/purview/commands/sensitivitylabel/sensitivitylabel-policysettings-list.js +1 -1
  67. package/dist/m365/purview/commands/threatassessment/threatassessment-add.js +123 -0
  68. package/dist/m365/purview/commands/threatassessment/threatassessment-list.js +104 -0
  69. package/dist/m365/purview/commands.js +3 -1
  70. package/dist/m365/spfx/commands/project/DeployWorkflow.js +115 -3
  71. package/dist/m365/spfx/commands/project/project-azuredevops-pipeline-add.js +183 -0
  72. package/dist/m365/spfx/commands/project/project-azuredevops-pipeline-model.js +2 -0
  73. package/dist/m365/spfx/commands/project/project-github-workflow-add.js +3 -4
  74. package/dist/m365/spfx/commands.js +1 -0
  75. package/dist/m365/spo/commands/spo-get.js +1 -1
  76. package/dist/m365/spo/commands/spo-search.js +52 -22
  77. package/dist/m365/spo/commands/spo-set.js +1 -1
  78. package/dist/m365/spo/commands/user/user-remove.js +93 -16
  79. package/dist/m365/teams/commands/chat/chat-get.js +1 -1
  80. package/dist/m365/teams/commands/chat/chat-list.js +1 -1
  81. package/dist/m365/teams/commands/chat/chat-message-send.js +1 -1
  82. package/dist/m365/teams/commands/meeting/meeting-add.js +1 -1
  83. package/dist/m365/teams/commands/meeting/meeting-attendancereport-list.js +1 -1
  84. package/dist/m365/teams/commands/meeting/meeting-get.js +1 -1
  85. package/dist/m365/teams/commands/meeting/meeting-list.js +2 -2
  86. package/dist/m365/teams/commands/meeting/meeting-transcript-list.js +1 -1
  87. package/dist/m365/tenant/commands/id/id-get.js +1 -1
  88. package/dist/m365/tenant/commands/info/info-get.js +1 -1
  89. package/dist/m365/util/commands/accesstoken/accesstoken-get.js +3 -3
  90. package/dist/m365/{yammer/commands/group/group-list.js → viva/commands/engage/engage-group-list.js} +19 -14
  91. package/dist/m365/{yammer/commands/group/group-user-add.js → viva/commands/engage/engage-group-user-add.js} +19 -14
  92. package/dist/m365/{yammer/commands/group/group-user-remove.js → viva/commands/engage/engage-group-user-remove.js} +19 -14
  93. package/dist/m365/{yammer/commands/message/message-add.js → viva/commands/engage/engage-message-add.js} +19 -14
  94. package/dist/m365/{yammer/commands/message/message-get.js → viva/commands/engage/engage-message-get.js} +17 -12
  95. package/dist/m365/{yammer/commands/message/message-like-set.js → viva/commands/engage/engage-message-like-set.js} +21 -16
  96. package/dist/m365/{yammer/commands/message/message-list.js → viva/commands/engage/engage-message-list.js} +21 -16
  97. package/dist/m365/{yammer/commands/message/message-remove.js → viva/commands/engage/engage-message-remove.js} +20 -15
  98. package/dist/m365/{yammer/commands/network/network-list.js → viva/commands/engage/engage-network-list.js} +16 -11
  99. package/dist/m365/viva/commands/engage/engage-report-activitycounts.js +23 -0
  100. package/dist/m365/viva/commands/engage/engage-report-activityusercounts.js +23 -0
  101. package/dist/m365/viva/commands/engage/engage-report-activityuserdetail.js +23 -0
  102. package/dist/m365/viva/commands/engage/engage-report-deviceusagedistributionusercounts.js +23 -0
  103. package/dist/m365/viva/commands/engage/engage-report-deviceusageusercounts.js +23 -0
  104. package/dist/m365/viva/commands/engage/engage-report-deviceusageuserdetail.js +23 -0
  105. package/dist/m365/viva/commands/engage/engage-report-groupsactivitycounts.js +23 -0
  106. package/dist/m365/viva/commands/engage/engage-report-groupsactivitydetail.js +23 -0
  107. package/dist/m365/viva/commands/engage/engage-report-groupsactivitygroupcounts.js +23 -0
  108. package/dist/m365/{yammer/commands/yammer-search.js → viva/commands/engage/engage-search.js} +23 -18
  109. package/dist/m365/{yammer/commands/user/user-get.js → viva/commands/engage/engage-user-get.js} +18 -13
  110. package/dist/m365/{yammer/commands/user/user-list.js → viva/commands/engage/engage-user-list.js} +18 -13
  111. package/dist/m365/{yammer/commands.js → viva/commands/engage/yammerCommands.js} +1 -1
  112. package/dist/m365/viva/commands.js +22 -1
  113. package/dist/request.js +1 -1
  114. package/dist/utils/entraUser.js +36 -0
  115. package/dist/utils/spo.js +36 -14
  116. package/dist/utils/urlUtil.js +31 -0
  117. package/dist/utils/validation.js +8 -0
  118. package/docs/docs/cmd/cli/cli-consent.mdx +9 -9
  119. package/docs/docs/cmd/connection/connection-list.mdx +100 -0
  120. package/docs/docs/cmd/connection/connection-remove.mdx +45 -0
  121. package/docs/docs/cmd/connection/connection-set.mdx +39 -0
  122. package/docs/docs/cmd/connection/connection-use.mdx +98 -0
  123. package/docs/docs/cmd/entra/administrativeunit/administrativeunit-member-add.mdx +5 -3
  124. package/docs/docs/cmd/entra/administrativeunit/administrativeunit-member-remove.mdx +107 -0
  125. package/docs/docs/cmd/entra/app/app-add.mdx +2 -1
  126. package/docs/docs/cmd/entra/app/app-get.mdx +1 -0
  127. package/docs/docs/cmd/entra/app/app-list.mdx +1 -0
  128. package/docs/docs/cmd/entra/app/app-permission-add.mdx +1 -0
  129. package/docs/docs/cmd/entra/app/app-permission-list.mdx +105 -0
  130. package/docs/docs/cmd/entra/app/app-remove.mdx +1 -0
  131. package/docs/docs/cmd/entra/app/app-role-add.mdx +1 -0
  132. package/docs/docs/cmd/entra/app/app-role-list.mdx +1 -0
  133. package/docs/docs/cmd/entra/app/app-role-remove.mdx +1 -0
  134. package/docs/docs/cmd/entra/app/app-set.mdx +1 -0
  135. package/docs/docs/cmd/entra/{sp/sp-add.mdx → enterpriseapp/enterpriseapp-add.mdx} +16 -15
  136. package/docs/docs/cmd/entra/{sp/sp-get.mdx → enterpriseapp/enterpriseapp-get.mdx} +15 -14
  137. package/docs/docs/cmd/entra/{sp/sp-list.mdx → enterpriseapp/enterpriseapp-list.mdx} +22 -21
  138. package/docs/docs/cmd/entra/group/group-add.mdx +231 -0
  139. package/docs/docs/cmd/entra/group/group-user-add.mdx +62 -0
  140. package/docs/docs/cmd/entra/m365group/m365group-report-activitygroupcounts.mdx +1 -1
  141. package/docs/docs/cmd/entra/oauth2grant/oauth2grant-add.mdx +3 -3
  142. package/docs/docs/cmd/entra/oauth2grant/oauth2grant-list.mdx +1 -1
  143. package/docs/docs/cmd/entra/user/user-registrationdetails-list.mdx +246 -0
  144. package/docs/docs/cmd/external/item/item-add.mdx +1 -1
  145. package/docs/docs/cmd/file/convert/convert-pdf.mdx +4 -0
  146. package/docs/docs/cmd/file/file-add.mdx +4 -0
  147. package/docs/docs/cmd/file/file-copy.mdx +68 -0
  148. package/docs/docs/cmd/file/file-list.mdx +100 -0
  149. package/docs/docs/cmd/login.mdx +15 -0
  150. package/docs/docs/cmd/purview/threatassessment/threatassessment-add.mdx +131 -0
  151. package/docs/docs/cmd/purview/threatassessment/threatassessment-list.mdx +110 -0
  152. package/docs/docs/cmd/setup.mdx +4 -0
  153. package/docs/docs/cmd/spfx/project/project-azuredevops-pipeline-add.mdx +87 -0
  154. package/docs/docs/cmd/spo/list/list-webhook-set.mdx +1 -1
  155. package/docs/docs/cmd/spo/spo-search.mdx +6 -2
  156. package/docs/docs/cmd/spo/theme/theme-set.mdx +14 -2
  157. package/docs/docs/cmd/spo/user/user-remove.mdx +40 -9
  158. package/docs/docs/cmd/{yammer/group/group-list.mdx → viva/engage/engage-group-list.mdx} +13 -13
  159. package/docs/docs/cmd/{yammer/group/group-user-add.mdx → viva/engage/engage-group-user-add.mdx} +7 -7
  160. package/docs/docs/cmd/{yammer/group/group-user-remove.mdx → viva/engage/engage-group-user-remove.mdx} +10 -10
  161. package/docs/docs/cmd/{yammer/message/message-add.mdx → viva/engage/engage-message-add.mdx} +12 -13
  162. package/docs/docs/cmd/{yammer/message/message-get.mdx → viva/engage/engage-message-get.mdx} +10 -10
  163. package/docs/docs/cmd/{yammer/message/message-like-set.mdx → viva/engage/engage-message-like-set.mdx} +10 -10
  164. package/docs/docs/cmd/{yammer/message/message-list.mdx → viva/engage/engage-message-list.mdx} +21 -21
  165. package/docs/docs/cmd/{yammer/message/message-remove.mdx → viva/engage/engage-message-remove.mdx} +10 -10
  166. package/docs/docs/cmd/{yammer/network/network-list.mdx → viva/engage/engage-network-list.mdx} +6 -6
  167. package/docs/docs/cmd/{yammer/report/report-activitycounts.mdx → viva/engage/engage-report-activitycounts.mdx} +9 -9
  168. package/docs/docs/cmd/{yammer/report/report-activityusercounts.mdx → viva/engage/engage-report-activityusercounts.mdx} +9 -9
  169. package/docs/docs/cmd/{yammer/report/report-activityuserdetail.mdx → viva/engage/engage-report-activityuserdetail.mdx} +11 -12
  170. package/docs/docs/cmd/{yammer/report/report-deviceusagedistributionusercounts.mdx → viva/engage/engage-report-deviceusagedistributionusercounts.mdx} +5 -5
  171. package/docs/docs/cmd/{yammer/report/report-deviceusageusercounts.mdx → viva/engage/engage-report-deviceusageusercounts.mdx} +5 -5
  172. package/docs/docs/cmd/{yammer/report/report-deviceusageuserdetail.mdx → viva/engage/engage-report-deviceusageuserdetail.mdx} +11 -11
  173. package/docs/docs/cmd/{yammer/report/report-groupsactivitycounts.mdx → viva/engage/engage-report-groupsactivitycounts.mdx} +9 -9
  174. package/docs/docs/cmd/{yammer/report/report-groupsactivitydetail.mdx → viva/engage/engage-report-groupsactivitydetail.mdx} +11 -11
  175. package/docs/docs/cmd/{yammer/report/report-groupsactivitygroupcounts.mdx → viva/engage/engage-report-groupsactivitygroupcounts.mdx} +5 -5
  176. package/docs/docs/cmd/{yammer/yammer-search.mdx → viva/engage/engage-search.mdx} +10 -10
  177. package/docs/docs/cmd/{yammer/user/user-get.mdx → viva/engage/engage-user-get.mdx} +8 -8
  178. package/docs/docs/cmd/{yammer/user/user-list.mdx → viva/engage/engage-user-list.mdx} +11 -11
  179. package/npm-shrinkwrap.json +230 -168
  180. package/package.json +20 -19
  181. package/dist/m365/base/AzmgmtCommand.js +0 -18
  182. package/dist/m365/base/AzmgmtItemsListCommand.js +0 -41
  183. package/dist/m365/yammer/commands/report/report-activitycounts.js +0 -15
  184. package/dist/m365/yammer/commands/report/report-activityusercounts.js +0 -15
  185. package/dist/m365/yammer/commands/report/report-activityuserdetail.js +0 -15
  186. package/dist/m365/yammer/commands/report/report-deviceusagedistributionusercounts.js +0 -15
  187. package/dist/m365/yammer/commands/report/report-deviceusageusercounts.js +0 -15
  188. package/dist/m365/yammer/commands/report/report-deviceusageuserdetail.js +0 -15
  189. package/dist/m365/yammer/commands/report/report-groupsactivitycounts.js +0 -15
  190. package/dist/m365/yammer/commands/report/report-groupsactivitydetail.js +0 -15
  191. package/dist/m365/yammer/commands/report/report-groupsactivitygroupcounts.js +0 -15
@@ -0,0 +1,246 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # entra user registrationdetails list
6
+
7
+ Retrieves a list of the authentication methods registered for users
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 entra user registrationdetails list [options]
13
+ ```
14
+
15
+ ## Alias
16
+
17
+ ```sh
18
+ m365 aad user registrationdetails list [options]
19
+ ```
20
+
21
+ ## Options
22
+
23
+ ```md definition-list
24
+ `--isAdmin [isAdmin]`
25
+ : Filter for users who are admins. Allowed values are `true` or `false`. If not specified, returns all users.
26
+
27
+ `--userType [userType]`
28
+ : Filter for members or guest users. Allowed values are `member` or `guest`. If not specified, returns all users.
29
+
30
+ `--userPreferredMethodForSecondaryAuthentication [userPreferredMethodForSecondaryAuthentication]`
31
+ : Filter users by selected method as default second-factor authentication. Allowed values are `push`, `oath`, `voiceMobile`, `voiceAlternateMobile`, `voiceOffice`, `sms` or `none`. Specify either one method or more methods separated by a comma.
32
+
33
+ `--systemPreferredAuthenticationMethods [systemPreferredAuthenticationMethods]`
34
+ : Filter users by most secure authentication methods registered for second-factor authentication. Allowed values are `push`, `oath`, `voiceMobile`, `voiceAlternateMobile`, `voiceOffice`, `sms` or `none`. Specify either one method or more methods separated by a comma.
35
+
36
+ `--isSelfServicePasswordResetRegistered [isSelfServicePasswordResetRegistered]`
37
+ : Filter for users who have registered for self-service password reset. Allowed values are `true` or `false`. If not specified, returns all users.
38
+
39
+ `--isSelfServicePasswordResetEnabled [isSelfServicePasswordResetEnabled]`
40
+ : Filter for users who have been enabled for self-service password reset. Allowed values are `true` or `false`. If not specified, returns all users.
41
+
42
+ `--isSelfServicePasswordResetCapable [isSelfServicePasswordResetCapable]`
43
+ : Filter for users who are ready to perform self-service password reset. Allowed values are `true` or `false`. If not specified, returns all users.
44
+
45
+ `--isMfaRegistered [isMfaRegistered]`
46
+ : Filter for users who are registered for multi-factor authentication. Allowed values are `true` or `false`. If not specified, returns all users.
47
+
48
+ `--isMfaCapable [isMfaCapable]`
49
+ : Filter for users who are ready to perform password reset or multi-factor authentication. Allowed values are `true` or `false`. If not specified, returns all users.
50
+
51
+ `--isPasswordlessCapable [isPasswordlessCapable]`
52
+ : Filter for user who have registered a password less strong authentication method. Allowed values are `true` or `false`. If not specified, returns all users.
53
+
54
+ `--isSystemPreferredAuthenticationMethodEnabled [isSystemPreferredAuthenticationMethodEnabled]`
55
+ : Filter for users who have enabled system preferred authentication method. Allowed values are `true` or `false`. If not specified, returns all users.
56
+
57
+ `--methodsRegistered [methodsRegistered]`
58
+ : Filter users by registered methods used during registration. Allowed values are `mobilePhone`, `email`, `fido2`, `microsoftAuthenticatorPush` or `softwareOneTimePasscode`. Specify either one method or more methods separated by a comma.
59
+
60
+ `--userIds [userIds]`
61
+ : Filter users by ids. Specify at most 20 ids separated by a comma.
62
+
63
+ `--userPrincipalNames [userPrincipalNames]`
64
+ : Filter users by user principal names. Specify at most 20 UPN separated by a comma.
65
+
66
+ `-p, --properties [properties]`
67
+ : Comma-separated list of properties to retrieve.
68
+ ```
69
+
70
+ <Global />
71
+
72
+ ## Remarks
73
+
74
+ Using the `--properties` option, you can specify a comma-separated list of registration details properties to retrieve from the Microsoft Graph. If you don't specify any properties, the command will retrieve user's account name, registered methods and timestamp of last update.
75
+
76
+ :::info
77
+
78
+ When multiple values are specified for `--userPreferredMethodForSecondaryAuthentication` option, the command returns registration details with at least one specified selected method as default second-factor authentication.
79
+
80
+ When multiple values are specified for `--systemPreferredAuthenticationMethods` option, the command returns registration details with at least one specified most secure authentication methods registered for second-factor authentication.
81
+
82
+ When multiple values are specified for `--registeredMethods` option, the command returns registration details with at least one specified registered methods used during registration.
83
+
84
+ :::
85
+
86
+ ## Examples
87
+
88
+ Retrieve registration details for all users
89
+
90
+ ```sh
91
+ m365 entra user registrationdetails list
92
+ ```
93
+
94
+ Retrieve user registration details and returns only specific properties
95
+
96
+ ```sh
97
+ m365 entra user registrationdetails list --properties 'id,isAdmin'
98
+ ```
99
+
100
+ Retrieve registration details for admins
101
+
102
+ ```sh
103
+ m365 entra user registrationdetails list --isAdmin true
104
+ ```
105
+
106
+ Retrieve registration details for guest users
107
+
108
+ ```sh
109
+ m365 entra user registrationdetails list --userType guest
110
+ ```
111
+
112
+ Retrieve registration details for users who selected either sms or push authentication method as the default second-factor for performing multifactor authentication
113
+
114
+ ```sh
115
+ m365 entra user registrationdetails list --userPreferredMethodForSecondaryAuthentication 'sms,push'
116
+ ```
117
+
118
+ Retrieve registration details for users with push authentication method as the most secure authentication method among the registered methods for second factor authentication determined by the system
119
+
120
+ ```sh
121
+ m365 entra user registrationdetails list --systemPreferredAuthenticationMethods push
122
+ ```
123
+
124
+ Retrieve registration details for users who have used either Microsoft Authenticator app or mobile phone during registration
125
+
126
+ ```sh
127
+ m365 entra user registrationdetails list --methodsRegistered 'microsoftAuthenticatorPush,mobilePhone'
128
+ ```
129
+
130
+ ## Response
131
+
132
+ <Tabs>
133
+ <TabItem value="JSON">
134
+
135
+ ```json
136
+ [
137
+ {
138
+ "id": "61b0c52f-a902-4769-9a09-c6628335b00a",
139
+ "userPrincipalName": "AdeleV@contoso.onmicrosoft.com",
140
+ "userDisplayName": "Adele Vance",
141
+ "userType": "member",
142
+ "isAdmin": false,
143
+ "isSsprRegistered": false,
144
+ "isSsprEnabled": false,
145
+ "isSsprCapable": false,
146
+ "isMfaRegistered": false,
147
+ "isMfaCapable": false,
148
+ "isPasswordlessCapable": false,
149
+ "methodsRegistered": [],
150
+ "isSystemPreferredAuthenticationMethodEnabled": false,
151
+ "systemPreferredAuthenticationMethods": [],
152
+ "userPreferredMethodForSecondaryAuthentication": "none",
153
+ "lastUpdatedDateTime": "2024-01-23T19:37:43.7170699Z"
154
+ },
155
+ {
156
+ "id": "ebd27dbd-75f2-4ef8-bd51-102c3faf62ec",
157
+ "userPrincipalName": "john.doe@contoso.onmicrosoft.com",
158
+ "userDisplayName": "John Doe",
159
+ "userType": "member",
160
+ "isAdmin": false,
161
+ "isSsprRegistered": false,
162
+ "isSsprEnabled": false,
163
+ "isSsprCapable": false,
164
+ "isMfaRegistered": true,
165
+ "isMfaCapable": true,
166
+ "isPasswordlessCapable": false,
167
+ "methodsRegistered": [
168
+ "microsoftAuthenticatorPush",
169
+ "softwareOneTimePasscode"
170
+ ],
171
+ "isSystemPreferredAuthenticationMethodEnabled": false,
172
+ "systemPreferredAuthenticationMethods": [],
173
+ "userPreferredMethodForSecondaryAuthentication": "push",
174
+ "lastUpdatedDateTime": "2024-01-23T19:37:43.7165489Z"
175
+ }
176
+ ]
177
+ ```
178
+
179
+ </TabItem>
180
+ <TabItem value="Text">
181
+
182
+ ```text
183
+ userPrincipalName methodsRegistered lastUpdatedDateTime
184
+ ----------------------------------------------- -------------------------------------------------------------------- ----------------------------
185
+ AdeleV@contoso.onmicrosoft.com 2024-01-23T19:37:43.7170699Z
186
+ john.doe@contoso.onmicrosoft.com microsoftAuthenticatorPush,softwareOneTimePasscode 2024-01-23T19:37:43.7165489Z
187
+ ```
188
+
189
+ </TabItem>
190
+ <TabItem value="CSV">
191
+
192
+ ```csv
193
+ id,userPrincipalName,userDisplayName,userType,isAdmin,isSsprRegistered,isSsprEnabled,isSsprCapable,isMfaRegistered,isMfaCapable,isPasswordlessCapable,isSystemPreferredAuthenticationMethodEnabled,userPreferredMethodForSecondaryAuthentication,lastUpdatedDateTime
194
+ 61b0c52f-a902-4769-9a09-c6628335b00a,AdeleV@contoso.onmicrosoft.com,Adele Vance,member,,,,,,,,,none,2024-01-23T19:37:43.7170699Z
195
+ ebd27dbd-75f2-4ef8-bd51-102c3faf62ec,john.doe@contoso.onmicrosoft.com,John Doe,member,,,,,1,1,,,push,2024-01-23T19:37:43.7165489Z
196
+ ```
197
+
198
+ </TabItem>
199
+ <TabItem value="Markdown">
200
+
201
+ ```md
202
+ # entra user registrationdetails list
203
+
204
+ Date: 1/27/2024
205
+
206
+ ## 61b0c52f-a902-4769-9a09-c6628335b00a
207
+
208
+ Property | Value
209
+ ---------|-------
210
+ id | 61b0c52f-a902-4769-9a09-c6628335b00a
211
+ userPrincipalName | AdeleV@contoso.onmicrosoft.com
212
+ userDisplayName | Adele Vance
213
+ userType | member
214
+ isAdmin | false
215
+ isSsprRegistered | false
216
+ isSsprEnabled | false
217
+ isSsprCapable | false
218
+ isMfaRegistered | false
219
+ isMfaCapable | false
220
+ isPasswordlessCapable | false
221
+ isSystemPreferredAuthenticationMethodEnabled | false
222
+ userPreferredMethodForSecondaryAuthentication | none
223
+ lastUpdatedDateTime | 2024-01-23T19:37:43.7170699Z
224
+
225
+ ## ebd27dbd-75f2-4ef8-bd51-102c3faf62ec
226
+
227
+ Property | Value
228
+ ---------|-------
229
+ id | ebd27dbd-75f2-4ef8-bd51-102c3faf62ec
230
+ userPrincipalName | john.doe@contoso.onmicrosoft.com
231
+ userDisplayName | John Doe
232
+ userType | member
233
+ isAdmin | false
234
+ isSsprRegistered | false
235
+ isSsprEnabled | false
236
+ isSsprCapable | false
237
+ isMfaRegistered | true
238
+ isMfaCapable | true
239
+ isPasswordlessCapable | false
240
+ isSystemPreferredAuthenticationMethodEnabled | false
241
+ userPreferredMethodForSecondaryAuthentication | push
242
+ lastUpdatedDateTime | 2024-01-23T19:37:43.7165489Z
243
+ ```
244
+
245
+ </TabItem>
246
+ </Tabs>
@@ -18,7 +18,7 @@ m365 external item add [options]
18
18
  `-i, --id <id>`
19
19
  : The ID of the item to create
20
20
 
21
- `--externalConnectionId <name>`
21
+ `--externalConnectionId <externalConnectionId>`
22
22
  : The ID of the external connection on which to create the item
23
23
 
24
24
  `--content <content>`
@@ -55,3 +55,7 @@ Converts file from a document library to PDF and saves the converted file to the
55
55
  ```sh
56
56
  m365 file convert pdf --sourceFile "https://contoso.sharepoint.com/Shared Documents/file.docx" --targetFile "https://contoso.sharepoint.com/Shared Documents/file.pdf"
57
57
  ```
58
+
59
+ ## Response
60
+
61
+ The command won't return a response on success.
@@ -62,3 +62,7 @@ Uploads file from the current folder to a document library in the specified site
62
62
  ```sh
63
63
  m365 file add --filePath file.pdf --folderUrl "https://contoso.sharepoint.com/sites/Contoso/Shared Documents" --siteUrl "https://contoso.sharepoint.com/sites/Contoso"
64
64
  ```
65
+
66
+ ## Response
67
+
68
+ The command won't return a response on success.
@@ -0,0 +1,68 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # file copy
4
+
5
+ Copies a file to another location using the Microsoft Graph
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 file copy [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `-u, --webUrl <webUrl>`
17
+ : The URL of the site where the file is located.
18
+
19
+ `-s, --sourceUrl <sourceUrl>`
20
+ : Server-relative or absolute URL of the file.
21
+
22
+ `-t, --targetUrl <targetUrl>`
23
+ : Server-relative or absolute URL of the location.
24
+
25
+ `--newName [newName]`
26
+ : New name of the destination file.
27
+
28
+ `--nameConflictBehavior [nameConflictBehavior]`
29
+ : Behavior when a document with the same name is already present at the destination. Possible values: `fail`, `replace`, `rename`. Default is `fail`.
30
+ ```
31
+
32
+ <Global />
33
+
34
+ ## Examples
35
+
36
+ Copy a file by server-relative URL to a document library in another site collection with server relative URL
37
+
38
+ ```sh
39
+ m365 file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents"
40
+ ```
41
+
42
+ Copy a file by absolute URL to a document library in another site collection with absolute URL
43
+
44
+ ```sh
45
+ m365 file copy --webUrl https://contoso.sharepoint.com --sourceUrl "https://contoso.sharepoint.com/Shared Documents/Document.pdf" --targetUrl "https://contoso.sharepoint.com/sites/IT/Shared Documents"
46
+ ```
47
+
48
+ Copy a file to a document library in another site collection and rename the file
49
+
50
+ ```sh
51
+ m365 file copy --webUrl https://contoso.sharepoint.com --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --newName "newName"
52
+ ```
53
+
54
+ Copy a file to a document library in another site collection and rename the file if a file with the same name already exists.
55
+
56
+ ```sh
57
+ m365 file copy --webUrl https://contoso.sharepoint.com --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --nameConflictBehavior rename
58
+ ```
59
+
60
+ Copy a file to Onedrive for business
61
+
62
+ ```sh
63
+ m365 file copy --webUrl https://contoso.sharepoint.com --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/documents"
64
+ ```
65
+
66
+ ## Response
67
+
68
+ The command won't return a response on success.
@@ -1,4 +1,6 @@
1
1
  import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
2
4
 
3
5
  # file list
4
6
 
@@ -48,3 +50,101 @@ Return all files from the _Important_ folder in the _Shared Documents_ document
48
50
  ```sh
49
51
  m365 file list --webUrl https://contoso.sharepoint.com/sites/project-x --folderUrl 'Shared Documents/Important'
50
52
  ```
53
+
54
+ <Tabs>
55
+ <TabItem value="JSON">
56
+
57
+ ```json
58
+ [
59
+ {
60
+ "@microsoft.graph.downloadUrl": "https://contoso.sharepoint.com/_layouts/15/download.aspx?UniqueId=9bdc8c49-644a-4875-aaa3-82914fb23226&Translate=false&tempauth=&ApiVersion=2.0",
61
+ "createdDateTime": "2024-02-14T22:41:41Z",
62
+ "eTag": "\"{9BDC8C49-644A-4875-AAA3-82914FB23226},1\"",
63
+ "id": "013TMHP6SJRTOJWSTEOVEKVI4CSFH3EMRG",
64
+ "lastModifiedDateTime": "2024-02-14T22:41:41Z",
65
+ "name": "Document.docx",
66
+ "webUrl": "https://contoso.sharepoint.com/_layouts/15/Doc.aspx?sourcedoc=%7B9BDC8C49-644A-4875-AAA3-82914FB23226%7D&file=Document.Docx&action=default&mobileredirect=true",
67
+ "cTag": "\"c:{9BDC8C49-644A-4875-AAA3-82914FB23226},2\"",
68
+ "size": 41554,
69
+ "createdBy": {
70
+ "user": {
71
+ "email": "john@contoso.com",
72
+ "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
73
+ "displayName": "John Doe"
74
+ }
75
+ },
76
+ "lastModifiedBy": {
77
+ "user": {
78
+ "email": "john@contoso.com",
79
+ "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
80
+ "displayName": "John Doe"
81
+ }
82
+ },
83
+ "parentReference": {
84
+ "driveType": "documentLibrary",
85
+ "driveId": "b!T4-bE44OMEa7ClAUQtubZID9tc40pGJKpguycvELod_YogR_WYHeSaTWzIZ6qMyU",
86
+ "id": "013TMHP6V6Y2GOVW7725BZO354PWSELRRZ",
87
+ "name": "TEST",
88
+ "path": "/drives/b!T4-bE44OMEa7ClAUQtubZID9tc40pGJKpguycvELod_YogR_WYHeSaTWzIZ6qMyU/root:",
89
+ "siteId": "0f9b8f4f-0e8e-4630-bb0a-501442db9b64"
90
+ },
91
+ "file": {
92
+ "mimeType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
93
+ "hashes": {
94
+ "quickXorHash": "MX9jeQT/AfhDDMpYygXlCPYI/kc="
95
+ }
96
+ },
97
+ "fileSystemInfo": {
98
+ "createdDateTime": "2024-02-14T22:41:41Z",
99
+ "lastModifiedDateTime": "2024-02-14T22:41:41Z"
100
+ },
101
+ "shared": {
102
+ "scope": "users"
103
+ },
104
+ "lastModifiedByUser": "John Doe"
105
+ }
106
+ ]
107
+ ```
108
+
109
+ </TabItem>
110
+ <TabItem value="Text">
111
+
112
+ ```text
113
+ lastModifiedByUser: John Doe
114
+ name : Document.docx
115
+ ```
116
+
117
+ </TabItem>
118
+ <TabItem value="CSV">
119
+
120
+ ```csv
121
+ @microsoft.graph.downloadUrl,createdDateTime,eTag,id,lastModifiedDateTime,name,webUrl,cTag,size,lastModifiedByUser
122
+ https://contoso.sharepoint.com/_layouts/15/download.aspx?UniqueId=9bdc8c49-644a-4875-aaa3-82914fb23226&Translate=false&tempauth=&ApiVersion=2.0,2024-02-14T22:41:41Z,"""{9BDC8C49-644A-4875-AAA3-82914FB23226},1""",013TMHP6SJRTOJWSTEOVEKVI4CSFH3EMRG,2024-02-14T22:41:41Z,Thailand.xlsx,https://contoso.sharepoint.com/_layouts/15/Doc.aspx?sourcedoc=%7B9BDC8C49-644A-4875-AAA3-82914FB23226%7D&file=Document.docx&action=default&mobileredirect=true,"""c:{9BDC8C49-644A-4875-AAA3-82914FB23226},2""",41554,John Doe
123
+ ```
124
+
125
+ </TabItem>
126
+ <TabItem value="Markdown">
127
+
128
+ ```md
129
+ # file list --webUrl "https://contoso.sharepoint.com" --folderUrl "Test"
130
+
131
+ Date: 14/02/2024
132
+
133
+ ## Document.docx (013TMHP6SJRTOJWSTEOVEKVI4CSFH3EMRG)
134
+
135
+ Property | Value
136
+ ---------|-------
137
+ @microsoft.graph.downloadUrl | https://contoso.sharepoint.com/\_layouts/15/download.aspx?UniqueId=9bdc8c49-644a-4875-aaa3-82914fb23226&Translate=false&tempauth=&ApiVersion=2.0
138
+ createdDateTime | 2024-02-14T22:41:41Z
139
+ eTag | "{9BDC8C49-644A-4875-AAA3-82914FB23226},1"
140
+ id | 013TMHP6SJRTOJWSTEOVEKVI4CSFH3EMRG
141
+ lastModifiedDateTime | 2024-02-14T22:41:41Z
142
+ name | Document.docx
143
+ webUrl | https://contoso.sharepoint.com/\_layouts/15/Doc.aspx?sourcedoc=%7B9BDC8C49-644A-4875-AAA3-82914FB23226%7D&file=Thailand.xlsx&action=default&mobileredirect=true
144
+ cTag | "c:{9BDC8C49-644A-4875-AAA3-82914FB23226},2"
145
+ size | 41554
146
+ lastModifiedByUser | John Doe
147
+ ```
148
+
149
+ </TabItem>
150
+ </Tabs>
@@ -44,6 +44,9 @@ m365 login [options]
44
44
 
45
45
  `--cloud [cloud]`
46
46
  : Cloud to connect to. Allowed values `Public`, `USGov`, `USGovHigh`, `USGovDoD` and `China`. Default `Public`
47
+
48
+ `--connectionName [connectionName]`
49
+ : Specify an optional name to make switching between connections easier.
47
50
  ```
48
51
 
49
52
  <Global />
@@ -64,6 +67,12 @@ Managed identity in Azure Cloud Shell is the identity of the user. It is neither
64
67
 
65
68
  When connecting to clouds other than `Public`, you'll need to use an Azure AD application registered in a directory provisioned in that cloud. If you try to login using the default Azure AD application, login will fail.
66
69
 
70
+ :::tip
71
+
72
+ When signing in with multiple identities, every signin will be saved as a connection. You can list available connections using [m365 connection list](./connection/connection-list.mdx) and switch between connections using [m365 connection use](./connection/connection-use.mdx)
73
+
74
+ :::
75
+
67
76
  ## Examples
68
77
 
69
78
  Log in to Microsoft 365 using the device code
@@ -72,6 +81,12 @@ Log in to Microsoft 365 using the device code
72
81
  m365 login
73
82
  ```
74
83
 
84
+ Log in to Microsoft 365 using the device code and set the connection name
85
+
86
+ ```sh
87
+ m365 login --connectionName 'myworkaccount'
88
+ ```
89
+
75
90
  Log in to Microsoft 365 using the device code in debug mode including detailed debug information in the console output
76
91
 
77
92
  ```sh
@@ -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>