@pnp/cli-microsoft365 6.3.0-beta.c3dc921 → 6.3.0-beta.e46ffee

package/dist/utils/accessToken.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.accessToken = void 0;
 exports.accessToken = {
     isAppOnlyAccessToken(accessToken) {
-        let isAppOnlyAccessToken = false;
+        let isAppOnlyAccessToken;
         if (!accessToken || accessToken.length === 0) {
             return isAppOnlyAccessToken;
         }

package/dist/utils/planner.js

@@ -41,17 +41,17 @@ exports.planner = {
      * Get all Planner plans for a specific group.
      * @param groupId Group ID.
      */
-    getPlansByGroupId(groupId) {
-        return odata_1.odata.getAllItems(`${graphResource}/v1.0/groups/${groupId}/planner/plans`, 'none');
+    getPlansByGroupId(groupId, metadata = 'none') {
+        return odata_1.odata.getAllItems(`${graphResource}/v1.0/groups/${groupId}/planner/plans`, metadata);
     },
     /**
      * Get Planner plan by title in a specific group.
      * @param title Title of the Planner plan. Case insensitive.
      * @param groupId Owner group ID .
      */
-    getPlanByTitle(title, groupId) {
+    getPlanByTitle(title, groupId, metadata = 'none') {
         return __awaiter(this, void 0, void 0, function* () {
-            const plans = yield this.getPlansByGroupId(groupId);
+            const plans = yield this.getPlansByGroupId(groupId, metadata);
             const filteredPlans = plans.filter(p => p.title && p.title.toLowerCase() === title.toLowerCase());
             if (!filteredPlans.length) {
                 throw Error(`The specified plan '${title}' does not exist.`);

package/dist/utils/spo.js

@@ -1,4 +1,13 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.spo = void 0;
 const url = require("url");
@@ -237,6 +246,24 @@ exports.spo = {
             });
         });
     },
+    /**
+     * Returns the Graph id of a site
+     * @param webUrl web url e.g. https://contoso.sharepoint.com/sites/site1
+     */
+    getSpoGraphSiteId(webUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const url = new URL(webUrl);
+            const requestOptions = {
+                url: `https://graph.microsoft.com/v1.0/sites/${url.hostname}:${url.pathname}?$select=id`,
+                headers: {
+                    'accept': 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const result = yield request_1.default.get(requestOptions);
+            return result.id;
+        });
+    },
     /**
      * Ensures the folder path exists
      * @param webFullUrl web full url e.g. https://contoso.sharepoint.com/sites/site1

package/docs/docs/cmd/aad/app/app-list.md

@@ -23,6 +23,7 @@ m365 aad app list
 ## Response
 
 === "JSON"
+
     ```json
     [
       {
@@ -136,6 +137,7 @@ m365 aad app list
     ```
 
 === "Text"
+
     ```text
     appId                                 id                                    displayName                                                              signInAudience
     ------------------------------------  ------------------------------------  -----------------------------------------------------------------------  ----------------------------------
@@ -143,6 +145,7 @@ m365 aad app list
     ```
 
 === "CSV"
+
     ```csv
     appId,id,displayName,signInAudience
     61ed4fab-a861-4307-bb87-a6a53dbe39f5,ff2798f7-1c7a-4607-8a7b-3d5e0c18c756,TestAppPermissions,AzureADMyOrg

package/docs/docs/cmd/aad/user/user-set.md

@@ -83,6 +83,6 @@ Change password of the currently logged in user
 m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --currentPassword SLBF5gnRtyYc --newPassword 6NLUId79Lc24
 ```
 
-### Response
+## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/flow/run/run-list.md

@@ -16,6 +16,15 @@ m365 flow run list [options]
 `-e, --environmentName <environmentName>`
 : The name of the environment to which the flow belongs
 
+`--status [status]` 
+: Filter the results to only flow runs with a given status: `Succeeded`, `Running`, `Failed` or `Cancelled`. By default all flow runs are listed.
+
+`--triggerStartTime [triggerStartTime]`
+: Time indicating the inclusive start of a time range of flow runs to return. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z).
+
+`--triggerEndTime [triggerEndTime]`
+: Time indicating the exclusive end of a time range of flow runs to return. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z).
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -35,6 +44,18 @@ List runs of the specified Microsoft Flow
 m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a
 ```
 
+List runs of the specified Microsoft Flow with a specific status
+
+```sh
+m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --status Running
+```
+
+List runs of the specified Microsoft Flow between a specific time range
+
+```sh
+m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --triggerStartTime 2023-01-21T18:19:00Z --triggerEndTime 2023-01-22T00:00:00Z
+```
+
 ## Response
 
 ### Standard response

package/docs/docs/cmd/planner/plan/plan-add.md

@@ -14,10 +14,13 @@ m365 planner plan add [options]
 : Title of the plan to add.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the Group that owns the plan. A valid group must exist before this option can be set. Specify either `ownerGroupId` or `ownerGroupName` but not both.
+: ID of the Group that owns the plan. A valid group must exist before this option can be set. Specify either `ownerGroupId`, `ownerGroupName` or `rosterId`.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the Group that owns the plan. A valid group must exist before this option can be set. Specify either `ownerGroupId` or `ownerGroupName` but not both.
+: Name of the Group that owns the plan. A valid group must exist before this option can be set. Specify either `ownerGroupId`, `ownerGroupName` or `rosterId`.
+
+`--rosterId [rosterId]`
+: ID of the Planner Roster. Specify either `ownerGroupId`, `ownerGroupName` or `rosterId`.
 
 `--shareWithUserIds [shareWithUserIds]`
 : The comma-separated IDs of the users with whom you want to share the plan. Specify either `shareWithUserIds` or `shareWithUserNames` but not both.
@@ -29,23 +32,31 @@ m365 planner plan add [options]
 
 ## Remarks
 
-Related to the options `--shareWithUserIds` and `--shareWithUserNames`. If you are leveraging Microsoft 365 groups, use the `aad o365group user` commands to manage group membership to share the [group's](https://pnp.github.io/cli-microsoft365/cmd/aad/o365group/o365group-user-add/) plan. You can also add existing members of the group to this collection though it is not required for them to access the plan owned by the group.
+- Related to the options `--shareWithUserIds` and `--shareWithUserNames`. If you are leveraging Microsoft 365 groups, use the `aad o365group user` commands to manage group membership to share the [group's](https://pnp.github.io/cli-microsoft365/cmd/aad/o365group/o365group-user-add/) plan. You can also add existing members of the group to this collection though it is not required for them to access the plan owned by the group.
+
+- Hint: Unlike for groups, a Planner Roster can contain only 1 plan.
 
 ## Examples
 
-Adds a Microsoft Planner plan with the name _My Planner Plan_ for Group _233e43d0-dc6a-482e-9b4e-0de7a7bce9b4_
+Adds a Microsoft Planner plan with a Group by id
 
 ```sh
 m365 planner plan add --title 'My Planner Plan' --ownerGroupId '233e43d0-dc6a-482e-9b4e-0de7a7bce9b4'
 ```
 
-Adds a Microsoft Planner plan with the name _My Planner Plan_ for Group _My Planner Group_
+Adds a Microsoft Planner plan with with a Group by name
 
 ```sh
 m365 planner plan add --title 'My Planner Plan' --ownerGroupName 'My Planner Group'
 ```
 
-Adds a Microsoft Planner plan with the name _My Planner Plan_ for Group _My Planner Group_ and share it with the users _Allan.Carroll@contoso.com_ and _Ida.Stevens@contoso.com_
+Adds a Microsoft Planner plan with a Roster by id
+
+```sh
+m365 planner plan add --title 'My Planner Plan' --rosterId 'tYqYlNd6eECmsNhN_fcq85cAGAnd'
+```
+
+Adds a Microsoft Planner plan with with a Group by name and share it with the given users
 
 ```sh
 m365 planner plan add --title 'My Planner Plan' --ownerGroupName 'My Planner Group' --shareWithUserNames 'Allan.Carroll@contoso.com,Ida.Stevens@contoso.com'

package/docs/docs/cmd/planner/plan/plan-remove.md

@@ -27,6 +27,10 @@ m365 planner plan remove [options]
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+If you wish to delete a Planner plan contained within a Planner Roster, you'll have to remove the roster using [planner roster remove](../roster/roster-remove.md).
+
 ## Examples
 
 Removes the Microsoft Planner plan by ID

package/docs/docs/cmd/planner/roster/roster-add.md

@@ -0,0 +1,60 @@
+# planner roster add
+
+Creates a new Microsoft Planner Roster
+
+## Usage
+
+```sh
+m365 planner roster add [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    The Roster will be automatically deleted when it doesn't contain a plan 24 hours after its creation. Membership information will be completely erased within 30 days of this deletion.
+
+!!! attention
+    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+!!! important
+    To be able to create a new Roster, the Planner Roster creation tenant setting should be enabled. Use the [planner tenant settings list](../tenant/tenant-settings-list.md) command to check if this setting is enabled for your tenant.
+
+## Examples
+
+Creates a new Microsoft Planner Roster
+
+```sh
+m365 planner roster add
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "e6fmvM_yi0OJgvmepE5uj5cAE6qX",
+      "assignedSensitivityLabel": null
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    assignedSensitivityLabel: null
+    id                      : e6fmvM_yi0OJgvmepE5uj5cAE6qX
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,assignedSensitivityLabel
+    e6fmvM_yi0OJgvmepE5uj5cAE6qX,
+    ```
+    
+## Additional information
+Rosters are a new type of container for Microsoft Planner plans. This enables users to create a Planner plan without the need to create a new Microsoft 365 group (with a mailbox, SharePoint site, ...). Access to Roster-contained plans is controlled by the members on the Roster. A Planner Roster can contain only 1 plan.

package/docs/docs/cmd/planner/roster/roster-remove.md

@@ -0,0 +1,48 @@
+# planner roster remove
+
+Removes a Microsoft Planner Roster
+
+## Usage
+
+```sh
+m365 planner roster remove [options]
+```
+
+## Options
+
+`--id <id>`
+: ID of the Planner Roster.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    Deleting a Planner Roster will also delete the plan within the Roster.
+
+!!! attention
+    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+## Examples
+
+Removes a Planner Roster
+
+```sh
+m365 planner roster remove --id tYqYlNd6eECmsNhN_fcq85cAGAnd
+```
+
+Removes a Planner Roster without confirmation prompt
+
+```sh
+m365 planner roster remove --id tYqYlNd6eECmsNhN_fcq85cAGAnd --confirm
+```
+
+## Response
+
+The command won't return a response on success.
+
+## Additional information
+Rosters are a new type of container for Microsoft Planner plans. This enables users to create a Planner plan without the need to create a new Microsoft 365 group (with a mailbox, SharePoint site, ...). Access to Roster-contained plans is controlled by the members on the Roster. A Planner Roster can contain only 1 plan.

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-get.md

@@ -0,0 +1,100 @@
+# purview retentioneventtype get
+
+Get a retention event type
+
+## Usage
+
+```sh
+m365 purview retentioneventtype get [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The Id of the retention event type.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Get a retention event type by id
+
+```sh
+m365 purview retentioneventtype get --id c37d695e-d581-4ae9-82a0-9364eba4291e
+```
+
+## Remarks
+
+!!! attention
+    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+## More information
+
+This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
+
+[Read more on event-based retention here](https://learn.microsoft.com/en-us/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "displayName": "Test retention event type",
+      "description": "Description for the retention event type",
+      "createdDateTime": "2023-01-29T09:30:42Z",
+      "lastModifiedDateTime": "2023-01-29T09:30:42Z",
+      "id": "c37d695e-d581-4ae9-82a0-9364eba4291e",
+      "createdBy": {
+        "user": {
+          "id": null,
+          "displayName": "John Doe"
+        }
+      },
+      "lastModifiedBy": {
+        "user": {
+          "id": null,
+          "displayName": "John Doe"
+        }
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    createdBy           : {"user":{"id":null,"displayName":"John Doe"}}
+    createdDateTime     : 2023-01-29T09:30:42Z
+    description         : Description for the retention event type
+    displayName         : Test retention event type
+    id                  : c37d695e-d581-4ae9-82a0-9364eba4291e
+    lastModifiedBy      : {"user":{"id":null,"displayName":"John Doe"}}
+    lastModifiedDateTime: 2023-01-29T09:30:42Z
+    ```
+
+=== "CSV"
+
+    ```csv
+    displayName,description,createdDateTime,lastModifiedDateTime,id,createdBy,lastModifiedBy
+    Test retention event type,Description for the retention event type,2023-01-29T09:30:42Z,2023-01-29T09:30:42Z,c37d695e-d581-4ae9-82a0-9364eba4291e,"{""user"":{""id"":null,""displayName"":""John Doe""}}","{""user"":{""id"":null,""displayName"":""John Doe""}}"
+    ```
+
+=== "Markdown"
+
+    ```md
+    # purview retentioneventtype get --id "c37d695e-d581-4ae9-82a0-9364eba4291e"
+
+    Date: 1/29/2023
+
+    ## Test retention event type (c37d695e-d581-4ae9-82a0-9364eba4291e)
+
+    Property | Value
+    ---------|-------
+    displayName | Test retention event type
+    description | Description for the retention event type
+    createdDateTime | 2023-01-29T09:30:42Z
+    lastModifiedDateTime | 2023-01-29T09:30:42Z
+    id | c37d695e-d581-4ae9-82a0-9364eba4291e
+    createdBy | {"user":{"id":null,"displayName":"John Doe"}}
+    lastModifiedBy | {"user":{"id":null,"displayName":"John Doe"}}
+    ```

package/docs/docs/cmd/spfx/project/project-permissions-grant.md

@@ -0,0 +1,65 @@
+# spfx project permissions grant
+
+Grant API permissions defined in the current SPFx project
+
+## Usage
+
+```sh
+m365 spfx project permissions grant [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! important
+    Run this command in the folder where the project is located from where you want to grant the permissions.
+
+This command grant the permissions defined in: _package-solution.json_.
+
+## Examples
+
+Grant API permissions requested in the current SPFx project
+
+```sh
+m365 spfx project permissions grant
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "ClientId": "6004a642-185c-479a-992a-15d1c23e2229",
+      "ConsentType": "AllPrincipals",
+      "IsDomainIsolated": false,
+      "ObjectId": "QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY",
+      "PackageName": null,
+      "Resource": "Microsoft Graph",
+      "ResourceId": "a46b0017-21e2-4db1-bc69-ca63576a38d6",
+      "Scope": "Mail.Read"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    ClientId        : 6004a642-185c-479a-992a-15d1c23e2229
+    ConsentType     : AllPrincipals
+    IsDomainIsolated: false
+    ObjectId        : QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY
+    PackageName     : null
+    Resource        : Microsoft Graph
+    ResourceId      : a46b0017-21e2-4db1-bc69-ca63576a38d6
+    Scope           : Mail.Read
+    ```
+
+=== "CSV"
+
+    ```csv
+    ClientId,ConsentType,IsDomainIsolated,ObjectId,PackageName,Resource,ResourceId,Scope
+    6004a642-185c-479a-992a-15d1c23e2229,AllPrincipals,,QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY,,Microsoft Graph,a46b0017-21e2-4db1-bc69-ca63576a38d6,Mail.Read
+    ```

package/docs/docs/cmd/spo/listitem/listitem-attachment-list.md

@@ -14,10 +14,10 @@ m365 spo listitem attachment list [options]
 URL of the site from which the item should be retrieved
 
 `--listId [listId]`
-: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+: ID of the list where the item should be retrieved. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listTitle [listTitle]`
-: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+: Title of the list where the item should be retrieved. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listUrl [listUrl]`
 : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`

package/docs/docs/cmd/spo/listitem/listitem-isrecord.md

@@ -17,10 +17,10 @@ m365 spo listitem isrecord [options]
 : The ID of the list item to check if it is a record
 
 `-l, --listId [listId]`
-: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+: ID of the list where the item should be checked. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+: Title of the list where the item should be checked. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listUrl [listUrl]`
 : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`

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.