Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007
Topic Last Modified: 2007-08-27

This topic describes how to use the Microsoft Exchange Management Shell and Exchange Management Console to allow and block access to documents in Windows SharePoint Services document libraries and Windows file shares on specific servers.

You can use the Set-OwaVirtualDirectory cmdlet in the Exchange Management Shell to create a list of host names for servers for which you want to allow or block access to Windows SharePoint Services and Windows file share documents. For more information about the settings that you can configure on Outlook Web Access, see Set-OwaVirtualDirectory.

Table 1 lists the parameters that you can configure on an Outlook Web Access virtual directory to allow or block access to documents on specific servers.

Table 1   Parameters that can be configured on an Outlook Web Access virtual directory to allow or block access to documents

Parameter Description

RemoteDocumentsActionForUnknownServers

The RemoteDocumentsActionForUnknownServers parameter determines whether to allow or block a server host name that is not included in the Allow list or Block list.

RemoteDocumentsAllowedServers

The RemoteDocumentsAllowedServers parameter creates a list of host names of servers that can be accessed.

RemoteDocumentsBlockedServers

The RemoteDocumentsBlockedServer parameter creates list of host names of servers that are blocked.

Before You Begin

To perform the following procedure, the account you use must be delegated the Exchange Server Administrator role and membership in the local Administrators group for the target server.

For more information about permissions, delegating roles, and the rights that are required to administer Exchange 2007, see Permission Considerations.

Procedure

To use the Exchange Management Console to allow or block access to documents from specific servers

  1. Open the Exchange Management Console, select Server Configuration, and then select Client Access.

  2. On the Outlook Web Access tab, select the virtual directory that you want to configure, and then double-click it to view its properties.

  3. Click the Remote File Servers tab.

  4. Click the Block or Allow button, and then add the host names of the servers to which you want to allow or block access.

  5. Click OK to save your changes, and then click OK again to exit the properties.

To use the Exchange Management Shell to allow or block access to documents on specific servers

  • To allow access, run the following command:

    Copy Code
    Set-OWAVirtualDirectory -Identity "owa (Default web site)" -RemoteDocumentsAllowedServers <host name>
    
  • To block access, run the following command:

    Copy Code
    Set-OWAVirtualDirectory -Identity "owa (Default web site)" -RemoteDocumentsBlockedServers <host name>
    
  • To specify the action for unknown servers, run the following command:

    Copy Code
    Set-OWAVirtualDirectory -Identity "owa (Default web site)" -RemoteDocumentsActionforUnknownServers <Allow|Block>
    

    Use Allow to allow access to documents on unknown servers, or Block to block access to documents on unknown servers.

Note:
When you add host names to the Block and Allow lists, you must enter a server name. Entering a Windows file share name will not work.

For more information about syntax and parameters, see Set-OwaVirtualDirectory.

For More Information

For more information about how to configure Windows SharePoint Services and Windows file shares for Outlook Web Access, see Configuring Windows SharePoint Services and Windows File Share Integration for Outlook Web Access.