Revoke-SPOHubSiteRights.md

external help file	Module Name	online version	applicable	title	schema	author	ms.author	ms.reviewer
sharepointonline.xml	Microsoft.Online.SharePoint.PowerShell	https://learn.microsoft.com/powershell/module/sharepoint-online/revoke-spohubsiterights	SharePoint Online	Revoke-SPOHubSiteRights	2.0.0	trent-green	trgreen

Revoke-SPOHubSiteRights

SYNOPSIS

Revokes rights for specified principals to a hub.

SYNTAX

Revoke-SPOHubSiteRights [-Identity] <SpoHubSitePipeBind> -Principals <string[]>  [<CommonParameters>]

DESCRIPTION

Revokes rights for specified principals to the given hub site. The specified principals will no longer be able to associate sites with the hub. To find which principals have access to a hub site, use the Get-SPOHubSite cmdlet.

Note

If the hub site doesn't exist, this cmdlet returns a "File not found" error.

EXAMPLES

Example 1

Revoke-SPOHubSiteRights https://contoso.sharepoint.com/sites/Marketing `
-Principals "nestorw@contoso.onmicrosoft.com"

This example shows how to revoke rights so that Nestor can no longer join sites to the Marketing hub site.

PARAMETERS

-Identity

URL of the hub site.

Type: SpoSitePipeBind
Parameter Sets: (All)
Aliases: HubSite
Applicable: SharePoint Online

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Principals

One or more principals to revoke the permissions for.

Type: String[]
Parameter Sets: (All)
Aliases:
Applicable: SharePoint Online

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.