Enable or disable MAPI access to mailboxes in Exchange 2016

 

Applies to: Exchange Server 2016

Topic Last Modified: 2017-05-26

Learn how administrators can enable or disable MAPI access to specific mailboxes in Exchange 2016.

MAPI is a client protocol that lets users access their mailbox by using Outlook or other MAPI email clients. By default, MAPI access to a user mailbox is enabled. Disabling MAPI access to a mailbox prevents the user from using Outlook to access their mailbox in Exchange mode. It doesn't prevent the user from using Outlook on the web or Outlook using other protocols (for example, POP3, IMAP4, or Exchange ActiveSync) to access their mailbox.

Administrators can use the Exchange admin center (EAC) or the Exchange Management Shell to enable or disable MAPI access to user mailbox.

For additional management tasks related to user access to mailboxes, see these topics:

tipTip:
Having problems? Ask for help in the Exchange forums. Visit the forums at: Exchange Server, Exchange Online, or Exchange Online Protection..

  1. In the EAC, go to Recipients > Mailboxes.

  2. In the list of mailboxes, find the mailbox that you want to modify. You can:

    • Scroll through the list of mailboxes.

    • Click Search Search icon and enter part of the user's name, email address, or alias.

    • Click More options More Options icon > Advanced search to find the mailbox.

    Once you've found the mailbox that you want to modify, select it, and then click Edit Edit icon.

  3. On the mailbox properties page that opens, click Mailbox features.

  4. In the Email Connectivity section, configure one of these settings:

    • If you see MAPI: Enabled, click Disable to disable it, and then click Yes in the warning message that appears.

    • If you see MAPI: Disabled, click Enable to enable it.

    Protocol access settings for a mailbox in the EAC at Recipients > select mailbox > Edit > Mailbox features > Email connectivity

    When you're finished, click Save.

To enable or disable MAPI access to a single mailbox, use this syntax:

Set-CasMailbox -Identity <MailboxIdentity> -MAPIEnabled <$true | $false>

This example disables MAPI access to the mailbox named Ken Sanchez.

Set-CasMailbox -Identity "Ken Sanchez" -MAPIEnabled $false

This example enables MAPI access to the mailbox named Esther Valle.

Set-CasMailbox -Identity "Esther Valle" -MAPIEnabled $true

For detailed syntax and parameter information, see Set-CASMailbox.

  1. In the EAC, go to Recipients > Mailboxes.

  2. In the list of mailboxes, find the mailboxes that you want to modify. You can:

    • Scroll through the list of mailboxes.

    • Click Search Search icon and enter part of the user's name, email address, or alias.

    • Click More options More Options icon > Advanced search to find the mailbox.

  3. In the list of mailboxes, select multiple mailboxes of the same type (for example, User) from the list. For example:

    • Select a mailbox, hold down the Shift key, and select another mailbox that's farther down in the list.

    • Hold down the CTRL key as you select each mailbox.

    After you select multiple mailboxes of the same type, the title of the details pane changes to Bulk Edit.

  4. In the details pane, scroll down to MAPI, click Enable or Disable, and then click OK in the warning message that appears.

    Bulk select mailboxes in the EAC to enable or disable MAPI

You can use the Get-Mailbox, Get-User or Get-Content cmdlets to identify the mailboxes that you want to modify. For example:

  • Use the OrganizationalUnit parameter to filter the mailboxes by organizational unit (OU).

  • Use the Filter parameter to create OPATH filters that identify the mailboxes. For more information, see Filterable properties for the -Filter parameter.

  • Use a text file to specify the mailboxes. The text file contains one mailbox (email address, name, or other unique identifier) on each line like this:

    ebrunner@tailspintoys.com
    fapodaca@tailspintoys.com
    glaureano@tailspintoys.com
    hrim@tailspintoys.com
    

This example disables MAPI access to all user mailboxes in the North America\Finance OU.

$NAFinance = Get-Mailbox -OrganizationalUnit "OU=Marketing,OU=North America,DC=contoso,DC=com" -Filter {RecipientTypeDetails -eq 'UserMailbox'} -ResultSize Unlimited; $NAFinance | foreach  {Set-CasMailbox  $_.Identity -MAPIEnabled $false}

This example disables MAPI access to all user mailboxes in the Engineering department in Washington state.

Get-User -Filter {RecipientType -eq 'UserMailbox' -and Department -like 'Engineering*' -and StateOrProvince -eq 'WA'} | Set-CasMailbox -MAPIEnabled $false

This example uses the text file C:\My Documents\Accounts.txt to disable MAPI access to the specified mailboxes.

Get-Content "C:\My Documents\Accounts.txt" | foreach {Set-CasMailbox $_ -MAPIEnabled $false}

For detailed syntax and parameter information, see Get-Mailbox and Get-User.

To verify that you've successfully enabled or disabled MAPI access to a mailbox, do any of these steps:

  • In the EAC, go to Recipients > Mailboxes > select the mailbox > click Edit Edit icon > Mailbox features and verify the MAPI value in the Email Connectivity section.

    Protocol access settings for a mailbox in the EAC at Recipients > select mailbox > Edit > Mailbox features > Email connectivity
  • In the Exchange Management Shell, replace <MailboxIdentity> with the identity of the mailbox (for example, name, alias, or email address), and run this command:

    Get-CasMailbox -Identity "<MailboxIdentity>"
    
  • Use the same filter that you used to identify the mailboxes, but use the Get-CasMailbox cmdlet instead of Set-CasMailbox. For example:

    Get-User -Filter {RecipientType -eq 'UserMailbox' -and Department -like 'Engineering*' -and StateOrProvince -eq 'WA'} | Get-CasMailbox
    
  • In the Exchange Management Shell, run this command to show all mailboxes where Outlook on the web access is disabled:

    Get-CasMailbox -ResultSize unlimited -Filter {MAPIEnabled -eq $false}
    
 
Show: