Commands › Exchange Online

Update-RoleGroupMember

Exchange Online ExchangeOnlineManagement Update-*

Modify the members of a management role group.

Quick start script

# Update-RoleGroupMember — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-RoleGroupMember
$before | Format-List

# 3. Make the change (dry run first)
Update-RoleGroupMember -Identity <RoleGroupIdParameter> -WhatIf
Update-RoleGroupMember -Identity <RoleGroupIdParameter>

# 4. Verify and diff
$after = Get-RoleGroupMember
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

Update-RoleGroupMember [-Identity] <RoleGroupIdParameter>
 [-BypassSecurityGroupManagerCheck]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-Members <MultiValuedProperty>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (6)

Parameter	Type	Required	What it controls
-Identity	RoleGroupIdParameter	yes	The Identity parameter specifies the role group whose membership you want to modify. If the name of the role group contains spaces, enclose the name in quotation marks (").
-BypassSecurityGroupManagerCheck	SwitchParameter		The BypassSecurityGroupManagerCheck switch specifies whether to allow a user who isn't an owner of the group to modify or delete the group. You don't need to specify a value with this switch.
-Confirm	SwitchParameter		The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding.
-DomainController	Fqdn		This parameter is available only in on-premises Exchange.
-Members	MultiValuedProperty		The Members parameter specifies the mailboxes or mail-enabled USGs to add as a member of the role group. You can identify the user or group by the name, DN, or primary SMTP address value. You can specify multiple...
-WhatIf	SwitchParameter		The WhatIf switch doesn't work in Security & Compliance PowerShell.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.