@pnp/cli-microsoft365 6.0.0-beta.09b5216 → 6.0.0-beta.0e3b373

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

@@ -14,10 +14,13 @@ m365 spo list get [options]
 : URL of the site where the list to retrieve is located
 
 `-i, --id [id]`
-: ID of the list to retrieve information for. Specify either `id` or `title` but not both
+: ID of the list to retrieve information for. Specify either `id`, `title` or `url` but not multiple.
 
 `-t, --title [title]`
-: Title of the list to retrieve information for. Specify either `id` or `title` but not both
+: Title of the list to retrieve information for. Specify either `id`, `title` or `url` but not multiple.
+
+`--url [url]`
+: Server- or site-relative URL of the list. Specify either `id`, `title` or `url` but not multiple.
 
 `-p, --properties [properties]`
 : Comma-separated list of properties to retrieve from the list. Will retrieve all properties possible from default response, if not specified.
@@ -29,25 +32,37 @@ m365 spo list get [options]
 
 ## Examples
 
-Return information about a list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Get information about a list with specified ID located in the specified site.
 
 ```sh
 m365 spo list get --id 0cd891ef-afce-4e55-b836-fce03286cccf --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
-Return information about a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Get information about a list with specified title located in the specified site.
 
 ```sh
 m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
-Get information about a list returning the specified list properties
+Get information about a list with specified server relative url located in the specified site.
+
+```sh
+m365 spo list get --url 'sites/project-x/Documents' --webUrl https://contoso.sharepoint.com/sites/project-x
+```
+
+Get information about a list with specified site-relative URL located in the specified site.
+
+```sh
+m365 spo list get --url 'Shared Documents' --webUrl https://contoso.sharepoint.com/sites/project-x
+```
+
+Get information about a list returning the specified list properties.
 
 ```sh
 m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Id,HasUniqueRoleAssignments,AllowContentTypes"
 ```
 
-Get information about a list along with the roles and permissions
+Get information about a list along with the roles and permissions.
 
 ```sh
 m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/sites/project-x --withPermissions
@@ -56,3 +71,136 @@ m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/site
 ## More information
 
 - List REST API resources: [https://msdn.microsoft.com/en-us/library/office/dn531433.aspx#bk_ListEndpoint](https://msdn.microsoft.com/en-us/library/office/dn531433.aspx#bk_ListEndpoint)
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "AllowContentTypes": true,
+      "BaseTemplate": 100,
+      "BaseType": 0,
+      "ContentTypesEnabled": true,
+      "CrawlNonDefaultViews": false,
+      "Created": "2022-10-23T09:30:00Z",
+      "CurrentChangeToken": {
+        "StringValue": "1;3;97d19285-b8a6-4c7f-9c6c-d6b850a6561a;638042258222730000;564169620"
+      },
+      "DefaultContentApprovalWorkflowId": "00000000-0000-0000-0000-000000000000",
+      "DefaultItemOpenUseListSetting": false,
+      "Description": "",
+      "Direction": "none",
+      "DisableCommenting": false,
+      "DisableGridEditing": false,
+      "DocumentTemplateUrl": null,
+      "DraftVersionVisibility": 0,
+      "EnableAttachments": true,
+      "EnableFolderCreation": false,
+      "EnableMinorVersions": false,
+      "EnableModeration": false,
+      "EnableRequestSignOff": true,
+      "EnableVersioning": true,
+      "EntityTypeName": "TestList",
+      "ExemptFromBlockDownloadOfNonViewableFiles": false,
+      "FileSavePostProcessingEnabled": false,
+      "ForceCheckout": false,
+      "HasExternalDataSource": false,
+      "Hidden": false,
+      "Id": "97d19285-b8a6-4c7f-9c6c-d6b850a6561a",
+      "ImagePath": {
+        "DecodedUrl": "/_layouts/15/images/itgen.png?rev=47"
+      },
+      "ImageUrl": "/_layouts/15/images/itgen.png?rev=47",
+      "DefaultSensitivityLabelForLibrary": "",
+      "IrmEnabled": false,
+      "IrmExpire": false,
+      "IrmReject": false,
+      "IsApplicationList": false,
+      "IsCatalog": false,
+      "IsPrivate": false,
+      "ItemCount": 0,
+      "LastItemDeletedDate": "2022-11-16T19:55:37Z",
+      "LastItemModifiedDate": "2022-11-16T19:55:39Z",
+      "LastItemUserModifiedDate": "2022-11-16T19:55:37Z",
+      "ListExperienceOptions": 0,
+      "ListItemEntityTypeFullName": "SP.Data.TestListItem",
+      "MajorVersionLimit": 50,
+      "MajorWithMinorVersionsLimit": 0,
+      "MultipleDataList": false,
+      "NoCrawl": false,
+      "ParentWebPath": {
+        "DecodedUrl": "/"
+      },
+      "ParentWebUrl": "/",
+      "ParserDisabled": false,
+      "ServerTemplateCanCreateFolders": true,
+      "TemplateFeatureId": "00bfea71-de22-43b2-a848-c05709900100",
+      "Title": "Test"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    AllowContentTypes                        : true
+    BaseTemplate                             : 100
+    BaseType                                 : 0
+    ContentTypesEnabled                      : true
+    CrawlNonDefaultViews                     : false
+    Created                                  : 2022-10-23T09:30:00Z
+    CurrentChangeToken                       : {"StringValue":"1;3;97d19285-b8a6-4c7f-9c6c-d6b850a6561a;638042258464070000;564169707"}
+    DefaultContentApprovalWorkflowId         : 00000000-0000-0000-0000-000000000000
+    DefaultItemOpenUseListSetting            : false
+    DefaultSensitivityLabelForLibrary        :
+    Description                              :
+    Direction                                : none
+    DisableCommenting                        : false
+    DisableGridEditing                       : false
+    DocumentTemplateUrl                      : null
+    DraftVersionVisibility                   : 0
+    EnableAttachments                        : true
+    EnableFolderCreation                     : false
+    EnableMinorVersions                      : false
+    EnableModeration                         : false
+    EnableRequestSignOff                     : true
+    EnableVersioning                         : true
+    EntityTypeName                           : TestList
+    ExemptFromBlockDownloadOfNonViewableFiles: false
+    FileSavePostProcessingEnabled            : false
+    ForceCheckout                            : false
+    HasExternalDataSource                    : false
+    Hidden                                   : false
+    Id                                       : 97d19285-b8a6-4c7f-9c6c-d6b850a6561a
+    ImagePath                                : {"DecodedUrl":"/_layouts/15/images/itgen.png?rev=47"}
+    ImageUrl                                 : /_layouts/15/images/itgen.png?rev=47
+    IrmEnabled                               : false
+    IrmExpire                                : false
+    IrmReject                                : false
+    IsApplicationList                        : false
+    IsCatalog                                : false
+    IsPrivate                                : false
+    ItemCount                                : 0
+    LastItemDeletedDate                      : 2022-11-16T19:55:37Z
+    LastItemModifiedDate                     : 2022-11-16T19:55:39Z
+    LastItemUserModifiedDate                 : 2022-11-16T19:55:37Z
+    ListExperienceOptions                    : 0
+    ListItemEntityTypeFullName               : SP.Data.TestListItem
+    MajorVersionLimit                        : 50
+    MajorWithMinorVersionsLimit              : 0
+    MultipleDataList                         : false
+    NoCrawl                                  : false
+    ParentWebPath                            : {"DecodedUrl":"/"}
+    ParentWebUrl                             : /
+    ParserDisabled                           : false
+    ServerTemplateCanCreateFolders           : true
+    TemplateFeatureId                        : 00bfea71-de22-43b2-a848-c05709900100
+    Title                                    : Test
+    ```
+
+=== "CSV"
+
+    ```csv
+    AllowContentTypes,BaseTemplate,BaseType,ContentTypesEnabled,CrawlNonDefaultViews,Created,CurrentChangeToken,DefaultContentApprovalWorkflowId,DefaultItemOpenUseListSetting,Description,Direction,DisableCommenting,DisableGridEditing,DocumentTemplateUrl,DraftVersionVisibility,EnableAttachments,EnableFolderCreation,EnableMinorVersions,EnableModeration,EnableRequestSignOff,EnableVersioning,EntityTypeName,ExemptFromBlockDownloadOfNonViewableFiles,FileSavePostProcessingEnabled,ForceCheckout,HasExternalDataSource,Hidden,Id,ImagePath,ImageUrl,DefaultSensitivityLabelForLibrary,IrmEnabled,IrmExpire,IrmReject,IsApplicationList,IsCatalog,IsPrivate,ItemCount,LastItemDeletedDate,LastItemModifiedDate,LastItemUserModifiedDate,ListExperienceOptions,ListItemEntityTypeFullName,MajorVersionLimit,MajorWithMinorVersionsLimit,MultipleDataList,NoCrawl,ParentWebPath,ParentWebUrl,ParserDisabled,ServerTemplateCanCreateFolders,TemplateFeatureId,Title
+    1,100,0,1,,2022-10-23T09:30:00Z,"{""StringValue"":""1;3;97d19285-b8a6-4c7f-9c6c-d6b850a6561a;638042258543870000;564169743""}",00000000-0000-0000-0000-000000000000,,,none,,,,0,1,,,,1,1,TestList,,,,,,97d19285-b8a6-4c7f-9c6c-d6b850a6561a,"{""DecodedUrl"":""/_layouts/15/images/itgen.png?rev=47""}",/_layouts/15/images/itgen.png?rev=47,,,,,,,,0,2022-11-16T19:55:37Z,2022-11-16T19:55:39Z,2022-11-16T19:55:37Z,0,SP.Data.TestListItem,50,0,,,"{""DecodedUrl"":""/""}",/,,1,00bfea71-de22-43b2-a848-c05709900100,Test
+    ```

package/docs/docs/cmd/spo/list/list-label-get.md

@@ -11,26 +11,102 @@ m365 spo list label get  [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list to get the label from is located
+: URL of the site where the list to get the label from is located.
 
 `-l, --listId [listId]`
-: ID of the list to get the label from. Specify either `listId` or `listTitle` but not both
+: ID of the list to get the label from. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
 
 `-t, --listTitle [listTitle]`
-: Title of the list to get the label from. Specify either `listId` or `listTitle` but not both
+: Title of the list to get the label from. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Gets label set on the list with title _ContosoList_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Gets label set on the list with specified title located in the specified site.
+
+```sh
+m365 spo list label get --listTitle ContosoList --webUrl https://contoso.sharepoint.com/sites/project-x
+```
+
+Gets label set on the list with specified id located in the specified site.
+
+```sh
+m365 spo list label get --listId cc27a922-8224-4296-90a5-ebbc54da2e85 --webUrl https://contoso.sharepoint.com/sites/project-x
+```
+
+Gets label set on the list with specified server relative url located in the specified site.
 
 ```sh
-m365 spo list label get  --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle ContosoList
+m365 spo list label get --listUrl 'sites/project-x/Documents' --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
-Gets label set on the list with id _cc27a922-8224-4296-90a5-ebbc54da2e85_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Gets label set on the list with specified site-relative URL located in the specified site.
 
 ```sh
-m365 spo list label get  --webUrl https://contoso.sharepoint.com/sites/project-x --listId cc27a922-8224-4296-90a5-ebbc54da2e85
+m365 spo list label get --listUrl 'Shared Documents' --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "AcceptMessagesOnlyFromSendersOrMembers": false,
+      "AccessType": null,
+      "AllowAccessFromUnmanagedDevice": null,
+      "AutoDelete": false,
+      "BlockDelete": false,
+      "BlockEdit": false,
+      "ContainsSiteLabel": false,
+      "DisplayName": "Label A",
+      "EncryptionRMSTemplateId": null,
+      "HasRetentionAction": false,
+      "IsEventTag": false,
+      "Notes": null,
+      "RequireSenderAuthenticationEnabled": false,
+      "ReviewerEmail": null,
+      "SharingCapabilities": null,
+      "SuperLock": false,
+      "TagDuration": 0,
+      "TagId": "4d535433-2a7b-40b0-9dad-8f0f8f3b3841",
+      "TagName": "Sensitive",
+      "TagRetentionBasedOn": null
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    AcceptMessagesOnlyFromSendersOrMembers: false
+    AccessType                            : null
+    AllowAccessFromUnmanagedDevice        : null
+    AutoDelete                            : false
+    BlockDelete                           : false
+    BlockEdit                             : false
+    ContainsSiteLabel                     : false
+    DisplayName                           : Label A
+    EncryptionRMSTemplateId               : null
+    HasRetentionAction                    : false
+    IsEventTag                            : false
+    Notes                                 : null
+    RequireSenderAuthenticationEnabled    : false
+    ReviewerEmail                         : null
+    SharingCapabilities                   : null
+    SuperLock                             : false
+    TagDuration                           : 0
+    TagId                                 : 4d535433-2a7b-40b0-9dad-8f0f8f3b3841
+    TagName                               : Sensitive
+    TagRetentionBasedOn                   : null
+    ```
+
+=== "CSV"
+
+    ```csv
+    AcceptMessagesOnlyFromSendersOrMembers,AccessType,AllowAccessFromUnmanagedDevice,AutoDelete,BlockDelete,BlockEdit,ContainsSiteLabel,DisplayName,EncryptionRMSTemplateId,HasRetentionAction,IsEventTag,Notes,RequireSenderAuthenticationEnabled,ReviewerEmail,SharingCapabilities,SuperLock,TagDuration,TagId,TagName,TagRetentionBasedOn
+    false,,,false,false,false,false,Label A,,false,false,,false,,,false,0,4d535433-2a7b-40b0-9dad-8f0f8f3b3841,Sensitive,
+    ```

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

@@ -49,3 +49,7 @@ Sets classification label "Confidential" and disables editing and deleting items
 ```sh
 m365 spo list label set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'Documents' --label 'Confidential' --blockEdit --blockDelete --syncToItems
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -13,9 +13,6 @@ m365 spo list list [options]
 `-u, --webUrl <webUrl>`
 : URL of the site where the lists to retrieve are located
 
-`--executeWithLimitedPermissions`
-: Use this option to execute this command with site member or visitor permissions. Not specifying this option will require site owner (or admin) permissions.
-
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
@@ -29,3 +26,92 @@ m365 spo list list --webUrl https://contoso.sharepoint.com/sites/project-x
 ## More information
 
 - List REST API resources: [https://msdn.microsoft.com/en-us/library/office/dn531433.aspx#bk_ListEndpoint](https://msdn.microsoft.com/en-us/library/office/dn531433.aspx#bk_ListEndpoint)
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "RootFolder": {
+          "ServerRelativeUrl": "/_catalogs/theme"
+        },
+        "AllowContentTypes": true,
+        "BaseTemplate": 123,
+        "BaseType": 1,
+        "ContentTypesEnabled": false,
+        "CrawlNonDefaultViews": false,
+        "Created": "2020-01-12T01:03:13Z",
+        "CurrentChangeToken": {
+          "StringValue": "1;3;66e5148c-7060-4479-88e7-636d79579148;638042267256930000;564174226"
+        },
+        "DefaultContentApprovalWorkflowId": "00000000-0000-0000-0000-000000000000",
+        "DefaultItemOpenUseListSetting": false,
+        "Description": "Use the theme gallery to store themes. The themes in this gallery can be used by this site or any of its subsites.",
+        "Direction": "none",
+        "DisableCommenting": false,
+        "DisableGridEditing": false,
+        "DocumentTemplateUrl": null,
+        "DraftVersionVisibility": 0,
+        "EnableAttachments": false,
+        "EnableFolderCreation": false,
+        "EnableMinorVersions": false,
+        "EnableModeration": false,
+        "EnableRequestSignOff": true,
+        "EnableVersioning": false,
+        "EntityTypeName": "OData__x005f_catalogs_x002f_theme",
+        "ExemptFromBlockDownloadOfNonViewableFiles": false,
+        "FileSavePostProcessingEnabled": false,
+        "ForceCheckout": false,
+        "HasExternalDataSource": false,
+        "Hidden": true,
+        "Id": "66e5148c-7060-4479-88e7-636d79579148",
+        "ImagePath": {
+          "DecodedUrl": "/_layouts/15/images/itdl.png?rev=47"
+        },
+        "ImageUrl": "/_layouts/15/images/itdl.png?rev=47",
+        "DefaultSensitivityLabelForLibrary": "",
+        "IrmEnabled": false,
+        "IrmExpire": false,
+        "IrmReject": false,
+        "IsApplicationList": false,
+        "IsCatalog": true,
+        "IsPrivate": false,
+        "ItemCount": 41,
+        "LastItemDeletedDate": "2020-01-12T01:03:13Z",
+        "LastItemModifiedDate": "2020-01-12T01:03:18Z",
+        "LastItemUserModifiedDate": "2020-01-12T01:03:18Z",
+        "ListExperienceOptions": 0,
+        "ListItemEntityTypeFullName": "SP.Data.OData__x005f_catalogs_x002f_themeItem",
+        "MajorVersionLimit": 0,
+        "MajorWithMinorVersionsLimit": 0,
+        "MultipleDataList": false,
+        "NoCrawl": true,
+        "ParentWebPath": {
+          "DecodedUrl": "/"
+        },
+        "ParentWebUrl": "/",
+        "ParserDisabled": false,
+        "ServerTemplateCanCreateFolders": false,
+        "TemplateFeatureId": "00000000-0000-0000-0000-000000000000",
+        "Title": "Theme Gallery",
+        "Url": "/_catalogs/theme"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Id                                    Url
+    ------------------------------------  ----------------
+    66e5148c-7060-4479-88e7-636d79579148  /_catalogs/theme
+    ```
+
+=== "CSV"
+
+    ```csv
+    Id,Url
+    Theme Gallery,/_catalogs/theme,66e5148c-7060-4479-88e7-636d79579148
+    ```

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

@@ -37,3 +37,7 @@ Remove the list with title _List 1_ located in site _https://contoso.sharepoint.
 ```sh
 m365 spo list remove --webUrl https://contoso.sharepoint.com/sites/project-x --title 'List 1'
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,82 @@
+# spo list roleassignment add
+
+Adds a role assignment to list permissions
+
+## Usage
+
+```sh
+m365 spo list roleassignment add [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: 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.
+
+`-t, --listTitle [listTitle]`
+: 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.
+
+`--principalId [principalId]`
+: 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 `principalId`, `upn`, or `groupName` but not multiple.
+
+`--groupName [groupName]`
+: 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.
+
+`--roleDefinitionName [roleDefinitionName]`
+: Enter the name of a role definition, like 'Contribute', 'Read', etc. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+add role assignment to list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --principalId 11 --roleDefinitionId 1073741829
+```
+
+add role assignment to list _0CD891EF-AFCE-4E55-B836-FCE03286CCCF_ located in site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "0CD891EF-AFCE-4E55-B836-FCE03286CCCF" --principalId 11 --roleDefinitionId 1073741829
+```
+
+add role assignment to list _sites/documents_ located in site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listUrl "sites/documents" --principalId 11 --roleDefinitionId 1073741829
+```
+
+add role assignment to list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_for upn _someaccount@tenant.onmicrosoft.com_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --upn "someaccount@tenant.onmicrosoft.com" --roleDefinitionId 1073741829
+```
+
+add role assignment to list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_for group _someGroup_ and role definition id _1073741829_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --groupName "someGroup" --roleDefinitionId 1073741829
+```
+
+add role assignment to list _someList_ located in site _https://contoso.sharepoint.com/sites/project-x_for principal id _11_ and role definition name _Full Control_
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --principalId 11 --roleDefinitionName "Full Control"
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,61 @@
+# spo list roleassignment remove
+
+Removes a role assignment from list permissions
+
+## Usage
+
+```sh
+m365 spo list roleassignment remove [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: 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.
+
+`-t, --listTitle [listTitle]`
+: 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.
+
+`--principalId [principalId]`
+: 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 `principalId`, `upn`, or `groupName` but not multiple.
+
+`--groupName [groupName]`
+: 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.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove roleassignment from list by title based on group name
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listTitle "someList" --groupName "saleGroup"
+```
+
+Remove roleassignment from list by title based on principal Id
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listTitle "Events" --principalId 2
+```
+
+Remove roleassignment from list by url based on principal Id
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --principalId 2
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -11,17 +11,23 @@ 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
 
+`--confirm`
+: Do not prompt for confirmation before breaking role inheritance.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -30,26 +36,36 @@ 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" --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
 
 ```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" --listId "202b8199-b9de-43fd-9737-7f213f51c991" --clearExistingPermissions --confirm
 ```
+
+## Response
+
+The command won't return a response on success.