@pnp/cli-microsoft365 6.8.0-beta.2463cfa → 6.8.0-beta.a10f6e4

package/docs/docs/cmd/spo/folder/folder-list.md

@@ -11,10 +11,10 @@ m365 spo folder list [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: The URL of the site where the folders to list are located
+: The URL of the site where the folders to list are located.
 
 `-p, --parentFolderUrl <parentFolderUrl>`
-: Site-relative URL of the parent folder
+: The server- or site-relative URL of the parent folder.
 
 `-f, --fields [fields]`
 : 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]
 : OData filter to use to query the list of folders with.
 
 `-r, --recursive`
-: Set to retrieve nested folders
+: Set to retrieve nested folders.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Gets list of folders under a parent folder
+Gets list of folders under a parent folder with site-relative URL
 
 ```sh
 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
 Gets recursive list of folders under a specific folder on a specific site
 
 ```sh
-m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents' --recursive
+m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/sites/project-x/Shared Documents' --recursive
 ```
 
 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
         "ItemCount": 9,
         "Name": "Folder A",
         "ProgID": null,
-        "ServerRelativeUrl": "/Shared Documents/Folder A",
+        "ServerRelativeUrl": "/sites/project-x/Shared Documents/Folder A",
         "TimeCreated": "2022-04-26T12:30:56Z",
         "TimeLastModified": "2022-04-26T12:50:14Z",
         "UniqueId": "20523746-971b-4488-aa6d-b45d645f61c5",
@@ -71,16 +71,16 @@ m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --p
 === "Text"
 
     ```text
-    Name     ServerRelativeUrl
-    -------  -------------------------
-    Folder A /Shared Documents/Folder A
+    Name      ServerRelativeUrl
+    --------  ------------------------------------------
+    Folder A  /sites/project-x/Shared Documents/Folder A
     ```
 
 === "CSV"
 
     ```csv
     Name,ServerRelativeUrl
-    Folder A,/Shared Documents/Folder A
+    Folder A,/sites/project-x/Shared Documents/Folder A
     ```
 
 === "Markdown"
@@ -99,7 +99,7 @@ m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --p
     ItemCount | 9
     Name | Folder A
     ProgID | null
-    ServerRelativeUrl | /Shared Documents/Folder A
+    ServerRelativeUrl | /sites/project-x/Shared Documents/Folder A
     TimeCreated | 2022-04-26T12:30:56Z
     TimeLastModified | 2022-04-26T12:50:14Z
     UniqueId | 20523746-971b-4488-aa6d-b45d645f61c5

package/docs/docs/cmd/spo/folder/folder-move.md

@@ -14,7 +14,7 @@ m365 spo folder move [options]
 : The URL of the site where the folder is located
 
 `-s, --sourceUrl <sourceUrl>`
-: Site-relative URL of the folder to move
+: The server- or site-relative URL of the folder to move
 
 `-t, --targetUrl <targetUrl>`
 : Server-relative URL where to move the folder

package/docs/docs/cmd/spo/folder/folder-remove.md

@@ -11,16 +11,16 @@ m365 spo folder remove [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: The URL of the site where the folder to be deleted is located
+: The URL of the site where the folder to be deleted is located.
 
 `-f, --url <url>`
-: Site-relative URL of the folder to delete
+: The server- or site-relative URL of the folder to delete.
 
 `--recycle`
-: Recycles the folder instead of actually deleting it
+: Recycles the folder instead of actually deleting it.
 
 `--confirm`
-: Don't prompt for confirming deleting the folder
+: Don't prompt for confirming deleting the folder.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -30,14 +30,14 @@ The `spo folder remove` command will remove folder only if it is empty. If the f
 
 ## Examples
 
-Removes a folder with site-relative URL _/Shared Documents/My Folder_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Remove a folder with a specific site-relative URL
 
 ```sh
 m365 spo folder remove --webUrl https://contoso.sharepoint.com/sites/project-x --url '/Shared Documents/My Folder'
 ```
 
-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
+Remove a folder with a specific server relative URL to the site recycle bin
 
 ```sh
-m365 spo folder remove --webUrl https://contoso.sharepoint.com/sites/project-x --url '/Shared Documents/My Folder' --recycle
+m365 spo folder remove --webUrl https://contoso.sharepoint.com/sites/project-x --url '/sites/project-x/Shared Documents/My Folder' --recycle
 ```

package/docs/docs/cmd/spo/folder/folder-rename.md

@@ -11,20 +11,26 @@ m365 spo folder rename [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: The URL of the site where the folder to be renamed is located
+: The URL of the site where the folder to be renamed is located.
 
 `-f, --url <url>`
-: Site-relative URL of the folder (including the folder)
+: The server- or site-relative URL of the folder (including the folder).
 
-`-n, --name`
-: New name for the target folder
+`-n, --name <name>`
+: New name for the target folder.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Renames a folder with site-relative URL _/Shared Documents/My Folder 1_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Renames a folder with a specific site-relative URL
 
 ```sh
 m365 spo folder rename --webUrl https://contoso.sharepoint.com/sites/project-x --url '/Shared Documents/My Folder 1' --name 'My Folder 2'
 ```
+
+Renames a folder with a specific server-relative URL
+
+```sh
+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'
+```

package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.md

@@ -11,10 +11,10 @@ m365 spo folder retentionlabel ensure [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the retentionlabel from a file to apply is located
+: URL of the site where the retention label from a file to apply is located
 
 `--folderUrl [folderUrl]`
-: The site- or server relative URL of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
+: The server- or site-relative URL of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
 
 `i, --folderId [folderId]`
 : 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]
 
 ## Remarks
 
-You can also use [spo listitem retentionlabel remove](./../../../cmd/spo//listitem/listitem-retentionlabel-remove.md) for removing the retentionlabel from a listitem.
+You can also use [spo listitem retentionlabel remove](./../../../cmd/spo//listitem/listitem-retentionlabel-remove.md) for removing the retention label from a listitem.
 
 ## Examples
 

package/docs/docs/cmd/spo/folder/folder-retentionlabel-remove.md

@@ -14,7 +14,7 @@ m365 spo folder retentionlabel remove [options]
 : The url of the web.
 
 `--folderUrl [folderUrl]`
-: The site- or server relative URL of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
+: The server- or site-relative URL of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
 
 `-i, --folderId [folderId]`
 : The UniqueId (GUID) of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.

package/docs/docs/cmd/spo/folder/folder-roleinheritance-break.md

@@ -14,7 +14,7 @@ m365 spo folder roleinheritance break [options]
 : URL of the site where the folder is located.
 
 `-f, --folderUrl <folderUrl>`
-: The site-relative URL or server-relative URL of the folder.
+: The server- or site-relative URL of the folder.
 
 `-c, --clearExistingPermissions`
 : Clear all existing permissions from the folder.

package/docs/docs/cmd/spo/folder/folder-roleinheritance-reset.md

@@ -14,7 +14,7 @@ m365 spo folder roleinheritance reset [options]
 : URL of the site where the folder is located.
 
 `-f, --folderUrl <folderUrl>`
-: The site-relative URL of the folder.
+: The server- or site-relative URL of the folder.
 
 `--confirm`
 : Don't prompt for confirmation to reset role inheritance of the folder.
@@ -23,19 +23,19 @@ m365 spo folder roleinheritance reset [options]
 
 ## Examples
 
-Reset inheritance of folder with site-relative url _Shared Documents/TestFolder_ located in site _https://contoso.sharepoint.com/sites/project-x_.
+Reset inheritance of folder with a specific site-relative URL
 
 ```sh
 m365 spo folder roleinheritance reset --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "Shared Documents/TestFolder"
 ```
 
-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.
+Reset inheritance of folder with a specific server-relative URL. It will **not** prompt for confirmation before resetting.
 
 ```sh
 m365 spo folder roleinheritance reset --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "/sites/project-x/Shared Documents/TestFolder" --confirm
 ```
 
-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.
+Reset inheritance of the specified root folder for the library with a specific server-relative URL. It will **not** prompt for confirmation before resetting.
 
 ```sh
 m365 spo folder roleinheritance reset --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "/sites/project-x/Shared Documents" --confirm

package/docs/docs/cmd/spo/site/site-recyclebinitem-move.md

@@ -0,0 +1,43 @@
+# spo site recyclebinitem move
+
+Moves items from the first-stage recycle bin to the second-stage recycle bin
+
+## Usage
+
+```sh
+m365 spo site recyclebinitem move [options]
+```
+
+## Options
+
+`-u, --siteUrl <siteUrl>`
+: URL of the site where the recycle bin is located.
+
+`-i, --ids [ids]`
+: Comma separated list of item IDs. Specify either `ids` or `all` but not both.
+
+`--all`
+: Move all first-stage recycle bin items to the second-stage recycle bin. Specify either `ids` or `all` but not both.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Move 2 specific items from the first-stage recycle bin to the second-stage
+
+```sh
+m365 spo site recyclebinitem move --siteUrl https://contoso.sharepoint.com/sites/sales --ids "06ca4fe4-3048-4b76-bd41-296fed4c9881,d679c17b-d7b8-429a-9307-34e1d9e631e7"
+```
+
+Move all first-stage recycle bin items to the second-stage
+
+```sh
+m365 spo site recyclebinitem move --siteUrl https://contoso.sharepoint.com/sites/sales --all
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/site/site-recyclebinitem-remove.md

@@ -0,0 +1,45 @@
+# spo site recyclebinitem remove
+
+Permanently deletes specific items from the site recycle bin
+
+## Usage
+
+```sh
+m365 spo site recyclebinitem remove [options]
+```
+
+## Options
+
+`-u, --siteUrl <siteUrl>`
+: URL of the site where the recycle bin is located.
+
+`-i, --ids <ids>`
+: Comma separated list of item IDs.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! warning
+    Items in the recycle bin will be permanently removed without the ability to restore them.
+
+## Examples
+
+Permanently remove 2 specific items from the recycle bin
+
+```sh
+m365 spo site recyclebinitem remove --siteUrl https://contoso.sharepoint.com/sites/sales --ids "06ca4fe4-3048-4b76-bd41-296fed4c9881,d679c17b-d7b8-429a-9307-34e1d9e631e7"
+```
+
+Permanently remove 2 specific items from the recycle bin and skip the confirmation prompt
+
+```sh
+m365 spo site recyclebinitem remove --siteUrl https://contoso.sharepoint.com/sites/sales --ids "06ca4fe4-3048-4b76-bd41-296fed4c9881,d679c17b-d7b8-429a-9307-34e1d9e631e7" --confirm
+```
+
+## Response
+
+The command won't return a response on success.