New-OwaVirtualDirectory (RTM)

 

适用于： Exchange Server 2007

上一次修改主题： 2007-11-15

New-OWAVirtualDirectory cmdlet 用于在运行 Microsoft Exchange Server 2007 的计算机上的现有 Internet 信息服务 (IIS) 网站中新建 Outlook Web Access 虚拟目录。

语法

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>]

详细说明

默认情况下，安装 Exchange 2007 时，将在本地 Exchange 服务器的默认 IIS 网站中创建下列 Outlook Web Access 虚拟目录：

• Owa Exchange 2007 Outlook Web Access 虚拟目录。

• Exchange   旧版 Outlook Web Access 虚拟目录，Exchange Server 2003 或 Exchange 2000 Server 服务器上有邮箱的用户可以访问该目录。

• Public   旧版 Outlook Web Access 虚拟目录，指向 Exchange Server 2003 或 Exchange 2000 Server 服务器上的公用文件夹。

• Exchweb   旧版 Outlook Web Access 虚拟目录，用户使用该虚拟目录访问 Outlook Web Access 虚拟目录。默认情况下，对“exchweb”虚拟目录的请求将发送到用户的邮箱服务器。

  注意：
  通常，如果有需要使用其他虚拟目录的特殊业务需要（例如，主机驻留），或者需要执行 Outlook Web Access 故障排除任务（例如，删除和重新创建 Outlook Web Access 虚拟目录），则应使用 New-OWAVirtualDirectory cmdlet。

必须在要驻留新虚拟目录的已安装客户端访问服务器角色的 Exchange 2007 服务器上运行 New-OwaVirtualDirectory cmdlet。若要运行 New-OwaVirtualDirectory cmdlet，必须为您使用的帐户委派 Exchange Server 管理员角色以及目标服务器的本地 Administrators 组成员身份。

有关管理 Exchange 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。

参数

参数	必需	类型	说明
ApplicationRoot	可选	System.String	此参数用于在元数据库中设置虚拟目录的路径。 注意： 此参数尚未实现。
AppPoolId	可选	System.String	此参数用于设置将运行 Outlook Web Access 的 IIS 应用程序池。最好保留默认设置。
DomainController	可选	Microsoft.Exchange.Data.Fqdn	若要指定用于从 Active Directory 目录服务检索数据的域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。
ExternalAuthenticationMethods	可选	Microsoft.Exchange.Data.MultiValuedProperty	ExternalAuthenticationMethods 参数（服务探查属性设置）用于指定 Exchange 服务器支持的从防火墙外部进行身份验证的方法。 注意： 此参数尚未实现，但是可以使用 Set-OwaVirtualDirectory (RTM) 设置该参数。
ExternalUrl	可选	System.Uri	此参数指定用于从防火墙外部连接到 Exchange 服务器的主机名。如果使用安全套接字层 (SSL)，则此设置也很重要。 注意： 只能在 Exchange 2007 虚拟目录上配置此设置。默认的 Exchange 2007 虚拟目录为 /owa。
InternalUrl	可选	System.Uri	此参数指定从防火墙内部连接 Exchange 服务器主机的主机名。如果使用 SSL，则此设置也很重要。 注意： 只能在 Exchange 2007 虚拟目录上配置此设置。默认的 Exchange 2007 虚拟目录为 /owa。
Name	可选	System.String	如果 Outlook Web Access 虚拟目录位于运行 Exchange Server 2003 或 Exchange 2000 Server 的服务器上，则此参数指定 Outlook Web Access 虚拟目录的名称。 如果 Outlook Web Access 虚拟目录在 Exchange 2007 服务器上，则忽略此参数。
OWAVersion	可选	Microsoft.Exchange.Data.Directory.SystemConfiguration.OwaVersions	此参数指定 Outlook Web Access 虚拟目录的版本是否是 Exchange 2007、Exchange 2003 还是 Exchange 2000。
Path	可选	System.String	此参数设置虚拟目录的文件系统路径。使用此参数时应格外小心，仅在需要使用除默认值以外的其他文件系统路径时才使用它。
TemplateInstance	可选	System.Management.Automation.PSObject	将现有对象提供给此参数时，该命令将使用对象的配置在本地服务器或目标服务器上创建对象的相同副本。 注意： 此参数尚未实现。
VirtualDirectoryType	可选	Microsoft.Exchange.Data.Directory.SystemConfiguration.VirtualDirectoryTypes	此参数指定 Outlook Web Access 虚拟目录是指向邮箱、公用文件夹还是 exchweb。如果 Outlook Web Access 虚拟目录位于 Exchange 2003 或 Exchange 2000 服务器上，则该参数是必需的。 如果 Outlook Web Access 虚拟目录位于 Exchange 2007 服务器上，则忽略此参数。
WebSiteName	可选	System.String	此参数指定在其下创建 Outlook Web Access 虚拟目录的 IIS 网站的名称。

输入类型

返回类型

错误

错误	说明

异常

异常	说明

示例

以下代码示例在本地 Exchange 服务器的非默认 IIS 网站“contoso.com”中新建一组名为“exchange”、“public”和“exchweb”的 Outlook Web Access 旧版虚拟目录。

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"