Veritas Enterprise Vault™ Setting up the Enterprise Vault Office Mail App

Last Published:
Product(s): Enterprise Vault (12.1, 12.0, 11.0.1, 11.0, 10.0.4, 10.0.3)
  1. Setting up the Enterprise Vault Office Mail App
    1.  
      About Microsoft Office Mail App
    2. About the Enterprise Vault Office Mail App
      1.  
        Enterprise Vault Office Mail App features
    3.  
      Enterprise Vault Office Mail App policy settings and options
    4.  
      Initial configuration of HTTPS for use of the Enterprise Vault Office Mail App
    5. Deploying the Enterprise Vault Office Mail App
      1.  
        About the PowerShell cmdlets for Office Mail Apps
      2.  
        About deploying the Office Mail App with the New-App cmdlet
      3.  
        About New-App command parameters for the Enterprise Vault Office Mail App
      4.  
        Deploying the Enterprise Vault Office Mail App for an individual user
      5.  
        Deploying the Enterprise Vault Office Mail App for multiple users
      6.  
        About the Enterprise Vault Office Mail App after deployment for an individual user
      7.  
        Deploying the Enterprise Vault Office Mail App for an organization
      8.  
        About the Enterprise Vault Office Mail App after deployment for an organization
      9.  
        Mailbox synchronization after upgrade to enable use of the Office Mail App
    6.  
      Additional requirements on Enterprise Vault Office Mail App users' computers
    7.  
      Disabling and re-enabling the Enterprise Vault Office Mail App for a device type
    8.  
      Removing, disabling, and re-enabling the Enterprise Vault Office Mail App for a user or an organization
    9. Troubleshooting the Enterprise Vault Office Mail App
      1.  
        Enterprise Vault Office Mail App: client tracing
      2.  
        Enterprise Vault Office Mail App: server tracing
      3.  
        Checking deployment of the Enterprise Vault Office Mail App
      4.  
        The Enterprise Vault Office Mail App manifest file is not created
      5.  
        Unable to deploy the Enterprise Vault Office Mail App at organization level
      6.  
        The Enterprise Vault Office Mail App window is blank or contains an error message
      7.  
        An Enterprise Vault Office Mail App action fails with an error message

Deploying the Enterprise Vault Office Mail App for an individual user

To deploy the Enterprise Vault Office Mail App for an individual user, use the PowerShell cmdlet New-App in the Exchange Management Shell.

See About deploying the Office Mail App with the New-App cmdlet.

Note:

You must log in to the Exchange server using an account that is assigned the management role User Options. By default, members of the "Organization Management" role group are assigned this role.

The following example shows how to use the New-App cmdlet to enable an individual user for the Office Mail App.

The backtick character (') is the PowerShell line-continuation character.

Add-Type -AssemblyName System.Web
$Mbx = get-mailbox "mailbox"

New-App -mailbox $Mbx.LegacyExchangeDN -Url '
    ("http://EV_server/EnterpriseVault/OfficeMailAppManifest.aspx?LegacyMbxDn=" +
    [System.Web.HttpUtility]::UrlEncode($Mbx.LegacyExchangeDN))

Where:

  • mailbox is the name of a mailbox that is enabled for archiving, and that you want to enable for the Office Mail App.

  • EV_server is the name of any Enterprise Vault server in your site. This Enterprise Vault server is not necessarily the one that is used to load the Office Mail App. The Enterprise Vault server that is used to load the Office Mail App is the server where the archive for the specified mailbox is located. The name of the correct Enterprise Vault server for the specified mailbox is returned within the manifest file.

Users may access the Enterprise Vault server externally, with no direct access. In this case, the manifest file must point to the URL of the server that provides external access. The same server would also be used for internal access. For example, the server may be a Microsoft Forefront Threat Management Gateway (TMG) server.

The following example shows how to use the BaseURL parameter with the OfficeMailAppManifest.aspx page to configure the manifest file to point to a server that provides external access.

The backtick character (') is the PowerShell line-continuation character.

Add-Type -AssemblyName System.Web
$Mbx = get-mailbox "mailbox"

New-App -mailbox $Mbx.LegacyExchangeDN -Url '
    ("http://EV_server/EnterpriseVault/OfficeMailAppManifest.aspx?LegacyMbxDn=" +
    [System.Web.HttpUtility]::UrlEncode($Mbx.LegacyExchangeDN) + 
    "&BaseURL=https://external_access_server/EnterpriseVault")

Where:

  • mailbox is the name of a mailbox that is enabled for archiving, and that you want to enable for the Office Mail App.

  • EV_server is the name of any Enterprise Vault server in your site. This Enterprise Vault server is not necessarily the one that is used to load the Office Mail App. The Enterprise Vault server that is used to load the Office Mail App is the server that is specified in the BaseURL parameter.

  • external_access_server is the name of the server that provides external access.