@pnp/cli-microsoft365 10.0.0-beta.787c5f1 → 10.0.0-beta.7be7794

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 (125) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/Auth.js +6 -4
  4. package/dist/AuthServer.js +7 -7
  5. package/dist/api.js +1 -1
  6. package/dist/config.js +1 -0
  7. package/dist/m365/cli/commands/cli-doctor.js +2 -2
  8. package/dist/m365/cli/commands.js +1 -2
  9. package/dist/m365/commands/login.js +120 -67
  10. package/dist/m365/entra/commands/group/{group-user-add.js → group-member-add.js} +18 -18
  11. package/dist/m365/entra/commands/group/{group-user-list.js → group-member-list.js} +17 -17
  12. package/dist/m365/entra/commands/group/{group-user-set.js → group-member-set.js} +19 -19
  13. package/dist/m365/entra/commands/m365group/m365group-set.js +159 -81
  14. package/dist/m365/entra/commands/m365group/m365group-user-add.js +5 -12
  15. package/dist/m365/entra/commands/oauth2grant/oauth2grant-list.js +3 -12
  16. package/dist/m365/entra/commands.js +3 -3
  17. package/dist/m365/external/commands/item/item-add.js +2 -5
  18. package/dist/m365/file/commands/file-move.js +135 -0
  19. package/dist/m365/file/commands.js +2 -1
  20. package/dist/m365/flow/commands/environment/environment-list.js +1 -1
  21. package/dist/m365/pa/commands/app/app-list.js +1 -6
  22. package/dist/m365/pa/commands/connector/connector-list.js +1 -6
  23. package/dist/m365/pa/commands/environment/environment-list.js +1 -1
  24. package/dist/m365/pp/commands/environment/environment-list.js +1 -1
  25. package/dist/m365/spfx/commands/project/project-doctor/doctor-1.20.0.js +27 -0
  26. package/dist/m365/spfx/commands/project/project-doctor/rules/FN002021_DEVDEP_rushstack_eslint_config.js +10 -0
  27. package/dist/m365/spfx/commands/project/project-doctor.js +2 -1
  28. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.20.0.js +59 -0
  29. package/dist/m365/spfx/commands/project/project-upgrade.js +2 -1
  30. package/dist/m365/spfx/commands/spfx-doctor.js +15 -0
  31. package/dist/m365/spo/commands/app/app-instance-list.js +3 -18
  32. package/dist/m365/spo/commands/app/app-list.js +1 -8
  33. package/dist/m365/spo/commands/feature/feature-list.js +1 -8
  34. package/dist/m365/spo/commands/file/file-copy.js +5 -1
  35. package/dist/m365/spo/commands/file/file-move.js +55 -33
  36. package/dist/m365/spo/commands/list/list-webhook-list.js +1 -6
  37. package/dist/m365/spo/commands/listitem/listitem-attachment-list.js +1 -8
  38. package/dist/m365/spo/commands/page/page-list.js +1 -1
  39. package/dist/m365/spo/commands/page/page-remove.js +37 -16
  40. package/dist/m365/spo/commands/page/page-template-list.js +1 -3
  41. package/dist/m365/spo/commands/site/site-admin-list.js +8 -9
  42. package/dist/m365/spo/commands/site/site-admin-remove.js +194 -0
  43. package/dist/m365/spo/commands/site/site-sharingpermission-set.js +68 -0
  44. package/dist/m365/spo/commands/sitescript/sitescript-get.js +3 -2
  45. package/dist/m365/spo/commands/sitescript/sitescript-list.js +1 -3
  46. package/dist/m365/spo/commands/{site/site-rename.js → tenant/tenant-site-rename.js} +29 -32
  47. package/dist/m365/spo/commands/theme/theme-list.js +1 -1
  48. package/dist/m365/spo/commands/web/web-clientsidewebpart-list.js +1 -6
  49. package/dist/m365/spo/commands.js +3 -1
  50. package/dist/m365/teams/MeetingTranscript.js +2 -0
  51. package/dist/m365/teams/commands/meeting/meeting-transcript-get.js +152 -0
  52. package/dist/m365/teams/commands/tab/tab-list.js +5 -3
  53. package/dist/m365/teams/commands.js +1 -0
  54. package/dist/m365/viva/commands/engage/Community.js +2 -0
  55. package/dist/m365/viva/commands/engage/engage-community-list.js +28 -0
  56. package/dist/m365/viva/commands.js +1 -0
  57. package/dist/request.js +46 -61
  58. package/dist/utils/driveUtil.js +51 -0
  59. package/dist/utils/spo.js +8 -8
  60. package/dist/utils/timersUtil.js +12 -0
  61. package/dist/utils/urlUtil.js +8 -0
  62. package/docs/docs/cmd/cli/cli-doctor.mdx +24 -23
  63. package/docs/docs/cmd/entra/group/group-member-add.mdx +62 -0
  64. package/docs/docs/cmd/entra/group/{group-user-list.mdx → group-member-list.mdx} +14 -14
  65. package/docs/docs/cmd/entra/group/group-member-set.mdx +62 -0
  66. package/docs/docs/cmd/entra/m365group/m365group-report-activitystorage.mdx +2 -2
  67. package/docs/docs/cmd/entra/m365group/m365group-set.mdx +37 -16
  68. package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx +0 -3
  69. package/docs/docs/cmd/external/item/item-add.mdx +3 -3
  70. package/docs/docs/cmd/file/file-move.mdx +79 -0
  71. package/docs/docs/cmd/login.mdx +9 -0
  72. package/docs/docs/cmd/spfx/project/project-upgrade.mdx +1 -1
  73. package/docs/docs/cmd/spo/cdn/cdn-get.mdx +1 -1
  74. package/docs/docs/cmd/spo/cdn/cdn-origin-add.mdx +1 -1
  75. package/docs/docs/cmd/spo/cdn/cdn-origin-list.mdx +1 -1
  76. package/docs/docs/cmd/spo/cdn/cdn-origin-remove.mdx +1 -1
  77. package/docs/docs/cmd/spo/cdn/cdn-policy-list.mdx +1 -1
  78. package/docs/docs/cmd/spo/cdn/cdn-policy-set.mdx +1 -1
  79. package/docs/docs/cmd/spo/externaluser/externaluser-list.mdx +1 -1
  80. package/docs/docs/cmd/spo/file/file-move.mdx +116 -9
  81. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-get.mdx +1 -1
  82. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-set.mdx +1 -1
  83. package/docs/docs/cmd/spo/homesite/homesite-remove.mdx +1 -1
  84. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-get.mdx +1 -1
  85. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-remove.mdx +1 -1
  86. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-set.mdx +1 -1
  87. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-add.mdx +1 -1
  88. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-list.mdx +1 -1
  89. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-remove.mdx +1 -1
  90. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-list.mdx +1 -1
  91. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-remove.mdx +1 -1
  92. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-set.mdx +1 -1
  93. package/docs/docs/cmd/spo/page/page-remove.mdx +30 -12
  94. package/docs/docs/cmd/spo/site/site-admin-add.mdx +2 -2
  95. package/docs/docs/cmd/spo/site/site-admin-list.mdx +64 -12
  96. package/docs/docs/cmd/spo/site/site-admin-remove.mdx +67 -0
  97. package/docs/docs/cmd/spo/site/site-appcatalog-add.mdx +1 -1
  98. package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx +1 -1
  99. package/docs/docs/cmd/spo/site/site-commsite-enable.mdx +1 -1
  100. package/docs/docs/cmd/spo/site/site-list.mdx +6 -4
  101. package/docs/docs/cmd/spo/site/site-set.mdx +1 -1
  102. package/docs/docs/cmd/spo/site/site-sharingpermission-set.mdx +58 -0
  103. package/docs/docs/cmd/spo/sitescript/sitescript-get.mdx +14 -1
  104. package/docs/docs/cmd/spo/storageentity/storageentity-remove.mdx +1 -1
  105. package/docs/docs/cmd/spo/storageentity/storageentity-set.mdx +1 -1
  106. package/docs/docs/cmd/spo/tenant/tenant-appcatalog-add.mdx +1 -1
  107. package/docs/docs/cmd/spo/tenant/tenant-appcatalogurl-get.mdx +1 -1
  108. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-list.mdx +1 -1
  109. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-remove.mdx +1 -1
  110. package/docs/docs/cmd/spo/tenant/tenant-settings-list.mdx +1 -1
  111. package/docs/docs/cmd/spo/{site/site-rename.mdx → tenant/tenant-site-rename.mdx} +7 -7
  112. package/docs/docs/cmd/spo/theme/theme-apply.mdx +1 -1
  113. package/docs/docs/cmd/spo/theme/theme-get.mdx +1 -1
  114. package/docs/docs/cmd/spo/theme/theme-list.mdx +1 -1
  115. package/docs/docs/cmd/spo/theme/theme-remove.mdx +1 -1
  116. package/docs/docs/cmd/spo/theme/theme-set.mdx +1 -1
  117. package/docs/docs/cmd/spp/contentcenter/contentcenter-list.mdx +3 -5
  118. package/docs/docs/cmd/teams/meeting/meeting-transcript-get.mdx +132 -0
  119. package/docs/docs/cmd/teams/tab/tab-list.mdx +1 -2
  120. package/docs/docs/cmd/viva/engage/engage-community-list.mdx +81 -0
  121. package/package.json +1 -1
  122. package/dist/m365/cli/commands/cli-reconsent.js +0 -29
  123. package/docs/docs/cmd/cli/cli-reconsent.mdx +0 -62
  124. package/docs/docs/cmd/entra/group/group-user-add.mdx +0 -62
  125. package/docs/docs/cmd/entra/group/group-user-set.mdx +0 -62
@@ -19,26 +19,35 @@ m365 aad m365group set [options]
19
19
  ## Options
20
20
 
21
21
  ```md definition-list
22
- `-i, --id <id>`
23
- : The ID of the Microsoft 365 Group to update
22
+ `-i, --id [id]`
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
- : Description for the Microsoft 365 Group
32
+ : Description for the Microsoft 365 Group.
33
+
34
+ `--ownerIds [ownerIds]`
35
+ : Comma-separated list of IDs of Microsoft Entra ID users that will be group owners. Specify either `ownerIds` or `ownerUserNames`, but not both.
36
+
37
+ `--ownerUserNames [ownerUserNames]`
38
+ : Comma-separated list of UPNs of Microsoft Entra ID users that will be group owners. Specify either `ownerIds` or `ownerUserNames`, but not both.
30
39
 
31
- `--owners [owners]`
32
- : Comma-separated list of Microsoft 365 Group owners to add
40
+ `--memberIds [memberIds]`
41
+ : Comma-separated list of IDs of Microsoft Entra ID users that will be group members. Specify either `memberIds` or `memberUserNames`, but not both.
33
42
 
34
- `--members [members]`
35
- : Comma-separated list of Microsoft 365 Group members to add
43
+ `--memberUserNames [memberUserNames]`
44
+ : Comma-separated list of UPNs of Microsoft Entra ID users that will be group members. Specify either `memberIds` or `memberUserNames`, but not both.
36
45
 
37
46
  `--isPrivate [isPrivate]`
38
47
  : Set to `true` if the Microsoft 365 Group should be private and `false` if it should be public.
39
48
 
40
49
  `-l, --logoPath [logoPath]`
41
- : Local path to the image file to use as group logo
50
+ : Local path to the image file to use as group logo.
42
51
 
43
52
  `--allowExternalSenders [allowExternalSenders]`
44
53
  : Indicates if people external to the organization can send messages to the group. Valid values: `true`, `false`.
@@ -57,7 +66,7 @@ m365 aad m365group set [options]
57
66
 
58
67
  ## Remarks
59
68
 
60
- When updating group's owners and members, the command will add newly specified users to the previously set owners and members. The previously set users will not be replaced.
69
+ When updating group's owners and members, the command will remove existing owners/members from the group, and the specified users will be added.
61
70
 
62
71
  When specifying the path to the logo image you can use both relative and absolute paths. Note, that ~ in the path, will not be resolved and will most likely result in an error.
63
72
 
@@ -72,7 +81,7 @@ Options `allowExternalSenders` and `autoSubscribeNewMembers` can only be set usi
72
81
  Update Microsoft 365 Group display name.
73
82
 
74
83
  ```sh
75
- m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --displayName Finance
84
+ m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --newDisplayName Finance
76
85
  ```
77
86
 
78
87
  Change Microsoft 365 Group visibility to public.
@@ -81,16 +90,28 @@ Change Microsoft 365 Group visibility to public.
81
90
  m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --isPrivate `false`
82
91
  ```
83
92
 
84
- Add new Microsoft 365 Group owners.
93
+ Updates the list of Microsoft 365 Group owners with a list of users by UPN.
94
+
95
+ ```sh
96
+ m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --ownerUserNames "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
97
+ ```
98
+
99
+ Updates the list of Microsoft 365 Group owners with a list of users by ID.
100
+
101
+ ```sh
102
+ m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --ownerIds "3527dada-9368-4cdd-a958-5460f5658e0e,e94b2cb8-7c9a-4651-b1af-207d81a010b6"
103
+ ```
104
+
105
+ Updates the list of Microsoft 365 Group members with a list of users by UPN.
85
106
 
86
107
  ```sh
87
- m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --owners "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
108
+ m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --memberUserNames "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
88
109
  ```
89
110
 
90
- Add new Microsoft 365 Group members.
111
+ Updates the list of Microsoft 365 Group members with a list of users by ID.
91
112
 
92
113
  ```sh
93
- m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --members "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
114
+ m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --memberIds "3527dada-9368-4cdd-a958-5460f5658e0e,e94b2cb8-7c9a-4651-b1af-207d81a010b6"
94
115
  ```
95
116
 
96
117
  Update Microsoft 365 Group logo.
@@ -113,4 +134,4 @@ m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --autoSubscri
113
134
 
114
135
  ## Response
115
136
 
116
- The command won't return a response on success.
137
+ The command won't return a response on success.
@@ -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.
@@ -47,6 +47,9 @@ m365 login [options]
47
47
 
48
48
  `--connectionName [connectionName]`
49
49
  : Specify an optional name to make switching between connections easier.
50
+
51
+ `--ensure`
52
+ : Ensures that the user is signed in. if the user isn't signed in, it initiates the login flow
50
53
  ```
51
54
 
52
55
  <Global />
@@ -190,6 +193,12 @@ Log in to Microsoft 365 using a client secret.
190
193
  m365 login --authType secret --secret topSeCr3t@007
191
194
  ```
192
195
 
196
+ Ensures that the user is signed in, initiates the login flow if the user isn't signed in
197
+
198
+ ```sh
199
+ m365 login --ensure
200
+ ```
201
+
193
202
  ## Response
194
203
 
195
204
  <Tabs>
@@ -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
 
@@ -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.
@@ -20,7 +20,7 @@ m365 spo hidedefaultthemes get [options]
20
20
 
21
21
  :::info
22
22
 
23
- To use this command you have to have permissions to access the tenant admin site.
23
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
24
24
 
25
25
  :::
26
26
 
@@ -23,7 +23,7 @@ m365 spo hidedefaultthemes set [options]
23
23
 
24
24
  :::info
25
25
 
26
- To use this command you have to have permissions to access the tenant admin site.
26
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
27
27
 
28
28
  :::
29
29
 
@@ -25,7 +25,7 @@ m365 spo homesite remove [options]
25
25
 
26
26
  :::info
27
27
 
28
- To use this command you have to have permissions to access the tenant admin site.
28
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
29
29
 
30
30
  :::
31
31
 
@@ -20,7 +20,7 @@ m365 spo knowledgehub get [options]
20
20
 
21
21
  :::info
22
22
 
23
- To use this command you have to have permissions to access the tenant admin site.
23
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
24
24
 
25
25
  :::
26
26
 
@@ -25,7 +25,7 @@ m365 spo knowledgehub remove [options]
25
25
 
26
26
  :::info
27
27
 
28
- To use this command you have to have permissions to access the tenant admin site.
28
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
29
29
 
30
30
  :::
31
31
 
@@ -27,7 +27,7 @@ If the specified url doesn't refer to an existing site collection, you will get
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
 
@@ -32,7 +32,7 @@ m365 spo orgassetslibrary add [options]
32
32
 
33
33
  :::info
34
34
 
35
- To use this command you have to have permissions to access the tenant admin site.
35
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
36
36
 
37
37
  :::
38
38
 
@@ -20,7 +20,7 @@ m365 spo orgassetslibrary list [options]
20
20
 
21
21
  :::info
22
22
 
23
- To use this command you have to have permissions to access the tenant admin site.
23
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
24
24
 
25
25
  :::
26
26
 
@@ -28,7 +28,7 @@ m365 spo orgassetslibrary remove [options]
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
 
@@ -20,7 +20,7 @@ m365 spo orgnewssite list [options]
20
20
 
21
21
  :::info
22
22
 
23
- To use this command you have to have permissions to access the tenant admin site.
23
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
24
24
 
25
25
  :::
26
26
 
@@ -26,7 +26,7 @@ m365 spo orgnewssite remove [options]
26
26
 
27
27
  :::info
28
28
 
29
- To use this command you have to have permissions to access the tenant admin site.
29
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
30
30
 
31
31
  :::
32
32
 
@@ -25,7 +25,7 @@ Using the `-u, --url` option you can specify which site to add to the list of or
25
25
 
26
26
  :::info
27
27
 
28
- To use this command you have to have permissions to access the tenant admin site.
28
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
29
29
 
30
30
  :::
31
31