Set-DefaultTenantBriefingConfig
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-DefaultTenantBriefingConfig cmdlet to modify the default Briefing email configuration in cloud-based organizations. For details about configuring the Briefing email, see Configure Briefing email.
For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.
Syntax
Set-DefaultTenantBriefingConfig
-IsEnabledByDefault <String>
[-ResultSize <Unlimited>]
[<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-DefaultTenantBriefingConfig -IsEnabledByDefault Opt-in
This example sets the default Briefing email configuration for the organization to receive the Briefing email.Parameters
-IsEnabledByDefault
The IsEnabledByDefault parameter specifies the default Briefing email configuration for the organization. Valid values are:
- Opt-in: By default, all users in the organization are subscribed to receive the Briefing email.
- Opt-out: By default, no users in the organization are subscribed to receive the Briefing email. This is the default value.
This setting affects the following users:
- Existing users who haven't already updated their user settings to opt-in or opt-out of the Briefing email.
- New users that you create.
This setting does not affect users who've already updated their user settings to opt-in or opt-out of the Briefing email.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
This parameter is reserved for internal Microsoft use.
| Type: | Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |