New-OwaVirtualDirectory

 

适用于: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题: 2010-02-25

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

语法

New-OwaVirtualDirectory [-Name <String>] [-ApplicationRoot <String>] [-AppPoolId <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-OwaVersion <Exchange2003or2000 | Exchange2007>] [-Path <String>] [-TemplateInstance <PSObject>] [-VirtualDirectoryType <NotSpecified | Mailboxes | PublicFolders | Exchweb | Exadmin>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]

详细说明

默认情况下,安装 Exchange 2007 后,将在运行 Microsoft 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 2003 或 Exchange 2000 的服务器上的公用文件夹。

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

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

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

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

参数

参数 必需 类型 说明

ApplicationRoot

可选

System.String

此参数用于在元数据库中设置虚拟目录的路径。

note注意:
此参数尚未实现。

AppPoolId

可选

System.String

此参数用于设置将运行 Outlook Web Access 的 IIS 应用程序池。最好保留默认设置。

Confirm

可选

System.Management.Automation.SwitchParameter

此参数将导致命令暂停处理,并且需要您在继续处理之前确认该命令将执行的操作。您不必使用 Confirm 参数指定值。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

此参数指定从 Active Directory 目录服务检索数据域控制器的完全限定的域名 (FQDN)。

ExternalAuthenticationMethods

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数(服务探查属性设置)用于指定 Exchange 服务器支持的从防火墙外部进行身份验证的方法。

note注意:
此参数尚未实现,但是可以使用 Set-OwaVirtualDirectory 设置该参数。

ExternalUrl

可选

System.Uri

此参数指定用于从防火墙外部连接到 Exchange 服务器的主机名。如果使用安全套接字层 (SSL),则此设置也很重要。

note注意:
只能在 Exchange 2007 虚拟目录上配置此设置。默认的 Exchange 2007 虚拟目录为 /owa。

InternalUrl

可选

System.Uri

此参数指定从防火墙内部连接 Exchange 服务器主机的主机名。如果使用 SSL,则此设置也很重要。

note注意:
只能在 Exchange 2007 虚拟目录上配置此设置。默认的 Exchange 2007 虚拟目录为 /owa。

Name

可选

System.String

如果某个 Outlook Web Access 虚拟目录位于运行 Exchange 2003 或 Exchange 2000 的服务器上,则此参数指定此 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

为此参数提供一个现有对象时,此参数将指定 cmdlet 使用此对象的配置在本地服务器或目标服务器上创建此对象的相同副本。

note注意:
此参数尚未实现。

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 网站的名称。

WhatIf

可选

System.Management.Automation.SwitchParameter

此参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数,您可以查看要发生的更改,而不必应用任何这些更改。您不必使用 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

以下代码示例在本地 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"