@pnp/cli-microsoft365 10.0.0-beta.7dfc31a → 10.0.0-beta.a0367997

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 (173) 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.js +27 -0
  49. package/dist/m365/spfx/commands/project/project-doctor/rules/FN002021_DEVDEP_rushstack_eslint_config.js +10 -0
  50. package/dist/m365/spfx/commands/project/project-doctor.js +2 -1
  51. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.20.0.js +59 -0
  52. package/dist/m365/spfx/commands/project/project-upgrade.js +2 -1
  53. package/dist/m365/spfx/commands/spfx-doctor.js +15 -0
  54. package/dist/m365/spo/commands/app/app-instance-list.js +3 -18
  55. package/dist/m365/spo/commands/app/app-list.js +1 -8
  56. package/dist/m365/spo/commands/contenttype/contenttype-field-remove.js +8 -8
  57. package/dist/m365/spo/commands/contenttype/contenttype-field-set.js +2 -2
  58. package/dist/m365/spo/commands/feature/feature-list.js +1 -8
  59. package/dist/m365/spo/commands/file/file-copy.js +5 -1
  60. package/dist/m365/spo/commands/file/file-move.js +55 -33
  61. package/dist/m365/spo/commands/file/file-roleassignment-add.js +17 -54
  62. package/dist/m365/spo/commands/file/file-roleassignment-remove.js +13 -40
  63. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +5 -13
  64. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +5 -13
  65. package/dist/m365/spo/commands/folder/folder-sharinglink-add.js +143 -0
  66. package/dist/m365/spo/commands/folder/folder-sharinglink-clear.js +111 -0
  67. package/dist/m365/spo/commands/folder/folder-sharinglink-remove.js +95 -0
  68. package/dist/m365/spo/commands/list/list-get.js +17 -4
  69. package/dist/m365/spo/commands/list/list-webhook-list.js +1 -6
  70. package/dist/m365/spo/commands/listitem/listitem-attachment-list.js +1 -8
  71. package/dist/m365/spo/commands/page/page-list.js +1 -1
  72. package/dist/m365/spo/commands/page/page-remove.js +37 -16
  73. package/dist/m365/spo/commands/page/page-section-add.js +185 -34
  74. package/dist/m365/spo/commands/page/page-template-list.js +1 -3
  75. package/dist/m365/spo/commands/site/SiteAdmin.js +2 -0
  76. package/dist/m365/spo/commands/site/site-admin-add.js +252 -0
  77. package/dist/m365/spo/commands/site/site-admin-list.js +10 -36
  78. package/dist/m365/spo/commands/site/site-admin-remove.js +194 -0
  79. package/dist/m365/spo/commands/site/site-sharingpermission-set.js +68 -0
  80. package/dist/m365/spo/commands/sitescript/sitescript-get.js +3 -2
  81. package/dist/m365/spo/commands/sitescript/sitescript-list.js +1 -3
  82. package/dist/m365/spo/commands/{site/site-rename.js → tenant/tenant-site-rename.js} +29 -32
  83. package/dist/m365/spo/commands/theme/theme-list.js +1 -1
  84. package/dist/m365/spo/commands/user/user-get.js +67 -9
  85. package/dist/m365/spo/commands/web/web-clientsidewebpart-list.js +1 -6
  86. package/dist/m365/spo/commands.js +7 -1
  87. package/dist/m365/spp/commands/contentcenter/contentcenter-list.js +56 -0
  88. package/dist/m365/spp/commands.js +5 -0
  89. package/dist/m365/teams/MeetingTranscript.js +2 -0
  90. package/dist/m365/teams/commands/meeting/meeting-transcript-get.js +152 -0
  91. package/dist/m365/teams/commands/tab/tab-list.js +5 -3
  92. package/dist/m365/teams/commands.js +1 -0
  93. package/dist/m365/viva/commands/engage/Community.js +2 -0
  94. package/dist/m365/viva/commands/engage/engage-community-list.js +28 -0
  95. package/dist/m365/viva/commands.js +1 -0
  96. package/dist/request.js +46 -61
  97. package/dist/settingsNames.js +6 -1
  98. package/dist/utils/driveUtil.js +51 -0
  99. package/dist/utils/entraApp.js +283 -0
  100. package/dist/utils/spo.js +76 -8
  101. package/dist/utils/timersUtil.js +12 -0
  102. package/dist/utils/urlUtil.js +8 -0
  103. package/dist/utils/zod.js +1 -1
  104. package/docs/docs/_clisettings.mdx +6 -1
  105. package/docs/docs/cmd/cli/cli-doctor.mdx +24 -23
  106. package/docs/docs/cmd/entra/m365group/m365group-report-activitystorage.mdx +2 -2
  107. package/docs/docs/cmd/entra/m365group/m365group-set.mdx +9 -6
  108. package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx +0 -3
  109. package/docs/docs/cmd/external/item/item-add.mdx +3 -3
  110. package/docs/docs/cmd/file/file-move.mdx +79 -0
  111. package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-list.mdx +132 -0
  112. package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-restore.mdx +55 -0
  113. package/docs/docs/cmd/setup.mdx +17 -6
  114. package/docs/docs/cmd/spfx/project/project-upgrade.mdx +1 -1
  115. package/docs/docs/cmd/spo/cdn/cdn-get.mdx +1 -1
  116. package/docs/docs/cmd/spo/cdn/cdn-origin-add.mdx +1 -1
  117. package/docs/docs/cmd/spo/cdn/cdn-origin-list.mdx +1 -1
  118. package/docs/docs/cmd/spo/cdn/cdn-origin-remove.mdx +1 -1
  119. package/docs/docs/cmd/spo/cdn/cdn-policy-list.mdx +1 -1
  120. package/docs/docs/cmd/spo/cdn/cdn-policy-set.mdx +1 -1
  121. package/docs/docs/cmd/spo/contenttype/contenttype-field-remove.mdx +7 -7
  122. package/docs/docs/cmd/spo/contenttype/contenttype-field-set.mdx +2 -2
  123. package/docs/docs/cmd/spo/externaluser/externaluser-list.mdx +1 -1
  124. package/docs/docs/cmd/spo/file/file-move.mdx +116 -9
  125. package/docs/docs/cmd/spo/folder/folder-sharinglink-add.mdx +125 -0
  126. package/docs/docs/cmd/spo/folder/folder-sharinglink-clear.mdx +50 -0
  127. package/docs/docs/cmd/spo/folder/folder-sharinglink-remove.mdx +50 -0
  128. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-get.mdx +1 -1
  129. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-set.mdx +1 -1
  130. package/docs/docs/cmd/spo/homesite/homesite-remove.mdx +1 -1
  131. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-get.mdx +1 -1
  132. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-remove.mdx +1 -1
  133. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-set.mdx +1 -1
  134. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-add.mdx +1 -1
  135. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-list.mdx +1 -1
  136. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-remove.mdx +1 -1
  137. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-list.mdx +1 -1
  138. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-remove.mdx +1 -1
  139. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-set.mdx +1 -1
  140. package/docs/docs/cmd/spo/page/page-remove.mdx +30 -12
  141. package/docs/docs/cmd/spo/page/page-section-add.mdx +57 -2
  142. package/docs/docs/cmd/spo/site/site-admin-add.mdx +67 -0
  143. package/docs/docs/cmd/spo/site/site-admin-list.mdx +64 -12
  144. package/docs/docs/cmd/spo/site/site-admin-remove.mdx +67 -0
  145. package/docs/docs/cmd/spo/site/site-appcatalog-add.mdx +1 -1
  146. package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx +1 -1
  147. package/docs/docs/cmd/spo/site/site-commsite-enable.mdx +1 -1
  148. package/docs/docs/cmd/spo/site/site-list.mdx +6 -4
  149. package/docs/docs/cmd/spo/site/site-set.mdx +1 -1
  150. package/docs/docs/cmd/spo/site/site-sharingpermission-set.mdx +58 -0
  151. package/docs/docs/cmd/spo/sitescript/sitescript-get.mdx +14 -1
  152. package/docs/docs/cmd/spo/storageentity/storageentity-remove.mdx +1 -1
  153. package/docs/docs/cmd/spo/storageentity/storageentity-set.mdx +1 -1
  154. package/docs/docs/cmd/spo/tenant/tenant-appcatalog-add.mdx +1 -1
  155. package/docs/docs/cmd/spo/tenant/tenant-appcatalogurl-get.mdx +1 -1
  156. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-list.mdx +1 -1
  157. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-remove.mdx +1 -1
  158. package/docs/docs/cmd/spo/tenant/tenant-settings-list.mdx +1 -1
  159. package/docs/docs/cmd/spo/{site/site-rename.mdx → tenant/tenant-site-rename.mdx} +7 -7
  160. package/docs/docs/cmd/spo/theme/theme-apply.mdx +1 -1
  161. package/docs/docs/cmd/spo/theme/theme-get.mdx +1 -1
  162. package/docs/docs/cmd/spo/theme/theme-list.mdx +1 -1
  163. package/docs/docs/cmd/spo/theme/theme-remove.mdx +1 -1
  164. package/docs/docs/cmd/spo/theme/theme-set.mdx +1 -1
  165. package/docs/docs/cmd/spo/user/user-get.mdx +35 -9
  166. package/docs/docs/cmd/spp/contentcenter/contentcenter-list.mdx +287 -0
  167. package/docs/docs/cmd/teams/meeting/meeting-transcript-get.mdx +132 -0
  168. package/docs/docs/cmd/teams/tab/tab-list.mdx +1 -2
  169. package/docs/docs/cmd/viva/engage/engage-community-list.mdx +81 -0
  170. package/npm-shrinkwrap.json +203 -375
  171. package/package.json +16 -17
  172. package/dist/m365/cli/commands/cli-reconsent.js +0 -30
  173. package/docs/docs/cmd/cli/cli-reconsent.mdx +0 -62
@@ -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.
@@ -35,7 +35,7 @@ m365 spfx project upgrade [options]
35
35
 
36
36
  ## Remarks
37
37
 
38
- The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.19.0).
38
+ The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.20.0).
39
39
 
40
40
  This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
41
41
 
@@ -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
@@ -16,10 +16,10 @@ m365 spo contenttype field set [options]
16
16
  `-u, --webUrl <webUrl>`
17
17
  : Absolute URL of the site where the content type is located.
18
18
 
19
- `-c, --contentTypeId <contentTypeId>`
19
+ `--contentTypeId <contentTypeId>`
20
20
  : ID of the content type on which the field reference should be set.
21
21
 
22
- `--id <id>`
22
+ `-i, --id <id>`
23
23
  : ID of the field to which the reference should be set.
24
24
 
25
25
  `-r, --required [required]`
@@ -37,7 +37,7 @@ m365 spo externaluser list [options]
37
37
 
38
38
  :::info
39
39
 
40
- To use this command you have to have permissions to access the tenant admin site.
40
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
41
41
 
42
42
  :::
43
43
 
@@ -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
  # spo file move
4
6
 
@@ -31,11 +33,14 @@ m365 spo file move [options]
31
33
  `--nameConflictBehavior [nameConflictBehavior]`
32
34
  : Behavior when a file or folder with the same name is already present at the destination. Allowed values: `fail`, `replace`, `rename`. Defaults to `fail`.
33
35
 
34
- `--retainEditorAndModified`
35
- : Use this option to retain the editor and modified date. When not specified, these values are reset when moving to another library.
36
+ `--includeItemPermissions`
37
+ : Ensure that item-level permissions are preserved during the move.
36
38
 
37
39
  `--bypassSharedLock`
38
40
  : This indicates whether a file with a share lock can still be moved. Use this option to move a file that is locked.
41
+
42
+ `--skipWait`
43
+ : Don't wait for the copy operation to complete.
39
44
  ```
40
45
 
41
46
  <Global />
@@ -45,7 +50,6 @@ m365 spo file move [options]
45
50
  All file versions are retained while moving a file.
46
51
 
47
52
  When you specify a value for `nameConflictBehavior`, consider the following:
48
-
49
53
  - `fail` will throw an error when the destination file already exists.
50
54
  - `replace` will replace the destination file if it already exists.
51
55
  - `rename` will add a suffix (e.g. Document1.pdf) when the destination file already exists.
@@ -70,16 +74,119 @@ Move a file to another document library and replace a file with the same name.
70
74
  m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl "/Shared Documents/Report project-x.pdf" --targetUrl "/sites/project-x/My Documents" --newName Report.pdf --nameConflictBehavior replace
71
75
  ```
72
76
 
73
- Move a file referenced by its ID to another document library and retain editor and modified date.
77
+ Move a file referenced by its ID to another document library and retain item-level permissions.
74
78
 
75
79
  ```sh
76
- m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --retainEditorAndModified
80
+ m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --includeItemPermissions
77
81
  ```
78
82
 
79
83
  ## Response
80
84
 
81
- The command won't return a response on success.
85
+ ### Standard Response
86
+
87
+ <Tabs>
88
+ <TabItem value="JSON">
89
+
90
+ ```json
91
+ {
92
+ "CheckInComment": "",
93
+ "CheckOutType": 2,
94
+ "ContentTag": "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1",
95
+ "CustomizedPageStatus": 0,
96
+ "ETag": "\"{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1\"",
97
+ "Exists": true,
98
+ "IrmEnabled": false,
99
+ "Length": "5987",
100
+ "Level": 1,
101
+ "LinkingUri": null,
102
+ "LinkingUrl": "",
103
+ "MajorVersion": 1,
104
+ "MinorVersion": 0,
105
+ "Name": "Test1.docx",
106
+ "ServerRelativeUrl": "/sites/project-x/documents/Test1.docx",
107
+ "TimeCreated": "2022-10-30T10:16:18Z",
108
+ "TimeLastModified": "2022-10-30T10:16:18Z",
109
+ "Title": null,
110
+ "UIVersion": 512,
111
+ "UIVersionLabel": "1.0",
112
+ "UniqueId": "b2307a39-e878-458b-bc90-03bc578531d6"
113
+ }
114
+ ```
115
+
116
+ </TabItem>
117
+ <TabItem value="Text">
118
+
119
+ ```text
120
+ CheckInComment :
121
+ CheckOutType : 2
122
+ ContentTag : {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
123
+ CustomizedPageStatus: 0
124
+ ETag : "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
125
+ Exists : true
126
+ IrmEnabled : false
127
+ Length : 5987
128
+ Level : 1
129
+ LinkingUri : null
130
+ LinkingUrl :
131
+ MajorVersion : 1
132
+ MinorVersion : 0
133
+ Name : Test1.docx
134
+ ServerRelativeUrl : /sites/project-x/documents/Test1.docx
135
+ TimeCreated : 2022-10-30T10:16:18Z
136
+ TimeLastModified : 2022-10-30T10:16:18Z
137
+ Title : null
138
+ UIVersion : 512
139
+ UIVersionLabel : 1.0
140
+ UniqueId : b2307a39-e878-458b-bc90-03bc578531d6
141
+ ```
142
+
143
+ </TabItem>
144
+ <TabItem value="CSV">
145
+
146
+ ```csv
147
+ CheckInComment,CheckOutType,ContentTag,CustomizedPageStatus,ETag,Exists,IrmEnabled,Length,Level,LinkingUri,LinkingUrl,MajorVersion,MinorVersion,Name,ServerRelativeUrl,TimeCreated,TimeLastModified,Title,UIVersion,UIVersionLabel,UniqueId
148
+ ,2,"{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1",0,"""{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1""",1,,5987,1,,,1,0,Test1.docx,/sites/project-x/documents/Test1.docx,2022-10-30T10:16:18Z,2022-10-30T10:16:18Z,,512,1.0,b2307a39-e878-458b-bc90-03bc578531d6
149
+ ```
150
+
151
+ </TabItem>
152
+ <TabItem value="Markdown">
153
+
154
+ ```md
155
+ # spo file move --webUrl "https://contoso.sharepoint.com/sites/IT" --sourceUrl "/Shared Documents/Document.docx" --targetUrl "/sites/project-x/Shared Documents"
156
+
157
+ Date: 10/3/2023
158
+
159
+ ## b2307a39-e878-458b-bc90-03bc578531d6
160
+
161
+ Property | Value
162
+ ---------|-------
163
+ CheckInComment |
164
+ CheckOutType | 2
165
+ ContentTag | {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
166
+ CustomizedPageStatus | 0
167
+ ETag | "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
168
+ Exists | true
169
+ ExistsAllowThrowForPolicyFailures | true
170
+ IrmEnabled | false
171
+ Length | 5987
172
+ Level | 1
173
+ LinkingUri | https://contoso.sharepoint.com/sites/project-x/shared%20documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
174
+ LinkingUrl | https://contoso.sharepoint.com/sites/project-x/shared documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
175
+ MajorVersion | 1
176
+ MinorVersion | 0
177
+ Name | Document.docx
178
+ ServerRelativeUrl | /sites/project-x/shared documents/Document.docx
179
+ TimeCreated | 2023-05-23T09:51:34Z
180
+ TimeLastModified | 2023-05-23T10:13:01Z
181
+ Title |
182
+ UIVersion | 1536
183
+ UIVersionLabel | 1.0
184
+ UniqueId | b2307a39-e878-458b-bc90-03bc578531d6
185
+ ```
186
+
187
+ </TabItem>
188
+ </Tabs>
189
+
190
+ ### `skipWait` response
82
191
 
83
- ## More information
84
-
85
- - Move items from a SharePoint document library: [https://support.office.com/en-us/article/move-or-copy-items-from-a-sharepoint-document-library-00e2f483-4df3-46be-a861-1f5f0c1a87bc](https://support.office.com/en-us/article/move-or-copy-items-from-a-sharepoint-document-library-00e2f483-4df3-46be-a861-1f5f0c1a87bc)
192
+ The command won't return a response on success.