Set-DefaultTenantMyAnalyticsFeatureConfig
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
Default (Default)
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 strongly advocates for the principle of least privilege. Assigning accounts only the minimum permissions necessary to perform their tasks helps reduce security risks and strengthens your organization's overall protection. Global Administrator is a highly privileged role that you typically limit to emergency scenarios or when you can't use a different 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
Applicable: Exchange Online
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)
Parameter properties
| Type: | String |
| Default value: | None |
| Accepted values: | Dashboard, Add-in, Digest-email, Meeting-effectiveness-survey, Scheduled-send, All |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-IsEnabled
Applicable: Exchange Online
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.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ResultSize
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Unlimited |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-SamplingRate
Applicable: Exchange Online
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.
Parameter properties
| Type: | Double |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.