@pnp/cli-microsoft365 8.1.0-beta.3bc5759 → 8.1.0-beta.a4eba60

package/docs/docs/cmd/spo/folder/folder-sharinglink-list.mdx

@@ -0,0 +1,114 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo folder sharinglink list
+
+Lists all the sharing links of a specific folder
+
+## Usage
+
+```sh
+m365 spo folder sharinglink list [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the site where the folder is located.
+
+`--folderUrl [folderUrl]`
+: The server- or site-relative decoded URL of the folder. Specify either `folderUrl` or `folderId` but not both.
+
+`--folderId [folderId]`
+: The UniqueId (GUID) of the folder. Specify either `folderUrl` or `folderId` but not both.
+
+`-s, --scope [scope]`
+: Filter the results to only sharing links of a given scope: `anonymous`, `users` or `organization`. By default all sharing links are listed.
+```
+
+<Global />
+
+## Examples
+
+List sharing links of a folder by id.
+
+```sh
+m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderId daebb04b-a773-4baa-b1d1-3625418e3234
+```
+
+List sharing links of a folder by url.
+
+```sh
+m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderUrl "/sites/demo/shared documents/folder"
+```
+
+List anonymous sharing links of a folder by url.
+
+```sh
+m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderUrl "/sites/demo/shared documents/folder" --scope anonymous
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "e6100f73-981c-4bde-986b-eed262f04659",
+      "roles": [
+        "write"
+      ],
+      "shareId": "u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc",
+      "hasPassword": false,
+      "grantedToIdentitiesV2": [],
+      "grantedToIdentities": [],
+      "link": {
+        "scope": "anonymous",
+        "type": "edit",
+        "webUrl": "https://contoso.sharepoint.com/:f:/g/EvAQivzKWfhOvI8rb6mTTHcBd3QLB9ulPb2A45Po5fdnag",
+        "preventsDownload": false
+      }
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                    scope         roles  link
+  ------------------------------------  ------------  -----  -----------------------------------------------------------------------------------
+  e6100f73-981c-4bde-986b-eed262f04659  anonymous     write  https://contoso.sharepoint.com/:f:/g/EvAQivzKWfhOvI8rb6mTTHcBd3QLB9ulPb2A45Po5fdnag
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,shareId,hasPassword
+  e6100f73-981c-4bde-986b-eed262f04659,u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo folder sharinglink list --webUrl "https://contoso.sharepoint.com/" --folderUrl "/shared documents/folder1"
+
+  Date: 24/04/2024
+
+  ## e6100f73-981c-4bde-986b-eed262f04659
+
+  Property | Value
+  ---------|-------
+  id | e6100f73-981c-4bde-986b-eed262f04659
+  shareId | u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc
+  hasPassword | false
+  ```
+
+  </TabItem>
+</Tabs>

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

@@ -91,6 +91,11 @@ m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/site
 
   ```json
   {
+    "VersionPolicies": {
+      "DefaultExpireAfterDays": 0,
+      "DefaultTrimMode": 0,
+      "DefaultTrimModeValue": "NoExpiration"
+    },
     "AllowContentTypes": true,
     "BaseTemplate": 100,
     "BaseType": 0,
@@ -210,6 +215,7 @@ m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/site
   ServerTemplateCanCreateFolders           : true
   TemplateFeatureId                        : 00bfea71-de22-43b2-a848-c05709900100
   Title                                    : Test
+  VersionPolicies                          : {"DefaultExpireAfterDays": 0,"DefaultTrimMode": 0,"DefaultTrimModeValue": "NoExpiration"}
   ```
 
   </TabItem>

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

@@ -26,13 +26,19 @@ m365 spo list roleassignment add [options]
 : 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.
+: SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
 
 `--upn [upn]`
-: The upn/email of user to assign role to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The upn/email of user to assign role to. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
+
+`--entraGroupId [entraGroupId]`
+: ID of the Microsoft Entra group to assign permissions to. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
+
+`--entraGroupName [entraGroupName]`
+: Display name of the Microsoft Entra group to assign permissions to. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
 
 `--groupName [groupName]`
-: The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The group name of the SharePoint group. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
 
 `--roleDefinitionId [roleDefinitionId]`
 : ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
@@ -81,6 +87,12 @@ Adds role assignment to list by title located in a specific site for given princ
 m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --principalId 11 --roleDefinitionName "Full Control"
 ```
 
+Adds role assignment to list for a Microsoft Entra group specified by display name.
+
+```sh
+m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --entraGroupName "Marketing" --roleDefinitionName "Full Control"
+```
+
 ## Response
 
 The command won't return a response on success.

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

@@ -26,13 +26,19 @@ m365 spo list roleassignment remove [options]
 : 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.
+: SharePoint ID of principal it may be either user id or group id you want to remove permissions. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
 
 `--upn [upn]`
-: The upn/email of user. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The upn/email of user. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
 
 `--groupName [groupName]`
-: The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The group name of the SharePoint group. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
+
+`--entraGroupId [entraGroupId]`
+: ID of the Microsoft Entra group. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
+
+`--entraGroupName [entraGroupName]`
+: Display name of the Microsoft Entra group. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
 
 `-f, --force`
 : Don't prompt for confirming removing the role assignment.
@@ -60,6 +66,12 @@ Remove roleassignment from list by url based on principal Id.
 m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --principalId 2
 ```
 
+Remove roleassignment from Microsoft Entra group specified by display name.
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --entraGroupName "Sales Team"
+```
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.mdx

@@ -14,19 +14,19 @@ m365 spo listitem retentionlabel ensure [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: URL of the site where the retentionlabel from a listitem to apply is located
+: URL of the site where the retentionlabel from a list item to apply is located.
 
 `--listItemId <listItemId>`
 : The ID of the list item for which the retention label should be applied.
 
 `--listId [listId]`
-: ID of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`
+: ID of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`.
 
 `--listTitle [listTitle]`
-: Title of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`
+: Title of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`.
 
 `--listUrl [listUrl]`
-: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-n, --name [name]`
 : The name of the retention label. Specify either `name` or `id`.

package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-remove.mdx

@@ -14,7 +14,7 @@ m365 spo listitem retentionlabel remove [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: URL of the site where the retentionlabel from a listitem to remove is located
+: URL of the site where the retentionlabel from a list item to remove is located
 
 `-i, --listItemId <listItemId>`
 : The ID of the list item for which the retention label should be removed.

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

@@ -14,7 +14,7 @@ m365 spo listitem roleassignment add [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: URL of the site where the listitem is located
+: URL of the site where the list item is located
 
 `--listId [listId]`
 : ID of the list. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
@@ -26,7 +26,7 @@ m365 spo listitem roleassignment add [options]
 : 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.
+: Id of the list item 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`.
@@ -35,7 +35,7 @@ m365 spo listitem roleassignment add [options]
 : The upn/email of user to assign role to. Specify either `upn`, `groupName` or `principalId`.
 
 `--groupName [groupName]`
-: The group name of Microsoft Entra or SharePoint group. Specify either `upn`, `groupName` or `principalId`.
+: The group name of the SharePoint group Specify either `upn`, `groupName` or `principalId`.
 
 `--roleDefinitionId [roleDefinitionId]`
 : ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
@@ -48,37 +48,37 @@ m365 spo listitem roleassignment add [options]
 
 ## Examples
 
-Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
+Add role assignment to specified list item 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.
+Add role assignment to specified list item 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.
+Add role assignment to specified list item 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.
+Add role assignment to specified list item 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.
+Add role assignment to specified list item 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.
+Add role assignment to specified list item 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"

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

@@ -14,7 +14,7 @@ m365 spo listitem roleassignment remove [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: URL of the site where the listitem is located.
+: URL of the site where the list item is located.
 
 `-i, --listId [listId]`
 : ID of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
@@ -26,7 +26,7 @@ m365 spo listitem roleassignment remove [options]
 : 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.
+: Id of the list item 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 either `principalId`, `upn`, or `groupName` but not multiple.
@@ -35,7 +35,7 @@ m365 spo listitem roleassignment remove [options]
 : The upn/email of user. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--groupName [groupName]`
-: The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The group name of the SharePoint group Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `-f, --force`
 : Don't prompt for confirming removing the role assignment.
@@ -45,26 +45,26 @@ m365 spo listitem roleassignment remove [options]
 
 ## Examples
 
-Remove roleassignment from listitem getting list by title based on group name
+Remove roleassignment from list item getting list by title based on group name
 
 ```sh
 m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listTitle "someList" --listItemId 1 --groupName "saleGroup"
 ```
 
-Remove roleassignment from listitem getting list by title based on principal Id
+Remove roleassignment from list item getting list by title based on principal Id
 
 ```sh
 m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listTitle "Events" --listItemId 1 --principalId 2
 ```
 
-Remove roleassignment from listitem getting list by url based on principal Id
+Remove roleassignment from list item getting list by url based on principal Id
 
 ```sh
 m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --listItemId 1 --principalId 2
 ```
 
 
-Remove roleassignment from listitem getting list by url based on principal Id without prompting for confirmation
+Remove roleassignment from list item getting list by url based on principal Id without prompting for confirmation
 
 ```sh
 m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --listItemId 1 --principalId 2 --force

package/docs/docs/cmd/spo/site/site-recyclebinitem-list.mdx

@@ -19,7 +19,7 @@ m365 spo site recyclebinitem list [options]
 : URL of the site for which to retrieve the recycle bin items
 
 `--type [type]`
-: Type of items which should be retrieved (listItems, folders, files)
+: Type of items which should be retrieved. Valid values: `listItems`, `folders`, `files`.
 
 `--secondary`
 : Use this switch to retrieve items from secondary recycle bin

package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx

@@ -23,7 +23,7 @@ m365 spo web roleassignment add [options]
 : The upn/email of user to assign role to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--groupName [groupName]`
-: The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The group name of the 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.

package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx

@@ -23,7 +23,7 @@ m365 spo web roleassignment remove [options]
 : The upn/email of user to assign role to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `--groupName [groupName]`
-: The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
+: The group name of the SharePoint group Specify either `principalId`, `upn`, or `groupName` but not multiple.
 
 `-f, --force`
 : Don't prompt for confirming removing the roleassignment.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "8.1.0-beta.3bc5759",
+  "version": "8.1.0-beta.a4eba60",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",