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

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'