@pnp/cli-microsoft365 6.2.0 → 6.3.0-beta.3f7129c

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

@@ -28,8 +28,15 @@ m365 spo navigation node add [options]
 `--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.
+
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+In order to use option `audienceIds`, make sure that audience targeted navigation is enabled using command [spo web set](../web/web-set.md).
+
 ## Examples
 
 Add a navigation node pointing to a SharePoint page to the top navigation
@@ -50,13 +57,21 @@ Add a navigation node below an existing node
 m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --parentNodeId 2010 --title About --url /sites/team-s/sitepages/about.aspx
 ```
 
+Add a navigation node to the top navigation which is audience targetted
+
+```sh
+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"
+```
+
 ## Response
 
 === "JSON"
 
     ```json
     {
-      "AudienceIds": null,
+      "AudienceIds": [
+        "7aa4a1ca-4035-4f2f-bac7-7beada59b5ba"
+      ],
       "CurrentLCID": 1033,
       "Id": 2030,
       "IsDocLib": true,
@@ -71,7 +86,7 @@ m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-
 === "Text"
 
     ```text
-    AudienceIds     : null
+    AudienceIds     : ["7aa4a1ca-4035-4f2f-bac7-7beada59b5ba"]
     CurrentLCID     : 1033
     Id              : 2031
     IsDocLib        : true
@@ -86,5 +101,5 @@ m365 spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-
 
     ```csv
     AudienceIds,CurrentLCID,Id,IsDocLib,IsExternal,IsVisible,ListTemplateType,Title,Url
-    ,1033,2032,1,1,1,0,Navigation Link,https://contoso.sharepoint.com
+    "[""7aa4a1ca-4035-4f2f-bac7-7beada59b5ba""]",1033,2032,1,1,1,0,Navigation Link,https://contoso.sharepoint.com
     ```

package/docs/docs/cmd/spo/navigation/navigation-node-list.md

@@ -39,7 +39,15 @@ m365 spo navigation node list --webUrl https://contoso.sharepoint.com/sites/team
     ```json
     [
       {
+        "AudienceIds": [
+          "5786b8e8-c495-4734-b345-756733960730"
+        ],
+        "CurrentLCID": 1033,
         "Id": 2032,
+        "IsDocLib": true,
+        "IsExternal": true,
+        "IsVisible": true,
+        "ListTemplateType": 0,
         "Title": "Navigation Link",
         "Url": "https://contoso.sharepoint.com"
       }
@@ -60,3 +68,25 @@ m365 spo navigation node list --webUrl https://contoso.sharepoint.com/sites/team
     Id,Title,Url
     2032,Navigation Link,https://contoso.sharepoint.com
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo navigation node list --webUrl "https://contoso.sharepoint.com" --location "QuickLaunch"
+
+    Date: 27/1/2023
+
+    ## Home (1031)
+
+    Property | Value
+    ---------|-------
+    AudienceIds | ["5786b8e8-c495-4734-b345-756733960730"]
+    CurrentLCID | 1033
+    Id | 2032
+    IsDocLib | true
+    IsExternal | false
+    IsVisible | true
+    ListTemplateType | 0
+    Title | Navigation Link
+    Url | https://contoso.sharepoint.com
+    ```

package/docs/docs/cmd/spo/navigation/navigation-node-remove.md

@@ -14,7 +14,7 @@ m365 spo navigation node remove [options]
 : Absolute URL of the site to which navigation should be modified
 
 `-l, --location <location>`
-: Navigation type where the node should be added. Available options: `QuickLaunch,TopNavigationBar`
+: Navigation type where the node should be removed. Available options: `QuickLaunch,TopNavigationBar`
 
 `-i, --id <id>`
 : ID of the node to remove

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

@@ -0,0 +1,59 @@
+# spo navigation node set
+
+Updates a SharePoint navigation node
+
+## Usage
+
+```sh
+m365 spo navigation node set [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: Absolute URL of the site.
+
+`--id <id>`
+: Id of the navigation node.
+
+`--title [title]`
+: New title of the navigation node.
+
+`--url [url]`
+: New URL of the navigation node.
+
+`--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`.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+To enable/disable audience targeting for the nsavigation bar, use command [`spo web set`](../web/web-set.md).
+
+## 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"
+```
+
+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
+```
+
+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"
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/web/web-set.md

@@ -37,6 +37,9 @@ m365 spo web set [options]
 `--footerEnabled [footerEnabled]`
 : Set to `true` to enable footer and to `false` to disable it
 
+`--navAudienceTargetingEnabled [navAudienceTargetingEnabled]`
+: Enable or disable site navigation audience targeting. Allowed values: `true` or `false`.
+
 `--searchScope [searchScope]`
 : Search scope to set in the site. Allowed values `DefaultScope,Tenant,Hub,Site`
 
@@ -87,6 +90,12 @@ Hide footer in the site
 m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --footerEnabled false
 ```
 
+Enable navigation audience targetting in the site
+
+```sh
+m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --navAudienceTargetingEnabled true
+```
+
 Set search scope to tenant scope
 
 ```sh

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "6.2.0",
+  "version": "6.3.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@pnp/cli-microsoft365",
-      "version": "6.2.0",
+      "version": "6.3.0",
       "license": "MIT",
       "dependencies": {
         "@azure/msal-node": "^1.14.5",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "6.2.0",
+  "version": "6.3.0-beta.3f7129c",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -272,4 +272,4 @@
     "sinon": "^15.0.1",
     "source-map-support": "^0.5.21"
   }
-}
+}