@pnp/cli-microsoft365 6.0.0-beta.27b9708 → 6.0.0-beta.291f17c

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

@@ -17,14 +17,20 @@ m365 spo listitem get [options]
 : ID of the item to retrieve.
 
 `-l, --listId [listId]`
-: ID of the list from which to retrieve the item. Specify `listId` or `listTitle` but not both
+: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list from which to retrieve the item. Specify `listId` or `listTitle` but not both
+: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `-p, --properties [properties]`
 : Comma-separated list of properties to retrieve. Will retrieve all properties if not specified and json output is requested
 
+`--withPermissions`
+: Set if you want to return associated roles and permissions
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -33,20 +39,207 @@ If you want to specify a lookup type in the `properties` option, define which co
 
 ## Examples
 
-Get an item with ID _147_ from list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
+Get an item with the ID parameter from a given list in a given site
 
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
-Get an items _Title_ and _Created_ column with ID _147_ from list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
+Get an item columns with the ID parameter from a given list in a given site
 
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created"
 ```
 
-Get an items _Title_, _Created_ column and lookup column _Company_ with ID _147_ from list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
+Get an item columns and lookup column with the ID parameter from a given list in a given site
 
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
 ```
+
+Get an item with specific properties from a given list based on the server-relative URL in a specific site
+
+```sh
+m365 spo listitem get --listUrl /sites/project-x/documents --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
+```
+
+Get an item with ID parameter from a given list based on the server-relative URL in a specific site with permissions
+
+```sh
+m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --withPermissions
+```
+
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "FileSystemObjectType": 0,
+      "Id": 147,
+      "ServerRedirectedEmbedUri": null,
+      "ServerRedirectedEmbedUrl": "",
+      "ContentTypeId": "0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126",
+      "Title": "Demo Item",
+      "Modified": "2022-10-30T10:55:37Z",
+      "Created": "2022-10-30T10:55:22Z",
+      "AuthorId": 10,
+      "EditorId": 10,
+      "OData__UIVersionString": "3.0",
+      "Attachments": false,
+      "GUID": "87f3138d-fac3-4126-97c0-543e55672261",
+      "ComplianceAssetId": null
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Attachments             : false
+    AuthorId                : 10
+    ComplianceAssetId       : null
+    ContentTypeId           : 0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126
+    Created                 : 2022-10-30T10:55:22Z
+    EditorId                : 10
+    FileSystemObjectType    : 0
+    GUID                    : 87f3138d-fac3-4126-97c0-543e55672261
+    Id                      : 147
+    Modified                : 2022-10-30T10:55:37Z
+    OData__UIVersionString  : 3.0
+    ServerRedirectedEmbedUri: null
+    ServerRedirectedEmbedUrl:
+    Title                   : Demo Item
+    ```
+
+=== "CSV"
+
+    ```csv
+    FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId
+    0,147,,,0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126,Demo Item,2022-10-30T10:55:37Z,2022-10-30T10:55:22Z,10,10,3.0,,87f3138d-fac3-4126-97c0-543e55672261,
+    ```
+
+### `withPermissions` response
+
+When we make use of the option `withPermissions` the response will differ. 
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "FileSystemObjectType": 0,
+      "Id": 147,
+      "ServerRedirectedEmbedUri": null,
+      "ServerRedirectedEmbedUrl": "",
+      "ContentTypeId": "0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126",
+      "Title": "Demo Item",
+      "Modified": "2022-10-30T10:55:37Z",
+      "Created": "2022-10-30T10:55:22Z",
+      "AuthorId": 10,
+      "EditorId": 10,
+      "OData__UIVersionString": "3.0",
+      "Attachments": false,
+      "GUID": "87f3138d-fac3-4126-97c0-543e55672261",
+      "ComplianceAssetId": null,
+      "RoleAssignments": [
+        {
+          "Member": {
+            "Id": 3,
+            "IsHiddenInUI": false,
+            "LoginName": "Communication site Owners",
+            "Title": "Communication site Owners",
+            "PrincipalType": 8,
+            "AllowMembersEditMembership": false,
+            "AllowRequestToJoinLeave": false,
+            "AutoAcceptRequestToJoinLeave": false,
+            "Description": null,
+            "OnlyAllowMembersViewMembership": false,
+            "OwnerTitle": "Communication site Owners",
+            "RequestToJoinLeaveEmailSetting": ""
+          },
+          "RoleDefinitionBindings": [
+            {
+              "BasePermissions": {
+                "High": "2147483647",
+                "Low": "4294967295"
+              },
+              "Description": "Has full control.",
+              "Hidden": false,
+              "Id": 1073741829,
+              "Name": "Full Control",
+              "Order": 1,
+              "RoleTypeKind": 5,
+              "BasePermissionsValue": [
+                "ViewListItems",
+                "AddListItems",
+                "EditListItems",
+                "DeleteListItems",
+                "ApproveItems",
+                "OpenItems",
+                "ViewVersions",
+                "DeleteVersions",
+                "CancelCheckout",
+                "ManagePersonalViews",
+                "ManageLists",
+                "ViewFormPages",
+                "AnonymousSearchAccessList",
+                "Open",
+                "ViewPages",
+                "AddAndCustomizePages",
+                "ApplyThemeAndBorder",
+                "ApplyStyleSheets",
+                "ViewUsageData",
+                "CreateSSCSite",
+                "ManageSubwebs",
+                "CreateGroups",
+                "ManagePermissions",
+                "BrowseDirectories",
+                "BrowseUserInfo",
+                "AddDelPrivateWebParts",
+                "UpdatePersonalWebParts",
+                "ManageWeb",
+                "AnonymousSearchAccessWebLists",
+                "UseClientIntegration",
+                "UseRemoteAPIs",
+                "ManageAlerts",
+                "CreateAlerts",
+                "EditMyUserInfo",
+                "EnumeratePermissions"
+              ],
+              "RoleTypeKindValue": "Administrator"
+            }
+          ],
+          "PrincipalId": 3
+        }
+      ]
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Attachments             : false
+    AuthorId                : 10
+    ComplianceAssetId       : null
+    ContentTypeId           : 0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126
+    Created                 : 2022-10-30T10:55:22Z
+    EditorId                : 10
+    FileSystemObjectType    : 0
+    GUID                    : 87f3138d-fac3-4126-97c0-543e55672261
+    Id                      : 147
+    Modified                : 2022-10-30T10:55:37Z
+    OData__UIVersionString  : 3.0
+    RoleAssignments         : [{"Member":{"Id":3,"IsHiddenInUI":false,"LoginName":"Communication site Owners","Title":"Communication site Owners","PrincipalType":8,"AllowMembersEditMembership":false,"AllowRequestToJoinLeave":false,"AutoAcceptRequestToJoinLeave":false,"Description":null,"OnlyAllowMembersViewMembership":false,"OwnerTitle":"Communication site Owners","RequestToJoinLeaveEmailSetting":""},"RoleDefinitionBindings":[{"BasePermissions":{"High":"2147483647","Low":"4294967295"},"Description":"Has full control.","Hidden":false,"Id":1073741829,"Name":"Full Control","Order":1,"RoleTypeKind":5,"BasePermissionsValue":["ViewListItems","AddListItems","EditListItems","DeleteListItems","ApproveItems","OpenItems","ViewVersions","DeleteVersions","CancelCheckout","ManagePersonalViews","ManageLists","ViewFormPages","AnonymousSearchAccessList","Open","ViewPages","AddAndCustomizePages","ApplyThemeAndBorder","ApplyStyleSheets","ViewUsageData","CreateSSCSite","ManageSubwebs","CreateGroups","ManagePermissions","BrowseDirectories","BrowseUserInfo","AddDelPrivateWebParts","UpdatePersonalWebParts","ManageWeb","AnonymousSearchAccessWebLists","UseClientIntegration","UseRemoteAPIs","ManageAlerts","CreateAlerts","EditMyUserInfo","EnumeratePermissions"],"RoleTypeKindValue":"Administrator"}],"PrincipalId":3}]
+    ServerRedirectedEmbedUri: null
+    ServerRedirectedEmbedUrl:
+    Title                   : Demo Item
+    ```
+
+=== "CSV"
+
+    ```csv
+    FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,RoleAssignments
+    0,147,,,0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126,Demo Item,2022-10-30T10:55:37Z,2022-10-30T10:55:22Z,10,10,3.0,,87f3138d-fac3-4126-97c0-543e55672261,"[{""Member"":{""Id"":3,""IsHiddenInUI"":false,""LoginName"":""Communication site Owners"",""Title"":""Communication site Owners"",""PrincipalType"":8,""AllowMembersEditMembership"":false,""AllowRequestToJoinLeave"":false,""AutoAcceptRequestToJoinLeave"":false,""Description"":null,""OnlyAllowMembersViewMembership"":false,""OwnerTitle"":""Communication site Owners"",""RequestToJoinLeaveEmailSetting"":""""},""RoleDefinitionBindings"":[{""BasePermissions"":{""High"":""2147483647"",""Low"":""4294967295""},""Description"":""Has full control."",""Hidden"":false,""Id"":1073741829,""Name"":""Full Control"",""Order"":1,""RoleTypeKind"":5,""BasePermissionsValue"":[""ViewListItems"",""AddListItems"",""EditListItems"",""DeleteListItems"",""ApproveItems"",""OpenItems"",""ViewVersions"",""DeleteVersions"",""CancelCheckout"",""ManagePersonalViews"",""ManageLists"",""ViewFormPages"",""AnonymousSearchAccessList"",""Open"",""ViewPages"",""AddAndCustomizePages"",""ApplyThemeAndBorder"",""ApplyStyleSheets"",""ViewUsageData"",""CreateSSCSite"",""ManageSubwebs"",""CreateGroups"",""ManagePermissions"",""BrowseDirectories"",""BrowseUserInfo"",""AddDelPrivateWebParts"",""UpdatePersonalWebParts"",""ManageWeb"",""AnonymousSearchAccessWebLists"",""UseClientIntegration"",""UseRemoteAPIs"",""ManageAlerts"",""CreateAlerts"",""EditMyUserInfo"",""EnumeratePermissions""],""RoleTypeKindValue"":""Administrator""}],""PrincipalId"":3}]"
+    ```

package/docs/docs/cmd/spo/listitem/listitem-isrecord.md

@@ -17,10 +17,13 @@ m365 spo listitem isrecord [options]
 : The ID of the list item to check if it is a record
 
 `-l, --listId [listId]`
-: The ID of the list where the item is located. Specify `listId` or `listTitle` but not both
+: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: The title of the list where the item is located. Specify `listId` or `listTitle` but not both
+: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 --8<-- "docs/cmd/_global.md"
 
@@ -37,3 +40,29 @@ Check whether the document with id _1_ in list with id _0cd891ef-afce-4e55-b836-
 ```sh
 m365 spo listitem isrecord --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id 1
 ```
+
+Check whether a document with a specific id in a list retrieved by server-relative URL in a specific site is a record
+
+```sh
+m365 spo listitem isrecord --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/documents --id 1
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    false
+    ```
+
+=== "Text"
+
+    ```text
+    false
+    ```
+
+=== "CSV"
+
+    ```csv
+    false
+    ```

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

@@ -11,28 +11,31 @@ m365 spo listitem list [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site from which the item should be retrieved
+: URL of the site from which the item should be retrieved.
 
 `-i, --listId [listId]`
-: ID of the list to retrieve items from. Specify `listId` or `listTitle` but not both
+: ID of the list to retrieve items from. Specify `listId` or `listTitle` but not both.
+
+`-l, --listId [listId]`
+: ID of the list where the item should be added. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
 
 `-t, --listTitle [listTitle]`
-: Title of the list to retrieve items from. Specify `listId` or `listTitle` but not both
+: Title of the list where the item should be added. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
 
 `-q, --camlQuery [camlQuery]`
-: CAML query to use to query the list of items with
+: CAML query to use to query the list of items with.
 
 `-f, --fields [fields]`
-: Comma-separated list of fields to retrieve. Will retrieve all fields if not specified and json output is requested. Specify `camlQuery` or `fields` but not both
+: Comma-separated list of fields to retrieve. Will retrieve all fields if not specified and json output is requested. Specify `camlQuery` or `fields` but not both.
 
 `-l, --filter [filter]`
-: OData filter to use to query the list of items with. Specify `camlQuery` or `filter` but not both
+: OData filter to use to query the list of items with. Specify `camlQuery` or `filter` but not both.
 
 `-p, --pageSize [pageSize]`
-: Number of list items to return. Specify `camlQuery` or `pageSize` but not both
+: Number of list items to return. Specify `camlQuery` or `pageSize` but not both.
 
 `-n, --pageNumber [pageNumber]`
-: Page number to return if `pageSize` is specified (first page is indexed as value of 0)
+: Page number to return if `pageSize` is specified (first page is indexed as value of 0).
 
 --8<-- "docs/cmd/_global.md"
 
@@ -85,3 +88,50 @@ From a list named _Demo List_ get the second batch of 10 items
 ```sh
 m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --pageSize 10 --pageNumber 2
 ```
+
+Get all items from a list by server-relative URL
+
+```sh
+m365 spo listitem list --listUrl /sites/project-x/documents --webUrl https://contoso.sharepoint.com/sites/project-x
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "FileSystemObjectType": 0,
+        "Id": 236,
+        "ServerRedirectedEmbedUri": null,
+        "ServerRedirectedEmbedUrl": "",
+        "ContentTypeId": "0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803",
+        "Title": "Test",
+        "Modified": "2022-11-16T21:00:03Z",
+        "Created": "2022-11-16T20:56:31Z",
+        "AuthorId": 10,
+        "EditorId": 10,
+        "OData__UIVersionString": "6.0",
+        "Attachments": true,
+        "GUID": "cac57513-e870-4e7a-9f23-f4ea10e14f4e",
+        "ComplianceAssetId": null,
+        "OData__vti_ItemDeclaredRecord": null
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Id   Title
+    ---  -----
+    236  Test
+    ```
+
+=== "CSV"
+
+    ```csv
+    FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,OData__vti_ItemDeclaredRecord
+    0,236,,,0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803,Test,2022-11-16T21:00:03Z,2022-11-16T20:56:31Z,10,10,6.0,1,cac57513-e870-4e7a-9f23-f4ea10e14f4e,,
+    ```

package/docs/docs/cmd/spo/listitem/listitem-record-declare.md

@@ -14,10 +14,13 @@ m365 spo listitem record declare [options]
 : URL of the site where the list is located
 
 `-l, --listId [listId]`
-: The ID of the list where the item is located. Specify `listId` or `listTitle` but not both
+: The ID of the list where the item is located. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: The title of the list where the item is located. Specify `listId` or `listTitle` but not both
+: The title of the list where the item is located. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `-i, --listItemId <listItemId>`
 : The ID of the list item to declare as record
@@ -47,8 +50,37 @@ Declare a document with id _1_ as a record with record declaration date _March 1
 m365 spo listitem record declare --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List" --listItemId 1 --date 2012-03-14
 ```
 
-Declare a document with id _1_ as a record with record declaration date _September 3, 2013_ in list with id _ea8e1356-5910-abc9-bc05-2408198057fc_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Declare a document with a specific id as a record with a record declaration date a list retrieved by server-relative URL located in a specific site
 
 ```sh
-m365 spo listitem record declare --webUrl https://contoso.sharepoint.com/sites/project-x --listId ea8e1356-5910-abc9-bc05-2408198057fc --listItemId 1 --date 2013-09-03
+m365 spo listitem record declare --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/Lists/Demo List' --listItemId 1 --date 2013-09-03
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "SchemaVersion": "15.0.0.0",
+      "LibraryVersion": "16.0.23102.12004",
+      "ErrorInfo": null,
+      "TraceCorrelationId": "064779a0-d05b-5000-843d-c36803e58f12"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    ErrorInfo         : null
+    LibraryVersion    : 16.0.23102.12004
+    SchemaVersion     : 15.0.0.0
+    TraceCorrelationId: 0a4779a0-c0ca-5000-d29d-4321a1739425
+    ```
+
+=== "CSV"
+
+    ```csv
+    SchemaVersion,LibraryVersion,ErrorInfo,TraceCorrelationId
+    15.0.0.0,16.0.23102.12004,,0d4779a0-609c-5000-843d-c98e4764c937
+    ```

package/docs/docs/cmd/spo/listitem/listitem-record-undeclare.md

@@ -17,10 +17,13 @@ m365 spo listitem record undeclare [options]
 : ID of the list item to be undeclared as a record.
 
 `-l, --listId [listId]`
-: The ID of the list where the item is located. Specify `listId` or `listTitle` but not both
+: The ID of the list where the item is located. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: The title of the list where the item is located. Specify `listId` or `listTitle` but not both
+: The title of the list where the item is located. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list where the item is located. Specify either `listTitle`, `listId` or `listUrl`
 
 --8<-- "docs/cmd/_global.md"
 
@@ -37,3 +40,13 @@ Undeclare the list item as a record with ID _1_ from list with title _List 1_ lo
 ```sh
 m365 spo listitem record undeclare --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'List 1' --listItemId 1
 ```
+
+Undeclare a list item with a specific id as a record from a list retrieved by server-relative URL located in a specific site
+
+```sh
+m365 spo listitem record undeclare --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/Lists/Lists 1' --id 1
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -17,10 +17,13 @@ m365 spo listitem remove [options]
 : The ID of the list item to remove.
 
 `-l, --listId [listId]`
-: List id of the list to remove. Specify either `listId` or `listTitle` but not both
+: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list to remove. Specify either `listId` or `listTitle` but not both
+: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `--recycle`
 : Recycle the list item
@@ -43,3 +46,13 @@ Remove the list item with ID _1_ from list with title _List 1_ located in site _
 ```sh
 m365 spo listitem remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'List 1' --id 1
 ```
+
+Remove the list item with a specific ID from a list retrieved by server-relative URL located in a specific site
+
+```sh
+m365 spo listitem remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/lists/TestList --id 1
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,85 @@
+# spo listitem roleassignment add
+
+Adds a role assignment to a listitem.
+
+## Usage
+
+```sh
+m365 spo listitem roleassignment add [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the listitem is located
+
+`--listId [listId]`
+: ID of the list. Specify either listId, listTitle or listUrl but not multiple.
+
+`--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.
+
+`--listItemId <listItemId>`
+: Id of the listitem to assign the role to.
+
+`--principalId [principalId]`
+: The SharePoint Id of the principal. It may be either a user id or group id to add a role assignment for. Specify either upn, groupName or principalId.
+
+`--upn [upn]`
+: upn/email of user to assign role to. Specify either upn, groupName or principalId.
+
+`--groupName [groupName]`
+: The group name of Azure AD or SharePoint group. Specify either upn, groupName or principalId.
+
+`--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 specified listitem in specified list located in specified site for specified principal id and specified role definition id.
+
+```sh
+m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
+```
+
+Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
+
+```sh
+m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "0CD891EF-AFCE-4E55-B836-FCE03286CCCF" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
+```
+
+Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
+
+```sh
+m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listUrl "sites/documents" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
+```
+
+Add role assignment to specified listitem in specified list located in specified site for specified upn and specified role definition id.
+
+```sh
+m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --upn "someaccount@tenant.onmicrosoft.com" --roleDefinitionId 1073741829
+```
+
+Add role assignment to specified listitem in specified list located in specified site for specified group and specified role definition id.
+
+```sh
+m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --groupName "someGroup" --roleDefinitionId 1073741829
+```
+
+Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition name.
+
+```sh
+m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionName "Full Control"
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -11,31 +11,31 @@ m365 spo listitem roleassignment remove [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the listitem is located
+: URL of the site where the listitem 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.
 
 `--listItemId <listItemId>`
 : Id of the listitem to remove the role from.
 
 `--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 we want to remove permissions. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--upn [upn]`
-: upn/email of user. Specify either upn or princpialId.
+: 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 princpialId.
+: 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"
 
@@ -64,4 +64,8 @@ Remove roleassignment from listitem getting list by url based on principal Id wi
 
 ```sh
 m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --listItemId 1 --principalId 2 --confirm
-```
+```
+
+## Response
+
+The command won't return a response on success.