Added the 'spo navigation node add' command solving pnp#521

docs/manual/docs/about/comparison-powershell.md

@@ -159,7 +159,7 @@ Add-PnPJavaScriptLink|SharePointPnPPowerShellOnline|
 Add-PnPListFoldersToProvisioningTemplate|SharePointPnPPowerShellOnline|
 Add-PnPListItem|SharePointPnPPowerShellOnline|[spo listitem add](../cmd/spo/listitem/listitem-add.md)
 Add-PnPMasterPage|SharePointPnPPowerShellOnline|
-Add-PnPNavigationNode|SharePointPnPPowerShellOnline|
+Add-PnPNavigationNode|SharePointPnPPowerShellOnline|[spo navigation node add](../cmd/spo/navigation/navigation-node-add.md)
 Add-PnPOffice365GroupToSite|SharePointPnPPowerShellOnline|
 Add-PnPPublishingImageRendition|SharePointPnPPowerShellOnline|
 Add-PnPPublishingPage|SharePointPnPPowerShellOnline|

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

@@ -0,0 +1,44 @@
+# spo navigation node add
+
+Adds a navigation node to the specified site navigation
+
+## Usage
+
+```sh
+spo navigation node add [options]
+```
+
+## Options
+
+Option|Description
+------|-----------
+`--help`|output usage information
+`-u, --webUrl <webUrl>`|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`
+`-t, --title <title>`|Navigation node title
+`--url <url>`|Navigation node URL
+`--isExternal`|Set, if the navigation node points to an external URL
+`-o, --output [output]`|Output type. `json|text`. Default `text`
+`--verbose`|Runs command with verbose logging
+`--debug`|Runs command with debug logging
+
+!!! important
+    Before using this command, connect to a SharePoint Online site, using the [spo connect](../connect.md) command.
+
+## Remarks
+
+To add a navigation node to a site, you have to first connect to a SharePoint Online site using the [spo connect](../connect.md) command, eg. `spo connect https://contoso.sharepoint.com`.
+
+## Examples
+
+Add a navigation node pointing to a SharePoint page to the top navigation
+
+```sh
+spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --location TopNavigationBar --title About --url /sites/team-s/sitepages/about.aspx
+```
+
+Add a navigation node pointing to an external page to the quick launch
+
+```sh
+spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --location QuickLaunch --title "About us" --url https://contoso.com/about-us --isExternal
+```

docs/manual/mkdocs.yml

@@ -78,6 +78,8 @@ pages:
         - listitem get: 'cmd/spo/listitem/listitem-get.md'
         - listitem remove: 'cmd/spo/listitem/listitem-remove.md'
         - listitem set: 'cmd/spo/listitem/listitem-set.md'
+      - navigation:
+        - navigation node aad: 'cmd/spo/navigation/navigation-node-add.md'
       - page:
         - page add: 'cmd/spo/page/page-add.md'
         - page control get: 'cmd/spo/page/page-control-get.md'

src/o365/spo/commands.ts

@@ -60,6 +60,7 @@ export default {
   LISTITEM_REMOVE: `${prefix} listitem remove`,
   LISTITEM_GET: `${prefix} listitem get`,
   LISTITEM_SET: `${prefix} listitem set`,
+  NAVIGATION_NODE_ADD: `${prefix} navigation node add`,
   PAGE_ADD: `${prefix} page add`,
   PAGE_CONTROL_GET: `${prefix} page control get`,
   PAGE_CONTROL_LIST: `${prefix} page control list`,