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

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/spo/site/site-remove.mdx

@@ -19,9 +19,6 @@ m365 spo site remove [options]
 `--permanent`
 : Permanently remove the site without leaving it in the recycle bin.
 
-`--skipRecycleBin`
-: Deprecated: use `--permanent` instead.
-
 `--fromRecycleBin`
 : Set to remove the site from the recycle bin.
 

package/docs/docs/cmd/spo/web/web-rule-get.mdx

@@ -0,0 +1,108 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo web rule get
+
+Retrieves information about a specific alert from a SharePoint list
+
+## Usage
+
+```sh
+m365 spo web rule get [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the SharePoint site.
+
+`--id <id>`
+: The ID of the rule.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | SharePoint      | AllSites.FullControl |
+  | Microsoft Graph | User.ReadBasic.All   |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions           |
+  |-----------------|-----------------------|
+  | SharePoint      | Sites.FullControl.All |
+  | Microsoft Graph | User.ReadBasic.All    |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Retrieve a rule by ID
+
+```sh
+m365 spo web rule get --webUrl https://contoso.sharepoint.com/sites/Marketing --id 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "AlertFrequency": 0,
+    "AlertTemplateName": "SPAlertTemplateType.DocumentLibrary",
+    "AlertType": 0,
+    "AlwaysNotify": false,
+    "DeliveryChannels": 1,
+    "EventType": -1,
+    "Filter": "",
+    "ID": "7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e",
+    "Status": 0,
+    "Title": "Marketing documents",
+    "UserId": 8,
+    "List": {
+      "Id": "39d9e102-9e8f-4e74-8f17-84a92f972fcf",
+      "Title": "Documents",
+      "RootFolder": {
+        "ServerRelativeUrl": "/sites/Marketing/Shared Documents"
+      }
+    },
+    "User": {
+      "Id": 8,
+      "UserPrincipalName": "jane.doe@contoso.com"
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  AlertFrequency   : 0
+  AlertTemplateName: SPAlertTemplateType.DocumentLibrary
+  AlertType        : 0
+  AlwaysNotify     : false
+  DeliveryChannels : 1
+  EventType        : -1
+  Filter           : 
+  ID               : 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
+  Status           : 0
+  Title            : Marketing documents
+  UserId           : 8
+  List             : {"Id":"39d9e102-9e8f-4e74-8f17-84a92f972fcf","Title":"Documents","RootFolder":{"ServerRelativeUrl":"/sites/Marketing/Shared Documents"}}
+  User             : {"Id":8,"UserPrincipalName":"jane.doe@contoso.com"}
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/web/web-rule-list.mdx

@@ -0,0 +1,189 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo web rule list
+
+Lists all SharePoint list alerts
+
+## Usage
+
+```sh
+m365 spo web rule list [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the SharePoint site.
+
+`--listId [listId]`
+: The ID of the SharePoint list. Specify either `listId`, `listUrl`, or `listTitle`, but not more than one.
+
+`--listUrl [listUrl]`
+: The URL of the SharePoint list. Specify either `listId`, `listUrl`, or `listTitle`, but not more than one.
+
+`--listTitle [listTitle]`
+: The title of the SharePoint list. Specify either `listId`, `listUrl`, or `listTitle`, but not more than one.
+
+`--userName [userName]`
+: The user name to filter alerts for. Specify either `userName` or `userId`, but not both.
+
+`--userId [userId]`
+: The user ID to filter alerts for. Specify either `userName` or `userId`, but not both.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | SharePoint      | AllSites.FullControl |
+  | Microsoft Graph | User.ReadBasic.All   |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions           |
+  |-----------------|-----------------------|
+  | SharePoint      | Sites.FullControl.All |
+  | Microsoft Graph | User.ReadBasic.All    |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+List all alerts for a SharePoint site:
+
+```sh
+m365 spo web rule list --webUrl https://contoso.sharepoint.com/sites/Marketing
+```
+
+List alerts for a SharePoint list by listUrl:
+
+```sh
+m365 spo web rule list --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl /sites/Marketing/lists/Tasks
+```
+
+List alerts for a specific user by userId:
+
+```sh
+m365 spo web rule list --webUrl https://contoso.sharepoint.com/sites/Marketing --userId 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
+```
+
+List alerts for a specific list by title and user by username:
+
+```sh
+m365 spo web rule list --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle "Tasks" --userName jane.doe@contoso.com
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "AlertFrequency": 0,
+      "AlertTemplateName": "SPAlertTemplateType.DocumentLibrary",
+      "AlertType": 1,
+      "AlwaysNotify": false,
+      "DeliveryChannels": 1,
+      "EventType": -1,
+      "Filter": "",
+      "ID": "c52b4bf0-add0-4323-b670-f765bb46337b",
+      "Properties": [
+        {
+          "Key": "dispformurl",
+          "Value": "Shared Documents/Forms/DispForm.aspx",
+          "ValueType": "Edm.String"
+        }
+      ],
+      "Status": 0,
+      "Title": "Documents: ProjectPlan.docx",
+      "UserId": 9,
+      "Item": {
+        "Id": 37326,
+        "FileRef": "/sites/marketing/Shared Documents/ProjectPlan.docx",
+        "GUID": "ef5cc60b-71c0-4357-a291-14274234efde"
+      },
+      "List": {
+        "Id": "6b4f195c-02da-47f4-8237-065b96258cf3",
+        "Title": "Documents",
+        "RootFolder": {
+          "ServerRelativeUrl": "/sites/marketing/Shared Documents"
+        }
+      },
+      "User": {
+        "Id": 9,
+        "IsHiddenInUI": false,
+        "LoginName": "i:0#.f|membership|jane.doe@contoso.onmicrosoft.com",
+        "Title": "Jane Doe",
+        "PrincipalType": 1,
+        "Email": "jane.doe@contoso.onmicrosoft.com",
+        "Expiration": "",
+        "IsEmailAuthenticationGuestUser": false,
+        "IsShareByEmailGuestUser": false,
+        "IsSiteAdmin": false,
+        "UserId": {
+          "NameId": "10037ffeaed549a5",
+          "NameIdIssuer": "urn:federation:microsoftonline"
+        },
+        "UserPrincipalName": "jane.doe@contoso.onmicrosoft.com"
+      }
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```txt
+  ID                                    Title                        UserPrincipalName
+  ------------------------------------  ---------------------------  --------------------
+  fa5115ee-0c72-4d17-9fda-ee2451ba1c6d  Documents: ProjectPlan.docx  jane.doe@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  AlertFrequency,AlertTemplateName,AlertType,AlwaysNotify,DeliveryChannels,EventType,Filter,ID,Status,Title,UserId,UserPrincipalName
+  0,SPAlertTemplateType.DocumentLibrary,1,0,1,-1,,fa5115ee-0c72-4d17-9fda-ee2451ba1c6d,0,Documents: ProjectPlan.docx,6,jane.doe@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo web rule list --webUrl "https://contoso.sharepoint.com/sites/marketing" --listUrl "/sites/marketing/Shared Documents"
+
+  Date: 10/6/2025
+
+  ## Documents: ProjectPlan.docx (c52b4bf0-add0-4323-b670-f765bb46337b)
+
+  Property | Value
+  ---------|-------
+  AlertFrequency | 0
+  AlertTemplateName | SPAlertTemplateType.DocumentLibrary
+  AlertType | 1
+  AlwaysNotify | false
+  DeliveryChannels | 1
+  EventType | -1
+  Filter |
+  ID | c52b4bf0-add0-4323-b670-f765bb46337b
+  Status | 0
+  Title | Documents: ProjectPlan.docx
+  UserId | 9
+  UserPrincipalName | jane.doe@contoso.com
+  ```
+
+  </TabItem>
+</Tabs>

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

@@ -0,0 +1,65 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo web rule remove
+
+Removes an alert from a SharePoint list
+
+## Usage
+
+```sh
+m365 spo web rule remove [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the SharePoint site.
+
+`--id <id>`
+: The ID of the alert.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions          |
+  |------------|----------------------|
+  | SharePoint | AllSites.FullControl |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions           |
+  |------------|-----------------------|
+  | SharePoint | Sites.FullControl.All |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Remove an alert by ID
+
+```sh
+m365 spo web rule remove --webUrl https://contoso.sharepoint.com/sites/Marketing --id 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
+```
+
+Remove another alert without confirmation
+
+```sh
+m365 spo web rule remove --webUrl https://contoso.sharepoint.com/sites/Marketing --id 2b6f1c8a-3e6a-4c7e-b8c0-7bf4c8e6d7f1 --force
+```
+
+## 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/tenant/people/people-profilecardproperty-add.mdx

@@ -44,6 +44,25 @@ When adding an attribute to a profile card, it takes up to 24 hours for the addi
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | PeopleSettings.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | PeopleSettings.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Add the UPN as a profile property to the profile cards properties

package/docs/docs/cmd/tenant/people/people-profilecardproperty-get.mdx

@@ -29,6 +29,25 @@ To use this command you must be either **Tenant Administrator** or **Global Admi
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | PeopleSettings.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | PeopleSettings.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Retrieve information about a specific profile card property