Get-PnPNavigationNode

Returns all or a specific navigation node

Syntax

Get-PnPNavigationNode
   [-Location <NavigationType>]
                        [-Tree [<SwitchParameter>]]
                        [-Web <WebPipeBind>]
                        [-Connection <SPOnlineConnection>]
Get-PnPNavigationNode
   [-Id <Int>]
                        [-Tree [<SwitchParameter>]]
                        [-Web <WebPipeBind>]
                        [-Connection <SPOnlineConnection>]

Examples

------------------EXAMPLE 1------------------

Get-PnPNavigationNode

Returns all navigation nodes in the quicklaunch navigation

------------------EXAMPLE 2------------------

Get-PnPNavigationNode -Location QuickLaunch

Returns all navigation nodes in the quicklaunch navigation

------------------EXAMPLE 3------------------

Get-PnPNavigationNode -Location TopNavigationBar

Returns all navigation nodes in the top navigation bar

------------------EXAMPLE 4------------------

$node = Get-PnPNavigationNode -Id 2030
PS> $children = $node.Children

Returns the selected navigation node and retrieves any children

Parameters

-Connection

Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.

Type:SPOnlineConnection
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Id

The Id of the node to retrieve

Type:Int
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Location

The location of the nodes to retrieve. Either TopNavigationBar, QuickLaunch

Type:NavigationType
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Tree

Show a tree view of all navigation nodes

Type:SwitchParameter
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Web

This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.

Type:WebPipeBind
Position:Named
Accept pipeline input:False
Accept wildcard characters:False