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 [-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