Commands › SharePoint Online
Add-SPOGeoAdministrator
Adds a new SharePoint user or security group as GeoAdministrator to a multi-geo tenant.
Quick start script
# Add-SPOGeoAdministrator — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-SPOService -Url https://$org-admin.sharepoint.com
# 2. Run and inspect
Add-SPOGeoAdministrator -GroupAlias <String> -ObjectId <Guid> -UserPrincipalName <String> | Format-List
# 3. Export for evidence / drift tracking
Add-SPOGeoAdministrator | Export-Clixml .\SPOGeoAdministrator-$(Get-Date -Format yyyyMMdd).xmlSyntax — 3 parameter sets
User (Default)
Add-SPOGeoAdministrator [-UserPrincipalName] <String> [<CommonParameters>]Group
Add-SPOGeoAdministrator [-GroupAlias] <String> [<CommonParameters>]ObjectId
Add-SPOGeoAdministrator [-ObjectId] <Guid> [<CommonParameters>]Parameters (3)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -GroupAlias | String | yes | 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). |
| -ObjectId | Guid | yes | Not all security groups have a group alias. If you want to add a security group that does not have an alias, run Get-EntraGroup to retrieve a list of groups, find your security group's ObjectID, and then use this... |
| -UserPrincipalName | String | yes | UserPrincipalName or UPN defined for the specific user on the SharePoint Online tenant. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.