@pnp/cli-microsoft365 6.0.0-beta.3a40034 → 6.0.0-beta.3bf0c3c

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

@@ -16,6 +16,9 @@ m365 spo folder list [options]
 `-p, --parentFolderUrl <parentFolderUrl>`
 : Site-relative URL of the parent folder
 
+`-r, --recursive`
+: Set to retrieve nested folders
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
@@ -25,3 +28,45 @@ Gets list of folders under a parent folder with site-relative url _/Shared Docum
 ```sh
 m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents'
 ```
+
+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
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [  
+      {
+        "Exists": true,
+        "IsWOPIEnabled": false,
+        "ItemCount": 9,
+        "Name": "Folder A",
+        "ProgID": null,
+        "ServerRelativeUrl": "/Shared Documents/Folder A",
+        "TimeCreated": "2022-04-26T12:30:56Z",
+        "TimeLastModified": "2022-04-26T12:50:14Z",
+        "UniqueId": "20523746-971b-4488-aa6d-b45d645f61c5",
+        "WelcomePage": ""
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Name     ServerRelativeUrl
+    -------  -------------------------
+    Folder A /Shared Documents/Folder A
+    ```
+
+=== "CSV"
+
+    ```csv
+    Name,ServerRelativeUrl
+    Folder A,/Shared Documents/Folder A
+    ```

package/docs/docs/cmd/spo/folder/folder-roleassignment-add.md

@@ -0,0 +1,59 @@
+# spo folder roleassignment add
+
+Adds a role assignment from the specified folder.
+
+## Usage
+
+```sh
+m365 spo folder roleassignment add [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The URL of the site where the folder is located.
+
+`-f, --folderUrl <folderUrl>`
+: The server- or site-relative URL of the folder.
+
+`--principalId [principalId]`
+: The SharePoint principal id. It may be either an user id or group id for which the role assignment will be addd. Specify either upn, groupName or principalId but not multiple.
+
+`--upn [upn]`
+: The upn/email of the user. Specify either upn, groupName or principalId but not multiple.
+
+`--groupName [groupName]`
+: The Azure AD or SharePoint group name. Specify either upn, groupName or principalId but not multiple.
+
+`--roleDefinitionId [roleDefinitionId]`
+: ID of the role definition. Specify either roleDefinitionId or roleDefinitionName but not both.
+
+`--roleDefinitionName [roleDefinitionName]`
+: The name of the role definition. E.g. 'Contribute', 'Read'. Specify either roleDefinitionId or roleDefinitionName but not both
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Add the role assignment to the specified folder based on the group name and role definition name.
+
+```sh
+m365 spo folder roleassignment add --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --folderUrl  "/Shared Documents/FolderPermission" --groupName "saleGroup" --roleDefinitionName "Edit"
+```
+
+Add the role assignment to the specified folder based on the principal Id and role definition id
+
+```sh
+m365 spo folder roleassignment add --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --folderUrl "/Shared Documents/FolderPermission" --principalId 2 --roleDefinitionId 1073741827 
+```
+
+Add the role assignment to the specified folder based on the upn and role definition name
+
+```sh
+m365 spo folder roleassignment add --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --folderUrl "/Shared Documents/FolderPermission" --upn "test@contoso.onmicrosoft.com" --roleDefinitionName "Edit"
+```
+Add the role assignment to the root folder based on the upn and role definition name
+
+```sh
+m365 spo folder roleassignment add --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --folderUrl "/Shared Documents" --upn "test@contoso.onmicrosoft.com" --roleDefinitionName "Edit"
+```

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

@@ -37,3 +37,9 @@ Break the inheritance of a folder with a specified server-relative URL. It will
 ```sh
 m365 spo folder roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "/sites/project-x/Shared Documents/TestFolder" --clearExistingPermissions --confirm
 ```
+
+Break the inheritance of the specified root folder for the library with a specified server-relative URL. It will clear the existing permissions of the root folder. It will **not** prompt for confirmation before breaking the inheritance.
+
+```sh
+m365 spo folder roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --folderUrl "/sites/project-x/Shared Documents" --clearExistingPermissions --confirm
+```

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

@@ -34,3 +34,9 @@ Reset inheritance of folder with server-relative url _/sites/project-x/Shared Do
 ```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.
+
+```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/hubsite/hubsite-connect.md

@@ -1,6 +1,6 @@
 # spo hubsite connect
 
-Connects the specified site collection to the given hub site
+Connect a hub site to a parent hub site
 
 ## Usage
 
@@ -10,31 +10,53 @@ m365 spo hubsite connect [options]
 
 ## Options
 
-`-u, --siteUrl <siteUrl>`
-: The URL of the site collection to connect to the hub site
+`-i, --id [id]`
+: ID of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
-`-i, --id <id>`
-: The ID of the hub site to which to connect the site collection
+`-t, --title [title]`
+: Title of the hub site. Specify either `id`, `title` or `url` but not multiple.
+
+`-u, --url [url]`
+: Absolute or server-relative URL of the hub site. Specify either `id`, `title` or `url` but not multiple.
+
+`--parentId [parentId]`
+: ID of the parent hub site. Specify either `parentId`, `parentTitle` or `parentUrl` but not multiple.
+
+`--parentTitle [parentTitle]`
+: Title of the parent hub site. Specify either `parentId`, `parentTitle` or `parentUrl` but not multiple.
+
+`--parentUrl [parentUrl]`
+: Absolute or server-relative URL of the parent hub site. Specify either `parentId`, `parentTitle` or `parentUrl` but not multiple.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
-If the specified site collection is already connected to a hub site, it will be disconnected and connected to the newly specified hub site.
-
-If the specified `id` doesn't point to a valid hub site, you will get a `ResourceNotFoundException` error.
+To connect a regular site to a hub site, use command [spo site hubsite connect](../site/site-hubsite-connect.md).
 
 ## Examples
 
-Connect the site collection with URL _https://contoso.sharepoint.com/sites/contoso-sales_ to the hub site with ID _255a50b2-527f-4413-8485-57f4c17a24d1_
+Connect a specific hub site to specific parent hub site by ID
+
+```sh
+m365 spo hubsite connect --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --parentId 637ed2ea-b65b-4a4b-a3d7-ad86953224a4
+```
+
+Connect a specific hub site to specific parent hub site by URL
+
+```sh
+m365 spo hubsite connect --url https://contoso.sharepoint.com/sites/project-x --parentUrl https://contoso.sharepoint.com/sites/projects
+```
+
+Connect a specific hub site with title to a parent hub site with ID
 
 ```sh
-m365 spo hubsite connect --siteUrl https://contoso.sharepoint.com/sites/contoso-sales --id 255a50b2-527f-4413-8485-57f4c17a24d1
+m365 spo hubsite connect --title "My hub site" --parentId 637ed2ea-b65b-4a4b-a3d7-ad86953224a4
 ```
 
-## More information
+## Response
 
-- SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)
+The command won't return a response on success.

package/docs/docs/cmd/spo/hubsite/hubsite-data-get.md

@@ -20,9 +20,6 @@ m365 spo hubsite data get [options]
 
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
-
 By default, the hub site data is returned from the server's cache. To refresh the data with the latest updates, use the `-f, --forceRefresh` option. Use this option, if you just made changes and need to see them right
 away.
 

package/docs/docs/cmd/spo/hubsite/hubsite-disconnect.md

@@ -1,6 +1,6 @@
 # spo hubsite disconnect
 
-Disconnects the specified site collection from its hub site
+Disconnect a hub site from its parent hub site
 
 ## Usage
 
@@ -10,33 +10,49 @@ m365 spo hubsite disconnect [options]
 
 ## Options
 
-`-u, --siteUrl <siteUrl>`
-: URL of the site collection to disconnect from its hub site
+`-i, --id [id]`
+: ID of the hub site. Specify either `id`, `title` or `url` but not multiple.
+
+`-t, --title [title]`
+: Title of the hub site. Specify either `id`, `title` or `url` but not multiple.
+
+`-u, --url [url]`
+: Absolute or server-relative URL of the hub site. Specify either `id`, `title` or `url` but not multiple.
 
 `--confirm`
-: Don't prompt for confirming disconnecting from the hub site
+: Don't prompt for confirmation.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
+
+To disconnect a regular site from a hub site, use command [spo site hubsite disconnect](../site/site-hubsite-disconnect.md).
+
+If the specified id doesn't point to a valid hub site, you will get a ResourceNotFoundException error.
 
 ## Examples
 
-Disconnect the site collection with URL _https://contoso.sharepoint.com/sites/sales_ from its hub site. Will prompt for confirmation before disconnecting from the hub site.
+Disconnect a specific hub site with id from its parent hub site
+
+```sh
+m365 spo hubsite disconnect --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a
+```
+
+Disconnect a specific hub site with url from its parent hub site
 
 ```sh
-m365 spo hubsite disconnect --siteUrl https://contoso.sharepoint.com/sites/sales
+m365 spo hubsite disconnect --url https://contoso.sharepoint.com/sites/project-x
 ```
 
-Disconnect the site collection with URL _https://contoso.sharepoint.com/sites/sales_ from its hub site without prompting for confirmation
+Disconnect a specific hub site with title from its parent hub site
 
 ```sh
-m365 spo hubsite disconnect --siteUrl https://contoso.sharepoint.com/sites/sales --confirm
+m365 spo hubsite disconnect --title "My hub site"
 ```
 
-## More information
+## Response
 
-- SharePoint hub sites new in Microsoft 365: [https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547](https://techcommunity.microsoft.com/t5/SharePoint-Blog/SharePoint-hub-sites-new-in-Office-365/ba-p/109547)
+The command won't return a response on success.

package/docs/docs/cmd/spo/hubsite/hubsite-register.md

@@ -17,8 +17,8 @@ m365 spo hubsite register [options]
 
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
 If the specified site collection is already registered as a hub site, you will get a `This site is already a HubSite.` error.
 

package/docs/docs/cmd/spo/hubsite/hubsite-rights-grant.md

@@ -21,13 +21,10 @@ m365 spo hubsite rights grant [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
 ## Examples
 

package/docs/docs/cmd/spo/hubsite/hubsite-rights-revoke.md

@@ -21,13 +21,10 @@ m365 spo hubsite rights revoke [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
 ## Examples
 

package/docs/docs/cmd/spo/hubsite/hubsite-set.md

@@ -24,13 +24,10 @@ m365 spo hubsite set [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    To use this command you have to have permissions to access the tenant admin site.
-
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
 If the specified `id` doesn't refer to an existing hub site, you will get an `Unknown Error` error.
 

package/docs/docs/cmd/spo/hubsite/hubsite-unregister.md

@@ -20,8 +20,8 @@ m365 spo hubsite unregister [options]
 
 ## Remarks
 
-!!! attention
-    This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.
+!!! important
+    To use this command you must be a Global or SharePoint administrator.
 
 If the specified site collection is not registered as a hub site, you will get a `hubSiteId` error.
 

package/docs/docs/cmd/spo/list/list-roleassignment-add.md

@@ -11,31 +11,31 @@ m365 spo list roleassignment add [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list is located
+: URL of the site where the list is located.
 
 `-i, --listId [listId]`
-: ID of the list. Specify either listId, listTitle or listUrl but not multiple.
+: ID of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
 
 `-t, --listTitle [listTitle]`
-: Title of the list. Specify either listId, listTitle or listUrl but not multiple.
+: Title of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
 
 `--listUrl [listUrl]`
-: Relative URL of the list. Specify either listId, listTitle or listUrl but not multiple.
+: Relative URL of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
 
 `--principalId [principalId]`
-: SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify principalId only when upn or groupName are not used.
+: SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--upn [upn]`
-: Upn/email of user to assign role to. Specify either upn or principalId
+: Upn/email of user to assign role to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--groupName [groupName]`
-: Enter group name of Azure AD or SharePoint group.. Specify either groupName or principalId
+: Enter group name of Azure AD or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--roleDefinitionId [roleDefinitionId]`
-: ID of role definition. Specify either roleDefinitionId or roleDefinitionName but not both
+: ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
 
 `--roleDefinitionName [roleDefinitionName]`
-: Enter the name of a role definition, like 'Contribute', 'Read', etc. Specify either roleDefinitionId or roleDefinitionName but not both
+: Enter the name of a role definition, like 'Contribute', 'Read', etc. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
 
 --8<-- "docs/cmd/_global.md"
 

package/docs/docs/cmd/spo/list/list-roleassignment-remove.md

@@ -11,28 +11,28 @@ m365 spo list roleassignment remove [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list is located
+: URL of the site where the list is located.
 
 `-i, --listId [listId]`
-: ID of the list. Specify either listId, listTitle or listUrl but not multiple.
+: ID of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
 
 `-t, --listTitle [listTitle]`
-: Title of the list. Specify either listId, listTitle or listUrl but not multiple.
+: Title of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
 
 `--listUrl [listUrl]`
-: Relative URL of the list. Specify either listId, listTitle or listUrl but not multiple.
+: Relative URL of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
 
 `--principalId [principalId]`
-: SharePoint ID of principal it may be either user id or group id we want to remove permissions Specify principalId only when upn or groupName are not used.
+: SharePoint ID of principal it may be either user id or group id you want to remove permissions. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--upn [upn]`
-: upn/email of user. Specify either upn or principalId.
+: upn/email of user. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--groupName [groupName]`
-: enter group name of Azure AD or SharePoint group. Specify either groupName or principalId.
+: enter group name of Azure AD or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--confirm`
-: Don't prompt for confirming removing the role assignment
+: Don't prompt for confirming removing the role assignment.
 
 --8<-- "docs/cmd/_global.md"
 

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

@@ -11,13 +11,16 @@ m365 spo list roleinheritance break [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list to retrieve is located
+: URL of the site where the list is located.
 
 `-i, --listId [listId]`
-: ID of the list to retrieve information for. Specify either id or title but not both
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list to retrieve information for. Specify either id or title but not both
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-c, --clearExistingPermissions`
 : Flag if used clears all roles from the list
@@ -33,28 +36,28 @@ By default, when breaking permissions inheritance, the list will retain existing
 
 ## Examples
 
-Break inheritance of list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Break inheritance of list by title in a specific site
 
 ```sh
 m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList"
 ```
 
-Break inheritance of list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Break inheritance of list by id in a specific site
 
 ```sh
 m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "202b8199-b9de-43fd-9737-7f213f51c991"
 ```
 
-Break inheritance of list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_ with clearing permissions 
+Break inheritance of list by title located in a specific site and clearing the existing permissions
 
 ```sh
 m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --clearExistingPermissions
 ```
 
-Break inheritance of list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ located in site _https://contoso.sharepoint.com/sites/project-x_ with clearing permissions
+Break inheritance of list by url in a specific site and clearing the existing permissions
 
 ```sh
-m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "202b8199-b9de-43fd-9737-7f213f51c991" --clearExistingPermissions
+m365 spo list roleinheritance break --webUrl "https://contoso.sharepoint.com/sites/project-x" --listUrl '/sites/project-x/lists/events' --clearExistingPermissions
 ```
 
 Break inheritance of list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ located in site _https://contoso.sharepoint.com/sites/project-x_ with clearing permissions without prompting for confirmation

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

@@ -11,13 +11,16 @@ m365 spo list roleinheritance reset [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list is located
+: URL of the site where the list is located.
 
 `-i, --listId [listId]`
-: ID of the list. Specify either id or title but not both
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list. Specify either id or title but not both
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `--confirm`
 : Do not prompt for confirmation before resetting role inheritance.
@@ -26,20 +29,26 @@ m365 spo list roleinheritance reset [options]
 
 ## Examples
 
-Restore role inheritance of list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Restores role inheritance of a specific list by id in a specific site
 
 ```sh
 m365 spo list roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf
 ```
 
-Restore role inheritance of list with title _test_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Restores role inheritance of a specific list by title in a specific site
 
 ```sh
 m365 spo list roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle test
 ```
 
-Restore role inheritance of list with title _test_ located in site _https://contoso.sharepoint.com/sites/project-x_ without prompting for confirmation
+Restores role inheritance of a specific list by url in a specific site
+
+```sh
+m365 spo list roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/lists/events'
+```
+
+Restores role inheritance of list a specific list by title without prompting for confirmation
 
 ```sh
 m365 spo list roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle test --confirm
-```
+```

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

@@ -10,14 +10,20 @@ m365 spo list set [options]
 
 ## Options
 
-`-i, --id <id>`
-: Id of the list to update
-
 `-u, --webUrl <webUrl>`
-: URL of the site where the list to update is located
+: URL of the site
+
+`--id [id]`
+: ID of the list. Specify either id, title or url but not multiple.
+
+`--title [title]`
+: Title of the list. Specify either id, title or url but not multiple.
+
+`--url [url]`
+: Relative URL of the list. Specify either id, title or url but not multiple.
 
-`-t, --title [title]`
-: The displayed title for the list
+`--newTitle [newTitle]`
+: New title for the list
 
 `--allowDeletion [allowDeletion]`
 : Boolean value specifying whether the list can be deleted. Valid values are `true,false`
@@ -221,6 +227,12 @@ Enable content types and versioning in the list with id _3EA5A977-315E-4E25-8B0F
 m365 spo list set --webUrl https://contoso.sharepoint.com/sites/project-x --id 3EA5A977-315E-4E25-8B0F-E4F949BF6B8F --contentTypesEnabled true --enableVersioning true --majorVersionLimit 50 --majorWithMinorVersionsLimit 100
 ```
 
+Update the Title of a list retrieved by it's original Title
+
+```sh
+m365 spo list set --webUrl https://contoso.sharepoint.com/sites/project-x --title Documents --newTitle 'Different Title'
+```
+
 ## More information
 
 - SPList Class Members information: [https://msdn.microsoft.com/en-us/library/microsoft.sharepoint.client.list_members.aspx](https://msdn.microsoft.com/en-us/library/microsoft.sharepoint.client.list_members.aspx)

package/docs/docs/cmd/spo/list/list-view-field-add.md

@@ -14,10 +14,13 @@ m365 spo list view field add [options]
 : URL of the site where the list is located
 
 `--listId [listId]`
-: ID of the list where the view is located. Specify `listTitle` or `listId` but not both
+: ID of the list where the view is located. Specify either `listId`, `listTitle`, or `listUrl`.
 
 `--listTitle [listTitle]`
-: Title of the list where the view is located. Specify `listTitle` or `listId` but not both
+: Title of the list where the view is located. Specify either `listId`, `listTitle`, or `listUrl`.
+
+ `--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId` , `listTitle` or `listUrl`.
 
 `--viewId [viewId]`
 : ID of the view to update. Specify `viewTitle` or `viewId` but not both
@@ -50,8 +53,15 @@ Add field with title _Custom field_ to view with title _All Documents_ of the li
 m365 spo list view field add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --viewTitle 'All Documents' --title 'Custom field'
 ```
 
-Add field with title _Custom field_ at the position _0_ to view with title _All Documents_ of the list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Add field with title _Custom field_ at the position _0_ to view with title _My Events_ of the list with url _/sites/project-x/lists/Events_ located in site _https://contoso.sharepoint.com/sites/project-x_
+
+```sh
+m365 spo list view field add --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/lists/Events' --viewTitle 'My Events' --title 'Custom field' --fieldPosition 0
+```
+
+Add field with title _Custom field_ to view with title _All Documents_ of the list with site-relative URL _/Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
 
 ```sh
-m365 spo list view field add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents --viewTitle 'All Documents' --title 'Custom field' --position 0
+m365 spo list view field add --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'Shared Documents' --viewTitle 'All Documents' --fieldTitle 'Custom field'
 ```
+