Hub Site Powershell Intro

Until you become more familiar with Powershell commands to create and manage SharePoint hub sites, you can just enter the cmdlet and hit enter.  Then, you are prompted for information rather than having to format your string.  This can mitigate having to properly form your cmdlet with parameters until you feel comfortable.

Items in italics are returned in powershell. Items in bold are what you type.

For the examples below, “ACME Whizbangs” is the company and the ACME Whizbangs Office 365 Tenant Name is, “acmewhiz”

Connect to your Office365 Tenant
cmdlet: Connect-SPOService

Example:
PS C:\Windows\system32> Connect-SPOService

cmdlet Connect-SPOService at command pipeline position 1
Supply values for the following parameters:
Url:
https://acmewhiz-admin.sharepoint.com
PS C:\Windows\system32>
 

Note: Replace acmewhiz-admin.sharepoint.com with the admin url to your Office 365 Tenant

Registering a new SharePoint hub site
cmdlet: Register-SPOHubSite
Before we can register a new hub site, we need to do a little prestaging.  We need to create a site collection that will be turned into a hubsite.
1. Create a new Team Site (Modern) or Community Site (modern)
2. Copy and paste the URL to the site you created into notepad.

Once your have created one of the two types of sites above, save the URL in notepad (a good practice starting out).  Since we are only entering the cmdlet and not formatting our string, it is a good idea to copy and paste the information you will need into notepad.  This also serves as a way to become familiar with the cmdlets, urls and parameters.

PS C:\Windows\system32> Register-SPOHubSite

cmdlet Register-SPOHubSite at command pipeline position 1
Supply values for the following parameters
Site:
insert_url_of_the_site_collection_you_prestaged
[ Example: https://acmewhiz.sharepoint.com/sites/newhubsite/ ]
Principals[0]: emailaddressofadmin@forthishubsite.com
[ Example: john.doe@acmewhizbangs.com ]
Principals[1]: enter additional email address, otherwise just hit Enter

I will continue to add to this posting, but for now if it worked fine yesterday but doesn’t today, BounceTheBox!

-Bill Beehner