Configure the Briefing email

As the admin, you can configure Briefing email for your organization. However, before configuration, confirm the following.

  • Prerequisite: Users get access to the Briefing email only if they have licenses that include the Exchange Online service plan.
  • Data privacy: See the Privacy Guide to understand how privacy is built into Briefing emails and to learn what you can configure to address your organization’s specific privacy requirements.

As the admin, you can set the Briefing email up at the tenant level or the user level.

Tenant-level configuration

You can enable or disable the Briefing email for all users in your organization at the tenant level. Use the following Exchange Online PowerShell cmdlets to set the tenant default:

Set-OrganizationIntelligenceConfig [-BriefingEmailDefault [<”Opt-in” | “Opt-out”>]
  • If you set BriefingEmailDefault parameter to Opt-out, the Briefing email will be Off by default for your organization. Users can then opt-in at briefing.microsoft.com.
  • If you set BriefingEmailDefault parameter to Opt-in, the Briefing email will be On by default for your organization. Users can then opt-out at briefing.microsoft.com. If no action is taken, this setting applies by default.

To get the current state of the Briefing email setting, use:

Get-OrganizationIntelligenceConfig

User-level configuration

You can also configure the Briefing email for individual users in your organization. At this level, you can completely opt-out a user, which turns off all Briefing email functionality for that user. However, the user can choose to opt back in at briefing.microsoft.com.

  • To enable or disable the Briefing email for a specific user in your organization, use the following Exchange Online PowerShell cmdlets, where you replace “Contoso\Jill” with your applicable organization and username:

    Set-UserIntelligenceConfig -Identity Contoso\Jill [-BriefingEmailMode [<”Opt-in” | “Opt-out”>]
    
    • If you set the BriefingEmailMode parameter to Opt-out, the Briefing email will be Off by default for that user. Users can then opt-in from briefing.microsoft.com.
    • If you set the BriefingEmailMode parameter to Opt-in, the Briefing email will be On by default for that user. Users can then opt-out from briefing.microsoft.com. If no action occurs, this setting applies by default.

    For example, to get the current state of the Briefing email flag for “Contoso\Jill,” you'd use:

    Get-UserIntelligenceConfig -Identity Contoso\Jill
    
  • Or you can set the parameter for multiple users with a PowerShell script that iterates through the users, changing the value one user at a time. Use the following script to:

    • List the user principal name for each user.
    • Set the specified Briefing email mode for each user.
    • Create a .csv file with all the users that were processed and shows their status.
    1. Create a comma-separated value (.csv) text file that contains the UserPrincipalName field and the location of the users you want to configure. For example:
    UserPrincipalName
    ClaudeL@contoso.onmicrosoft.com
    LynneB@contoso.onmicrosoft.com
    ShawnM@contoso.onmicrosoft.com
    
    1. Specify the location of the input .csv file, the output .csv file, and the value of BriefingEmailMode of Opt-in or Opt-out for each user:
    $inFileName="<path and file name of the input .csv file that contains the users, example: C:\admin\Users2Opt-out..csv>"
    $outFileName="<path and file name of the output .csv file that records the results, example: C:\admin\Users2Opt-out-Done..csv>"
    $briefingEmailMode = "Opt-in"
    
    $users=Import-Csv $inFileName
    ForEach ($user in $users)
    {
    $user.Userprincipalname
    $upn=$user.UserPrincipalName
    
    Set-UserInelligenceConfig –Identity $upn -BriefingEmailMode $briefingEmailMode
    Get-UserIntelligenceConfig –Identity $upn | Export-Csv $outFileName
    }
    
    1. Run the resulting commands at the PowerShell command prompt. For more information about the Exchange Online PowerShell, see Connect to Exchange Online PowerShell.

Briefing email overview