Revoke-SPOHubSiteRights
Revokes rights for specified principals to a hub.
Syntax
Default (Default)
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
Applicable: SharePoint Online
URL of the hub site.
Parameter properties
| Type: | Microsoft.Online.SharePoint.PowerShell.SpoHubSitePipeBind |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | HubSite |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Principals
Applicable: SharePoint Online
One or more principals to revoke the permissions for.
Parameter properties
| Type: | System.String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.