Commands › Exchange Online

Remove-WorkforceInsightsDelegationAccess

Exchange Online ExchangeOnlineManagement Remove-*

9.2-Preview1 or later. For more information, see About the Exchange Online PowerShell module. Use the Remove-WorkforceInsightsDelegationAccess 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-WorkforceInsightsDelegationAccess — 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-WorkforceInsightsDelegationAccess
$before | Format-List

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

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

Syntax

Remove-WorkforceInsightsDelegationAccess -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.