Skip to content

Latest commit

 

History

History
130 lines (89 loc) · 3.15 KB

File metadata and controls

130 lines (89 loc) · 3.15 KB
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/add-spogeoadministrator
applicable SharePoint Online
title Add-SPOGeoAdministrator
schema 2.0.0
author samkabue
ms.author speedta
ms.reviewer
ms.custom no-azure-ad-ps-ref

Add-SPOGeoAdministrator

SYNOPSIS

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

SYNTAX

User (Default)

Add-SPOGeoAdministrator [-UserPrincipalName] <String> [<CommonParameters>]

Group

Add-SPOGeoAdministrator [-GroupAlias] <String> [<CommonParameters>]

ObjectId

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

Applicable: SharePoint Online

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: System.String
Parameter Sets: Group
Aliases:

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

-ObjectId

Applicable: SharePoint Online

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 parameter. For more information, see Add or remove a geo administrator in Microsoft 365 Multi-Geo.

Type: System.Guid
Parameter Sets: ObjectId
Aliases:

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

-UserPrincipalName

Applicable: SharePoint Online

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

Type: System.String
Parameter Sets: User
Aliases:

Required: True
Position: 0
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.

INPUTS

None

OUTPUTS

System.Object

NOTES

RELATED LINKS

Getting started with SharePoint Online Management Shell

Get-SPOAppErrors

Get-SPOGeoAdministrator

Remove-SPOGeoAdministrator