View and Customize Settings in Outlook Web App Mailbox Policies

 

Applies to: Office 365 for professionals and small businesses, Office 365 for enterprises, Live@edu

Topic Last Modified: 2011-11-23

It's difficult to view all the settings in an Outlook Web App mailbox policy without truncating the results. However, you can save the results to a comma separated value (CSV) file or an HTML file, and open the file without truncating the results.

Also, the parameters in an Outlook Web App mailbox policy that control user access to files in Outlook Web App contain many values. However, as with most Set- cmdlets, the value you specify for one of these multi-valued parameters overwrites the existing values. In other words, if you run the command Set-OwaMailboxPolicy OwaMailboxPolicy-Default -AllowedFileTypes '.xyz', the entire list of allowed file types is replaced by the single value .xyz. That’s not good.

To remedy this, you can specify the original list of file types and the new file type you want to add. However, there are more efficient ways to add or remove individual file types from a list without affecting the existing values.

In this topic, we explain the following:

Before you begin

To learn how to install and configure Windows PowerShell and connect to the service, see Use Windows PowerShell in Exchange Online.

View all settings in an Outlook Web App mailbox policy

To save the settings in an Outlook Web App mailbox policy to a CSV file, run the following command:

Get-OwaMailboxPolicy <name> | ConvertTo-Csv -NoTypeInformation > "<file name>.csv"

For example, in Microsoft Office 365, to save the settings of the built-in Outlook Web App mailbox policy named OwaMailboxPolicy-Default to a file named "C:\My Documents\Default OWA Mailbox Policy.csv", run the following command:

Get-OwaMailboxPolicy OwaMailboxPolicy-Default | ConvertTo-Csv -NoTypeInformation > "C:\My Documents\Default OWA Mailbox Policy.csv"

After you open the CSV file in a spreadsheet application, it's much easier to view the results if you transpose the columns to rows. You can easily do this in Microsoft Excel with the transpose paste action.

Top of page

View the settings you can modify in an Outlook Web App mailbox policy

The Get-MailboxPolicy cmdlet shows all the settings associated with an Outlook Web App mailbox policy, including many settings you can't modify. To view the Outlook Web App mailbox policy settings you can modify, you need to view the built-in RBAC roles that give you access to the Set-OwaMailboxPolicy cmdlet, and the parameters that are available with that cmdlet. To view the Outlook Web App mailbox policy settings that you can modify, run the following command:

Get-ManagementRoleEntry *\Set-OwaMailboxPolicy | ConvertTo-HTML > <path and file name>.htm

For example, to save the results to a file named C:\My Documents\OWA Mailbox Policy Settings, run the following command:

Get-ManagementRoleEntry *\Set-OwaMailboxPolicy | ConvertTo-HTML > "C:\My Documents\OWA Mailbox Policy Settings.htm"

Notes:

  • The Role column and Parameters column in the HTML file are the most interesting.

  • Some of the parameters available on the Set-OwaMailboxPolicy cmdlet don't produce tangible results, or aren't available to all organizations. Use Outlook Web App Mailbox Policies | Available Settings as your guide to useful settings you can apply with Outlook Web App mailbox policies.

Top of page

View and modify file access lists

As described in Outlook Web App Mailbox Policies | Available Settings, the following parameters on the Set-OwaMailboxPolicy cmdlet control a user's access to specific file types in Outlook Web App mailbox policies:

  • AllowedFileTypes

  • BlockedFileTypes

  • ForceSaveFileTypes

  • AllowedMimeTypes

  • BlockedMimeTypes

  • ForceSaveMimeTypes

  • WebReadyFileTypes

  • WebReadyMimeTypes

The following procedures work with all the file access lists:

However, the following caveats apply to these procedures:

  • Parameters containing the word File use basic file extension syntax for each entry, for example, .doc.

  • Parameters containing the word Mime use the syntax <text>/<text> for each entry, for example, application/msword.

  • When the same file type is specified in more than one list, the following order of precedence is applied:

    • The Allow list overrides the Block list and the Force Save list.

    • The Block list overrides the Force Save list.

  • The WebReadyFileTypes and WebReadyMimeTypes parameters must contain values from the specific lists of pre-determined file types. These file types are found in the WebReadyDocumentViewingSupportedFileTypes and WebReadyDocumentViewingSupportedMimeTypes parameters on the Get-OwaMailboxPolicy cmdlet. You can remove existing entries or add missing entries from the WebReadyFileTypes and WebReadyMimeTypes parameters, but you can't add new or unknown file types. Furthermore, file types specified by the WebReadyFileTypes and WebReadyMimeTypes parameters are only used when the WebReadyDocumentViewingForAllSupportedFileTypes parameter is $false.

Top of page

Add or remove file types from file access lists

Run the following command:

Set-OwaMailboxPolicy <name> -<file access list> @{Add | Remove = '<value 1>','<value 2>'...}

For example, in a Live@edu organization, to add the file types .abc and .xyz to the AllowedFileTypes list in the Outlook Web App mailbox policy named OwaMailboxPolicy-DefaultMailboxPlan, run the following command:

Set-OwaMailboxPolicy OwaMailboxPolicy-DefaultMailboxPlan -AllowedFileTypes @{Add = '.abc','.xyz'}

This example removes the MIME embedded file type application/pdf from the WebReadyMimeTypes list in Outlook Web App mailbox policy named OwaMailboxPolicy-Default:

Set-OwaMailboxPolicy OwaMailboxPolicy-Default -WebReadyMimeTypes @{Remove = 'application/pdf'}

Top of page

View existing file types in file access lists

Run the following command:

Get-OwaMailboxPolicy <name> | select -ExpandProperty <file access list>

For example, in Microsoft Office 365, to view the contents of the BlockedFileTypes list in the Outlook Web App mailbox policy named OWAMailboxPolicy-Default without truncating the results, run the following command:

Get-OwaMailboxPolicy OWAMailboxPolicy-Default | select -ExpandProperty BlockedFileTypes

Note   To save the results of the previous command to a text file, add > "<file name and path>.txt" to the end of the command.

Top of page

 
Related help topics
Loading...
No resources were found.