New-OwaVirtualDirectory (RTM)
Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.
Applies to: Exchange Server 2007
The New-OWAVirtualDirectory cmdlet creates a new Outlook Web Access virtual directory in an existing Internet Information Services (IIS) Web site on a computer that is running Microsoft Exchange Server 2007.
Syntax
New-OwaVirtualDirectory [-Name <String>] [-ApplicationRoot <String>] [-AppPoolId <String>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-OwaVersion <Exchange2003or2000 | Exchange2007>] [-Path <String>] [-TemplateInstance <PSObject>] [-VirtualDirectoryType <NotSpecified | Mailboxes | PublicFolders | Exchweb | Exadmin>] [-WebSiteName <String>]
Detailed Description
By default, when Exchange 2007 is installed, the following Outlook Web Access virtual directories are created in the default IIS Web site on the local Exchange server:
Owa An Exchange 2007 Outlook Web Access virtual directory.
Exchange A legacy Outlook Web Access virtual directory that can be accessed by users who have mailboxes on Exchange Server 2003 or Exchange 2000 Server servers.
Public A legacy Outlook Web Access virtual directory that points to the public folders on Exchange Server 2003 or Exchange 2000 Server servers.
Exchweb A legacy Outlook Web Access virtual directory that users use to access the Outlook Web Access virtual directories. By default, requests to the "exchweb" virtual directory are sent to the user’s Mailbox server.
Note
Generally, you use the New-OWAVirtualDirectory cmdlet if you have special business needs that require additional virtual directories, such as hosting, or for Outlook Web Access troubleshooting tasks such as deleting and re-creating an Outlook Web Access virtual directory.
The New-OwaVirtualDirectory cmdlet must be run on the Exchange 2007 server that is hosting the Client Access server role on which you want to host the new virtual directory. To run the New-OwaVirtualDirectory cmdlet, 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.
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
ApplicationRoot |
Optional |
System.String |
This parameter sets the path of the virtual directory in the metabase. Note This parameter has not been implemented. |
AppPoolId |
Optional |
System.String |
This parameter sets the IIS application pool in which Outlook Web Access will run. It is best to leave this set to the default. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from the Active Directory directory service, include the DomainController parameter in the command. |
ExternalAuthenticationMethods |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
The ExternalAuthenticationMethods parameter, a Services Discovery property setting, specifies the authentication methods that are supported on the Exchange server from outside the firewall. Note This parameter has not been implemented, but can be set by using Set-OwaVirtualDirectory (RTM). |
ExternalUrl |
Optional |
System.Uri |
This parameter specifies the host name that would be used to connect to the Exchange server from outside the firewall. This setting is also important when Secure Sockets Layer (SSL) is used. Note You can configure this setting only on Exchange 2007 virtual directories. The default Exchange 2007 virtual directory is /owa. |
InternalUrl |
Optional |
System.Uri |
This parameter specifies the host name of the Exchange server host for connection from inside the firewall. This setting is also important when SSL is used. Note You can configure this setting only on Exchange 2007 virtual directories. The default Exchange 2007 virtual directory is /owa. |
Name |
Optional |
System.String |
This parameter specifies the name of an Outlook Web Access virtual directory if the Outlook Web Access virtual directory is on a server that is running Exchange Server 2003 or Exchange 2000 Server. If the Outlook Web Access virtual directory is on an Exchange 2007 server, the parameter is ignored. |
OWAVersion |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.OwaVersions |
This parameter specifies whether the version of the Outlook Web Access virtual directory is Exchange 2007, Exchange 2003, or Exchange 2000. |
Path |
Optional |
System.String |
This parameter sets the file system path of the virtual directory. This parameter should be used with care and only when it is necessary to use a different file system path than the default. |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
When an existing object is supplied to this parameter, the command uses the configuration of that object to create an identical copy of the object on a local or target server. Note This parameter has not been implemented. |
VirtualDirectoryType |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.VirtualDirectoryTypes |
This parameter specifies whether the Outlook Web Access virtual directory points to mailboxes, public folders, or exchweb. It is required if the Outlook Web Access virtual directory is on an Exchange 2003 or Exchange 2000 server. If the Outlook Web Access virtual directory is on an Exchange 2007 server, this parameter is ignored. |
WebSiteName |
Optional |
System.String |
This parameter specifies the name of the IIS Web site under which the Outlook Web Access virtual directory is created. |
Input Types
Return Types
Errors
| Error | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Example
The following code examples create a set of new Outlook Web Access legacy virtual directories named "exchange", "public", and "exchweb" in a non-default IIS Web site named "contoso.com" on the local Exchange server.
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Mailboxes -Name "exchange" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType PublicFolders -Name "public" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Exchweb -Name "exchweb" -WebSiteName "Contoso.com"