| applicable | Exchange Online |
|---|---|
| external help file | Microsoft.Exchange.Management.RestApiClient.dll-Help.xml |
| Locale | en-US |
| Module Name | ExchangePowerShell |
| online version | https://learn.microsoft.com/powershell/module/exchangepowershell/set-defaulttenantbriefingconfig |
| schema | 2.0.0 |
| title | 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.
Set-DefaultTenantBriefingConfig -IsEnabledByDefault <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
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.
Set-DefaultTenantBriefingConfig -IsEnabledByDefault Opt-in
This example sets the default Briefing email configuration for the organization to receive the Briefing email.
Applicable: Exchange Online
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 value is the default.
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
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseApplicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Type: Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.