@pnp/cli-microsoft365 6.8.0-beta.62006d7 → 6.8.0-beta.f473be5

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 (61) hide show
  1. package/.mocharc.json +1 -0
  2. package/dist/m365/spo/commands/file/file-checkin.js +8 -3
  3. package/dist/m365/spo/commands/file/file-checkout.js +8 -3
  4. package/dist/m365/spo/commands/file/file-copy.js +4 -4
  5. package/dist/m365/spo/commands/file/file-get.js +3 -1
  6. package/dist/m365/spo/commands/file/file-list.js +2 -2
  7. package/dist/m365/spo/commands/file/file-move.js +6 -7
  8. package/dist/m365/spo/commands/file/file-remove.js +3 -12
  9. package/dist/m365/spo/commands/file/file-rename.js +3 -3
  10. package/dist/m365/spo/commands/file/file-roleassignment-add.js +2 -1
  11. package/dist/m365/spo/commands/file/file-roleassignment-remove.js +3 -3
  12. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +2 -1
  13. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +2 -1
  14. package/dist/m365/spo/commands/file/file-sharinginfo-get.js +4 -2
  15. package/dist/m365/spo/commands/file/file-version-clear.js +3 -1
  16. package/dist/m365/spo/commands/file/file-version-get.js +3 -1
  17. package/dist/m365/spo/commands/file/file-version-remove.js +3 -1
  18. package/dist/m365/spo/commands/file/file-version-restore.js +3 -1
  19. package/dist/m365/spo/commands/folder/folder-copy.js +4 -4
  20. package/dist/m365/spo/commands/folder/folder-get.js +5 -2
  21. package/dist/m365/spo/commands/folder/folder-move.js +3 -2
  22. package/dist/m365/spo/commands/folder/folder-rename.js +5 -2
  23. package/dist/m365/spo/commands/serviceprincipal/serviceprincipal-permissionrequest-list.js +46 -1
  24. package/dist/utils/spo.js +1 -1
  25. package/docs/docs/cmd/spo/file/file-add.md +1 -1
  26. package/docs/docs/cmd/spo/file/file-checkin.md +1 -1
  27. package/docs/docs/cmd/spo/file/file-checkout.md +1 -1
  28. package/docs/docs/cmd/spo/file/file-copy.md +1 -1
  29. package/docs/docs/cmd/spo/file/file-get.md +1 -1
  30. package/docs/docs/cmd/spo/file/file-move.md +3 -3
  31. package/docs/docs/cmd/spo/file/file-rename.md +1 -1
  32. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.md +3 -3
  33. package/docs/docs/cmd/spo/file/file-retentionlabel-remove.md +2 -2
  34. package/docs/docs/cmd/spo/file/file-roleassignment-add.md +1 -1
  35. package/docs/docs/cmd/spo/file/file-roleassignment-remove.md +1 -1
  36. package/docs/docs/cmd/spo/file/file-roleinheritance-break.md +1 -1
  37. package/docs/docs/cmd/spo/file/file-roleinheritance-reset.md +1 -1
  38. package/docs/docs/cmd/spo/file/file-sharinginfo-get.md +1 -1
  39. package/docs/docs/cmd/spo/file/file-sharinglink-add.md +1 -1
  40. package/docs/docs/cmd/spo/file/file-sharinglink-clear.md +1 -1
  41. package/docs/docs/cmd/spo/file/file-sharinglink-get.md +1 -1
  42. package/docs/docs/cmd/spo/file/file-sharinglink-list.md +1 -1
  43. package/docs/docs/cmd/spo/file/file-sharinglink-remove.md +1 -1
  44. package/docs/docs/cmd/spo/file/file-sharinglink-set.md +1 -1
  45. package/docs/docs/cmd/spo/file/file-version-clear.md +2 -2
  46. package/docs/docs/cmd/spo/file/file-version-get.md +1 -1
  47. package/docs/docs/cmd/spo/file/file-version-list.md +1 -1
  48. package/docs/docs/cmd/spo/file/file-version-remove.md +1 -1
  49. package/docs/docs/cmd/spo/file/file-version-restore.md +1 -1
  50. package/docs/docs/cmd/spo/folder/folder-add.md +9 -3
  51. package/docs/docs/cmd/spo/folder/folder-copy.md +1 -1
  52. package/docs/docs/cmd/spo/folder/folder-get.md +7 -7
  53. package/docs/docs/cmd/spo/folder/folder-list.md +11 -11
  54. package/docs/docs/cmd/spo/folder/folder-move.md +1 -1
  55. package/docs/docs/cmd/spo/folder/folder-remove.md +7 -7
  56. package/docs/docs/cmd/spo/folder/folder-rename.md +11 -5
  57. package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.md +3 -3
  58. package/docs/docs/cmd/spo/folder/folder-retentionlabel-remove.md +1 -1
  59. package/docs/docs/cmd/spo/folder/folder-roleinheritance-break.md +1 -1
  60. package/docs/docs/cmd/spo/folder/folder-roleinheritance-reset.md +4 -4
  61. package/package.json +1 -1
@@ -14,7 +14,7 @@ m365 spo file get [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-u, --url [url]`
17
- : The server-relative URL of the file to retrieve. Specify either `url` or `id` but not both
17
+ : The server- or site-relative URL of the file to retrieve. Specify either `url` or `id` but not both
18
18
 
19
19
  `-i, --id [id]`
20
20
  : The UniqueId (GUID) of the file to retrieve. Specify either `url` or `id` but not both
@@ -14,7 +14,7 @@ m365 spo file move [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-s, --sourceUrl <sourceUrl>`
17
- : Site-relative URL of the file to move
17
+ : The server- or site-relative URL of the file to move
18
18
 
19
19
  `-t, --targetUrl <targetUrl>`
20
20
  : Server-relative URL where to move the file
@@ -36,7 +36,7 @@ When you move a file using the `spo file move` command, all of the versions are
36
36
  Move file to a document library in another site collection
37
37
 
38
38
  ```sh
39
- m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/
39
+ m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /sites/test1/Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/
40
40
  ```
41
41
 
42
42
  Move file to a document library in the same site collection
@@ -54,7 +54,7 @@ m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceU
54
54
  Move file to a document library in another site collection. Allow for schema mismatch
55
55
 
56
56
  ```sh
57
- m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/ --allowSchemaMismatch
57
+ m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /sites/test1/Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/ --allowSchemaMismatch
58
58
  ```
59
59
 
60
60
 
@@ -14,7 +14,7 @@ m365 spo file rename [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-s, --sourceUrl <sourceUrl>`
17
- : Site-relative URL of the file to rename
17
+ : The server- or site-relative URL of the file to rename
18
18
 
19
19
  `-t, --targetFileName <targetFileName>`
20
20
  : New file name of the file
@@ -11,10 +11,10 @@ m365 spo file retentionlabel ensure [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : URL of the site where the retentionlabel from a file to apply is located
14
+ : URL of the site where the retention label from a file to apply is located
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The site- or server relative URL of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
17
+ : The site- or server-relative URL of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
@@ -29,7 +29,7 @@ m365 spo file retentionlabel ensure [options]
29
29
 
30
30
  ## Remarks
31
31
 
32
- You can also use [spo listitem retentionlabel remove](./../../../cmd/spo//listitem/listitem-retentionlabel-remove.md) for removing the retentionlabel from a listitem.
32
+ You can also use [spo listitem retentionlabel remove](./../../../cmd/spo//listitem/listitem-retentionlabel-remove.md) for removing the retention label from a listitem.
33
33
 
34
34
  The `--assetId` option has to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
35
35
 
@@ -11,10 +11,10 @@ m365 spo file retentionlabel remove [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : URL of the site where the retentionlabel from a file to remove is located
14
+ : URL of the site where the retention label from a file to remove is located
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The site- or server relative URL of the file of which the label should be removed. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative URL of the file of which the label should be removed. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `-i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file of which the label should be removed. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file roleassignment add [options]
14
14
  : URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file roleassignment remove [options]
14
14
  : URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `-i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file roleinheritance break [options]
14
14
  : URL of the site where the file is located
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative URL of the file. Specify either `fileUrl` or `fileId` but not both
17
+ : The server- or site-relative URL of the file. Specify either `fileUrl` or `fileId` but not both
18
18
 
19
19
  `i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both
@@ -14,7 +14,7 @@ m365 spo file roleinheritance reset [options]
14
14
  : URL of the site where the file is located
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
17
+ : The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
18
18
 
19
19
  `i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
@@ -14,7 +14,7 @@ m365 spo file sharinginfo get [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-f, --fileUrl [fileUrl]`
17
- : The server-relative URL of the file for which to build the report. Specify either `fileUrl` or `fileId` but not both
17
+ : The server- or site-relative URL of the file for which to build the report. Specify either `fileUrl` or `fileId` but not both
18
18
 
19
19
  `-i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file for which to build the report. Specify either `fileUrl` or `fileId` but not both
@@ -14,7 +14,7 @@ m365 spo file sharinglink add [options]
14
14
  : The URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `--fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file sharinglink clear [options]
14
14
  : The URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `--fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file sharinglink get [options]
14
14
  : The URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `--fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file sharinglink list [options]
14
14
  : The URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `--fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file sharinglink remove [options]
14
14
  : The URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `--fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,7 +14,7 @@ m365 spo file sharinglink set [options]
14
14
  : The URL of the site where the file is located.
15
15
 
16
16
  `--fileUrl [fileUrl]`
17
- : The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
17
+ : The server- or site-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
18
18
 
19
19
  `--fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
@@ -14,10 +14,10 @@ m365 spo file version clear [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-u, --fileUrl [fileUrl]`
17
- : The server-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
17
+ : The server- or site-relative URL of the file. Specify either `fileUrl` or `fileId` but not both
18
18
 
19
19
  `-i, --fileId [fileId]`
20
- : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
20
+ : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both
21
21
 
22
22
  `--confirm [confirm]`
23
23
  : Don't prompt for confirmation.
@@ -17,7 +17,7 @@ m365 spo file version get [options]
17
17
  : Label of version which will be retrieved
18
18
 
19
19
  `-u, --fileUrl [fileUrl]`
20
- : The server-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
20
+ : The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
21
21
 
22
22
  `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
@@ -14,7 +14,7 @@ m365 spo file version list [options]
14
14
  : The URL of the site where the file is located
15
15
 
16
16
  `-u, --fileUrl [fileUrl]`
17
- : The site-relative or server-relative URL of the file. Specify either `fileUrl` or `fileId` but not both
17
+ : The server- or site-relative URL of the file. Specify either `fileUrl` or `fileId` but not both
18
18
 
19
19
  `-i, --fileId [fileId]`
20
20
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both
@@ -17,7 +17,7 @@ m365 spo file version remove [options]
17
17
  : Label of version which will be removed
18
18
 
19
19
  `-u, --fileUrl [fileUrl]`
20
- : The server-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
20
+ : The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
21
21
 
22
22
  `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
@@ -17,7 +17,7 @@ m365 spo file version restore [options]
17
17
  : Label of version which will be restored
18
18
 
19
19
  `-u, --fileUrl [fileUrl]`
20
- : The server-relative URL of the file whose version will be restored. Specify either `fileUrl` or `fileId` but not both
20
+ : The server- or site-relative URL of the file whose version will be restored. Specify either `fileUrl` or `fileId` but not both
21
21
 
22
22
  `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file whose version will be restored. Specify either `fileUrl` or `fileId` but not both
@@ -11,10 +11,10 @@ m365 spo folder add [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : The URL of the site where the folder will be created
14
+ : The URL of the site where the folder will be created.
15
15
 
16
16
  `-p, --parentFolderUrl <parentFolderUrl>`
17
- : Site-relative URL of the parent folder
17
+ : The server- or site-relative URL of the parent folder.
18
18
 
19
19
  `-n, --name <name>`
20
20
  : Name of the new folder to be created
@@ -23,8 +23,14 @@ m365 spo folder add [options]
23
23
 
24
24
  ## Examples
25
25
 
26
- Creates folder in a parent folder with site relative url _/Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
26
+ Creates folder in a specific library within the site
27
27
 
28
28
  ```sh
29
29
  m365 spo folder add --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents' --name 'My Folder Name'
30
30
  ```
31
+
32
+ Creates folder in a specific folder within the site
33
+
34
+ ```sh
35
+ m365 spo folder add --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/sites/project-x/Shared Documents/Reports' --name 'Financial reports'
36
+ ```
@@ -14,7 +14,7 @@ m365 spo folder copy [options]
14
14
  : The URL of the site where the folder is located
15
15
 
16
16
  `-s, --sourceUrl <sourceUrl>`
17
- : Site-relative URL of the folder to copy
17
+ : The server- or site-relative URL of the folder to copy
18
18
 
19
19
  `-t, --targetUrl <targetUrl>`
20
20
  : Server-relative URL where to copy the folder
@@ -11,13 +11,13 @@ m365 spo folder get [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : The URL of the site where the folder is located
14
+ : The URL of the site where the folder is located.
15
15
 
16
16
  `-f, --url [url]`
17
- : The server-relative URL of the folder to retrieve. Specify either `folderUrl` or `id` but not both
17
+ : The server- or site-relative URL of the folder to retrieve. Specify either `folderUrl` or `id` but not both.
18
18
 
19
19
  `-i, --id [id]`
20
- : The UniqueId (GUID) of the folder to retrieve. Specify either `url` or `id` but not both
20
+ : The UniqueId (GUID) of the folder to retrieve. Specify either `url` or `id` but not both.
21
21
 
22
22
  `--withPermissions`
23
23
  : Set if you want to return associated roles and permissions of the folder.
@@ -32,20 +32,20 @@ If root level folder is passed, you will get a `Please ensure the specified fold
32
32
 
33
33
  ## Examples
34
34
 
35
- Get folder properties for folder with server-relative url _'/Shared Documents'_ located in site _https://contoso.sharepoint.com/sites/project-x_
35
+ Get folder properties for a folder with a specific site-relative URL
36
36
 
37
37
  ```sh
38
38
  m365 spo folder get --webUrl https://contoso.sharepoint.com/sites/project-x --url "/Shared Documents"
39
39
  ```
40
40
 
41
- Get folder properties for folder with id (UniqueId) _b2307a39-e878-458b-bc90-03bc578531d6_ located in site _https://contoso.sharepoint.com/sites/project-x_
41
+ Get folder properties for a folder with a specific id (UniqueId)
42
42
 
43
43
  ```sh
44
44
  m365 spo folder get --webUrl https://contoso.sharepoint.com/sites/project-x --id "b2307a39-e878-458b-bc90-03bc578531d6"
45
45
  ```
46
46
 
47
- Get folder properties for folder with server-relative url _'/Shared Documents/Test1'_ located in site _https://contoso.sharepoint.com/sites/test
47
+ Get folder properties with permissions for a folder with server-relative URL
48
48
 
49
49
  ```sh
50
- m365 spo folder get --webUrl https://contoso.sharepoint.com/sites/test --url "Shared Documents/Test1" --withPermissions
50
+ m365 spo folder get --webUrl https://contoso.sharepoint.com/sites/test --url "/sites/test/Shared Documents/Test1" --withPermissions
51
51
  ```
@@ -11,10 +11,10 @@ m365 spo folder list [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : The URL of the site where the folders to list are located
14
+ : The URL of the site where the folders to list are located.
15
15
 
16
16
  `-p, --parentFolderUrl <parentFolderUrl>`
17
- : Site-relative URL of the parent folder
17
+ : The server- or site-relative URL of the parent folder.
18
18
 
19
19
  `-f, --fields [fields]`
20
20
  : Comma-separated list of fields to retrieve. Will retrieve all fields if not specified and json output is requested.
@@ -23,13 +23,13 @@ m365 spo folder list [options]
23
23
  : OData filter to use to query the list of folders with.
24
24
 
25
25
  `-r, --recursive`
26
- : Set to retrieve nested folders
26
+ : Set to retrieve nested folders.
27
27
 
28
28
  --8<-- "docs/cmd/_global.md"
29
29
 
30
30
  ## Examples
31
31
 
32
- Gets list of folders under a parent folder
32
+ Gets list of folders under a parent folder with site-relative URL
33
33
 
34
34
  ```sh
35
35
  m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents'
@@ -38,7 +38,7 @@ m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --p
38
38
  Gets recursive list of folders under a specific folder on a specific site
39
39
 
40
40
  ```sh
41
- m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents' --recursive
41
+ m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/sites/project-x/Shared Documents' --recursive
42
42
  ```
43
43
 
44
44
  Return a filtered list of folders and only return the list item ID
@@ -59,7 +59,7 @@ m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --p
59
59
  "ItemCount": 9,
60
60
  "Name": "Folder A",
61
61
  "ProgID": null,
62
- "ServerRelativeUrl": "/Shared Documents/Folder A",
62
+ "ServerRelativeUrl": "/sites/project-x/Shared Documents/Folder A",
63
63
  "TimeCreated": "2022-04-26T12:30:56Z",
64
64
  "TimeLastModified": "2022-04-26T12:50:14Z",
65
65
  "UniqueId": "20523746-971b-4488-aa6d-b45d645f61c5",
@@ -71,16 +71,16 @@ m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --p
71
71
  === "Text"
72
72
 
73
73
  ```text
74
- Name ServerRelativeUrl
75
- ------- -------------------------
76
- Folder A /Shared Documents/Folder A
74
+ Name ServerRelativeUrl
75
+ -------- ------------------------------------------
76
+ Folder A /sites/project-x/Shared Documents/Folder A
77
77
  ```
78
78
 
79
79
  === "CSV"
80
80
 
81
81
  ```csv
82
82
  Name,ServerRelativeUrl
83
- Folder A,/Shared Documents/Folder A
83
+ Folder A,/sites/project-x/Shared Documents/Folder A
84
84
  ```
85
85
 
86
86
  === "Markdown"
@@ -99,7 +99,7 @@ m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --p
99
99
  ItemCount | 9
100
100
  Name | Folder A
101
101
  ProgID | null
102
- ServerRelativeUrl | /Shared Documents/Folder A
102
+ ServerRelativeUrl | /sites/project-x/Shared Documents/Folder A
103
103
  TimeCreated | 2022-04-26T12:30:56Z
104
104
  TimeLastModified | 2022-04-26T12:50:14Z
105
105
  UniqueId | 20523746-971b-4488-aa6d-b45d645f61c5
@@ -14,7 +14,7 @@ m365 spo folder move [options]
14
14
  : The URL of the site where the folder is located
15
15
 
16
16
  `-s, --sourceUrl <sourceUrl>`
17
- : Site-relative URL of the folder to move
17
+ : The server- or site-relative URL of the folder to move
18
18
 
19
19
  `-t, --targetUrl <targetUrl>`
20
20
  : Server-relative URL where to move the folder
@@ -11,16 +11,16 @@ m365 spo folder remove [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : The URL of the site where the folder to be deleted is located
14
+ : The URL of the site where the folder to be deleted is located.
15
15
 
16
16
  `-f, --url <url>`
17
- : Site-relative URL of the folder to delete
17
+ : The server- or site-relative URL of the folder to delete.
18
18
 
19
19
  `--recycle`
20
- : Recycles the folder instead of actually deleting it
20
+ : Recycles the folder instead of actually deleting it.
21
21
 
22
22
  `--confirm`
23
- : Don't prompt for confirming deleting the folder
23
+ : Don't prompt for confirming deleting the folder.
24
24
 
25
25
  --8<-- "docs/cmd/_global.md"
26
26
 
@@ -30,14 +30,14 @@ The `spo folder remove` command will remove folder only if it is empty. If the f
30
30
 
31
31
  ## Examples
32
32
 
33
- Removes a folder with site-relative URL _/Shared Documents/My Folder_ located in site _https://contoso.sharepoint.com/sites/project-x_
33
+ Remove a folder with a specific site-relative URL
34
34
 
35
35
  ```sh
36
36
  m365 spo folder remove --webUrl https://contoso.sharepoint.com/sites/project-x --url '/Shared Documents/My Folder'
37
37
  ```
38
38
 
39
- Moves a folder with site-relative URL _/Shared Documents/My Folder_ located in site _https://contoso.sharepoint.com/sites/project-x_ to the site recycle bin
39
+ Remove a folder with a specific server relative URL to the site recycle bin
40
40
 
41
41
  ```sh
42
- m365 spo folder remove --webUrl https://contoso.sharepoint.com/sites/project-x --url '/Shared Documents/My Folder' --recycle
42
+ m365 spo folder remove --webUrl https://contoso.sharepoint.com/sites/project-x --url '/sites/project-x/Shared Documents/My Folder' --recycle
43
43
  ```
@@ -11,20 +11,26 @@ m365 spo folder rename [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : The URL of the site where the folder to be renamed is located
14
+ : The URL of the site where the folder to be renamed is located.
15
15
 
16
16
  `-f, --url <url>`
17
- : Site-relative URL of the folder (including the folder)
17
+ : The server- or site-relative URL of the folder (including the folder).
18
18
 
19
- `-n, --name`
20
- : New name for the target folder
19
+ `-n, --name <name>`
20
+ : New name for the target folder.
21
21
 
22
22
  --8<-- "docs/cmd/_global.md"
23
23
 
24
24
  ## Examples
25
25
 
26
- Renames a folder with site-relative URL _/Shared Documents/My Folder 1_ located in site _https://contoso.sharepoint.com/sites/project-x_
26
+ Renames a folder with a specific site-relative URL
27
27
 
28
28
  ```sh
29
29
  m365 spo folder rename --webUrl https://contoso.sharepoint.com/sites/project-x --url '/Shared Documents/My Folder 1' --name 'My Folder 2'
30
30
  ```
31
+
32
+ Renames a folder with a specific server-relative URL
33
+
34
+ ```sh
35
+ m365 spo folder rename --webUrl https://contoso.sharepoint.com/sites/project-x --url '/sites/project-x/Shared Documents/My Folder 1' --name 'My Folder 2'
36
+ ```
@@ -11,10 +11,10 @@ m365 spo folder retentionlabel ensure [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : URL of the site where the retentionlabel from a file to apply is located
14
+ : URL of the site where the retention label from a file to apply is located
15
15
 
16
16
  `--folderUrl [folderUrl]`
17
- : The site- or server relative URL of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
17
+ : The server- or site-relative URL of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
18
18
 
19
19
  `i, --folderId [folderId]`
20
20
  : The UniqueId (GUID) of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
@@ -26,7 +26,7 @@ m365 spo folder retentionlabel ensure [options]
26
26
 
27
27
  ## Remarks
28
28
 
29
- You can also use [spo listitem retentionlabel remove](./../../../cmd/spo//listitem/listitem-retentionlabel-remove.md) for removing the retentionlabel from a listitem.
29
+ You can also use [spo listitem retentionlabel remove](./../../../cmd/spo//listitem/listitem-retentionlabel-remove.md) for removing the retention label from a listitem.
30
30
 
31
31
  ## Examples
32
32
 
@@ -14,7 +14,7 @@ m365 spo folder retentionlabel remove [options]
14
14
  : The url of the web.
15
15
 
16
16
  `--folderUrl [folderUrl]`
17
- : The site- or server relative URL of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
17
+ : The server- or site-relative URL of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
18
18
 
19
19
  `-i, --folderId [folderId]`
20
20
  : The UniqueId (GUID) of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
@@ -14,7 +14,7 @@ m365 spo folder roleinheritance break [options]
14
14
  : URL of the site where the folder is located.
15
15
 
16
16
  `-f, --folderUrl <folderUrl>`
17
- : The site-relative URL or server-relative URL of the folder.
17
+ : The server- or site-relative URL of the folder.
18
18
 
19
19
  `-c, --clearExistingPermissions`
20
20
  : Clear all existing permissions from the folder.
@@ -14,7 +14,7 @@ m365 spo folder roleinheritance reset [options]
14
14
  : URL of the site where the folder is located.
15
15
 
16
16
  `-f, --folderUrl <folderUrl>`
17
- : The site-relative URL of the folder.
17
+ : The server- or site-relative URL of the folder.
18
18
 
19
19
  `--confirm`
20
20
  : Don't prompt for confirmation to reset role inheritance of the folder.
@@ -23,19 +23,19 @@ m365 spo folder roleinheritance reset [options]
23
23
 
24
24
  ## Examples
25
25
 
26
- Reset inheritance of folder with site-relative url _Shared Documents/TestFolder_ located in site _https://contoso.sharepoint.com/sites/project-x_.
26
+ Reset inheritance of folder with a specific site-relative URL
27
27
 
28
28
  ```sh
29
29
  m365 spo folder roleinheritance reset --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "Shared Documents/TestFolder"
30
30
  ```
31
31
 
32
- Reset inheritance of folder with server-relative url _/sites/project-x/Shared Documents/TestFolder_ located in site _https://contoso.sharepoint.com/sites/project-x_. It will **not** prompt for confirmation before resetting.
32
+ Reset inheritance of folder with a specific server-relative URL. It will **not** prompt for confirmation before resetting.
33
33
 
34
34
  ```sh
35
35
  m365 spo folder roleinheritance reset --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "/sites/project-x/Shared Documents/TestFolder" --confirm
36
36
  ```
37
37
 
38
- Reset inheritance of the specified root folder for the library with the server-relative url _/sites/project-x/Shared Documents located in site _https://contoso.sharepoint.com/sites/project-x_. It will **not** prompt for confirmation before resetting.
38
+ Reset inheritance of the specified root folder for the library with a specific server-relative URL. It will **not** prompt for confirmation before resetting.
39
39
 
40
40
  ```sh
41
41
  m365 spo folder roleinheritance reset --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "/sites/project-x/Shared Documents" --confirm
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pnp/cli-microsoft365",
3
- "version": "6.8.0-beta.62006d7",
3
+ "version": "6.8.0-beta.f473be5",
4
4
  "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
5
5
  "license": "MIT",
6
6
  "main": "./dist/api.js",