@pnp/cli-microsoft365 12.0.0-beta.1752794 → 12.0.0-beta.4ac11a7

package/docs/docs/cmd/spo/navigation/navigation-node-set.mdx

@@ -16,6 +16,9 @@ m365 spo navigation node set [options]
 `-u, --webUrl <webUrl>`
 : Absolute URL of the site.
 
+`-l, --location <location>`
+: Navigation type where the node is located. Available options: `QuickLaunch`, `TopNavigationBar`.
+
 `--id <id>`
 : Id of the navigation node.
 
@@ -26,10 +29,7 @@ m365 spo navigation node set [options]
 : New URL of the navigation node. Specify an empty string `""` to update the navigation label to a linkless label.
 
 `--audienceIds [audienceIds]`
-: Comma-separated list of group IDs that will be used for audience targeting. Speficy an empty string `""` to clear this value. The limit is 10 ids per navigation node.
-
-`--isExternal [isExternal]`
-: Whether the navigation node points to an external URL. Valid values: `true` or `false`.
+: Comma-separated list of group IDs that will be used for audience targeting. Specify an empty string `""` to clear this value. The limit is 10 ids per navigation node.
 
 `--openInNewWindow [openInNewWindow]`
 : Open the URL in a new window. Valid values: `true` or `false`.
@@ -41,30 +41,32 @@ m365 spo navigation node set [options]
 
 To enable/disable audience targeting for the navigation bar, use the [`spo web set`](../web/web-set.mdx) command.
 
+SharePoint doesn't allow changing the URL of a navigation node pointing to a page in the current site into an external URL. In that case, the URL isn't updated and no error is returned. To point such a node to an external URL, remove the node using [`spo navigation node remove`](./navigation-node-remove.mdx) and add it again using [`spo navigation node add`](./navigation-node-add.mdx).
+
 ## Examples
 
 Updates the title of a navigation node
 
 ```sh
-m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --id 2209 --title "Pictures"
+m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --location TopNavigationBar --id 2209 --title "Pictures"
 ```
 
 Updates the URL of a navigation node
 
 ```sh
-m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --id 2209 --url "https://www.microsoft.com" --isExternal true
+m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --location QuickLaunch --id 2209 --url "https://www.microsoft.com"
 ```
 
 Updates audience targeting of a navigation node with 3 groups
 
 ```sh
-m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --id 2209 --audienceIds "61f78c73-f71a-471e-a3b9-15daa936e200,9524e6b4-e663-44fe-b179-210c963e37e7,c42b8756-494d-4141-a575-45f01320e26a"
+m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --location QuickLaunch --id 2209 --audienceIds "61f78c73-f71a-471e-a3b9-15daa936e200,9524e6b4-e663-44fe-b179-210c963e37e7,c42b8756-494d-4141-a575-45f01320e26a"
 ```
 
 Updates the navigation node so that it opens in a new window
 
 ```sh
-m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --id 2209 --openInNewWindow true
+m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --location QuickLaunch --id 2209 --openInNewWindow true
 ```
 
 ## Response

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

@@ -0,0 +1,63 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo page unpublish
+
+Unpublishes a modern page
+
+## Usage
+
+```sh
+m365 spo page unpublish [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the page is located.
+
+`-n, --name <name>`
+: Name of the page.
+```
+
+<Global />
+
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Unpublish a modern page
+
+```sh
+m365 spo page unpublish --webUrl https://contoso.sharepoint.com/sites/Marketing --name "Style guide.aspx"
+```
+
+Unpublish a modern page in a subfolder
+
+```sh
+m365 spo page unpublish --webUrl https://contoso.sharepoint.com/sites/Marketing --name "/Styles/Guide.aspx"
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -46,6 +46,25 @@ m365 teams tab add [options]
 
 The corresponding app must already be installed in the team.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | TeamsTab.Create |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | TeamsTab.Create |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
   
 Add teams tab for website.

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

@@ -40,6 +40,25 @@ m365 teams tab get [options]
 
 You can only retrieve tabs for teams of which you are a member.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                                  |
+  |-----------------|--------------------------------------------------------------|
+  | Microsoft Graph | Channel.ReadBasic.All, Team.ReadBasic.All, TeamsTab.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                                  |
+  |-----------------|--------------------------------------------------------------|
+  | Microsoft Graph | Channel.ReadBasic.All, Team.ReadBasic.All, TeamsTab.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a Microsoft Teams Tab with the specified ID.

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

@@ -30,6 +30,25 @@ You can only retrieve tabs for teams of which you are a member.
 
 Tabs _Conversations_ and _Files_ are present in every team and therefore not included in the list of available tabs.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | TeamsTab.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | TeamsTab.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
   
 List all tabs in a Microsoft Teams channel.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # teams tab remove
 
@@ -28,6 +30,25 @@ m365 teams tab remove [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | TeamsTab.ReadWriteForTeam |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | TeamsTab.ReadWriteForTeam.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes a tab from the specified channel. Will prompt for confirmation

package/docs/docs/cmd/viva/engage/engage-message-add.mdx

@@ -41,6 +41,23 @@ In order to use this command, you need to grant the Microsoft Entra application
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource | Permissions        |
+  |----------|--------------------|
+  | Yammer   | user_impersonation |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Replies to a message with the ID 1231231231.

package/docs/docs/cmd/viva/engage/engage-message-get.mdx

@@ -29,6 +29,23 @@ In order to use this command, you need to grant the Microsoft Entra application
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource | Permissions        |
+  |----------|--------------------|
+  | Yammer   | user_impersonation |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Returns the Viva Engage message with the id 1239871123.

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

@@ -54,6 +54,23 @@ Feed types
 - Private: Private messages received by the user
 - Received: All messages received by the user
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource | Permissions        |
+  |----------|--------------------|
+  | Yammer   | user_impersonation |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Returns all Viva Engage network messages

package/docs/docs/cmd/viva/engage/engage-message-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # viva engage message remove
 
@@ -36,6 +38,23 @@ To remove a message, you must either:
 - be an administrator of the group the message was posted to or
 - be an admin of the network the message is in
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource | Permissions        |
+  |----------|--------------------|
+  | Yammer   | user_impersonation |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes the Viva Engage message with the id _1239871123_

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "12.0.0-beta.1752794",
+  "version": "12.0.0-beta.4ac11a7",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -111,11 +111,6 @@
       "name": "Milan Holemans",
       "email": "11723921+milanholemans@users.noreply.github.com",
       "web": "https://github.com/milanholemans"
-    },
-    {
-      "name": "Mathijs Verbeeck",
-      "email": "verbeeckmathijs@gmail.com",
-      "web": "https://github.com/MathijsVerbeeck"
     }
   ],
   "contributors": [
@@ -161,6 +156,7 @@
     "Honen, Nicholas <nickhonen@gmail.com>",
     "Högberg, Joakim <joakim.hogberg@bravero.se>",
     "Hunt, Geoffrey <info@runningdeveloper.com>",
+    "Hutzli, Fabian <136681117+fabianhutzli@users.noreply.github.com>",
     "Hvam, Allan <ahp@delegate.dk>",
     "Jaakke, Robert <robert.jaakke@mavention.nl>",
     "Jain, Ayush <urayushjain@gmail.com>",
@@ -233,6 +229,7 @@
     "Shafi, Danish <33339824+builtbydans@users.noreply.github.com>",
     "Shah, Dipen <Dips365@hotmail.com>",
     "Sharma, Dushyant <dushyantsharma17117@gmail.com>",
+    "Shreshtha, Sarthak <78229815+Sarthak-Shreshtha01@users.noreply.github.com>",
     "Siatka, Piotr <piotr@valointranet.com>",
     "Sinha, Kislay <kislay_sinha@outlook.com>",
     "Sitaraman, Rajesh <rajesh.sitaraman@outlook.com>",
@@ -245,6 +242,7 @@
     "Svenson, Mikael <miksvenson@gmail.com>",
     "Tane, Peter <peter.tane@gmail.come>",
     "Tatti, Anoop <anoop@live.co.uk>",
+    "Thakur, Anikesh <44468436+Anikesh348@users.noreply.github.com>",
     "Thangavel, Sekar <sekar.thangavel@gmail.com>",
     "Thorild, Fredrik <fredrik.thorild@sogeti.com>",
     "Trinder, Garry <garry.trinder@live.com>",