Applies to: Exchange Server 2007
Topic Last Modified: 2007-11-15
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>]
|
Parameters
| Parameter | Required | Type | Description | ||
|---|---|---|---|---|---|
|
ApplicationRoot |
Optional |
System.String |
This parameter sets the path of the virtual directory in the metabase.
|
||
|
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.
|
||
|
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.
|
||
|
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.
|
||
|
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.
|
||
|
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. |
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.
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.
 Copy Code |
|
|---|---|
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" |
|