Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

Topic Last Modified: 2012-11-16

Use the Set-OwaMailboxPolicy cmdlet to configure an existing Microsoft Office Outlook Web App mailbox policy.

Syntax

Set-OwaMailboxPolicy -Identity <MailboxPolicyIdParameter> [-ActionForUnknownFileAndMIMETypes <Allow | ForceSave | Block>] [-ActiveSyncIntegrationEnabled <$true | $false>] [-AllAddressListsEnabled <$true | $false>] [-AllowedFileTypes <MultiValuedProperty>] [-AllowedMimeTypes <MultiValuedProperty>] [-BlockedFileTypes <MultiValuedProperty>] [-BlockedMimeTypes <MultiValuedProperty>] [-CalendarEnabled <$true | $false>] [-ChangePasswordEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-ContactsEnabled <$true | $false>] [-DefaultClientLanguage <Int32>] [-DefaultTheme <String>] [-DelegateAccessEnabled <$true | $false>] [-DirectFileAccessOnPrivateComputersEnabled <$true | $false>] [-DirectFileAccessOnPublicComputersEnabled <$true | $false>] [-DomainController <Fqdn>] [-ExplicitLogonEnabled <$true | $false>] [-ForceSaveAttachmentFilteringEnabled <$true | $false>] [-ForceSaveFileTypes <MultiValuedProperty>] [-ForceSaveMimeTypes <MultiValuedProperty>] [-ForceWebReadyDocumentViewingFirstOnPrivateComputers <$true | $false>] [-ForceWebReadyDocumentViewingFirstOnPublicComputers <$true | $false>] [-GlobalAddressListEnabled <$true | $false>] [-InstantMessagingEnabled <$true | $false>] [-InstantMessagingType <None | Ocs | Msn>] [-IRMEnabled <$true | $false>] [-JournalEnabled <$true | $false>] [-JunkEmailEnabled <$true | $false>] [-LogonAndErrorLanguage <Int32>] [-Name <String>] [-NotesEnabled <$true | $false>] [-OrganizationEnabled <$true | $false>] [-OutboundCharset <AlwaysUTF8 | AutoDetect | UserLanguageChoice>] [-OWALightEnabled <$true | $false>] [-OWAMiniEnabled <$true | $false>] [-PhoneticSupportEnabled <$true | $false>] [-PremiumClientEnabled <$true | $false>] [-PublicFoldersEnabled <$true | $false>] [-RecoverDeletedItemsEnabled <$true | $false>] [-RemindersAndNotificationsEnabled <$true | $false>] [-RulesEnabled <$true | $false>] [-SearchFoldersEnabled <$true | $false>] [-SignaturesEnabled <$true | $false>] [-SilverlightEnabled <$true | $false>] [-SMimeEnabled <$true | $false>] [-SpellCheckerEnabled <$true | $false>] [-TasksEnabled <$true | $false>] [-TextMessagingEnabled <$true | $false>] [-ThemeSelectionEnabled <$true | $false>] [-UMIntegrationEnabled <$true | $false>] [-UNCAccessOnPrivateComputersEnabled <$true | $false>] [-UNCAccessOnPublicComputersEnabled <$true | $false>] [-UseGB18030 <$true | $false>] [-UseISO885915 <$true | $false>] [-WebReadyDocumentViewingForAllSupportedTypes <$true | $false>] [-WebReadyDocumentViewingOnPrivateComputersEnabled <$true | $false>] [-WebReadyDocumentViewingOnPublicComputersEnabled <$true | $false>] [-WebReadyDocumentViewingSupportedFileTypes <MultiValuedProperty>] [-WebReadyDocumentViewingSupportedMimeTypes <MultiValuedProperty>] [-WebReadyFileTypes <MultiValuedProperty>] [-WebReadyMimeTypes <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WSSAccessOnPrivateComputersEnabled <$true | $false>] [-WSSAccessOnPublicComputersEnabled <$true | $false>]

Detailed Description

By default, when Exchange is installed, an Outlook Web App mailbox policy named default is created in the organization. The Set-OwaMailboxPolicy cmdlet configures an existing Outlook Web App mailbox policy.

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 "Outlook Web App mailbox policies" entry in the Client Access Permissions topic.

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

The Identity parameter specifies the name of the policy or the path to the policy including the name, for example, <Organization>\<ResellerA>\<Reseller…n>\<Tenant>\<Object Name>.

ActionForUnknownFileAndMIMETypes

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AttachmentBlockingActions

The ActionForUnknownFileAndMIMETypes parameter specifies how to handle files that aren't included in other File Access Management lists.

The following values are valid for this parameter:

  • Allow

  • ForceSave

  • Block

ActiveSyncIntegrationEnabled

Optional

System.Boolean

The ActiveSyncIntegrationEnabled parameter specifies whether to disable Microsoft Exchange ActiveSync on the Outlook Web App Options page.

AllAddressListsEnabled

Optional

System.Boolean

The AllAddressListsEnabled parameter specifies which address lists are available to the user.

You can use one of the following values:

  • If set to $true, users can view all address lists.

  • If set to $false, users can view only the global address list.

AllowedFileTypes

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The AllowedFileTypes parameter specifies the extensions of file types that the user can save locally and view from a Web browser. If the same extensions are in multiple settings lists, the most secure setting overrides the less secure settings.

AllowedMimeTypes

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The AllowedMimeTypes parameter creates extensions of MIME attachments that users can save locally and view from a Web browser. If the same extensions are in multiple settings lists, the most secure setting overrides the less secure settings.

BlockedFileTypes

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The BlockedFileTypes parameter specifies a list of extensions of attachments that are blocked. Attachments that contain these blocked extensions can't be saved locally or viewed from a Web browser.

BlockedMimeTypes

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The BlockedMimeTypes parameter specifies a list of MIME extensions of attachments that are blocked. Attachments that contain these blocked MIME extensions can't be saved locally or viewed from a Web browser.

CalendarEnabled

Optional

System.Boolean

The CalendarEnabled parameter specifies whether to enable or disable the calendar for users.

ChangePasswordEnabled

Optional

System.Boolean

The ChangePasswordEnabled parameter specifies whether users can change their passwords from inside Outlook Web App.

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.

ContactsEnabled

Optional

System.Boolean

The ContactsEnabled parameter specifies whether Contacts are enabled for users.

DefaultClientLanguage

Optional

System.Int32

The DefaultClientLanguage parameter isn't available in this release.

DefaultTheme

Optional

System.String

The DefaultTheme parameter specifies the default theme used by Outlook Web App when the user has not selected a theme.

DelegateAccessEnabled

Optional

System.Boolean

The DelegateAccessEnabled parameter specifies whether delegates can use Outlook Web App to open folders they have delegate access to through this virtual directory.

DirectFileAccessOnPrivateComputersEnabled

Optional

System.Boolean

The DirectFileAccessOnPrivateComputersEnabled parameter specifies the left-click options on attachments when the user has chosen to log on using the Private option. If this parameter is set to $true, Open is an available option. If it's set to $false, the Open option is disabled.

DirectFileAccessOnPublicComputersEnabled

Optional

System.Boolean

The DirectFileAccessOnPublicComputersEnabled parameter specifies the left-click options on attachments when the user has chosen to log on using the Public option. If this parameter is set to $true, Open is an available option. If it's set to $false, the Open option is disabled.

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.

ExplicitLogonEnabled

Optional

System.Boolean

The ExplicitLogonEnabled parameter specifies whether to allow a user to open someone else's mailbox in Outlook Web App. If this parameter is set to $true, it allows a user to open someone else's mailbox in Outlook Web App.

ForceSaveAttachmentFilteringEnabled

Optional

System.Boolean

The ForceSaveAttachmentFilteringEnabled parameter sets whether files which are included in the list of extensions created by the ForceSaveFileTypes parameter are filtered before the user can save them.

ForceSaveFileTypes

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The ForceSaveFileTypes parameter creates a list of extensions of attachments that can be opened only after the file is saved locally on the user's computer.

ForceSaveMimeTypes

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The ForceSaveMimeTypes parameter specifies the MIME types of attachments that can be opened only after the file is saved locally on the user's computer.

ForceWebReadyDocumentViewingFirstOnPrivateComputers

Optional

System.Boolean

The ForceWebReadyDocumentViewingFirstOnPrivateComputers parameter specifies whether a user who has logged on using the Private option can open a document directly without first viewing it as a Web page.

ForceWebReadyDocumentViewingFirstOnPublicComputers

Optional

System.Boolean

The ForceWebReadyDocumentViewingFirstOnPublicComputers parameter specifies whether a user who has logged on using the Public option can open a document directly without first viewing it as a Web page.

GlobalAddressListEnabled

Optional

System.Boolean

The GlobalAddressListEnabled parameter specifies whether to show the global address list in Outlook Web App.

InstantMessagingEnabled

Optional

System.Boolean

The InstantMessagingEnabled parameter specifies whether to enable instant messaging in Outlook Web App.

InstantMessagingType

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.InstantMessagingTypeOptions

The InstantMessagingType parameter specifies the type of instant messaging provider to be used. Set this parameter to 0 for no provider and 1 for Microsoft Office Communication Server. Outlook Live organizations can also set this parameter to 2 for Microsoft Network(MSN).

IRMEnabled

Optional

System.Boolean

The IRMEnabled parameter specifies whether the Information Rights Management (IRM) feature is enabled.

JournalEnabled

Optional

System.Boolean

The JournalEnabled parameter specifies whether the Journal folder is visible.

JunkEmailEnabled

Optional

System.Boolean

The JunkEmailEnabled parameter specifies whether the Junk E-Mail management tools are enabled.

LogonAndErrorLanguage

Optional

System.Int32

The LogonAndErrorLanguage parameter specifies which language Outlook Web App uses for forms-based authentication and for error messages that occur when a user's current language setting can't be read. When this parameter has a value of 0, the language selection is undefined.

Name

Optional

System.String

The Name parameter specifies a name for the new policy.

NotesEnabled

Optional

System.Boolean

The NotesEnabled parameter specifies whether the Notes folder is visible in Outlook Web App.

OrganizationEnabled

Optional

System.Boolean

When the OrganizationEnabled parameter is set to $false, the Automatic Reply option doesn't include external and internal options, the address book doesn't show the organization hierarchy, and the Resources tab in Calendar forms is turned off.

OutboundCharset

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.OutboundCharsetOptions

The OutboundCharset parameter specifies the character set used for messages sent by users on a specific Outlook Web App virtual directory.

OWALightEnabled

Optional

System.Boolean

The OWALightEnabled parameter, when set to $false, removes the option to use the light version of Outlook Web App from the logon page and removes the Accessibility check box from the General Options tab. This parameter doesn't apply to Outlook Web App.

OWAMiniEnabled

Optional

System.Boolean

This parameter controls whether the mini version of Outlook Web App is enabled.

PhoneticSupportEnabled

Optional

System.Boolean

The PhoneticSupportEnabled parameter specifies phonetically spelled entries in the address book. This parameter is available for use in Japan.

PremiumClientEnabled

Optional

System.Boolean

The PremiumClientEnabled parameter specifies whether a user can access Outlook Web App. This parameter doesn't apply to the light version of Outlook Web App.

PublicFoldersEnabled

Optional

System.Boolean

The PublicFoldersEnabled parameter specifies whether a user can browse or read items in public folders using Outlook Web App.

By default, the PublicFoldersEnabled parameter is set to $true. If the PublicFoldersEnabled parameter is set to $false, users can only access their private mailboxes in Outlook Web App.

RecoverDeletedItemsEnabled

Optional

System.Boolean

The RecoverDeletedItemsEnabled parameter specifies whether a user can use Outlook Web App to view, recover, or delete permanently items that have been deleted from the Deleted Items folder. By default, the RecoverDeletedItemsEnabled parameter is set to $true. If the RecoverDeletedItemsEnabled parameter is set to $false, the items deleted from the Deleted Items folder are retained. However, users can't view, recover, or permanently delete them using Outlook Web App.

RemindersAndNotificationsEnabled

Optional

System.Boolean

The RemindersAndNotificationsEnabled parameter specifies whether notifications and reminders are enabled in Outlook Web App. This parameter doesn't apply to the light version of Outlook Web App.

RulesEnabled

Optional

System.Boolean

The RulesEnabled parameter specifies whether a user can view, create, or modify server-side rules using Outlook Web App. By default, the RulesEnabled parameter is set to $true. If the RulesEnabled parameter is set to $false, users must use Microsoft Outlook to view, create, and modify server-side rules.

SearchFoldersEnabled

Optional

System.Boolean

The SearchFoldersEnabled parameter specifies whether Search Folders are available in Outlook Web App.

SignaturesEnabled

Optional

System.Boolean

The SignaturesEnabled parameter specifies whether a user can use the Signature feature in Outlook Web App.

SilverlightEnabled

Optional

System.Boolean

The SilverlightEnabled parameter specifies whether a user can use Microsoft Silverlight features in Outlook Web App.

SMimeEnabled

Optional

System.Boolean

The SMimeEnabled parameter specifies whether users can download the S/MIME control for Outlook Web App and use it to read and compose signed and encrypted messages. By default, the SMimeEnabled parameter is set to $true. If the SMimeEnabled parameter is set to $false, users are unable to read or compose messages that are opaque-signed or encrypted. Messages that are clear-signed can be read but not composed, and their signatures aren't validated.

SpellCheckerEnabled

Optional

System.Boolean

The SpellCheckerEnabled parameter specifies whether a user can check spelling in Outlook Web App. This parameter doesn't apply to the light version of Outlook Web App.

TasksEnabled

Optional

System.Boolean

The TasksEnabled parameter specifies whether a user can use the Tasks feature in Outlook Web App. This parameter doesn't apply to the light version of Outlook Web App.

TextMessagingEnabled

Optional

System.Boolean

The TextMessagingEnabled parameter specifies whether users can send and receive text messages. This parameter doesn't apply to the light version of Outlook Web App.

ThemeSelectionEnabled

Optional

System.Boolean

The ThemeSelectionEnabled parameter specifies whether users can select a theme in Outlook Web App.

UMIntegrationEnabled

Optional

System.Boolean

The UMIntegrationEnabled parameter specifies whether Unified Messaging is enabled on Outlook Web App. This setting applies only if Unified Messaging has been enabled for a user using the Enable-UMMailbox cmdlet. This parameter doesn't apply to the light version of Outlook Web App.

UNCAccessOnPrivateComputersEnabled

Optional

System.Boolean

The UNCAccessOnPrivateComputersEnabled parameter isn't available in this release.

UNCAccessOnPublicComputersEnabled

Optional

System.Boolean

The UNCAccessOnPublicComputersEnabled parameter isn't available in this release.

UseGB18030

Optional

System.Boolean

The UseGB18030 parameter specifies when to use the character set GB18030. This parameter is a character-handling registry key that works in coordination with the OutboundCharset registry key. When the UseGB18030 parameter is set to 1, the character set GB18030 is used wherever GB2312 would have been used.

UseISO885915

Optional

System.Boolean

The UseISO885915 parameter specifies when to use the character set ISO8859-15. This parameter is a character-handling registry key that works in coordination with the OutboundCharset registry key. When the UseISO885915 parameter is set to 1, the character set ISO8859-15 is used wherever ISO8859-1 would have been used.

WebReadyDocumentViewingForAllSupportedTypes

Optional

System.Boolean

The WebReadyDocumentViewingForAllSupportedTypes parameter enables WebReady Document Viewing for all supported file and MIME types. If this parameter is set to $false, use the WebReadyFileTypes and WebReadyMimeTypes parameters to set which file and MIME types to convert.

WebReadyDocumentViewingOnPrivateComputersEnabled

Optional

System.Boolean

The WebReadyDocumentViewingOnPrivateComputersEnabled parameter specifies whether WebReady Document Viewing is enabled when the user selects the This is a private computer option on the Outlook Web App logon page.

WebReadyDocumentViewingOnPublicComputersEnabled

Optional

System.Boolean

The WebReadyDocumentViewingOnPublicComputersEnabled parameter specifies whether WebReady Document Viewing is enabled when the user selects the This is a public or shared computer option on the Outlook Web App logon page.

WebReadyDocumentViewingSupportedFileTypes

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The read-only WebReadyDocumentViewingSupportedFileTypes parameter lists the file types supported by the conversion engine.

WebReadyDocumentViewingSupportedMimeTypes

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The read-only WebReadyDocumentViewingSupportedMimeTypes parameter lists the MIME types supported by the conversion engine

WebReadyFileTypes

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The WebReadyFileTypes parameter creates a list of file types on which WebReady Document Viewing is performed.

WebReadyMimeTypes

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The WebReadyMimeTypes parameter creates a list of MIME types on which WebReady Document Viewing is performed.

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.

WSSAccessOnPrivateComputersEnabled

Optional

System.Boolean

The WSSAccessOnPrivateComputersEnabled parameter isn't available in this release.

WSSAccessOnPublicComputersEnabled

Optional

System.Boolean

The WSSAccessOnPublicComputersEnabled parameter isn't available in this release.

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.

Examples

EXAMPLE 1

This example disables access to the calendar for the mailbox policy Corporate for the tenant Contoso in the organization EMEA.

Copy Code
Set-OwaMailboxPolicy -Identity EMEA\Contoso\Corporate -CalendarEnabled $false

EXAMPLE 2

This example disables access to the Tasks folder for the default mailbox policy.

Copy Code
Set-OwaMailboxPolicy -Identity Default -TasksEnabled $false

EXAMPLE 3

This example sets the allowed file type extensions to .doc and .pdf for the default mailbox policy, allowing users to save files with those extensions locally or view them from a Web browser.

Copy Code
Set-OwaMailboxPolicy -Identity Default -AllowedFileTypes '.doc', '.pdf'