Add-SPOGeoAdministrator

  • Reference
Module:
Microsoft.Online.SharePoint.PowerShell
Applies to:
SharePoint Online

Adds a new SharePoint user or security group as GeoAdministrator to a multi-geo tenant.

Syntax

Add-SPOGeoAdministrator
   [-UserPrincipalName] <String>
   [<CommonParameters>]
Add-SPOGeoAdministrator
   [-GroupAlias] <String>
   [<CommonParameters>]
Add-SPOGeoAdministrator
   [-ObjectId] <Guid>
   [<CommonParameters>]

Description

This cmdlet requires a connection to a multi-geo tenant to run correctly. You must be a SharePoint Online administrator to run this cmdlet.

Examples

EXAMPLE 1

Add-SPOGeoAdministrator -UserPrincipalName admin@contoso.onmicrosoft.com

Adds the user admin@contoso.onmicrosoft.com as administrator to the SharePoint Online multi-geo tenant.

Parameters

-GroupAlias

Use this parameter to add a security group or a mail-enabled security group as a geo admin. (Distribution groups and Microsoft 365 Groups are not supported).

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-ObjectId

Not all security groups have a group alias. If you want to add a security group that does not have an alias, run Get-MsolGroup to retrieve a list of groups, find your security group's ObjectID, and then use this parameter. For more information, see Add or remove a geo administrator in Microsoft 365 Multi-Geo.

Type:Guid
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-UserPrincipalName

UserPrincipalName or UPN defined for the specific user on the SharePoint Online tenant.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online