@pnp/cli-microsoft365 7.5.0-beta.d4d820f → 7.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (178) hide show
  1. package/.devcontainer/Dockerfile +2 -2
  2. package/.eslintrc.cjs +6 -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 +171 -69
  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/m365/base/AppCommand.js +2 -2
  13. package/dist/m365/base/PowerAppsCommand.js +2 -2
  14. package/dist/m365/base/PowerAutomateCommand.js +2 -2
  15. package/dist/m365/base/PowerPlatformCommand.js +2 -2
  16. package/dist/m365/base/SpoCommand.js +3 -3
  17. package/dist/m365/base/{YammerCommand.js → VivaEngageCommand.js} +2 -2
  18. package/dist/m365/cli/commands/cli-consent.js +5 -3
  19. package/dist/m365/cli/commands/cli-doctor.js +5 -5
  20. package/dist/m365/commands/ConnectionDetails.js +2 -0
  21. package/dist/m365/commands/login.js +26 -48
  22. package/dist/m365/commands/logout.js +2 -2
  23. package/dist/m365/commands/request.js +2 -2
  24. package/dist/m365/commands/status.js +15 -23
  25. package/dist/m365/connection/commands/connection-list.js +47 -0
  26. package/dist/m365/connection/commands/connection-remove.js +67 -0
  27. package/dist/m365/connection/commands/connection-set.js +56 -0
  28. package/dist/m365/connection/commands/connection-use.js +51 -0
  29. package/dist/m365/connection/commands.js +8 -0
  30. package/dist/m365/entra/aadCommands.js +3 -0
  31. package/dist/m365/entra/commands/administrativeunit/administrativeunit-member-remove.js +153 -0
  32. package/dist/m365/entra/commands/app/app-add.js +2 -2
  33. package/dist/m365/entra/commands/app/app-get.js +1 -1
  34. package/dist/m365/entra/commands/app/app-list.js +1 -1
  35. package/dist/m365/entra/commands/app/app-permission-add.js +1 -1
  36. package/dist/m365/entra/commands/app/app-permission-list.js +182 -0
  37. package/dist/m365/entra/commands/app/app-remove.js +1 -1
  38. package/dist/m365/entra/commands/app/app-role-add.js +1 -1
  39. package/dist/m365/entra/commands/app/app-role-list.js +1 -1
  40. package/dist/m365/entra/commands/app/app-role-remove.js +1 -1
  41. package/dist/m365/entra/commands/app/app-set.js +1 -1
  42. package/dist/m365/entra/commands/{sp/sp-add.js → enterpriseapp/enterpriseapp-add.js} +18 -18
  43. package/dist/m365/entra/commands/{sp/sp-get.js → enterpriseapp/enterpriseapp-get.js} +19 -19
  44. package/dist/m365/entra/commands/{sp/sp-list.js → enterpriseapp/enterpriseapp-list.js} +13 -13
  45. package/dist/m365/entra/commands/group/group-add.js +224 -0
  46. package/dist/m365/entra/commands/group/group-user-add.js +145 -0
  47. package/dist/m365/entra/commands/m365group/m365group-report-activitygroupcounts.js +1 -1
  48. package/dist/m365/entra/commands/user/user-get.js +38 -38
  49. package/dist/m365/entra/commands/user/user-license-list.js +1 -1
  50. package/dist/m365/entra/commands/user/user-registrationdetails-list.js +224 -0
  51. package/dist/m365/entra/commands/user/user-set.js +2 -2
  52. package/dist/m365/entra/commands.js +17 -0
  53. package/dist/m365/external/commands/connection/connection-doctor.js +2 -1
  54. package/dist/m365/file/commands/convert/convert-pdf.js +1 -1
  55. package/dist/m365/file/commands/file-copy.js +151 -0
  56. package/dist/m365/file/commands.js +1 -0
  57. package/dist/m365/outlook/commands/mail/mail-send.js +1 -1
  58. package/dist/m365/outlook/commands/message/message-get.js +1 -1
  59. package/dist/m365/pa/commands/app/app-permission-ensure.js +1 -1
  60. package/dist/m365/pa/commands/app/app-permission-remove.js +1 -1
  61. package/dist/m365/planner/commands/roster/roster-plan-list.js +1 -1
  62. package/dist/m365/purview/commands/auditlog/auditlog-list.js +1 -1
  63. package/dist/m365/purview/commands/sensitivitylabel/sensitivitylabel-get.js +1 -1
  64. package/dist/m365/purview/commands/sensitivitylabel/sensitivitylabel-list.js +1 -1
  65. package/dist/m365/purview/commands/sensitivitylabel/sensitivitylabel-policysettings-list.js +1 -1
  66. package/dist/m365/spfx/commands/project/DeployWorkflow.js +4 -3
  67. package/dist/m365/spo/commands/spo-get.js +1 -1
  68. package/dist/m365/spo/commands/spo-search.js +52 -22
  69. package/dist/m365/spo/commands/spo-set.js +1 -1
  70. package/dist/m365/teams/commands/chat/chat-get.js +1 -1
  71. package/dist/m365/teams/commands/chat/chat-list.js +1 -1
  72. package/dist/m365/teams/commands/chat/chat-message-send.js +1 -1
  73. package/dist/m365/teams/commands/meeting/meeting-add.js +1 -1
  74. package/dist/m365/teams/commands/meeting/meeting-attendancereport-list.js +1 -1
  75. package/dist/m365/teams/commands/meeting/meeting-get.js +1 -1
  76. package/dist/m365/teams/commands/meeting/meeting-list.js +2 -2
  77. package/dist/m365/teams/commands/meeting/meeting-transcript-list.js +1 -1
  78. package/dist/m365/tenant/commands/id/id-get.js +1 -1
  79. package/dist/m365/tenant/commands/info/info-get.js +1 -1
  80. package/dist/m365/util/commands/accesstoken/accesstoken-get.js +3 -3
  81. package/dist/m365/{yammer/commands/group/group-list.js → viva/commands/engage/engage-group-list.js} +19 -14
  82. package/dist/m365/{yammer/commands/group/group-user-add.js → viva/commands/engage/engage-group-user-add.js} +19 -14
  83. package/dist/m365/{yammer/commands/group/group-user-remove.js → viva/commands/engage/engage-group-user-remove.js} +19 -14
  84. package/dist/m365/{yammer/commands/message/message-add.js → viva/commands/engage/engage-message-add.js} +19 -14
  85. package/dist/m365/{yammer/commands/message/message-get.js → viva/commands/engage/engage-message-get.js} +17 -12
  86. package/dist/m365/{yammer/commands/message/message-like-set.js → viva/commands/engage/engage-message-like-set.js} +21 -16
  87. package/dist/m365/{yammer/commands/message/message-list.js → viva/commands/engage/engage-message-list.js} +21 -16
  88. package/dist/m365/{yammer/commands/message/message-remove.js → viva/commands/engage/engage-message-remove.js} +20 -15
  89. package/dist/m365/{yammer/commands/network/network-list.js → viva/commands/engage/engage-network-list.js} +16 -11
  90. package/dist/m365/viva/commands/engage/engage-report-activitycounts.js +23 -0
  91. package/dist/m365/viva/commands/engage/engage-report-activityusercounts.js +23 -0
  92. package/dist/m365/viva/commands/engage/engage-report-activityuserdetail.js +23 -0
  93. package/dist/m365/viva/commands/engage/engage-report-deviceusagedistributionusercounts.js +23 -0
  94. package/dist/m365/viva/commands/engage/engage-report-deviceusageusercounts.js +23 -0
  95. package/dist/m365/viva/commands/engage/engage-report-deviceusageuserdetail.js +23 -0
  96. package/dist/m365/viva/commands/engage/engage-report-groupsactivitycounts.js +23 -0
  97. package/dist/m365/viva/commands/engage/engage-report-groupsactivitydetail.js +23 -0
  98. package/dist/m365/viva/commands/engage/engage-report-groupsactivitygroupcounts.js +23 -0
  99. package/dist/m365/{yammer/commands/yammer-search.js → viva/commands/engage/engage-search.js} +23 -18
  100. package/dist/m365/{yammer/commands/user/user-get.js → viva/commands/engage/engage-user-get.js} +18 -13
  101. package/dist/m365/{yammer/commands/user/user-list.js → viva/commands/engage/engage-user-list.js} +18 -13
  102. package/dist/m365/{yammer/commands.js → viva/commands/engage/yammerCommands.js} +1 -1
  103. package/dist/m365/viva/commands.js +22 -1
  104. package/dist/request.js +1 -1
  105. package/dist/utils/entraUser.js +36 -0
  106. package/dist/utils/spo.js +36 -14
  107. package/dist/utils/urlUtil.js +31 -0
  108. package/dist/utils/validation.js +8 -0
  109. package/docs/docs/cmd/cli/cli-consent.mdx +9 -9
  110. package/docs/docs/cmd/connection/connection-list.mdx +100 -0
  111. package/docs/docs/cmd/connection/connection-remove.mdx +45 -0
  112. package/docs/docs/cmd/connection/connection-set.mdx +39 -0
  113. package/docs/docs/cmd/connection/connection-use.mdx +98 -0
  114. package/docs/docs/cmd/entra/administrativeunit/administrativeunit-member-add.mdx +5 -3
  115. package/docs/docs/cmd/entra/administrativeunit/administrativeunit-member-remove.mdx +107 -0
  116. package/docs/docs/cmd/entra/app/app-add.mdx +2 -1
  117. package/docs/docs/cmd/entra/app/app-get.mdx +1 -0
  118. package/docs/docs/cmd/entra/app/app-list.mdx +1 -0
  119. package/docs/docs/cmd/entra/app/app-permission-add.mdx +1 -0
  120. package/docs/docs/cmd/entra/app/app-permission-list.mdx +105 -0
  121. package/docs/docs/cmd/entra/app/app-remove.mdx +1 -0
  122. package/docs/docs/cmd/entra/app/app-role-add.mdx +1 -0
  123. package/docs/docs/cmd/entra/app/app-role-list.mdx +1 -0
  124. package/docs/docs/cmd/entra/app/app-role-remove.mdx +1 -0
  125. package/docs/docs/cmd/entra/app/app-set.mdx +1 -0
  126. package/docs/docs/cmd/entra/{sp/sp-add.mdx → enterpriseapp/enterpriseapp-add.mdx} +16 -15
  127. package/docs/docs/cmd/entra/{sp/sp-get.mdx → enterpriseapp/enterpriseapp-get.mdx} +15 -14
  128. package/docs/docs/cmd/entra/{sp/sp-list.mdx → enterpriseapp/enterpriseapp-list.mdx} +22 -21
  129. package/docs/docs/cmd/entra/group/group-add.mdx +231 -0
  130. package/docs/docs/cmd/entra/group/group-user-add.mdx +62 -0
  131. package/docs/docs/cmd/entra/m365group/m365group-report-activitygroupcounts.mdx +1 -1
  132. package/docs/docs/cmd/entra/oauth2grant/oauth2grant-add.mdx +3 -3
  133. package/docs/docs/cmd/entra/oauth2grant/oauth2grant-list.mdx +1 -1
  134. package/docs/docs/cmd/entra/user/user-registrationdetails-list.mdx +246 -0
  135. package/docs/docs/cmd/external/item/item-add.mdx +1 -1
  136. package/docs/docs/cmd/file/convert/convert-pdf.mdx +4 -0
  137. package/docs/docs/cmd/file/file-add.mdx +4 -0
  138. package/docs/docs/cmd/file/file-copy.mdx +68 -0
  139. package/docs/docs/cmd/file/file-list.mdx +100 -0
  140. package/docs/docs/cmd/login.mdx +15 -0
  141. package/docs/docs/cmd/setup.mdx +4 -0
  142. package/docs/docs/cmd/spo/list/list-webhook-set.mdx +1 -1
  143. package/docs/docs/cmd/spo/spo-search.mdx +6 -2
  144. package/docs/docs/cmd/spo/theme/theme-set.mdx +14 -2
  145. package/docs/docs/cmd/{yammer/group/group-list.mdx → viva/engage/engage-group-list.mdx} +13 -13
  146. package/docs/docs/cmd/{yammer/group/group-user-add.mdx → viva/engage/engage-group-user-add.mdx} +7 -7
  147. package/docs/docs/cmd/{yammer/group/group-user-remove.mdx → viva/engage/engage-group-user-remove.mdx} +10 -10
  148. package/docs/docs/cmd/{yammer/message/message-add.mdx → viva/engage/engage-message-add.mdx} +12 -13
  149. package/docs/docs/cmd/{yammer/message/message-get.mdx → viva/engage/engage-message-get.mdx} +10 -10
  150. package/docs/docs/cmd/{yammer/message/message-like-set.mdx → viva/engage/engage-message-like-set.mdx} +10 -10
  151. package/docs/docs/cmd/{yammer/message/message-list.mdx → viva/engage/engage-message-list.mdx} +21 -21
  152. package/docs/docs/cmd/{yammer/message/message-remove.mdx → viva/engage/engage-message-remove.mdx} +10 -10
  153. package/docs/docs/cmd/{yammer/network/network-list.mdx → viva/engage/engage-network-list.mdx} +6 -6
  154. package/docs/docs/cmd/{yammer/report/report-activitycounts.mdx → viva/engage/engage-report-activitycounts.mdx} +9 -9
  155. package/docs/docs/cmd/{yammer/report/report-activityusercounts.mdx → viva/engage/engage-report-activityusercounts.mdx} +9 -9
  156. package/docs/docs/cmd/{yammer/report/report-activityuserdetail.mdx → viva/engage/engage-report-activityuserdetail.mdx} +11 -12
  157. package/docs/docs/cmd/{yammer/report/report-deviceusagedistributionusercounts.mdx → viva/engage/engage-report-deviceusagedistributionusercounts.mdx} +5 -5
  158. package/docs/docs/cmd/{yammer/report/report-deviceusageusercounts.mdx → viva/engage/engage-report-deviceusageusercounts.mdx} +5 -5
  159. package/docs/docs/cmd/{yammer/report/report-deviceusageuserdetail.mdx → viva/engage/engage-report-deviceusageuserdetail.mdx} +11 -11
  160. package/docs/docs/cmd/{yammer/report/report-groupsactivitycounts.mdx → viva/engage/engage-report-groupsactivitycounts.mdx} +9 -9
  161. package/docs/docs/cmd/{yammer/report/report-groupsactivitydetail.mdx → viva/engage/engage-report-groupsactivitydetail.mdx} +11 -11
  162. package/docs/docs/cmd/{yammer/report/report-groupsactivitygroupcounts.mdx → viva/engage/engage-report-groupsactivitygroupcounts.mdx} +5 -5
  163. package/docs/docs/cmd/{yammer/yammer-search.mdx → viva/engage/engage-search.mdx} +10 -10
  164. package/docs/docs/cmd/{yammer/user/user-get.mdx → viva/engage/engage-user-get.mdx} +8 -8
  165. package/docs/docs/cmd/{yammer/user/user-list.mdx → viva/engage/engage-user-list.mdx} +11 -11
  166. package/npm-shrinkwrap.json +228 -166
  167. package/package.json +21 -20
  168. package/dist/m365/base/AzmgmtCommand.js +0 -18
  169. package/dist/m365/base/AzmgmtItemsListCommand.js +0 -41
  170. package/dist/m365/yammer/commands/report/report-activitycounts.js +0 -15
  171. package/dist/m365/yammer/commands/report/report-activityusercounts.js +0 -15
  172. package/dist/m365/yammer/commands/report/report-activityuserdetail.js +0 -15
  173. package/dist/m365/yammer/commands/report/report-deviceusagedistributionusercounts.js +0 -15
  174. package/dist/m365/yammer/commands/report/report-deviceusageusercounts.js +0 -15
  175. package/dist/m365/yammer/commands/report/report-deviceusageuserdetail.js +0 -15
  176. package/dist/m365/yammer/commands/report/report-groupsactivitycounts.js +0 -15
  177. package/dist/m365/yammer/commands/report/report-groupsactivitydetail.js +0 -15
  178. 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
@@ -90,3 +90,7 @@ Configure CLI for Microsoft for use in scripts without prompting for additional
90
90
  ```sh
91
91
  m365 setup --scripting
92
92
  ```
93
+
94
+ ## Response
95
+
96
+ The command won't return a response on success.
@@ -64,6 +64,6 @@ Update the notification url and clientState of a webhook with a specific ID atta
64
64
  m365 spo list webhook set --webUrl https://contoso.sharepoint.com/sites/ninja --listUrl '/sites/ninja/Documents' --id cc27a922-8224-4296-90a5-ebbc54da2e81 --notificationUrl https://contoso-functions.azurewebsites.net/webhook --expirationDateTime 2019-03-02 --clientState 'My client state'
65
65
  ```
66
66
 
67
- ## Respone
67
+ ## Response
68
68
 
69
69
  The command won't return a response on success.
@@ -25,7 +25,7 @@ m365 spo search [options]
25
25
  : The web against which we want to execute the query. If the parameter is not defined, the query is executed against the web that's used when logging in to the SPO environment.
26
26
 
27
27
  `--allResults`
28
- : Set, to get all results of the search query, instead of the number specified by the `rowlimit` (default: 10)
28
+ : Set, to get all results of the search query in batches of 500.
29
29
 
30
30
  `--rowLimit [rowLimit]`
31
31
  : The number of rows to be returned. When the `allResults` option is used, the specified value will define the size of retrieved batches
@@ -55,7 +55,7 @@ m365 spo search [options]
55
55
  : The ID of the ranking model to use for the query.
56
56
 
57
57
  `--startRow [startRow]`
58
- : The first row that is included in the search results that are returned. You use this parameter when you want to implement paging for search results.
58
+ : The first row that is included in the search results that are returned. You use this parameter when you want to implement manual paging for search results.
59
59
 
60
60
  `--properties [properties]`
61
61
  : Additional properties for the query.
@@ -90,6 +90,10 @@ m365 spo search [options]
90
90
 
91
91
  <Global />
92
92
 
93
+ ## Remarks
94
+
95
+ When using the `--allResults` option, you cannot use the `--startRow` option. Only use `--startRow` for manual paging purposes.
96
+
93
97
  ## Examples
94
98
 
95
99
  Execute search query to retrieve all Document Sets (ContentTypeId = _0x0120D520_) for the English locale
@@ -76,13 +76,25 @@ To use this command you have to have permissions to access the tenant admin site
76
76
  Add or update a theme from a theme JSON file
77
77
 
78
78
  ```sh
79
- m365 spo theme set --name Contoso-Blue --theme @/Users/rjesh/themes/contoso-blue.json
79
+ m365 spo theme set --name Contoso-Blue --theme @/Users/user/themes/contoso-blue.json
80
80
  ```
81
81
 
82
82
  Add or update an inverted theme from a theme JSON file
83
83
 
84
84
  ```sh
85
- m365 spo theme set --name Contoso-Blue --theme @/Users/rjesh/themes/contoso-blue.json --isInverted
85
+ m365 spo theme set --name Contoso-Blue --theme @/Users/user/themes/contoso-blue.json --isInverted
86
+ ```
87
+
88
+ Add or update a theme from inline JSON
89
+
90
+ ```sh
91
+ m365 spo theme set --name Contoso-Red --theme '{"themePrimary":"#d81e05","themeLighterAlt":"#fdf5f4","themeLighter":"#f9d6d2","themeLight":"#f4b4ac","themeTertiary":"#e87060","themeSecondary":"#dd351e","themeDarkAlt":"#c31a04","themeDark":"#a51603","themeDarker":"#791002","neutralLighterAlt":"#eeeeee","neutralLighter":"#f5f5f5","neutralLight":"#e1e1e1","neutralQuaternaryAlt":"#d1d1d1","neutralQuaternary":"#c8c8c8","neutralTertiaryAlt":"#c0c0c0","neutralTertiary":"#c2c2c2","neutralSecondary":"#858585","neutralPrimaryAlt":"#4b4b4b","neutralPrimary":"#333333","neutralDark":"#272727","black":"#1d1d1d","white":"#f5f5f5"}'
92
+ ```
93
+
94
+ Add or update an inverted theme from inline JSON
95
+
96
+ ```sh
97
+ m365 spo theme set --name Contoso-Red --theme '{"themePrimary":"#d81e05","themeLighterAlt":"#fdf5f4","themeLighter":"#f9d6d2","themeLight":"#f4b4ac","themeTertiary":"#e87060","themeSecondary":"#dd351e","themeDarkAlt":"#c31a04","themeDark":"#a51603","themeDarker":"#791002","neutralLighterAlt":"#eeeeee","neutralLighter":"#f5f5f5","neutralLight":"#e1e1e1","neutralQuaternaryAlt":"#d1d1d1","neutralQuaternary":"#c8c8c8","neutralTertiaryAlt":"#c0c0c0","neutralTertiary":"#c2c2c2","neutralSecondary":"#858585","neutralPrimaryAlt":"#4b4b4b","neutralPrimary":"#333333","neutralDark":"#272727","black":"#1d1d1d","white":"#f5f5f5"}' --isInverted
86
98
  ```
87
99
 
88
100
  ## Response
@@ -2,14 +2,14 @@ import Global from '/docs/cmd/_global.mdx';
2
2
  import Tabs from '@theme/Tabs';
3
3
  import TabItem from '@theme/TabItem';
4
4
 
5
- # yammer group list
5
+ # viva engage group list
6
6
 
7
- Returns the list of groups in a Yammer network or the groups for a specific user
7
+ Returns the list of groups in a Viva Engage network or the groups for a specific user
8
8
 
9
9
  ## Usage
10
10
 
11
11
  ```sh
12
- m365 yammer group list [options]
12
+ m365 viva engage group list [options]
13
13
  ```
14
14
 
15
15
  ## Options
@@ -28,34 +28,34 @@ m365 yammer group list [options]
28
28
 
29
29
  :::warning
30
30
 
31
- In order to use this command, you need to grant the Azure AD application used by the CLI for Microsoft 365 the permission to the Yammer API. To do this, execute the `cli consent --service yammer` command.
31
+ In order to use this command, you need to grant the Azure AD application used by the CLI for Microsoft 365 the permission to the Viva Engage API. To do this, execute the `cli consent --service VivaEngage` command.
32
32
 
33
33
  :::
34
34
 
35
35
  ## Examples
36
36
 
37
- Returns all Yammer network groups
37
+ Returns all Viva Engage network groups
38
38
 
39
39
  ```sh
40
- m365 yammer group list
40
+ m365 viva engage group list
41
41
  ```
42
42
 
43
- Returns all Yammer network groups for the user with the ID `5611239081`
43
+ Returns all Viva Engage network groups for the user with the ID `5611239081`
44
44
 
45
45
  ```sh
46
- m365 yammer group list --userId 5611239081
46
+ m365 viva engage group list --userId 5611239081
47
47
  ```
48
48
 
49
- Returns the first 10 Yammer network groups
49
+ Returns the first 10 Viva Engage network groups
50
50
 
51
51
  ```sh
52
- m365 yammer group list --limit 10
52
+ m365 viva engage group list --limit 10
53
53
  ```
54
54
 
55
- Returns the first 10 Yammer network groups for the user with the ID `5611239081`
55
+ Returns the first 10 Viva Engage network groups for the user with the ID `5611239081`
56
56
 
57
57
  ```sh
58
- m365 yammer group list --userId 5611239081 --limit 10
58
+ m365 viva engage group list --userId 5611239081 --limit 10
59
59
  ```
60
60
 
61
61
  ## Response
@@ -130,7 +130,7 @@ m365 yammer group list --userId 5611239081 --limit 10
130
130
  <TabItem value="Markdown">
131
131
 
132
132
  ```md
133
- # yammer group list --limit "1"
133
+ # viva engage group list --limit "1"
134
134
 
135
135
  Date: 2023-05-16
136
136