Commands › Exchange Online

Remove-VivaOrgInsightsDelegatedRole

Exchange Online ExchangeOnlineManagement Remove-*

7.1 or later. For more information, see About the Exchange Online PowerShell module. Use the Remove-VivaOrgInsightsDelegatedRole cmdlet to remove delegate access from the specified account (the delegate) so they can't view organizational insights like the leader (the delegator).

Quick start script

# Remove-VivaOrgInsightsDelegatedRole — 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-VivaOrgInsightsDelegatedRole
$before | Format-List

# 3. Make the change
Remove-VivaOrgInsightsDelegatedRole -Delegate <Guid> -Delegator <Guid>

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

Syntax

Remove-VivaOrgInsightsDelegatedRole -Delegate <Guid> -Delegator <Guid>
 [-ResultSize <Unlimited>]
 [<CommonParameters>]

Parameters (3)

Parameter	Type	Required	What it controls
-Delegate	Guid	yes	The Delegate parameter specifies the account that can view organizational insights like the leader (the account specified by the Delegator account).
-Delegator	Guid	yes	The Delegator parameter specifies the account of the leader that can view organizational insights. This capability is delegated to the account specified by the Delegate parameter.
-ResultSize	Unlimited		This parameter is reserved for internal Microsoft use.

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