Skip to content

spo navigation node set

Updates a SharePoint navigation node

Usage

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. 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.
-h, --help [help]
Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv,md. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Remarks

To enable/disable audience targeting for the navigation bar, use the spo web set command.

Examples

Updates the title of a navigation node

m365 spo navigation node set --webUrl https://contoso.sharepoint.com/sites/marketing --id 2209 --title "Pictures"

Updates the URL of a navigation node

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

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.