@pnp/cli-microsoft365 12.0.0-beta.bf446c8 → 12.0.0-beta.d0b29c1

package/docs/docs/cmd/spo/folder/folder-unarchive.mdx

@@ -0,0 +1,76 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo folder unarchive
+
+Unarchives a folder
+
+## Usage
+
+```sh
+m365 spo folder unarchive [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the site where the folder is located.
+
+`--url [url]`
+: The server- or site-relative decoded URL of the folder to unarchive. Specify either `url` or `id`, but not both.
+
+`-i, --id [id]`
+: The unique ID (GUID) of the folder to unarchive. Specify either `url` or `id`, but not both.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::warning
+
+Reactivation could take up to 24 hours. Folders that are reactivated cannot be archived again for **120 days**.
+
+:::
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Unarchive a folder without prompting for confirmation
+
+```sh
+m365 spo folder unarchive --webUrl https://contoso.sharepoint.com/sites/Marketing --id 7a8c9207-7745-4cda-b0e2-be2618ee3030 --force
+```
+
+Unarchive a folder by URL with prompting for confirmation
+
+```sh
+m365 spo folder unarchive --webUrl https://contoso.sharepoint.com/sites/Marketing --url '/sites/Marketing/documents/general'
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -30,9 +30,6 @@ m365 spo navigation node add [options]
 `--parentNodeId [parentNodeId]`
 : ID of the node below which the node should be added. Specify either `location` or `parentNodeId` but not both.
 
-`--isExternal`
-: Set, if the navigation node points to an external URL.
-
 `--audienceIds [audienceIds]`
 : Comma-separated list of group IDs that will be used for audience targeting. The limit is 10 ids per navigation node.
 
@@ -57,7 +54,7 @@ m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-
 Add a navigation node pointing to an external page to the quick launch.
 
 ```sh
-m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --location QuickLaunch --title "About us" --url https://contoso.com/about-us --isExternal
+m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --location QuickLaunch --title "About us" --url https://contoso.com/about-us
 ```
 
 Add a navigation node below an existing node and opens it in a new window.
@@ -72,6 +69,12 @@ Add a navigation node to the top navigation which is audience targetted and open
 m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --location TopNavigationBar --title About --url /sites/team-s/sitepages/about.aspx --audienceIds "7aa4a1ca-4035-4f2f-bac7-7beada59b5ba,4bbf236f-a131-4019-b4a2-315902fcfa3a" --openInNewWindow
 ```
 
+Add a linkless label to the quick launch.
+
+```sh
+m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --location QuickLaunch --title Resources
+```
+
 ## Response
 
 <Tabs>
@@ -83,13 +86,18 @@ m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-
       "7aa4a1ca-4035-4f2f-bac7-7beada59b5ba"
     ],
     "CurrentLCID": 1033,
-    "Id": 2030,
-    "IsDocLib": true,
-    "IsExternal": true,
-    "IsVisible": true,
-    "ListTemplateType": 0,
+    "CustomProperties": [],
+    "FriendlyUrlSegment": "",
+    "IsDeleted": false,
+    "IsHidden": false,
+    "IsTitleForExistingLanguage": false,
+    "Key": "2030",
+    "Nodes": [],
+    "NodeType": 0,
+    "OpenInNewWindow": true,
+    "SimpleUrl": "https://contoso.sharepoint.com",
     "Title": "Navigation Link",
-    "Url": "https://contoso.sharepoint.com"
+    "Translations": []
   }
   ```
 
@@ -97,45 +105,52 @@ m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-
   <TabItem value="Text">
 
   ```text
-  AudienceIds     : ["7aa4a1ca-4035-4f2f-bac7-7beada59b5ba"]
-  CurrentLCID     : 1033
-  Id              : 2031
-  IsDocLib        : true
-  IsExternal      : true
-  IsVisible       : true
-  ListTemplateType: 0
-  Title           : Navigation Link
-  Url             : https://contoso.sharepoint.com
+  AudienceIds               : ["7aa4a1ca-4035-4f2f-bac7-7beada59b5ba"]
+  CurrentLCID               : 1033
+  CustomProperties          : []
+  FriendlyUrlSegment        :
+  IsDeleted                 : false
+  IsHidden                  : false
+  IsTitleForExistingLanguage: false
+  Key                       : 2030
+  NodeType                  : 0
+  Nodes                     : []
+  OpenInNewWindow           : true
+  SimpleUrl                 : https://contoso.sharepoint.com
+  Title                     : Navigation Link
+  Translations              : []
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  AudienceIds,CurrentLCID,Id,IsDocLib,IsExternal,IsVisible,ListTemplateType,Title,Url
-  "[""7aa4a1ca-4035-4f2f-bac7-7beada59b5ba""]",1033,2032,1,1,1,0,Navigation Link,https://contoso.sharepoint.com
+  CurrentLCID,FriendlyUrlSegment,IsDeleted,IsHidden,IsTitleForExistingLanguage,Key,NodeType,OpenInNewWindow,SimpleUrl,Title
+  1033,,0,0,0,2030,0,1,https://contoso.sharepoint.com,Navigation Link
   ```
 
   </TabItem>
   <TabItem value="Markdown">
 
   ```md
-  # spo navigation node get --webUrl "https://contoso.sharepoint.com/sites/team-a" --location "TopNavigationBar" --title "Navigation Link" --url "https://contoso.sharepoint.com"
+  # spo navigation node add --webUrl "https://contoso.sharepoint.com/sites/team-a" --location "TopNavigationBar" --title "Navigation Link" --url "https://contoso.sharepoint.com" --openInNewWindow "true"
 
-  Date: 2/20/2023
+  Date: 10/7/2026
 
-  ## Navigation Link (2030)
+  ## Navigation Link
 
   Property | Value
   ---------|-------
   CurrentLCID | 1033
-  Id | 2030
-  IsDocLib | true
-  IsExternal | false
-  IsVisible | true
-  ListTemplateType | 0
+  FriendlyUrlSegment |
+  IsDeleted | false
+  IsHidden | false
+  IsTitleForExistingLanguage | false
+  Key | 2030
+  NodeType | 0
+  OpenInNewWindow | true
+  SimpleUrl | https://contoso.sharepoint.com
   Title | Navigation Link
-  Url | https://contoso.sharepoint.com
   ```
 
   </TabItem>

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

@@ -18,6 +18,9 @@ m365 spo navigation node get [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.
 ```
@@ -45,10 +48,16 @@ m365 spo navigation node get [options]
 
 ## Examples
 
-Retrieve information for a specific navigation node.
+Retrieve information for a specific navigation node from the quick launch.
 
 ```sh
-m365 spo navigation node get --webUrl https://contoso.sharepoint.com/sites/Marketing --id 2209
+m365 spo navigation node get --webUrl https://contoso.sharepoint.com/sites/Marketing --location QuickLaunch --id 2209
+```
+
+Retrieve information for a specific navigation node from the top navigation.
+
+```sh
+m365 spo navigation node get --webUrl https://contoso.sharepoint.com/sites/Marketing --location TopNavigationBar --id 2209
 ```
 
 ## Response
@@ -58,31 +67,39 @@ m365 spo navigation node get --webUrl https://contoso.sharepoint.com/sites/Marke
 
   ```json
   {
-    "Children": [
+    "AudienceIds": [
+      "0d718612-8407-4d6b-833c-6891a553354f"
+    ],
+    "CurrentLCID": 1033,
+    "CustomProperties": [],
+    "FriendlyUrlSegment": "",
+    "IsDeleted": false,
+    "IsHidden": false,
+    "IsTitleForExistingLanguage": false,
+    "Key": "2209",
+    "Nodes": [
       {
-        "AudienceIds": null,
+        "AudienceIds": [],
         "CurrentLCID": 1033,
-        "Id": 2033,
-        "IsDocLib": true,
-        "IsExternal": true,
-        "IsVisible": true,
-        "ListTemplateType": 0,
+        "CustomProperties": [],
+        "FriendlyUrlSegment": "",
+        "IsDeleted": false,
+        "IsHidden": false,
+        "IsTitleForExistingLanguage": false,
+        "Key": "2210",
+        "Nodes": [],
+        "NodeType": 0,
+        "OpenInNewWindow": true,
+        "SimpleUrl": "https://microsoft365.com",
         "Title": "Microsoft 365",
-        "Url": "https://microsoft365.com",
-        "Children": []
+        "Translations": []
       }
     ],
-    "AudienceIds": [
-      "0d718612-8407-4d6b-833c-6891a553354f"
-    ],
-    "CurrentLCID": 1033,
-    "Id": 2209,
-    "IsDocLib": true,
-    "IsExternal": false,
-    "IsVisible": true,
-    "ListTemplateType": 100,
+    "NodeType": 0,
+    "OpenInNewWindow": null,
+    "SimpleUrl": "/sites/Marketing/Lists/Work Status/AllItems.aspx",
     "Title": "Work Status",
-    "Url": "/sites/Marketing/Lists/Work Status/AllItems.aspx"
+    "Translations": []
   }
   ```
 
@@ -90,46 +107,51 @@ m365 spo navigation node get --webUrl https://contoso.sharepoint.com/sites/Marke
   <TabItem value="Text">
 
   ```text
-  Children        : [{ AudienceIds: null, CurrentLCID: 1033, Id: 2033, IsDocLib: true, IsExternal: true, IsVisible: true, ListTemplateType: 0, Title: "Microsoft 365", Url: "https://microsoft365.com", Children: [] }]
-  AudienceIds     : ["0d718612-8407-4d6b-833c-6891a553354f"]
-  CurrentLCID     : 1033
-  Id              : 2209
-  IsDocLib        : true
-  IsExternal      : false
-  IsVisible       : true
-  ListTemplateType: 100
-  Title           : Work Status
-  Url             : /sites/Marketing/Lists/Work Status/AllItems.aspx
+  AudienceIds               : ["0d718612-8407-4d6b-833c-6891a553354f"]
+  CurrentLCID               : 1033
+  CustomProperties          : []
+  FriendlyUrlSegment        :
+  IsDeleted                 : false
+  IsHidden                  : false
+  IsTitleForExistingLanguage: false
+  Key                       : 2209
+  NodeType                  : 0
+  Nodes                     : [{"AudienceIds":[],"CurrentLCID":1033,"CustomProperties":[],"FriendlyUrlSegment":"","IsDeleted":false,"IsHidden":false,"IsTitleForExistingLanguage":false,"Key":"2210","Nodes":[],"NodeType":0,"OpenInNewWindow":true,"SimpleUrl":"https://microsoft365.com","Title":"Microsoft 365","Translations":[]}]
+  OpenInNewWindow           : null
+  SimpleUrl                 : /sites/Marketing/Lists/Work Status/AllItems.aspx
+  Title                     : Work Status
+  Translations              : []
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  CurrentLCID,Id,IsDocLib,IsExternal,IsVisible,ListTemplateType,Title,Url
-  1033,2209,1,,1,100,Work Status,/sites/Marketing/Lists/Work Status/AllItems.aspx
+  CurrentLCID,FriendlyUrlSegment,IsDeleted,IsHidden,IsTitleForExistingLanguage,Key,NodeType,OpenInNewWindow,SimpleUrl,Title
+  1033,,0,0,0,2209,0,,/sites/Marketing/Lists/Work Status/AllItems.aspx,Work Status
   ```
 
   </TabItem>
   <TabItem value="Markdown">
 
   ```md
-  # spo navigation node get --webUrl "https://contoso.sharepoint.com/sites/Marketing" --id "2209"
+  # spo navigation node get --webUrl "https://contoso.sharepoint.com/sites/Marketing" --location "QuickLaunch" --id "2209"
 
-  Date: 1/29/2023
+  Date: 10/7/2026
 
-  ## Work Status (2209)
+  ## Work Status
 
   Property | Value
   ---------|-------
   CurrentLCID | 1033
-  Id | 2209
-  IsDocLib | true
-  IsExternal | false
-  IsVisible | true
-  ListTemplateType | 100
+  FriendlyUrlSegment |
+  IsDeleted | false
+  IsHidden | false
+  IsTitleForExistingLanguage | false
+  Key | 2209
+  NodeType | 0
+  SimpleUrl | /sites/Marketing/Lists/Work Status/AllItems.aspx
   Title | Work Status
-  Url | /sites/Marketing/Lists/Work Status/AllItems.aspx
   ```
 
   </TabItem>

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/spp/model/model-get.mdx

@@ -32,7 +32,7 @@ m365 spp model get [options]
 
 ## Examples
 
-Retrieve information about a SharePoint Premium document understanding model, using model UniqueId.
+Retrieve information about a SharePoint Premium document understanding model, using model unique ID.
 
 ```sh
 m365 spp model get --siteUrl "https://contoso.sharepoint.com/sites/ContentCenter" --id "7645e69d-21fb-4a24-a17a-9bdfa7cb63dc"

package/docs/docs/cmd/spp/model/model-remove.mdx

@@ -40,7 +40,7 @@ The model must be removed from all libraries before it can be deleted.
 
 ## Examples
 
-Delete a SharePoint Premium document understanding model using the model’s UniqueId.
+Delete a SharePoint Premium document understanding model using the model’s unique ID.
 
 ```sh
 m365 spp model remove --siteUrl "https://contoso.sharepoint.com/sites/ContentCenter" --id "7645e69d-21fb-4a24-a17a-9bdfa7cb63dc"

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.