Commands › Exchange Online
Remove-RoleGroupMember
Remove a member of a management role group.
Quick start script
# Remove-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)
Remove-RoleGroupMember -Identity <RoleGroupIdParameter> -Member <SecurityPrincipalIdParameter> -WhatIf
Remove-RoleGroupMember -Identity <RoleGroupIdParameter> -Member <SecurityPrincipalIdParameter>
# 4. Verify and diff
$after = Get-RoleGroupMember
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
Remove-RoleGroupMember [-Identity] <RoleGroupIdParameter> -Member <SecurityPrincipalIdParameter>
[-BypassSecurityGroupManagerCheck]
[-Confirm]
[-DomainController <Fqdn>]
[-WhatIf]
[<CommonParameters>]Parameters (6)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Identity | RoleGroupIdParameter | yes | The Identity parameter specifies the role group that you want to remove a member from. If the role group name contains spaces, enclose the name in quotation marks ("). |
| -Member | SecurityPrincipalIdParameter | yes | The Member parameter specifies who to remove from the role group. You can specify the following types of users or groups (security principals) for this parameter: |
| -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. | |
| -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.