| external help file | Microsoft.Online.SharePoint.PowerShell.dll-Help.xml |
|---|---|
| Module Name | Microsoft.Online.SharePoint.PowerShell |
| online version | https://learn.microsoft.com/powershell/module/microsoft.online.sharepoint.powershell/register-spohubsite |
| applicable | SharePoint Online |
| title | Register-SPOHubSite |
| schema | 2.0.0 |
| author | samkabue |
| ms.author | speedta |
| ms.reviewer |
Enables the hub site feature on a site to make it a hub site. For more information visit SharePoint hub sites overview.
Register-SPOHubSite [-Site] <SpoSitePipeBind> -Principals <String[]> [<CommonParameters>]
Use this cmdlet to register an existing site collection as a hub site.
Important
A maximum of 2000 hub sites may be created per tenant, with 'unlimited' number of site collections associated to a hub site. [!NOTE] It can take up to 2-4 hours for the changes to appear.
Register-SPOHubSite https://contoso.sharepoint.com/sites/Marketing -Principals $nullThis example registers the marketing site on Contoso as hub site without setting any principals for it.
Applicable: SharePoint Online
Specifies one or more principals (user or group) to be granted rights to the specified HubSite. Can be used to filter who can associate sites to this hub site.
Type: System.String[]
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseApplicable: SharePoint Online
Specifies the URL of the site collection to which to enable the hub site features.
Type: Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
If the site doesn't exist, this cmdlet returns a "File not found" error.
If the site is already a hub site, this cmdlet returns a "This site is already a HubSite" error.
If the site is already associated with another hub site, this cmdlet returns a "This site is currently associated with a HubSite" error. You'll need to run the Remove-SPOHubSiteAssociation cmdlet first before you can make the site a hub site.