New-WebServicesVirtualDirectory
适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题： 2007-08-20
使用 New-WebServicesVirtualDirectory cmdlet，可以在运行 Microsoft Exchange Server 2007（安装了客户端访问服务器角色）的计算机上新建一个名为 EWS 的虚拟目录。
语法
New-WebServicesVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
详细说明
使用 New-WebServicesVirtualDirectory cmdlet，可以在 Exchange 2007 客户端访问服务器上新建一个名为 EWS 的虚拟目录。可以使用该 cmdlet 创建多个虚拟目录。
.gif "note") 注意： |
|---|
| 每个网站只能创建一个 EWS 虚拟目录。 |
若要运行 New-WebServicesVirtualDirectory cmdlet，必须为您使用的帐户委派 Exchange Server 管理员角色以及目标服务器的本地 Administrators 组成员身份。
有关管理 Exchange 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。
参数
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
ApplicationRoot |
可选 |
System.String |
此参数设置虚拟目录的元数据库路径。默认情况下，此路径与创建虚拟目录的网站相同。 |
AppPoolId |
可选 |
System.String |
此参数用于设置可用于虚拟目录的程序池。 |
BasicAuthentication |
可选 |
System.Boolean |
此参数指定是否对 EWS 虚拟目录启用基本身份验证。 |
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
Confirm 参数将导致命令暂停处理，并且需要您在继续处理之前确认该命令将执行的操作。您不必使用 Confirm 参数指定值。 |
DigestAuthentication |
可选 |
System.Boolean |
此参数（如果使用）指定对虚拟目录使用摘要式身份验证。 |
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
若要指定用于将此配置更改写入 Active Directory 目录服务的域控制器的完全限定的域名 (FQDN)，请在 cmdlet 中包含 DomainController 参数。 |
ExternalUrl |
可选 |
System.Uri |
此参数指定主机名，用于从外围网络连接到 Exchange 服务器。 |
InternalNLBBypassUrl |
可选 |
System.Uri |
此参数指定客户端访问服务器的 URL，无论它是否位于网络负载平衡 (NLB) 阵列后面。尽管 InternalUrl 参数将被设置为 NLB 的 URL，但是 InternalNLBBypassUrl 参数应该始终设置为客户端访问服务器的 URL。这是因为某些 Exchange Web 服务呼叫要求计算机关联，并且只要有可能，Exchange Web 服务就会将传入呼叫代理到更适合的客户端访问服务器。 |
InternalUrl |
可选 |
System.Uri |
此参数指定在从网络防火墙内部连接到虚拟目录时使用的 URL。 |
Path |
可选 |
System.String |
此参数用于在元数据库中设置虚拟目录的路径。 |
TemplateInstance |
可选 |
System.Management.Automation.PSObject |
将现有对象提供给此参数时，该命令将使用该对象的配置在本地服务器或目标服务器上创建对象的副本。 |
WebSiteName |
可选 |
System.String |
此参数指定要在其中新建虚拟目录的网站的名称。在默认网站中新建虚拟目录时，不应使用该参数。 |
WindowsAuthentication |
可选 |
System.Boolean |
使用此参数可以指定是否允许在新的 Exchange Web 服务虚拟目录上使用集成 Windows 身份验证。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
WhatIf 参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。您不必使用 WhatIf 参数指定值。 |
输入类型
返回类型
错误
| 错误 | 说明 |
|---|---|
|
|
异常
| 异常 | 说明 |
|---|---|
|
|
示例
此代码示例将新建名为“contoso”的虚拟目录，外部 URL 设置为“https://www.contoso.com/webservices.aspx”。
New-WebServicesVirtualDirectory -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/webservices.aspx"