Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2009-05-14

The Set-CASMailbox cmdlet sets client access-related attributes for Microsoft Exchange ActiveSync, Microsoft Office Outlook Web Access, Post Office Protocol version 3 (POP3), and Internet Message Access Protocol version 4rev1 (IMAP4) for a specified user.

Syntax


set-CASMailbox -Identity <MailboxIdParameter> [-ActiveSyncAllowedDeviceIDs <MultiValuedProperty>] [-ActiveSyncDebugLogging <Nullable>] [-ActiveSyncEnabled <$true \| $false>] [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-HasActiveSyncDevicePartnership <$true \| $false>] [-IgnoreDefaultScope <SwitchParameter>] [-ImapEnabled <$true \| $false>] [-ImapEnableExactRFC822Size <$true \| $false>] [-ImapMessagesRetrievalMimeFormat <TextOnly \| HtmlOnly \| HtmlAndTextAlternative \| TextEnrichedOnly \| TextEnrichedAndTextAlternative \| BestBodyFormat \| Tnef>] [-ImapUseProtocolDefaults <$true \| $false>] [-MAPIBlockOutlookNonCachedMode <$true \| $false>] [-MAPIBlockOutlookRpcHttp <$true \| $false>] [-MAPIBlockOutlookVersions <String>] [-MAPIEnabled <$true \| $false>] [-Name <String>] [-OWAActiveSyncIntegrationEnabled <Nullable>] [-OWAAllAddressListsEnabled <Nullable>] [-OWACalendarEnabled <Nullable>] [-OWAChangePasswordEnabled <Nullable>] [-OWAContactsEnabled <Nullable>] [-OWAEnabled <$true \| $false>] [-OWAJournalEnabled <Nullable>] [-OWAJunkEmailEnabled <Nullable>] [-OWANotesEnabled <Nullable>] [-OWAPremiumClientEnabled <Nullable>] [-OWAPublicFoldersEnabled <Nullable>] [-OWARecoverDeletedItemsEnabled <Nullable>] [-OWARemindersAndNotificationsEnabled <Nullable>] [-OWARulesEnabled <Nullable>] [-OWASearchFoldersEnabled <Nullable>] [-OWASignaturesEnabled <Nullable>] [-OWASMimeEnabled <Nullable>] [-OWASpellCheckerEnabled <Nullable>] [-OWATasksEnabled <Nullable>] [-OWAThemeSelectionEnabled <Nullable>] [-OWAUMIntegrationEnabled <Nullable>] [-OWAUNCAccessOnPrivateComputersEnabled <Nullable>] [-OWAUNCAccessOnPublicComputersEnabled <Nullable>] [-OWAWSSAccessOnPrivateComputersEnabled <Nullable>] [-OWAWSSAccessOnPublicComputersEnabled <Nullable>] [-PopEnabled <$true \| $false>] [-PopEnableExactRFC822Size <$true \| $false>] [-PopMessagesRetrievalMimeFormat <TextOnly \| HtmlOnly \| HtmlAndTextAlternative \| TextEnrichedOnly \| TextEnrichedAndTextAlternative \| BestBodyFormat \| Tnef>] [-PopUseProtocolDefaults <$true \| $false>] [-PrimarySmtpAddress <SmtpAddress>] [-ProtocolSettings <MultiValuedProperty>] [-SamAccountName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

set-CASMailbox -Identity <MailboxIdParameter>
[-ActiveSyncAllowedDeviceIDs <MultiValuedProperty>]
[-ActiveSyncDebugLogging <Nullable>] [-ActiveSyncEnabled
<$true | $false>] [-ActiveSyncMailboxPolicy
<MailboxPolicyIdParameter>] [-Confirm
[<SwitchParameter>]] [-DisplayName <String>]
[-DomainController <Fqdn>] [-EmailAddresses
<ProxyAddressCollection>] [-HasActiveSyncDevicePartnership
<$true | $false>] [-IgnoreDefaultScope
<SwitchParameter>] [-ImapEnabled <$true | $false>]
[-ImapEnableExactRFC822Size <$true | $false>]
[-ImapMessagesRetrievalMimeFormat <TextOnly | HtmlOnly |
HtmlAndTextAlternative | TextEnrichedOnly |
TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>]
[-ImapUseProtocolDefaults <$true | $false>]
[-MAPIBlockOutlookNonCachedMode <$true | $false>]
[-MAPIBlockOutlookRpcHttp <$true | $false>]
[-MAPIBlockOutlookVersions <String>] [-MAPIEnabled <$true
| $false>] [-Name <String>]
[-OWAActiveSyncIntegrationEnabled <Nullable>]
[-OWAAllAddressListsEnabled <Nullable>] [-OWACalendarEnabled
<Nullable>] [-OWAChangePasswordEnabled <Nullable>]
[-OWAContactsEnabled <Nullable>] [-OWAEnabled <$true |
$false>] [-OWAJournalEnabled <Nullable>]
[-OWAJunkEmailEnabled <Nullable>] [-OWANotesEnabled
<Nullable>] [-OWAPremiumClientEnabled <Nullable>]
[-OWAPublicFoldersEnabled <Nullable>]
[-OWARecoverDeletedItemsEnabled <Nullable>]
[-OWARemindersAndNotificationsEnabled <Nullable>]
[-OWARulesEnabled <Nullable>] [-OWASearchFoldersEnabled
<Nullable>] [-OWASignaturesEnabled <Nullable>]
[-OWASMimeEnabled <Nullable>] [-OWASpellCheckerEnabled
<Nullable>] [-OWATasksEnabled <Nullable>]
[-OWAThemeSelectionEnabled <Nullable>]
[-OWAUMIntegrationEnabled <Nullable>]
[-OWAUNCAccessOnPrivateComputersEnabled <Nullable>]
[-OWAUNCAccessOnPublicComputersEnabled <Nullable>]
[-OWAWSSAccessOnPrivateComputersEnabled <Nullable>]
[-OWAWSSAccessOnPublicComputersEnabled <Nullable>]
[-PopEnabled <$true | $false>] [-PopEnableExactRFC822Size
<$true | $false>] [-PopMessagesRetrievalMimeFormat
<TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly
| TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>]
[-PopUseProtocolDefaults <$true | $false>]
[-PrimarySmtpAddress <SmtpAddress>] [-ProtocolSettings
<MultiValuedProperty>] [-SamAccountName <String>]
[-UseRusServer <String>] [-WhatIf
[<SwitchParameter>]]


set-CASMailbox [-ActiveSyncAllowedDeviceIDs <MultiValuedProperty>] [-ActiveSyncDebugLogging <Nullable>] [-ActiveSyncEnabled <$true \| $false>] [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-HasActiveSyncDevicePartnership <$true \| $false>] [-IgnoreDefaultScope <SwitchParameter>] [-ImapEnabled <$true \| $false>] [-ImapEnableExactRFC822Size <$true \| $false>] [-ImapMessagesRetrievalMimeFormat <TextOnly \| HtmlOnly \| HtmlAndTextAlternative \| TextEnrichedOnly \| TextEnrichedAndTextAlternative \| BestBodyFormat \| Tnef>] [-ImapUseProtocolDefaults <$true \| $false>] [-Instance <CASMailbox>] [-MAPIBlockOutlookNonCachedMode <$true \| $false>] [-MAPIBlockOutlookRpcHttp <$true \| $false>] [-MAPIBlockOutlookVersions <String>] [-MAPIEnabled <$true \| $false>] [-Name <String>] [-OWAActiveSyncIntegrationEnabled <Nullable>] [-OWAAllAddressListsEnabled <Nullable>] [-OWACalendarEnabled <Nullable>] [-OWAChangePasswordEnabled <Nullable>] [-OWAContactsEnabled <Nullable>] [-OWAEnabled <$true \| $false>] [-OWAJournalEnabled <Nullable>] [-OWAJunkEmailEnabled <Nullable>] [-OWANotesEnabled <Nullable>] [-OWAPremiumClientEnabled <Nullable>] [-OWAPublicFoldersEnabled <Nullable>] [-OWARecoverDeletedItemsEnabled <Nullable>] [-OWARemindersAndNotificationsEnabled <Nullable>] [-OWARulesEnabled <Nullable>] [-OWASearchFoldersEnabled <Nullable>] [-OWASignaturesEnabled <Nullable>] [-OWASMimeEnabled <Nullable>] [-OWASpellCheckerEnabled <Nullable>] [-OWATasksEnabled <Nullable>] [-OWAThemeSelectionEnabled <Nullable>] [-OWAUMIntegrationEnabled <Nullable>] [-OWAUNCAccessOnPrivateComputersEnabled <Nullable>] [-OWAUNCAccessOnPublicComputersEnabled <Nullable>] [-OWAWSSAccessOnPrivateComputersEnabled <Nullable>] [-OWAWSSAccessOnPublicComputersEnabled <Nullable>] [-PopEnabled <$true \| $false>] [-PopEnableExactRFC822Size <$true \| $false>] [-PopMessagesRetrievalMimeFormat <TextOnly \| HtmlOnly \| HtmlAndTextAlternative \| TextEnrichedOnly \| TextEnrichedAndTextAlternative \| BestBodyFormat \| Tnef>] [-PopUseProtocolDefaults <$true \| $false>] [-PrimarySmtpAddress <SmtpAddress>] [-ProtocolSettings <MultiValuedProperty>] [-SamAccountName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

set-CASMailbox [-ActiveSyncAllowedDeviceIDs
<MultiValuedProperty>] [-ActiveSyncDebugLogging
<Nullable>] [-ActiveSyncEnabled <$true | $false>]
[-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
[-Confirm [<SwitchParameter>]] [-DisplayName <String>]
[-DomainController <Fqdn>] [-EmailAddresses
<ProxyAddressCollection>] [-HasActiveSyncDevicePartnership
<$true | $false>] [-IgnoreDefaultScope
<SwitchParameter>] [-ImapEnabled <$true | $false>]
[-ImapEnableExactRFC822Size <$true | $false>]
[-ImapMessagesRetrievalMimeFormat <TextOnly | HtmlOnly |
HtmlAndTextAlternative | TextEnrichedOnly |
TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>]
[-ImapUseProtocolDefaults <$true | $false>] [-Instance
<CASMailbox>] [-MAPIBlockOutlookNonCachedMode <$true |
$false>] [-MAPIBlockOutlookRpcHttp <$true | $false>]
[-MAPIBlockOutlookVersions <String>] [-MAPIEnabled <$true
| $false>] [-Name <String>]
[-OWAActiveSyncIntegrationEnabled <Nullable>]
[-OWAAllAddressListsEnabled <Nullable>] [-OWACalendarEnabled
<Nullable>] [-OWAChangePasswordEnabled <Nullable>]
[-OWAContactsEnabled <Nullable>] [-OWAEnabled <$true |
$false>] [-OWAJournalEnabled <Nullable>]
[-OWAJunkEmailEnabled <Nullable>] [-OWANotesEnabled
<Nullable>] [-OWAPremiumClientEnabled <Nullable>]
[-OWAPublicFoldersEnabled <Nullable>]
[-OWARecoverDeletedItemsEnabled <Nullable>]
[-OWARemindersAndNotificationsEnabled <Nullable>]
[-OWARulesEnabled <Nullable>] [-OWASearchFoldersEnabled
<Nullable>] [-OWASignaturesEnabled <Nullable>]
[-OWASMimeEnabled <Nullable>] [-OWASpellCheckerEnabled
<Nullable>] [-OWATasksEnabled <Nullable>]
[-OWAThemeSelectionEnabled <Nullable>]
[-OWAUMIntegrationEnabled <Nullable>]
[-OWAUNCAccessOnPrivateComputersEnabled <Nullable>]
[-OWAUNCAccessOnPublicComputersEnabled <Nullable>]
[-OWAWSSAccessOnPrivateComputersEnabled <Nullable>]
[-OWAWSSAccessOnPublicComputersEnabled <Nullable>]
[-PopEnabled <$true | $false>] [-PopEnableExactRFC822Size
<$true | $false>] [-PopMessagesRetrievalMimeFormat
<TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly
| TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>]
[-PopUseProtocolDefaults <$true | $false>]
[-PrimarySmtpAddress <SmtpAddress>] [-ProtocolSettings
<MultiValuedProperty>] [-SamAccountName <String>]
[-UseRusServer <String>] [-WhatIf
[<SwitchParameter>]]

Parameters

Parameter	Required	Type	Description
Identity	Required	Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter	This parameter can be the Active Directory Object ID or a string that represents the GUID, distinguished name, domain or account, user principal name (UPN), legacy Exchange distinguished name, Simple Mail Transfer Protocol (SMTP) address, or alias.
ActiveSyncAllowedDeviceIDs	Optional	Microsoft.Exchange.Data.MultiValuedProperty	This parameter accepts a list of device IDs that are allowed to synchronize with the mailbox.
ActiveSyncDebugLogging	Optional	System.Nullable	This parameter specifies whether error logging is enabled for mobile devices.
ActiveSyncEnabled	Optional	System.Boolean	This parameter enables or disables Exchange ActiveSync.
ActiveSyncMailboxPolicy	Optional	Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter	This parameter specifies the name of the Exchange ActiveSync mailbox policy for the mailbox.
Confirm	Optional	System.Management.Automation.SwitchParameter	The Confirm parameter causes the command to pause processing and requires that you acknowledge what the command will do before processing continues. You do not have to specify a value with the Confirm parameter.
DisplayName	Optional	System.String	This parameter is the display name for the mailbox.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	This parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes configuration changes to the Active Directory directory service.
EmailAddresses	Optional	Microsoft.Exchange.Data.ProxyAddressCollection	This parameter specifies the e-mail address for the mailbox.
HasActiveSyncDevicePartnership	Optional	System.Boolean	This parameter specifies whether the mailbox has an active sync device partnership established.
IgnoreDefaultScope	Optional	System.Management.Automation.SwitchParameter	This parameter instructs the command to ignore the default recipient scope setting for the Exchange Management Shell and to use the whole forest as the scope. This allows the command to access Active Directory objects that are currently not in the default scope. Using this parameter introduces the following restrictions: You cannot use the DomainController parameter. The command will use 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 are not accepted. You cannot use the OrganizationalUnit and Identity parameters together. You cannot use the Credential parameter.
ImapEnabled	Optional	System.Boolean	This parameter specifies whether the IMAP4 protocol is enabled for this mailbox.
ImapEnableExactRFC822Size	Optional	System.Boolean	The ImapEnableExactRFC822Size parameter specifies the IMAP4 cache size.
ImapMessagesRetrievalMimeFormat	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat	This parameter specifies the format of the messages that are retrieved from the server. The possible values are as follows: 0:Text Only 1:HTML Only 2:HTML and Alternative Text 3:Enriched Text Only 4:Enriched Text and Alternative Text 5:Best Body Format
ImapUseProtocolDefaults	Optional	System.Boolean	This parameter specifies whether to use protocol defaults for the IMAP4 protocol.
Instance	Optional	Microsoft.Exchange.Data.Directory.Management.CASMailbox	This parameter specifies an instance of a Client Access server.
MAPIBlockOutlookNonCachedMode	Optional	System.Boolean	This parameter specifies whether Outlook can be used in online mode.
MAPIBlockOutlookRpcHttp	Optional	System.Boolean	This parameter specifies whether clients can connect to Outlook by using Outlook Anywhere.
MAPIBlockOutlookVersions	Optional	System.String	This parameter specifies whether certain versions of Outlook are blocked.
MAPIEnabled	Optional	System.Boolean	This parameter specifies whether the MAPI protocol is enabled for the mailbox.
Name	Optional	System.String	This parameter specifies the name of the mailbox.
OWAActiveSyncIntegrationEnabled	Optional	System.Nullable	This parameter specifies whether Outlook Web Access Exchange ActiveSync mobile options are enabled.
OWAAllAddressListsEnabled	Optional	System.Nullable	This parameter specifies whether all address lists are available in Outlook Web Access.
OWACalendarEnabled	Optional	System.Nullable	This parameter specifies whether calendaring is enabled in Outlook Web Access.
OWAChangePasswordEnabled	Optional	System.Nullable	This parameter specifies whether a user can change their password in Outlook Web Access.
OWAContactsEnabled	Optional	System.Nullable	This parameter specifies whether contacts are enabled in Outlook Web Access.
OWAEnabled	Optional	System.Boolean	This parameter enables Outlook Web Access.
OWAJournalEnabled	Optional	System.Nullable	This parameter specifies whether the Journal folder can be accessed in Outlook Web Access.
OWAJournalEnabled	Optional	System.Nullable	This parameter specifies whether journaling is enabled in Outlook Web Access.
OWAJunkEmailEnabled	Optional	System.Nullable	This parameter specifies whether management of junk e-mail is enabled in Outlook Web Access.
OWANotesEnabled	Optional	System.Nullable	This parameter specifies whether Sticky Notes are enabled in Outlook Web Access.
OWAPremiumClientEnabled	Optional	System.Nullable	This parameter specifies whether the Outlook Web Access Premium version is enabled.
OWAPublicFoldersEnabled	Optional	System.Nullable	This parameter specifies whether the viewing of public folders is enabled in Outlook Web Access.
OWARecoverDeletedItemsEnabled	Optional	System.Nullable	This parameter specifies whether recovery of deleted items is enabled in Outlook Web Access.
OWARemindersAndNotificationsEnabled	Optional	System.Nullable	This parameter specifies whether calendar reminders are enabled in Outlook Web Access.
OWARulesEnabled	Optional	System.Nullable	This parameter specifies whether rules can be accessed in Outlook Web Access. If this parameter is set to `$false`, server rules will continue to function, but cannot be modified in Outlook Web Access.
OWASearchFoldersEnabled	Optional	System.Nullable	This parameter specifies whether search folders are enabled in Outlook Web Access.
OWASignaturesEnabled	Optional	System.Nullable	This parameter specifies whether the signature feature is enabled in Outlook Web Access.
OWASMimeEnabled	Optional	System.Nullable	This parameter specifies whether viewing of e-mail that is encrypted by using S/MIME is supported in Outlook Web Access.
OWASpellCheckerEnabled	Optional	System.Nullable	This parameter specifies whether the spelling checker is enabled in Outlook Web Access.
OWATasksEnabled	Optional	System.Nullable	This parameter specifies whether tasks are enabled in Outlook Web Access.
OWAThemeSelectionEnabled	Optional	System.Nullable	This parameter specifies whether theme selection is enabled in Outlook Web Access.
OWAUMIntegrationEnabled	Optional	System.Nullable	This parameter specifies whether Unified Messaging (UM) integration is enabled in Outlook Web Access.
OWAUNCAccessOnPrivateComputersEnabled	Optional	System.Nullable	This parameter specifies whether access to Windows file shares is permitted when users select This is a private computer on the Outlook Web Access logon page.
OWAUNCAccessOnPublicComputersEnabled	Optional	System.Nullable	This parameter specifies whether access to Windows file shares is permitted when users select This is a public or shared computer on the Outlook Web Access logon page.
OWAWSSAccessOnPrivateComputersEnabled	Optional	System.Nullable	This parameter specifies whether Windows SharePoint Services access is permitted when users select This is a private computer on the Outlook Web Access logon page.
OWAWSSAccessOnPublicComputersEnabled	Optional	System.Nullable	This parameter specifies whether Windows SharePoint Services access is permitted when users select This is a public or shared computer on the Outlook Web Access logon page.
PopEnabled	Optional	System.Boolean	This 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.
PopMessagesRetrievalMimeFormat	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat	This parameter specifies the format of the messages that are retrieved from the server. The possible values are as follows: 0:Text Only 1:HTML Only 2:HTML and Alternative Text 3:Enriched Text Only 4:Enriched Text and Alternative Text 6: Best Body Format
PopUseProtocolDefaults	Optional	System.Boolean	This parameter specifies whether to use protocol defaults for the POP3 protocol.
PrimarySmtpAddress	Optional	Microsoft.Exchange.Data.SmtpAddress	This parameter specifies the primary SMTP address that is associated with the mailbox.
ProtocolSettings	Optional	Microsoft.Exchange.Data.MultiValuedProperty	This parameter specifies the protocol settings.
SamAccountName	Optional	System.String	This parameter specifies the security account name.
UseRusServer	Optional	System.String	This parameter instructs the command to use the specified RUS server to get and set mailbox and Active Directory user attributes.
WhatIf	Optional	System.Management.Automation.SwitchParameter	This parameter instructs the command to simulate the actions that it would take on the object. By using this parameter, you can view the changes that would occur without having to apply any of those changes. You do not have to specify a value with this parameter.

Detailed Description

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

To run the Set-CASMailbox cmdlet, the account you use must be delegated the Exchange Recipient Administrator role.

For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.

Input Types

Return Types

Errors

Error	Description

Exceptions

Exceptions	Description

Example

The following code example enables the change password user interface in Outlook Web Access and enables POP3 for the user adam@contoso.com.

	Copy Code
Set-CASMailbox -identity adam@contoso.com -OWATasksEnabled:$true -POPEnabled:$true