@pnp/cli-microsoft365 10.0.0-beta.c07d83f → 10.0.0-beta.d126736

package/docs/docs/cmd/entra/m365group/m365group-set.mdx

@@ -19,11 +19,14 @@ m365 aad m365group set [options]
 ## Options
 
 ```md definition-list
-`-i, --id <id>`
+`-i, --id [id]`
 : The ID of the Microsoft 365 Group to update
 
 `-n, --displayName [displayName]`
-: Display name for the Microsoft 365 Group
+: Display name of the Microsoft 365 Group to update
+
+`--newDisplayName [newDisplayName]`
+: New display name for the Microsoft 365 Group
 
 `-d, --description [description]`
 : Description for the Microsoft 365 Group
@@ -72,7 +75,7 @@ Options `allowExternalSenders` and `autoSubscribeNewMembers` can only be set usi
 Update Microsoft 365 Group display name.
 
 ```sh
-m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --displayName Finance
+m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --newDisplayName Finance
 ```
 
 Change Microsoft 365 Group visibility to public.
@@ -81,16 +84,16 @@ Change Microsoft 365 Group visibility to public.
 m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --isPrivate `false`
 ```
 
-Add new Microsoft 365 Group owners.
+Add new Microsoft 365 Group owners of group.
 
 ```sh
-m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --owners "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
+m365 entra m365group set --displayName 'Project Team' --owners "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
 ```
 
 Add new Microsoft 365 Group members.
 
 ```sh
-m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --members "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
+m365 entra m365group set --displayName 'Project Team' --members "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
 ```
 
 Update Microsoft 365 Group logo.

package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx

@@ -37,9 +37,6 @@ m365 teams user add
 `--teamName [teamName]`
 : The display name of the Microsoft Teams team. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
 
-`-n, --userName [userName]`
-: (deprecated) User's UPN (User Principal Name), e.g. johndoe@example.com.
-
 `--ids [ids]`
 : Microsoft Entra IDs of users. You can also pass a comma-separated list of IDs. Specify either `ids` or `userNames` but not both.
 

package/docs/docs/cmd/external/item/item-add.mdx

@@ -63,13 +63,13 @@ For more information about using these options, see the Microsoft Graph API docu
 Creates an external item with simple properties that everyone is allowed to access
 
 ```sh
-m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
+m365 external item add --id "pnp-ensure-siteassets-library" --externalConnectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
 ```
 
 Creates an external item with multi-value properties accessible only to users from the specified Entra group
 
 ```sh
-m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors@odata.type "Collection(String)" --authors "Phil Harding;#Steve Smith" --acls "grant,group,Super users"
+m365 external item add --id "pnp-ensure-siteassets-library" --externalConnectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors@odata.type "Collection(String)" --authors "Phil Harding;#Steve Smith" --acls "grant,group,Super users"
 ```
 
 ## Response
@@ -123,7 +123,7 @@ m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samp
   <TabItem value="Markdown">
 
   ```md
-  # m365 external item add --id "pnp-ensure-siteassets-library" --connectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
+  # m365 external item add --id "pnp-ensure-siteassets-library" --externalConnectionId "samplesolutiongallery" --content "Ensure that the Site Assets library is created." --title "Ensure the Site Assets Library is created" --description "Ensure that the Site Assets library is created." --authors "Phil Harding" --acls "grant,everyone,everyone"
 
   Date: 2023-10-28
 

package/docs/docs/cmd/spfx/project/project-upgrade.mdx

@@ -35,7 +35,7 @@ m365 spfx project upgrade [options]
 
 ## Remarks
 
-The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.19.0).
+The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.20.0).
 
 This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
 

package/docs/docs/cmd/spo/page/page-remove.mdx

@@ -13,36 +13,54 @@ m365 spo page remove [options]
 ## Options
 
 ```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the page is located.
+
 `-n, --name <name>`
-: Name of the page to remove.
+: Name of the page.
 
-`-u, --webUrl <webUrl>`
-: URL of the site from which the page should be removed.
+`--recycle`
+: Send the page to the recycle bin instead of permanently deleting it.
+
+`--bypassSharedLock`
+: Remove the page even if it is locked for shared use.
 
 `-f, --force`
-: Do not prompt for confirmation before removing the page.
+: Do not prompt for confirmation.
 ```
 
 <Global />
 
-## Remarks
-
-If you try to remove a page with that does not exist, you will get a `The file does not exist` error.
-
-If you set the `-f, --force` flag, you will not be prompted for confirmation before the page is actually removed.
-
 ## Examples
 
 Remove a modern page
 
 ```sh
-m365 spo page remove --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team
+m365 spo page remove --name HR.aspx --webUrl https://contoso.sharepoint.com/sites/Marketing
 ```
 
 Remove a modern page without a confirmation prompt
 
 ```sh
-m365 spo page remove --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --force
+m365 spo page remove --name HR.aspx --webUrl https://contoso.sharepoint.com/sites/Marketing --force
+```
+
+Send a page to the recycle bin
+
+```sh
+m365 spo page remove --name HR.aspx --webUrl https://contoso.sharepoint.com/sites/Marketing --recycle
+```
+
+Remove a page that is locked
+
+```sh
+m365 spo page remove --name HR.aspx --webUrl https://contoso.sharepoint.com/sites/Marketing --bypassSharedLock
+```
+
+Remove a page that is located in a subfolder
+
+```sh
+m365 spo page remove --name /Departments/People/HR.aspx --webUrl https://contoso.sharepoint.com/sites/Marketing
 ```
 
 ## Response

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

@@ -28,12 +28,10 @@ m365 spo site admin list [options]
 
 :::info
 
-To use this command with the `--asAdmin` mode, you must have permission to access the tenant admin site.
+To use this command with the `--asAdmin` mode, you must be at least SharePoint administrator.
 
 Without this parameter, you must have site collection admin permissions for the requested site.
 
-In `--asAdmin` mode, the Id, PrincipalType, and PrincipalTypeString properties are not exported.
-
 :::
 
 ## Examples
@@ -52,6 +50,8 @@ m365 spo site admin list --siteUrl https://contoso.sharepoint.com --asAdmin
 
 ## Response
 
+### Standard response
+
 <Tabs>
   <TabItem value="JSON">
 
@@ -73,13 +73,9 @@ m365 spo site admin list --siteUrl https://contoso.sharepoint.com --asAdmin
   <TabItem value="Text">
 
   ```text
-  Email               : user@contoso.com
-  Id                  : 6
-  LoginName           : i:0#.f|membership|user@contoso.com
-  PrincipalType       : 1
-  PrincipalTypeString : User
-  Title               : User Example
-  IsPrimaryAdmin      : true
+  Id  LoginName                                                                    Title    PrincipalTypeString
+  --  ---------------------------------------------------------------------------  -------  -------------------
+  15  c:0o.c|federateddirectoryclaimprovider|d8430798-5a00-00ba-83b0-dd7a032d549a  Members  SecurityGroup
   ```
 
   </TabItem>
@@ -98,7 +94,7 @@ m365 spo site admin list --siteUrl https://contoso.sharepoint.com --asAdmin
 
   Date: 20/03/2024
 
-  ## User
+  ## User Example
 
   Property | Value
   ---------|-------
@@ -112,4 +108,60 @@ m365 spo site admin list --siteUrl https://contoso.sharepoint.com --asAdmin
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>
+
+### `asAdmin` response
+
+When we make use of the option `asAdmin` the response will differ. 
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "Email": "user@contoso.com",
+      "LoginName": "i:0#.f|membership|user@contoso.com",
+      "Title": "User Example",
+      "IsPrimaryAdmin": true
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  LoginName                                                                    Title          
+  ---------------------------------------------------------------------------  ---------------
+  c:0o.c|federateddirectoryclaimprovider|d8430798-5a00-00ba-83b0-dd7a032d549a  Members        
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  Email,LoginName,Title,IsPrimaryAdmin
+  user@contoso.com,i:0#.f|membership|user@contoso.com,User Example,1
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo site admin list --siteUrl "https://contoso.sharepoint.com/sites/Test" --asAdmin
+
+  Date: 20/03/2024
+
+  ## User Example
+
+  Property | Value
+  ---------|-------
+  Email | user@contoso.com
+  LoginName | i:0#.f\|membership\|user@contoso.com
+  Title | User Example
+  IsPrimaryAdmin | true
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/site/site-sharingpermission-set.mdx

@@ -0,0 +1,58 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo site sharingpermission set
+
+Controls how a site and its components can be shared
+
+## Usage
+
+```sh
+m365 spo site sharingpermission set [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --url <url>`
+: URL of the site.
+
+`--capability <capability>`
+: Define how the site is shared. Possible values: `full`, `limited`, `ownersOnly`.
+```
+
+<Global />
+
+## Remarks
+
+When specifying `capability`, consider the following:
+- `full`: Site owners and members can share files, folders, and the site. People with Edit permissions can share files and folders.
+- `limited`: Site owners and members, and people with Edit permissions can share files and folders, but only site owners can share the site.
+- `ownersOnly`: Only site owners can share files, folders, and the site.
+
+## Examples
+
+Update the sharing permissions for a site so only owners can share files and the site
+
+```sh
+m365 spo site sharingpermission set --siteUrl https://siteaddress.com/sites/sitename  --capability ownersOnly
+```
+
+Update the sharing permissions for a site where so both owners and members can share files and the site
+
+```sh
+m365 spo site sharingpermission set --siteUrl https://siteaddress.com/sites/sitename  --capability full
+```
+
+Update the sharing permissions for a site where so owners can share the site, but members can only share files
+
+```sh
+m365 spo site sharingpermission set --siteUrl https://siteaddress.com/sites/sitename  --capability full
+```
+
+## Response
+
+The command won't return a response on success.
+
+## More information
+
+- Sharing a SharePoint site: [https://support.microsoft.com/office/share-a-site-958771a8-d041-4eb8-b51c-afea2eae3658](https://support.microsoft.com/office/share-a-site-958771a8-d041-4eb8-b51c-afea2eae3658)

package/docs/docs/cmd/spo/{site/site-rename.mdx → tenant/tenant-site-rename.mdx}

@@ -2,14 +2,14 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# spo site rename
+# spo tenant site rename
 
 Renames the URL and title of a site collection
 
 ## Usage
 
 ```sh
-m365 spo site rename [options]
+m365 spo tenant site rename [options]
 ```
 
 ## Options
@@ -38,7 +38,7 @@ m365 spo site rename [options]
 
 ## Remarks
 
-Renaming site collections is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the operation to complete fully, you should use the `--wait` flag. When using this flag, the `spo site rename` command  will keep running until it receives confirmation from Microsoft 365 that the site rename operation has completed.
+Renaming site collections is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the operation to complete fully, you should use the `--wait` flag. When using this flag, the `spo tenant site rename` command  will keep running until it receives confirmation from Microsoft 365 that the site rename operation has completed.
 
 :::info
 
@@ -51,19 +51,19 @@ To use this command you must have permissions to access the tenant admin site.
 Starts the rename of the site collection with name "samplesite" to "renamed" without modifying the title
 
 ```sh
-m365 spo site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed
+m365 spo tenant site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed
 ```
 
 Starts the rename of the site collection with name "samplesite" to "renamed" modifying the title of the site to "New Title"
 
 ```sh
-m365 spo site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed --newTitle "New Title"
+m365 spo tenant site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed --newTitle "New Title"
 ```
 
 Renames the specified site collection and waits for the operation to complete
 
 ```sh
-m365 spo site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed --newTitle "New Title" --wait
+m365 spo tenant site rename --url http://contoso.sharepoint.com/samplesite --newUrl http://contoso.sharepoint.com/renamed --newTitle "New Title" --wait
 ```
 
 ## Response
@@ -130,7 +130,7 @@ m365 spo site rename --url http://contoso.sharepoint.com/samplesite --newUrl htt
   <TabItem value="Markdown">
 
   ```md
-  # spo site rename --url "https://contoso.sharepoint.com/sites/team1" --newUrl "https://contoso.sharepoint.com/sites/team2"
+  # spo tenant site rename --url "https://contoso.sharepoint.com/sites/team1" --newUrl "https://contoso.sharepoint.com/sites/team2"
 
   Date: 2023-06-21
 

package/docs/docs/cmd/teams/tab/tab-list.mdx

@@ -67,8 +67,7 @@ m365 teams tab list --teamId 00000000-0000-0000-0000-000000000000 --channelId 19
         "externalId": null,
         "displayName": "My Contoso Tab",
         "distributionMethod": "store"
-      },
-      "teamsAppTabId": "1542629c-01b3-4a6d-8f76-1938b779e48d"
+      }
     }
   ]
   ```

package/docs/docs/cmd/viva/engage/engage-community-list.mdx

@@ -0,0 +1,81 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# viva engage community list
+
+Lists all Viva Engage communities
+
+## Usage
+
+```sh
+m365 viva engage community list [options]
+```
+
+## Options
+
+<Global />
+
+## Examples
+
+Lists all Viva Engage communities
+
+```sh
+m365 viva engage community list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9",
+      "displayName": "All Company",
+      "description": "This is the default group for everyone in the network",
+      "privacy": "public",
+      "groupId": "7c99afd7-9f3a-49e2-b105-4ee36314350c"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                                displayName  privacy
+  ------------------------------------------------  -----------  -------
+  eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9  All Company  public
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,displayName,description,privacy,groupId
+  eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9,All Company,This is the default group for everyone in the network,public,7c99afd7-9f3a-49e2-b105-4ee36314350c
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # viva engage community list
+
+  Date: 8/29/2024
+
+  ## All Company (eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9)
+
+  Property | Value
+  ---------|-------
+  id | eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9
+  displayName | All Company
+  description | This is the default group for everyone in the network
+  privacy | public
+  groupId | 7c99afd7-9f3a-49e2-b105-4ee36314350c
+  ```
+  
+  </TabItem>
+</Tabs>

package/package.json

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

package/dist/m365/cli/commands/cli-reconsent.js

@@ -1,29 +0,0 @@
-import { cli } from '../../../cli/cli.js';
-import { settingsNames } from '../../../settingsNames.js';
-import { browserUtil } from '../../../utils/browserUtil.js';
-import AnonymousCommand from '../../base/AnonymousCommand.js';
-import commands from '../commands.js';
-class CliReconsentCommand extends AnonymousCommand {
-    get name() {
-        return commands.RECONSENT;
-    }
-    get description() {
-        return 'Returns URL to open in the browser to re-consent CLI for Microsoft 365 Microsoft Entra permissions';
-    }
-    async commandAction(logger) {
-        const url = `https://login.microsoftonline.com/${cli.getTenant()}/oauth2/authorize?client_id=${cli.getClientId()}&response_type=code&prompt=admin_consent`;
-        if (cli.getSettingWithDefaultValue(settingsNames.autoOpenLinksInBrowser, false) === false) {
-            await logger.log(`To re-consent your Microsoft Entra application, navigate in your web browser to ${url}.`);
-            return;
-        }
-        await logger.log(`Opening the following page in your browser: ${url}`);
-        try {
-            await browserUtil.open(url);
-        }
-        catch (err) {
-            this.handleRejectedODataJsonPromise(err);
-        }
-    }
-}
-export default new CliReconsentCommand();
-//# sourceMappingURL=cli-reconsent.js.map

package/docs/docs/cmd/cli/cli-reconsent.mdx

@@ -1,62 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-
-# cli reconsent
-
-Returns URL to open in the browser to re-consent CLI for Microsoft 365 Microsoft Entra permissions
-
-## Usage
-
-```sh
-m365 cli reconsent [options]
-```
-
-## Options
-
-<Global />
-
-## Examples
-
-Get the URL to open in the browser to re-consent CLI for Microsoft 365 permissions
-
-```sh
-m365 cli reconsent
-```
-
-## Response
-
-<Tabs>
-  <TabItem value="JSON">
-
-  ```json
-  "To re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent"
-  ```
-
-  </TabItem>
-  <TabItem value="Text">
-
-  ```text
-  To re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent
-  ```
-
-  </TabItem>
-  <TabItem value="CSV">
-
-  ```csv
-  To re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent
-  ```
-
-  </TabItem>
-  <TabItem value="Markdown">
-
-  ```md
-  To re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent
-  ```
-
-  </TabItem>
-</Tabs>
-
-## More information
-
-- Re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application: [https://pnp.github.io/cli-microsoft365/user-guide/connecting-microsoft-365/#re-consent-the-pnp-microsoft-365-management-shell-azure-ad-application](https://pnp.github.io/cli-microsoft365/user-guide/connecting-microsoft-365/#re-consent-the-pnp-microsoft-365-management-shell-azure-ad-application)