Set-DefaultTenantMyAnalyticsFeatureConfig

Module:

ExchangePowerShell

Applies to:

Exchange Online

This cmdlet is available only in the Exchange Online PowerShell module version 3.2.0 or later. For more information, see About the Exchange Online PowerShell module.

Use the Set-DefaultTenantMyAnalyticsFeatureConfig cmdlet to update the availability and status of Viva Insights features for the cloud-based organization: digest email, add-in, dashboard, meeting effectiveness survey, and schedule send suggestions.

For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.

Syntax

Set-DefaultTenantMyAnalyticsFeatureConfig
   [-Feature <String>]
   [-IsEnabled <Boolean>]
   [-ResultSize <Unlimited>]
   [-SamplingRate <Double>]
   [<CommonParameters>]

Description

This cmdlet requires the .NET Framework 4.7.2 or later.

To run this cmdlet, you need to be a member of one of the following directory role groups in the destination organization:

• Global Administrator
• Exchange Administrator
• Insights Administrator

For more information, see Microsoft Entra built-in roles.

Important

Microsoft recommends that you use roles with the fewest permissions. Using lower permissioned accounts helps improve security for your organization. Global Administrator is a highly privileged role that should be limited to emergency scenarios when you can't use an existing role.

Examples

Example 1

Set-DefaultTenantMyAnalyticsFeatureConfig -Feature All -IsEnabled $true

This example enables all available Viva Insights features for the organization: add-in, dashboard, digest email, meeting effectiveness survey, schedule send suggestions.

Example 2

Set-DefaultTenantMyAnalyticsFeatureConfig -Feature Add-in -IsEnabled $false

This example disables Viva Insight add-in feature for the organization.

Example 3

Set-DefaultTenantMyAnalyticsFeatureConfig -Feature Meeting-Effectiveness-Survey-Sampling-Rate -SamplingRate 0.2

This example sets the meeting effectiveness survey sampling rate to 20%.

Parameters

-Feature

The Feature parameter specifies the Viva Insights feature to enable or disable. Valid values are:

• Add-in
• Dashboard
• Digest-email
• Meeting-effectiveness-survey
• Meeting-effectiveness-survey-sampling-rate
• Schedule-send
• All (all features)

Type:	String
Accepted values:	Dashboard, Add-in, Digest-email, Meeting-effectiveness-survey, Scheduled-send, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-IsEnabled

The IsEnabled parameter enables or disables the Viva Insights feature specified by the Feature parameter. Valid values are:

• $true: The feature is enabled.
• $false: The feature is disabled.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ResultSize

This parameter is reserved for internal Microsoft use.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SamplingRate

This parameter is available only in version 3.2.0 or later.

The SamplingRate parameter specifies the meeting effectiveness survey sampling rate. The percentage value is expressed a a decimal (for example, 0.1 indicates 10%). A valid value is from 0.1 to 0.7.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

Related Links

• Deploy personal insights