Commands › Exchange Online

Set-VivaInsightsSettings

Exchange Online ExchangeOnlineManagement Set-*

For more information, see About the Exchange Online PowerShell module. **Note**: 0.5 or later of the module. Use the Set-VivaInsightsSettings cmdlet to control user access to features in Viva Insights. Only users with provisioned Exchange Online mailboxes can access features within the Viva Insights app in Teams.

Quick start script

# Set-VivaInsightsSettings — 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-VivaInsightsSettings
$before | Format-List

# 3. Make the change
Set-VivaInsightsSettings -Identity <String> -Enabled <Boolean> -Feature <String>

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

Syntax

Set-VivaInsightsSettings -Identity <String> -Enabled <Boolean> -Feature <String>
 [-ResultSize <Unlimited>]
 [<CommonParameters>]

Parameters (4)

Parameter	Type	Required	What it controls
-Identity	String	yes	The Identity parameter specifies the user that you want to modify. You identify the user by their User Principal Name (UPN) (for example, roy@contoso.onmicrosoft.com).
-Enabled	Boolean	yes	The Enabled parameter enables or disables access to specific features of Microsoft Viva Insights in Microsoft Teams for the user. Valid values are:
-Feature	String	yes	The Feature parameter specifies the feature of Microsoft Viva Insights in Microsoft Teams for the user. Valid values are:
-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.