Applies to: Exchange Server 2013

Topic Last Modified: 2013-01-08

Use the Set-CASMailbox cmdlet to set attributes related to client access for Microsoft Exchange ActiveSync, Microsoft Office Outlook Web App, POP3, and IMAP4 for a specified user.

For information about the parameter sets in the Syntax section below, see Syntax.

Syntax


Set-CASMailbox -Identity <MailboxIdParameter> [-ActiveSyncAllowedDeviceIDs <MultiValuedProperty>] [-ActiveSyncBlockedDeviceIDs <MultiValuedProperty>] [-ActiveSyncDebugLogging <$true \| $false>] [-ActiveSyncEnabled <$true \| $false>] [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ECPEnabled <$true \| $false>] [-EmailAddresses <ProxyAddressCollection>] [-EwsAllowEntourage <$true \| $false>] [-EwsAllowList <MultiValuedProperty>] [-EwsAllowMacOutlook <$true \| $false>] [-EwsAllowOutlook <$true \| $false>] [-EwsApplicationAccessPolicy <EnforceAllowList \| EnforceBlockList>] [-EwsBlockList <MultiValuedProperty>] [-EwsEnabled <$true \| $false>] [-IgnoreDefaultScope <SwitchParameter>] [-ImapEnabled <$true \| $false>] [-ImapEnableExactRFC822Size <$true \| $false>] [-ImapForceICalForCalendarRetrievalOption <$true \| $false>] [-ImapMessagesRetrievalMimeFormat <TextOnly \| HtmlOnly \| HtmlAndTextAlternative \| TextEnrichedOnly \| TextEnrichedAndTextAlternative \| BestBodyFormat \| Tnef>] [-ImapSuppressReadReceipt <$true \| $false>] [-ImapUseProtocolDefaults <$true \| $false>] [-MAPIBlockOutlookNonCachedMode <$true \| $false>] [-MAPIBlockOutlookRpcHttp <$true \| $false>] [-MAPIBlockOutlookVersions <String>] [-MAPIEnabled <$true \| $false>] [-Name <String>] [-OWAEnabled <$true \| $false>] [-OwaMailboxPolicy <MailboxPolicyIdParameter>] [-OWAMobileAppEnabled <$true \| $false>] [-PopEnabled <$true \| $false>] [-PopEnableExactRFC822Size <$true \| $false>] [-PopForceICalForCalendarRetrievalOption <$true \| $false>] [-PopMessagesRetrievalMimeFormat <TextOnly \| HtmlOnly \| HtmlAndTextAlternative \| TextEnrichedOnly \| TextEnrichedAndTextAlternative \| BestBodyFormat \| Tnef>] [-PopSuppressReadReceipt <$true \| $false>] [-PopUseProtocolDefaults <$true \| $false>] [-PrimarySmtpAddress <SmtpAddress>] [-ResetAutoBlockedDevices <SwitchParameter>] [-SamAccountName <String>] [-ShowGalAsDefaultView <$true \| $false>] [-WhatIf [<SwitchParameter>]]

Set-CASMailbox -Identity <MailboxIdParameter>
[-ActiveSyncAllowedDeviceIDs <MultiValuedProperty>]
[-ActiveSyncBlockedDeviceIDs <MultiValuedProperty>]
[-ActiveSyncDebugLogging <$true | $false>]
[-ActiveSyncEnabled <$true | $false>]
[-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
[-Confirm [<SwitchParameter>]] [-DisplayName <String>]
[-DomainController <Fqdn>] [-ECPEnabled <$true |
$false>] [-EmailAddresses <ProxyAddressCollection>]
[-EwsAllowEntourage <$true | $false>] [-EwsAllowList
<MultiValuedProperty>] [-EwsAllowMacOutlook <$true |
$false>] [-EwsAllowOutlook <$true | $false>]
[-EwsApplicationAccessPolicy <EnforceAllowList |
EnforceBlockList>] [-EwsBlockList <MultiValuedProperty>]
[-EwsEnabled <$true | $false>] [-IgnoreDefaultScope
<SwitchParameter>] [-ImapEnabled <$true | $false>]
[-ImapEnableExactRFC822Size <$true | $false>]
[-ImapForceICalForCalendarRetrievalOption <$true | $false>]
[-ImapMessagesRetrievalMimeFormat <TextOnly | HtmlOnly |
HtmlAndTextAlternative | TextEnrichedOnly |
TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>]
[-ImapSuppressReadReceipt <$true | $false>]
[-ImapUseProtocolDefaults <$true | $false>]
[-MAPIBlockOutlookNonCachedMode <$true | $false>]
[-MAPIBlockOutlookRpcHttp <$true | $false>]
[-MAPIBlockOutlookVersions <String>] [-MAPIEnabled <$true
| $false>] [-Name <String>] [-OWAEnabled <$true |
$false>] [-OwaMailboxPolicy <MailboxPolicyIdParameter>]
[-OWAMobileAppEnabled <$true | $false>] [-PopEnabled
<$true | $false>] [-PopEnableExactRFC822Size <$true |
$false>] [-PopForceICalForCalendarRetrievalOption <$true |
$false>] [-PopMessagesRetrievalMimeFormat <TextOnly |
HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly |
TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>]
[-PopSuppressReadReceipt <$true | $false>]
[-PopUseProtocolDefaults <$true | $false>]
[-PrimarySmtpAddress <SmtpAddress>] [-ResetAutoBlockedDevices
<SwitchParameter>] [-SamAccountName <String>]
[-ShowGalAsDefaultView <$true | $false>] [-WhatIf
[<SwitchParameter>]]

Examples

EXAMPLE 1

This example enables Outlook Web App and enables POP3 for the user adam@contoso.com.

	Copy Code
Set-CASMailbox -Identity adam@contoso.com -OWAEnabled:$true -PopEnabled:$true

EXAMPLE 2

This example enables Exchange ActiveSync logging and specifies the Exchange ActiveSync mailbox policy for the user adam@contoso.com.

	Copy Code
Set-CASMailbox -Identity adam@contoso.com -ActiveSyncDebugLogging:$true -ActiveSyncMailboxPolicy "Management"

EXAMPLE 3

This example sets the display name and enables Outlook Anywhere access for the user tony@contoso.com.

	Copy Code
Set-CASMailbox -Identity tony@contoso.com -DisplayName "Tony Smith" -MAPIBlockOutlookRpcHttp:$true

Detailed Description

The Set-CASMailbox cmdlet operates on one mailbox at a time. You can configure properties for Outlook Web App, Exchange ActiveSync, POP3, and IMAP4 by using this cmdlet. You can configure a single property or multiple properties by using one statement.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Client protocol settings" entry in the Recipients Permissions topic.

Parameters

Parameter	Required	Type	Description
Identity	Required	Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter	The Identity parameter specifies the mailbox ID. You can use the following values: GUID Distinguished name (DN) User principal name (UPN) SMTP address Alias
ActiveSyncAllowedDeviceIDs	Optional	Microsoft.Exchange.Data.MultiValuedProperty	The ActiveSyncAllowedDeviceIDs parameter accepts a list of device IDs that are allowed to synchronize with the mailbox.
ActiveSyncBlockedDeviceIDs	Optional	Microsoft.Exchange.Data.MultiValuedProperty	The ActiveSyncBlockedDeviceIDs parameter accepts a list of device IDs that aren't allowed to synchronize with the mailbox.
ActiveSyncDebugLogging	Optional	System.Boolean	The ActiveSyncDebugLogging parameter specifies whether logging is enabled for debugging purposes for Exchange ActiveSync.
ActiveSyncEnabled	Optional	System.Boolean	The ActiveSyncEnabled parameter specifies whether to enable Exchange ActiveSync.
ActiveSyncMailboxPolicy	Optional	Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter	The ActiveSyncMailboxPolicy parameter specifies the name of the Exchange ActiveSync mailbox policy for the mailbox.
Confirm	Optional	System.Management.Automation.SwitchParameter	The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch.
DisplayName	Optional	System.String	The DisplayName parameter specifies the display name for the mailbox.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.
ECPEnabled	Optional	System.Boolean	The ECPEnabled parameter specifies whether the Web management interface is enabled on this Client Access server.
EmailAddresses	Optional	Microsoft.Exchange.Data.ProxyAddressCollection	The EmailAddresses parameter specifies the email address for the mailbox.
EwsAllowEntourage	Optional	System.Boolean	The EwsAllowEntourage parameter specifies whether to allow or disallow Entourage 2008 for Mac, Web Services Edition to access Exchange Web Services for the user. (Because Entourage 2008 is entirely based on Exchange Web Services, this parameter allows for enabling or disabling Entourage 2008.)
EwsAllowList	Optional	Microsoft.Exchange.Data.MultiValuedProperty	The EwsAllowList parameter specifies the applications (user agent strings) that can access Exchange Web Services when the EwsApplicationAccessPolicy parameter is set to `EnforceAllowList`.
EwsAllowMacOutlook	Optional	System.Boolean	The EwsAllowMacOutlook parameter specifies whether to allow or disallow Microsoft Outlook for Mac 2011 to access Exchange Web Services for the user. (Because Outlook for Mac 2011 is entirely based on Exchange Web Services, this parameter allows for enabling or disabling Outlook for Mac 2011.)
EwsAllowOutlook	Optional	System.Boolean	The EwsAllowOutlook parameter specifies whether to allow or disallow Microsoft Office Outlook 2007 to access Exchange Web Services for the user. Outlook uses Exchange Web Services for free/busy, out-of-office settings, and calendar sharing.
EwsApplicationAccessPolicy	Optional	Microsoft.Exchange.Data.Directory.EwsApplicationAccessPolicy	The EwsApplicationAccessPolicy parameter specifies which applications other than Entourage, Outlook for Mac 2011, and Outlook can access Exchange Web Services. If set to `EnforceAllowList`, only applications specified in the EwsAllowList parameter are allowed access to Exchange Web Services. If set to `EnforceBlockList`, every application is allowed access to Exchange Web Services except the ones specified in the EwsBlockList parameter.
EwsBlockList	Optional	Microsoft.Exchange.Data.MultiValuedProperty	The EwsBlockList parameter specifies the applications (user agent strings) that can't access Exchange Web Services when the EwsApplicationAccessPolicy parameter is set to `EnforceBlockList`.
EwsEnabled	Optional	System.Boolean	The EwsEnabled parameter specifies whether to globally enable or disable Exchange Web Services access for the user, regardless of which application is making the request. When the EwsEnabled parameter is set to `$false`, Exchange Web Services access is turned off regardless of the values of the EwsAllowEntourage parameter. In other words, for the EwsAllowEntourage parameter to be meaningful, Exchange Web Services must be enabled in the first place and thus the EwsEnabled parameter must be set to `$true`.
IgnoreDefaultScope	Optional	System.Management.Automation.SwitchParameter	The IgnoreDefaultScope parameter instructs the command to ignore the default recipient scope setting for the Exchange Management Shell session and use the entire forest as the scope. This allows the command to access Active Directory objects that aren't currently in the default scope. Using the IgnoreDefaultScope parameter introduces the following restrictions: You can't use the DomainController parameter. The command uses an appropriate global catalog server automatically. You can only use the DN for the Identity parameter. Other forms of identification, such as alias or GUID, aren't accepted.
ImapEnabled	Optional	System.Boolean	The ImapEnabled parameter specifies whether the IMAP4 protocol is enabled for this mailbox.
ImapEnableExactRFC822Size	Optional	System.Boolean	The ImapEnableExactRFC822Size parameter specifies the IMAP4 cache size.
ImapForceICalForCalendarRetrievalOption	Optional	System.Boolean	The IMAPForceICalForCalendarRetrievalOption parameter specifies that the iCal format should be used to retrieve calendar information.
ImapMessagesRetrievalMimeFormat	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat	The ImapMessagesRetrievalMimeFormat parameter specifies the format of the messages retrieved from the server. The possible values are: 0: `TextOnly` 1: `HtmlOnly` 2: `HtmlAndTextAlternative` 3: `TextEnrichedOnly` 4: `TextEnrichedAndTextAlternative` 5: `BestBodyFormat` 6: `Tnef`
ImapSuppressReadReceipt	Optional	System.Boolean	The ImapSuppressReadReceipt parameter specifies whether to stop duplicate read receipts from being sent to IMAP4 senders that are using the "send read receipt for messages I send" option in their IMAP4 email program. This option is set to `$false` by default. By default, IMAP4 senders that use the "send read receipt for messages I send" option receive a read receipt in both of the following circumstances: When messages they send are downloaded by the recipient. When the recipient opens the message. The valid values and descriptions for this parameter are: `$false` IMAP4 users are sent a read receipt each time a recipient downloads a message. IMAP4 users are also sent a read receipt when the user opens the message. `$true` IMAP4 users that use the "send read receipt for messages I send" option in their email client programs only receive a read receipt when the recipient opens the message.
ImapUseProtocolDefaults	Optional	System.Boolean	The ImapUseProtocolDefaults parameter specifies whether to use protocol defaults for the IMAP4 protocol.
MAPIBlockOutlookNonCachedMode	Optional	System.Boolean	The MAPIBlockOutlookNonCachedMode parameter specifies whether Microsoft Outlook can be used in online mode.
MAPIBlockOutlookRpcHttp	Optional	System.Boolean	The MAPIBlockOutlookRpcHttp parameter specifies whether clients can connect to Outlook by using Outlook Anywhere.
MAPIBlockOutlookVersions	Optional	System.String	The MAPIBlockOutlookVersions parameter specifies whether certain versions of Outlook are blocked.
MAPIEnabled	Optional	System.Boolean	The MAPIEnabled parameter specifies whether the MAPI protocol is enabled for the mailbox.
Name	Optional	System.String	The Name parameter specifies the name of the mailbox.
OWAEnabled	Optional	System.Boolean	The OWAEnabled parameter specifies whether to enable Outlook Web App.
OwaMailboxPolicy	Optional	Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter	The OwaMailboxPolicy parameter specifies the active Outlook Web App mailbox policy.
OWAMobileAppEnabled	Optional	System.Boolean	This parameter is reserved for internal Microsoft use.
PopEnabled	Optional	System.Boolean	The PopEnabled parameter specifies whether the POP3 protocol is enabled for a mailbox.
PopEnableExactRFC822Size	Optional	System.Boolean	The PopEnableExactRFC822Size parameter specifies the size of the POP3 cache.
PopForceICalForCalendarRetrievalOption	Optional	System.Boolean	POPForceICalForCalendarRetrievalOption parameter specifies that the iCal format should be used to retrieve calendar information.
PopMessagesRetrievalMimeFormat	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat	The PopMessagesRetrievalMimeFormat parameter specifies the format of the messages retrieved from the server. The possible values are: 0: `TextOnly` 1: `HtmlOnly` 2: `HtmlAndTextAlternative` 3: `TextEnrichedOnly` 4: `TextEnrichedAndTextAlternative` 5: `BestBodyFormat` 6: `Tnef`
PopSuppressReadReceipt	Optional	System.Boolean	The PopSuppressReadReceipt parameter specifies whether to stop duplicate read receipts from being sent to POP3 senders that are using the "send read receipt for messages I send" option in their POP3 email program. This option is set to `$false` by default. By default, POP3 senders that use the "send read receipt for messages I send" option receive a read receipt in both of the following circumstances: When messages they send are downloaded by the recipient. When the recipient opens the message. The valid values and descriptions for this parameter are: `$false` POP3 users are sent a read receipt each time a recipient downloads a message. POP3 users are also sent a read receipt when the user opens the message. `$true` POP3 users that use the "send read receipt for messages I send" option in their email client programs only receive a read receipt when the recipient opens the message.
PopUseProtocolDefaults	Optional	System.Boolean	The PopUseProtocolDefaults parameter specifies whether to use protocol defaults for the POP3 protocol.
PrimarySmtpAddress	Optional	Microsoft.Exchange.Data.SmtpAddress	The PrimarySmtpAddress parameter specifies the primary SMTP address associated with the mailbox.
ResetAutoBlockedDevices	Optional	System.Management.Automation.SwitchParameter	The ResetAutoBlockedDevices switch specifies whether to reset the status of any mobile device that has been blocked automatically.
SamAccountName	Optional	System.String	The SamAccountName parameter specifies the security account name.
ShowGalAsDefaultView	Optional	System.Boolean	The ShowGalAsDefaultView parameter specifies that the global address list (GAL) is shown by default when adding message recipients.
WhatIf	Optional	System.Management.Automation.SwitchParameter	The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch.

Input Types

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

Return Types

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.