@pnp/cli-microsoft365 10.0.0-beta.48e9f7d → 10.0.0-beta.58166a8

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 (171) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/Auth.js +17 -16
  4. package/dist/AuthServer.js +7 -7
  5. package/dist/Command.js +4 -1
  6. package/dist/api.js +1 -1
  7. package/dist/cli/cli.js +14 -0
  8. package/dist/config.js +61 -5
  9. package/dist/m365/base/PowerAutomateCommand.js +1 -1
  10. package/dist/m365/base/SpoCommand.js +1 -1
  11. package/dist/m365/cli/commands/cli-consent.js +2 -2
  12. package/dist/m365/cli/commands/cli-doctor.js +4 -4
  13. package/dist/m365/cli/commands/config/config-set.js +12 -4
  14. package/dist/m365/cli/commands.js +1 -2
  15. package/dist/m365/commands/login.js +28 -9
  16. package/dist/m365/commands/setup.js +256 -33
  17. package/dist/m365/commands/setupPresets.js +2 -4
  18. package/dist/m365/connection/commands/connection-list.js +4 -4
  19. package/dist/m365/entra/commands/app/app-add.js +52 -288
  20. package/dist/m365/entra/commands/m365group/m365group-set.js +24 -16
  21. package/dist/m365/entra/commands/m365group/m365group-user-add.js +5 -12
  22. package/dist/m365/entra/commands/oauth2grant/oauth2grant-list.js +3 -12
  23. package/dist/m365/external/commands/item/item-add.js +2 -5
  24. package/dist/m365/file/commands/file-move.js +135 -0
  25. package/dist/m365/file/commands.js +2 -1
  26. package/dist/m365/flow/commands/environment/environment-get.js +1 -1
  27. package/dist/m365/flow/commands/environment/environment-list.js +2 -2
  28. package/dist/m365/flow/commands/flow-disable.js +1 -1
  29. package/dist/m365/flow/commands/flow-enable.js +1 -1
  30. package/dist/m365/flow/commands/flow-export.js +17 -16
  31. package/dist/m365/flow/commands/flow-get.js +1 -1
  32. package/dist/m365/flow/commands/flow-list.js +1 -1
  33. package/dist/m365/flow/commands/flow-remove.js +1 -1
  34. package/dist/m365/flow/commands/owner/owner-ensure.js +1 -1
  35. package/dist/m365/flow/commands/owner/owner-list.js +1 -1
  36. package/dist/m365/flow/commands/owner/owner-remove.js +1 -1
  37. package/dist/m365/flow/commands/recyclebinitem/recyclebinitem-list.js +47 -0
  38. package/dist/m365/flow/commands/recyclebinitem/recyclebinitem-restore.js +48 -0
  39. package/dist/m365/flow/commands/run/run-cancel.js +1 -1
  40. package/dist/m365/flow/commands/run/run-get.js +1 -1
  41. package/dist/m365/flow/commands/run/run-list.js +1 -1
  42. package/dist/m365/flow/commands/run/run-resubmit.js +2 -2
  43. package/dist/m365/flow/commands.js +2 -0
  44. package/dist/m365/pa/commands/app/app-list.js +1 -6
  45. package/dist/m365/pa/commands/connector/connector-list.js +1 -6
  46. package/dist/m365/pa/commands/environment/environment-list.js +1 -1
  47. package/dist/m365/pp/commands/environment/environment-list.js +1 -1
  48. package/dist/m365/spfx/commands/project/project-doctor/doctor-1.20.0-rc.1.js +25 -0
  49. package/dist/m365/spfx/commands/project/project-doctor.js +2 -1
  50. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.20.0-rc.1.js +57 -0
  51. package/dist/m365/spfx/commands/project/project-upgrade.js +16 -13
  52. package/dist/m365/spfx/commands/spfx-doctor.js +15 -0
  53. package/dist/m365/spo/commands/app/app-instance-list.js +3 -18
  54. package/dist/m365/spo/commands/app/app-list.js +1 -8
  55. package/dist/m365/spo/commands/contenttype/contenttype-field-remove.js +8 -8
  56. package/dist/m365/spo/commands/contenttype/contenttype-field-set.js +2 -2
  57. package/dist/m365/spo/commands/feature/feature-list.js +1 -8
  58. package/dist/m365/spo/commands/file/file-copy.js +5 -1
  59. package/dist/m365/spo/commands/file/file-move.js +55 -33
  60. package/dist/m365/spo/commands/file/file-roleassignment-add.js +17 -54
  61. package/dist/m365/spo/commands/file/file-roleassignment-remove.js +13 -40
  62. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +5 -13
  63. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +5 -13
  64. package/dist/m365/spo/commands/folder/folder-sharinglink-add.js +143 -0
  65. package/dist/m365/spo/commands/folder/folder-sharinglink-clear.js +111 -0
  66. package/dist/m365/spo/commands/folder/folder-sharinglink-remove.js +95 -0
  67. package/dist/m365/spo/commands/list/list-get.js +17 -4
  68. package/dist/m365/spo/commands/list/list-webhook-list.js +1 -6
  69. package/dist/m365/spo/commands/listitem/listitem-attachment-list.js +1 -8
  70. package/dist/m365/spo/commands/page/page-list.js +1 -1
  71. package/dist/m365/spo/commands/page/page-remove.js +37 -16
  72. package/dist/m365/spo/commands/page/page-section-add.js +185 -34
  73. package/dist/m365/spo/commands/page/page-template-list.js +1 -3
  74. package/dist/m365/spo/commands/site/SiteAdmin.js +2 -0
  75. package/dist/m365/spo/commands/site/site-admin-add.js +252 -0
  76. package/dist/m365/spo/commands/site/site-admin-list.js +10 -36
  77. package/dist/m365/spo/commands/site/site-admin-remove.js +194 -0
  78. package/dist/m365/spo/commands/site/site-sharingpermission-set.js +68 -0
  79. package/dist/m365/spo/commands/sitescript/sitescript-get.js +3 -2
  80. package/dist/m365/spo/commands/sitescript/sitescript-list.js +1 -3
  81. package/dist/m365/spo/commands/{site/site-rename.js → tenant/tenant-site-rename.js} +29 -32
  82. package/dist/m365/spo/commands/theme/theme-list.js +1 -1
  83. package/dist/m365/spo/commands/user/user-get.js +67 -9
  84. package/dist/m365/spo/commands/web/web-clientsidewebpart-list.js +1 -6
  85. package/dist/m365/spo/commands.js +7 -1
  86. package/dist/m365/spp/commands/contentcenter/contentcenter-list.js +56 -0
  87. package/dist/m365/spp/commands.js +5 -0
  88. package/dist/m365/teams/MeetingTranscript.js +2 -0
  89. package/dist/m365/teams/commands/meeting/meeting-transcript-get.js +152 -0
  90. package/dist/m365/teams/commands/tab/tab-list.js +5 -3
  91. package/dist/m365/teams/commands.js +1 -0
  92. package/dist/m365/viva/commands/engage/Community.js +2 -0
  93. package/dist/m365/viva/commands/engage/engage-community-list.js +28 -0
  94. package/dist/m365/viva/commands.js +1 -0
  95. package/dist/request.js +46 -61
  96. package/dist/settingsNames.js +6 -1
  97. package/dist/utils/driveUtil.js +51 -0
  98. package/dist/utils/entraApp.js +283 -0
  99. package/dist/utils/spo.js +76 -8
  100. package/dist/utils/timersUtil.js +12 -0
  101. package/dist/utils/urlUtil.js +8 -0
  102. package/dist/utils/zod.js +1 -1
  103. package/docs/docs/_clisettings.mdx +6 -1
  104. package/docs/docs/cmd/cli/cli-doctor.mdx +24 -23
  105. package/docs/docs/cmd/entra/m365group/m365group-report-activitystorage.mdx +2 -2
  106. package/docs/docs/cmd/entra/m365group/m365group-set.mdx +9 -6
  107. package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx +0 -3
  108. package/docs/docs/cmd/external/item/item-add.mdx +3 -3
  109. package/docs/docs/cmd/file/file-move.mdx +79 -0
  110. package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-list.mdx +132 -0
  111. package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-restore.mdx +55 -0
  112. package/docs/docs/cmd/setup.mdx +17 -6
  113. package/docs/docs/cmd/spo/cdn/cdn-get.mdx +1 -1
  114. package/docs/docs/cmd/spo/cdn/cdn-origin-add.mdx +1 -1
  115. package/docs/docs/cmd/spo/cdn/cdn-origin-list.mdx +1 -1
  116. package/docs/docs/cmd/spo/cdn/cdn-origin-remove.mdx +1 -1
  117. package/docs/docs/cmd/spo/cdn/cdn-policy-list.mdx +1 -1
  118. package/docs/docs/cmd/spo/cdn/cdn-policy-set.mdx +1 -1
  119. package/docs/docs/cmd/spo/contenttype/contenttype-field-remove.mdx +7 -7
  120. package/docs/docs/cmd/spo/contenttype/contenttype-field-set.mdx +2 -2
  121. package/docs/docs/cmd/spo/externaluser/externaluser-list.mdx +1 -1
  122. package/docs/docs/cmd/spo/file/file-move.mdx +116 -9
  123. package/docs/docs/cmd/spo/folder/folder-sharinglink-add.mdx +125 -0
  124. package/docs/docs/cmd/spo/folder/folder-sharinglink-clear.mdx +50 -0
  125. package/docs/docs/cmd/spo/folder/folder-sharinglink-remove.mdx +50 -0
  126. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-get.mdx +1 -1
  127. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-set.mdx +1 -1
  128. package/docs/docs/cmd/spo/homesite/homesite-remove.mdx +1 -1
  129. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-get.mdx +1 -1
  130. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-remove.mdx +1 -1
  131. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-set.mdx +1 -1
  132. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-add.mdx +1 -1
  133. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-list.mdx +1 -1
  134. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-remove.mdx +1 -1
  135. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-list.mdx +1 -1
  136. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-remove.mdx +1 -1
  137. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-set.mdx +1 -1
  138. package/docs/docs/cmd/spo/page/page-remove.mdx +30 -12
  139. package/docs/docs/cmd/spo/page/page-section-add.mdx +57 -2
  140. package/docs/docs/cmd/spo/site/site-admin-add.mdx +67 -0
  141. package/docs/docs/cmd/spo/site/site-admin-list.mdx +64 -12
  142. package/docs/docs/cmd/spo/site/site-admin-remove.mdx +67 -0
  143. package/docs/docs/cmd/spo/site/site-appcatalog-add.mdx +1 -1
  144. package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx +1 -1
  145. package/docs/docs/cmd/spo/site/site-commsite-enable.mdx +1 -1
  146. package/docs/docs/cmd/spo/site/site-list.mdx +6 -4
  147. package/docs/docs/cmd/spo/site/site-set.mdx +1 -1
  148. package/docs/docs/cmd/spo/site/site-sharingpermission-set.mdx +58 -0
  149. package/docs/docs/cmd/spo/sitescript/sitescript-get.mdx +14 -1
  150. package/docs/docs/cmd/spo/storageentity/storageentity-remove.mdx +1 -1
  151. package/docs/docs/cmd/spo/storageentity/storageentity-set.mdx +1 -1
  152. package/docs/docs/cmd/spo/tenant/tenant-appcatalog-add.mdx +1 -1
  153. package/docs/docs/cmd/spo/tenant/tenant-appcatalogurl-get.mdx +1 -1
  154. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-list.mdx +1 -1
  155. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-remove.mdx +1 -1
  156. package/docs/docs/cmd/spo/tenant/tenant-settings-list.mdx +1 -1
  157. package/docs/docs/cmd/spo/{site/site-rename.mdx → tenant/tenant-site-rename.mdx} +7 -7
  158. package/docs/docs/cmd/spo/theme/theme-apply.mdx +1 -1
  159. package/docs/docs/cmd/spo/theme/theme-get.mdx +1 -1
  160. package/docs/docs/cmd/spo/theme/theme-list.mdx +1 -1
  161. package/docs/docs/cmd/spo/theme/theme-remove.mdx +1 -1
  162. package/docs/docs/cmd/spo/theme/theme-set.mdx +1 -1
  163. package/docs/docs/cmd/spo/user/user-get.mdx +35 -9
  164. package/docs/docs/cmd/spp/contentcenter/contentcenter-list.mdx +287 -0
  165. package/docs/docs/cmd/teams/meeting/meeting-transcript-get.mdx +132 -0
  166. package/docs/docs/cmd/teams/tab/tab-list.mdx +1 -2
  167. package/docs/docs/cmd/viva/engage/engage-community-list.mdx +81 -0
  168. package/npm-shrinkwrap.json +203 -375
  169. package/package.json +16 -17
  170. package/dist/m365/cli/commands/cli-reconsent.js +0 -30
  171. package/docs/docs/cmd/cli/cli-reconsent.mdx +0 -62
@@ -2,6 +2,11 @@ Setting name|Definition|Default value
2
2
  ------------|----------|-------------
3
3
  `authType`|Default login method to use when running `m365 login` without the `--authType` option.|`deviceCode`
4
4
  `autoOpenLinksInBrowser`|Automatically open the browser for all commands which return a url and expect the user to copy paste this to the browser. For example when logging in, using `m365 login` in device code mode.|`false`
5
+ `clientId`|ID of the default Entra ID app use by the CLI to authenticate|``
6
+ `clientSecret`|Secret of the default Entra ID app use by the CLI to authenticate|``
7
+ `clientCertificateFile`|Path to the file containing the client certificate to use for authentication|``
8
+ `clientCertificateBase64Encoded`|Base64-encoded client certificate contents|``
9
+ `clientCertificatePassword`|Password to the client certificate file|``
5
10
  `copyDeviceCodeToClipboard`|Automatically copy the device code to the clipboard when running `m365 login` command in device code mode|`false`
6
11
  `csvEscape`|Single character used for escaping; only apply to characters matching the quote and the escape options|`"`
7
12
  `csvHeader`|Display the column names on the first line|`true`
@@ -17,4 +22,4 @@ Setting name|Definition|Default value
17
22
  `prompt`|Prompts for missing values in required options and enables interactive selection when multiple values are available for a command that requires a specific value to be retrieved.|`true`
18
23
  `promptListPageSize`|By default, lists of choices longer than 7 will be paginated. Use this option to control how many choices will appear on the screen at once.|7
19
24
  `showHelpOnFailure`|Automatically display help when executing a command failed|`true`
20
- `showSpinner`|Display spinner when executing commands|`true`
25
+ `tenantId`|ID of the default tenant to use when authenticating with|``
@@ -22,7 +22,7 @@ This command gets all the necessary diagnostic information needed to triage and
22
22
 
23
23
  ## Examples
24
24
 
25
- Retrieve diagnostic information
25
+ Retrieve diagnostic information.
26
26
 
27
27
  ```sh
28
28
  m365 cli doctor
@@ -42,18 +42,20 @@ m365 cli doctor
42
42
  },
43
43
  "cliVersion": "6.1.0",
44
44
  "nodeVersion": "v16.13.0",
45
- "cliAadAppId": "31359c7f-bd7e-475c-86db-fdb8c937548e",
46
- "cliAadAppTenant": "common",
47
- "authMode": "DeviceCode",
45
+ "cliEntraAppId": "31359c7f-bd7e-475c-86db-fdb8c937548e",
46
+ "cliEntraAppTenant": "common",
47
+ "authMode": "deviceCode",
48
48
  "cliEnvironment": "",
49
49
  "cliConfig": {
50
50
  "output": "json",
51
51
  "showHelpOnFailure": false
52
52
  },
53
53
  "roles": [],
54
- "scopes": [
55
- "AllSites.FullControl"
56
- ]
54
+ "scopes": {
55
+ "https://graph.microsoft.com": [
56
+ "AllSites.FullControl"
57
+ ]
58
+ }
57
59
  }
58
60
  ```
59
61
 
@@ -61,24 +63,24 @@ m365 cli doctor
61
63
  <TabItem value="Text">
62
64
 
63
65
  ```text
64
- authMode : DeviceCode
65
- cliAadAppId : 31359c7f-bd7e-475c-86db-fdb8c937548e
66
- cliAadAppTenant: common
67
- cliConfig : {"output":"json","showHelpOnFailure":false}
68
- cliEnvironment :
69
- cliVersion : 6.1.0
70
- nodeVersion : v16.13.0
71
- os : {"platform":"win32","version":"Windows 10 Pro","release":"10.0.19045"}
72
- roles : []
73
- scopes : ["AllSites.FullControl"]
66
+ authMode : deviceCode
67
+ cliConfig : {"output":"json","showHelpOnFailure":false}
68
+ cliEntraAppId : 31359c7f-bd7e-475c-86db-fdb8c937548e
69
+ cliEntraAppTenant: common
70
+ cliEnvironment :
71
+ cliVersion : 6.1.0
72
+ nodeVersion : v16.13.0
73
+ os : {"platform":"win32","version":"Windows 10 Pro","release":"10.0.19045"}
74
+ roles : []
75
+ scopes : {"https://graph.microsoft.com":["AllSites.FullControl"]}
74
76
  ```
75
77
 
76
78
  </TabItem>
77
79
  <TabItem value="CSV">
78
80
 
79
81
  ```csv
80
- os,cliVersion,nodeVersion,cliAadAppId,cliAadAppTenant,authMode,cliEnvironment,cliConfig,roles,scopes
81
- "{""platform"":""win32"",""version"":""Windows 10 Pro"",""release"":""10.0.19045""}",6.1.0,v16.13.0,31359c7f-bd7e-475c-86db-fdb8c937548e,common,DeviceCode,,"{""output"":""json"",""showHelpOnFailure"":false}",[],"[""AllSites.FullControl""]"
82
+ os,cliVersion,nodeVersion,cliEntraAppId,cliEntraAppTenant,authMode,cliEnvironment,cliConfig,roles,scopes
83
+ "{""platform"":""win32"",""version"":""Windows 10 Pro"",""release"":""10.0.19045""}",6.1.0,v16.13.0,31359c7f-bd7e-475c-86db-fdb8c937548e,common,deviceCode,,"{""output"":""json"",""showHelpOnFailure"":false}",[],"{""https://graph.microsoft.com"":[""AllSites.FullControl""]}"
82
84
  ```
83
85
 
84
86
  </TabItem>
@@ -93,12 +95,11 @@ m365 cli doctor
93
95
  ---------|-------
94
96
  cliVersion | 6.1.0
95
97
  nodeVersion | v16.13.0
96
- cliAadAppId | 31359c7f-bd7e-475c-86db-fdb8c937548e
97
- cliAadAppTenant | common
98
- authMode | DeviceCode
98
+ cliEntraAppId | 31359c7f-bd7e-475c-86db-fdb8c937548e
99
+ cliEntraAppTenant | common
100
+ authMode | deviceCode
99
101
  cliEnvironment |
100
102
  ```
101
103
 
102
104
  </TabItem>
103
105
  </Tabs>
104
-
@@ -9,13 +9,13 @@ Get the total storage used across all group mailboxes and group sites
9
9
  ## Usage
10
10
 
11
11
  ```sh
12
- m365 entra m365group report activitystorage [options]
12
+ m365 entra m365group report activitystorage [options]
13
13
  ```
14
14
 
15
15
  ## Alias
16
16
 
17
17
  ```sh
18
- m365 aad m365group report activitystorage [options]
18
+ m365 aad m365group report activitystorage [options]
19
19
  ```
20
20
 
21
21
  ## Options
@@ -19,11 +19,14 @@ m365 aad m365group set [options]
19
19
  ## Options
20
20
 
21
21
  ```md definition-list
22
- `-i, --id <id>`
22
+ `-i, --id [id]`
23
23
  : The ID of the Microsoft 365 Group to update
24
24
 
25
25
  `-n, --displayName [displayName]`
26
- : Display name for the Microsoft 365 Group
26
+ : Display name of the Microsoft 365 Group to update
27
+
28
+ `--newDisplayName [newDisplayName]`
29
+ : New display name for the Microsoft 365 Group
27
30
 
28
31
  `-d, --description [description]`
29
32
  : Description for the Microsoft 365 Group
@@ -72,7 +75,7 @@ Options `allowExternalSenders` and `autoSubscribeNewMembers` can only be set usi
72
75
  Update Microsoft 365 Group display name.
73
76
 
74
77
  ```sh
75
- m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --displayName Finance
78
+ m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --newDisplayName Finance
76
79
  ```
77
80
 
78
81
  Change Microsoft 365 Group visibility to public.
@@ -81,16 +84,16 @@ Change Microsoft 365 Group visibility to public.
81
84
  m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --isPrivate `false`
82
85
  ```
83
86
 
84
- Add new Microsoft 365 Group owners.
87
+ Add new Microsoft 365 Group owners of group.
85
88
 
86
89
  ```sh
87
- m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --owners "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
90
+ m365 entra m365group set --displayName 'Project Team' --owners "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
88
91
  ```
89
92
 
90
93
  Add new Microsoft 365 Group members.
91
94
 
92
95
  ```sh
93
- m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --members "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
96
+ m365 entra m365group set --displayName 'Project Team' --members "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
94
97
  ```
95
98
 
96
99
  Update Microsoft 365 Group logo.
@@ -37,9 +37,6 @@ m365 teams user add
37
37
  `--teamName [teamName]`
38
38
  : The display name of the Microsoft Teams team. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
39
39
 
40
- `-n, --userName [userName]`
41
- : (deprecated) User's UPN (User Principal Name), e.g. johndoe@example.com.
42
-
43
40
  `--ids [ids]`
44
41
  : Microsoft Entra IDs of users. You can also pass a comma-separated list of IDs. Specify either `ids` or `userNames` but not both.
45
42
 
@@ -63,13 +63,13 @@ For more information about using these options, see the Microsoft Graph API docu
63
63
  Creates an external item with simple properties that everyone is allowed to access
64
64
 
65
65
  ```sh
66
- m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
66
+ m365 external item add --id "pnp-ensure-siteassets-library" --externalConnectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
67
67
  ```
68
68
 
69
69
  Creates an external item with multi-value properties accessible only to users from the specified Entra group
70
70
 
71
71
  ```sh
72
- m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors@odata.type "Collection(String)" --authors "Phil Harding;#Steve Smith" --acls "grant,group,Super users"
72
+ m365 external item add --id "pnp-ensure-siteassets-library" --externalConnectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors@odata.type "Collection(String)" --authors "Phil Harding;#Steve Smith" --acls "grant,group,Super users"
73
73
  ```
74
74
 
75
75
  ## Response
@@ -123,7 +123,7 @@ m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samp
123
123
  <TabItem value="Markdown">
124
124
 
125
125
  ```md
126
- # m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
126
+ # m365 external item add --id "pnp-ensure-siteassets-library" --externalConnectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
127
127
 
128
128
  Date: 2023-10-28
129
129
 
@@ -0,0 +1,79 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # file move
4
+
5
+ Moves a file to another location using the Microsoft Graph
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 file move [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
+ ## Remarks
35
+
36
+ - If the source and target locations are within the same document library or drive, the command will utilize the Move DriveItem API, preserving the version history of the file.
37
+ - If the source and target locations are in different document libraries or drives, the command will use a copy-and-delete combination to move the file. Please note that in this case, version history will not be retained.
38
+
39
+ ## Examples
40
+
41
+ Move a file by server-relative URL to a folder in the same document library
42
+
43
+ ```sh
44
+ m365 file move --webUrl "https://contoso.sharepoint.com/sites/project" --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/project/Shared Documents/NewFolder"
45
+ ```
46
+
47
+ Move a file by server-relative URL to a document library in another site collection with server relative URL
48
+
49
+ ```sh
50
+ m365 file move --webUrl "https://contoso.sharepoint.com/sites/project" --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents"
51
+ ```
52
+
53
+ Move a file by absolute URL to a document library in another site collection with absolute URL
54
+
55
+ ```sh
56
+ m365 file move --webUrl "https://contoso.sharepoint.com" --sourceUrl "https://contoso.sharepoint.com/Shared Documents/Document.pdf" --targetUrl "https://contoso.sharepoint.com/sites/IT/Shared Documents"
57
+ ```
58
+
59
+ Move a file to a document library in another site collection and rename the file
60
+
61
+ ```sh
62
+ m365 file move --webUrl "https://contoso.sharepoint.com" --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --newName "newName"
63
+ ```
64
+
65
+ Move a file to a document library in another site collection and rename the file if a file with the same name already exists.
66
+
67
+ ```sh
68
+ m365 file move --webUrl "https://contoso.sharepoint.com" --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --nameConflictBehavior rename
69
+ ```
70
+
71
+ Move a file to Onedrive for business
72
+
73
+ ```sh
74
+ m365 file move --webUrl "https://contoso.sharepoint.com" --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/documents"
75
+ ```
76
+
77
+ ## Response
78
+
79
+ The command won't return a response on success.
@@ -0,0 +1,132 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # flow recyclebinitem list
6
+
7
+ Lists all soft-deleted Power Automate flows within an environment
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 flow recyclebinitem list [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-e, --environmentName <environmentName>`
19
+ : The name of the environment.
20
+ ```
21
+
22
+ <Global />
23
+
24
+ ## Remarks
25
+
26
+ :::warning
27
+
28
+ This command is based on an API that is currently in preview and is subject to change once the API reaches general availability.
29
+
30
+ :::
31
+
32
+ :::info
33
+
34
+ To use this command, you must be a Global or Power Platform administrator.
35
+
36
+ :::
37
+
38
+ A Power Automate flow is soft-deleted when:
39
+ - It's a non-solution flow.
40
+ - It's been deleted less than 21 days ago.
41
+
42
+ If the environment with the name you specified doesn't exist, you will get the `Access to the environment 'xyz' is denied.` error.
43
+
44
+ ## Examples
45
+
46
+ List all soft-deleted flows within a specific environment
47
+
48
+ ```sh
49
+ m365 flow recyclebinitem list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
50
+ ```
51
+
52
+ ## Response
53
+
54
+ <Tabs>
55
+ <TabItem value="JSON">
56
+
57
+ ```json
58
+ [
59
+ {
60
+ "name": "26a9a283-af42-4c09-aa3e-60c3cc166b90",
61
+ "id": "/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/26a9a283-af42-4c09-aa3e-60c3cc166b90",
62
+ "type": "Microsoft.ProcessSimple/environments/flows",
63
+ "properties": {
64
+ "apiId": "/providers/Microsoft.PowerApps/apis/shared_logicflows",
65
+ "displayName": "Invoicing flow",
66
+ "state": "Deleted",
67
+ "createdTime": "2024-08-05T23:13:54Z",
68
+ "lastModifiedTime": "2024-08-05T23:14:00Z",
69
+ "flowSuspensionReason": "None",
70
+ "environment": {
71
+ "name": "Default-d87a7535-dd31-4437-bfe1-95340acd55c5",
72
+ "type": "Microsoft.ProcessSimple/environments",
73
+ "id": "/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5"
74
+ },
75
+ "definitionSummary": {
76
+ "triggers": [],
77
+ "actions": []
78
+ },
79
+ "creator": {
80
+ "tenantId": "a16e76a1-837f-4bf9-82dc-78874d18e434",
81
+ "objectId": "bd51c64d-c262-4184-ba3f-5361ea553820",
82
+ "userId": "bd51c64d-c262-4184-ba3f-5361ea553820",
83
+ "userType": "ActiveDirectory"
84
+ },
85
+ "flowFailureAlertSubscribed": false,
86
+ "isManaged": false,
87
+ "machineDescriptionData": {},
88
+ "flowOpenAiData": {
89
+ "isConsequential": false,
90
+ "isConsequentialFlagOverwritten": false
91
+ }
92
+ }
93
+ }
94
+ ]
95
+ ```
96
+
97
+ </TabItem>
98
+ <TabItem value="Text">
99
+
100
+ ```text
101
+ name displayName
102
+ ------------------------------------ --------------
103
+ 26a9a283-af42-4c09-aa3e-60c3cc166b90 Invoicing flow
104
+ ```
105
+
106
+ </TabItem>
107
+ <TabItem value="CSV">
108
+
109
+ ```csv
110
+ name,id,type
111
+ 26a9a283-af42-4c09-aa3e-60c3cc166b90,/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/26a9a283-af42-4c09-aa3e-60c3cc166b90,Microsoft.ProcessSimple/environments/flows
112
+ ```
113
+
114
+ </TabItem>
115
+ <TabItem value="Markdown">
116
+
117
+ ```md
118
+ # flow recyclebinitem list --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5"
119
+
120
+ Date: 06/08/2024
121
+
122
+ ## 26a9a283-af42-4c09-aa3e-60c3cc166b90 (/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/26a9a283-af42-4c09-aa3e-60c3cc166b90)
123
+
124
+ Property | Value
125
+ ---------|-------
126
+ name | 26a9a283-af42-4c09-aa3e-60c3cc166b90
127
+ id | /providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/26a9a283-af42-4c09-aa3e-60c3cc166b90
128
+ type | Microsoft.ProcessSimple/environments/flows
129
+ ```
130
+
131
+ </TabItem>
132
+ </Tabs>
@@ -0,0 +1,55 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # flow recyclebinitem restore
6
+
7
+ Restores a soft-deleted Power Automate flow
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 flow recyclebinitem restore [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-e, --environmentName <environmentName>`
19
+ : The name of the environment where the flow is located.
20
+
21
+ `-n, --flowName <flowName>`
22
+ : The name of the Power Automate flow.
23
+ ```
24
+
25
+ <Global />
26
+
27
+ ## Remarks
28
+
29
+ :::warning
30
+
31
+ This command is based on an API that is currently in preview and is subject to change once the API reaches general availability.
32
+
33
+ :::
34
+
35
+ :::info
36
+
37
+ To use this command, you must be a Global or Power Platform administrator.
38
+
39
+ :::
40
+
41
+ When a Power Automate flow is restored, it will be automatically disabled. To make it operational again, you must [enable](../flow-enable.mdx) it.
42
+
43
+ If the environment with the name you specified doesn't exist, you will get the `Access to the environment 'xyz' is denied.` error.
44
+
45
+ ## Examples
46
+
47
+ Restores a soft-deleted flow within a specific environment
48
+
49
+ ```sh
50
+ m365 flow recyclebinitem restore --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a
51
+ ```
52
+
53
+ ## Response
54
+
55
+ The command won't return a response on success.
@@ -18,6 +18,9 @@ m365 setup [options]
18
18
 
19
19
  `--scripting`
20
20
  : Configure CLI for Microsoft 365 for use in scripts without prompting for additional information.
21
+
22
+ `--skipApp`
23
+ : Skip configuring an Entra app for use with CLI for Microsoft 365.
21
24
  ```
22
25
 
23
26
  <Global />
@@ -28,9 +31,13 @@ The `m365 setup` command is a wizard that helps you configure the CLI for Micros
28
31
 
29
32
  The command will ask you the following questions:
30
33
 
34
+ - _CLI for Microsoft 365 requires a Microsoft Entra app. Do you want to create a new app registration or use an existing one?_
35
+
36
+ You can choose between using an existing Entra app or creating a new one. If you choose to create a new app, the CLI will ask you to choose between a minimal and a full set of permissions. It then signs in as Azure CLI to your tenant, creates a new app registration, and stores its information in the CLI configuration.
37
+
31
38
  - _How do you plan to use the CLI?_
32
39
 
33
- You can choose between **interactive** and **scripting** use. In interactive mode, the CLI for Microsoft 365 will prompt you for additional information when needed, automatically open links browser, automatically show help on errors and show spinners. In **scripting** mode, the CLI will not use interactivity to prevent blocking your scripts.
40
+ You can choose between **interactive** and **scripting** use. In interactive mode, the CLI for Microsoft 365 will prompt you for additional information when needed, automatically open links browser, automatically show help on errors. In **scripting** mode, the CLI will not use interactivity to prevent blocking your scripts.
34
41
 
35
42
  - _Are you going to use the CLI in PowerShell?_ (asked only when you chose to configure CLI for scripting)
36
43
 
@@ -53,7 +60,6 @@ The `m365 setup` command uses the following presets:
53
60
  - printErrorsAsPlainText: true,
54
61
  - prompt: true,
55
62
  - showHelpOnFailure: true,
56
- - showSpinner: true
57
63
  - scripting use:
58
64
  - autoOpenLinksInBrowser: false,
59
65
  - copyDeviceCodeToClipboard: false,
@@ -61,7 +67,6 @@ The `m365 setup` command uses the following presets:
61
67
  - printErrorsAsPlainText: false,
62
68
  - prompt: false,
63
69
  - showHelpOnFailure: false,
64
- - showSpinner: false
65
70
  - use in PowerShell:
66
71
  - errorOutput: 'stdout'
67
72
  - beginner:
@@ -71,24 +76,30 @@ The `m365 setup` command uses the following presets:
71
76
 
72
77
  ## Examples
73
78
 
74
- Configure CLI for Microsoft based on your preferences interactively
79
+ Configure CLI for Microsoft 365 based on your preferences interactively
75
80
 
76
81
  ```sh
77
82
  m365 setup
78
83
  ```
79
84
 
80
- Configure CLI for Microsoft for interactive use without prompting for additional information
85
+ Configure CLI for Microsoft 365 for interactive use without prompting for additional information
81
86
 
82
87
  ```sh
83
88
  m365 setup --interactive
84
89
  ```
85
90
 
86
- Configure CLI for Microsoft for use in scripts without prompting for additional information
91
+ Configure CLI for Microsoft 365 for use in scripts without prompting for additional information
87
92
 
88
93
  ```sh
89
94
  m365 setup --scripting
90
95
  ```
91
96
 
97
+ Configure CLI for Microsoft 365 without setting up an Entra app
98
+
99
+ ```sh
100
+ m365 setup --skipApp
101
+ ```
102
+
92
103
  ## Response
93
104
 
94
105
  The command won't return a response on success.
@@ -27,7 +27,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
27
27
 
28
28
  :::info
29
29
 
30
- To use this command you have to have permissions to access the tenant admin site.
30
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
31
31
 
32
32
  :::
33
33
 
@@ -28,7 +28,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
28
28
 
29
29
  :::info
30
30
 
31
- To use this command you have to have permissions to access the tenant admin site.
31
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
32
32
 
33
33
  :::
34
34
 
@@ -27,7 +27,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
27
27
 
28
28
  :::info
29
29
 
30
- To use this command you have to have permissions to access the tenant admin site.
30
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
31
31
 
32
32
  :::
33
33
 
@@ -31,7 +31,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
31
31
 
32
32
  :::info
33
33
 
34
- To use this command you have to have permissions to access the tenant admin site.
34
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
35
35
 
36
36
  :::
37
37
 
@@ -27,7 +27,7 @@ Using the `-t, --cdnType` option you can choose whether you want to manage the s
27
27
 
28
28
  :::info
29
29
 
30
- To use this command you have to have permissions to access the tenant admin site.
30
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
31
31
 
32
32
  :::
33
33
 
@@ -31,7 +31,7 @@ Using the `-t, --cdnType` option you can choose whether you want to manage the s
31
31
 
32
32
  :::info
33
33
 
34
- To use this command you have to have permissions to access the tenant admin site.
34
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
35
35
 
36
36
  :::
37
37
 
@@ -25,10 +25,10 @@ m365 spo contenttype field remove [options]
25
25
  `--listUrl [listUrl]`
26
26
  : Server- or site-relative URL of the list (if it is a list content type). Specify either `listTitle`, `listId` or `listUrl`.
27
27
 
28
- `-i, --contentTypeId <contentTypeId>`
28
+ `--contentTypeId <contentTypeId>`
29
29
  : The ID of the content type to remove the column from.
30
30
 
31
- `--fieldLinkId <fieldLinkId>`
31
+ `-i, --id <id>`
32
32
  : The ID of the column to remove.
33
33
 
34
34
  `-c, --updateChildContentTypes`
@@ -45,31 +45,31 @@ m365 spo contenttype field remove [options]
45
45
  Remove column with a specific ID from a content type with a specific ID from a specific site.
46
46
 
47
47
  ```sh
48
- m365 spo contenttype field remove --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A6" --fieldLinkId "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --force
48
+ m365 spo contenttype field remove --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A6" --id "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --force
49
49
  ```
50
50
 
51
51
  Remove column with a specific ID from a content type with a specific ID from a specific site and updating the child content types.
52
52
 
53
53
  ```sh
54
- m365 spo contenttype field remove --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A6" --fieldLinkId "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --updateChildContentTypes
54
+ m365 spo contenttype field remove --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A6" --id "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --updateChildContentTypes
55
55
  ```
56
56
 
57
57
  Remove fieldLink with a specific ID from a list (obtained by Title) content type with a specific ID on a specific site.
58
58
 
59
59
  ```sh
60
- m365 spo contenttype field remove --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A60062F089A38C867747942DB2C3FC50FF6A" --fieldLinkId "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --listTitle "Documents"
60
+ m365 spo contenttype field remove --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A60062F089A38C867747942DB2C3FC50FF6A" --id "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --listTitle "Documents"
61
61
  ```
62
62
 
63
63
  Remove fieldLink with a specific ID from a list (obtained by ID) content type with a specific ID on a specific site.
64
64
 
65
65
  ```sh
66
- m365 spo contenttype field remove --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A60062F089A38C867747942DB2C3FC50FF6A" --fieldLinkId "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --listId "8c7a0fcd-9d64-4634-85ea-ce2b37b2ec0c"
66
+ m365 spo contenttype field remove --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A60062F089A38C867747942DB2C3FC50FF6A" --id "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --listId "8c7a0fcd-9d64-4634-85ea-ce2b37b2ec0c"
67
67
  ```
68
68
 
69
69
  Remove fieldLink with a specific ID from a list (obtained by URL) content type with a specific ID on a specific site.
70
70
 
71
71
  ```sh
72
- m365 spo contenttype field remove --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A60062F089A38C867747942DB2C3FC50FF6A" --fieldLinkId "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --listUrl "/shared documents"
72
+ m365 spo contenttype field remove --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A60062F089A38C867747942DB2C3FC50FF6A" --id "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --listUrl "/shared documents"
73
73
  ```
74
74
 
75
75
  ## Response