Set-WebServicesVirtualDirectory (RTM)
适用于： Exchange Server 2007
上一次修改主题： 2007-06-11
使用 Set-WebServicesVirtualDirectory cmdlet，可以修改安装了客户端访问服务器角色的 Exchange 2007 计算机上的现有 Exchange Web 服务虚拟目录。
语法
Set-WebServicesVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Url>] [-InternalUrl <Url>] [-WindowsAuthentication <$true | $false>]
详细说明
使用 Set-WebServicesVirtualDirectory cmdlet，可以修改 Exchange 2007 客户端访问服务器上的现有 Exchange Web 服务虚拟目录。
.gif "note") 注意： |
|---|
| 如果拥有客户端访问服务器的负载平衡集，则无需在运行 cmdlet 时指定每个服务器的名称。只需使用联网的负载平衡服务器中的一个服务器名称就足够了。 |
若要运行 Set-WebServicesVirtualDirectory cmdlet，必须为您使用的帐户委派以下角色：
- Exchange Server 管理员角色和目标服务器的本地 Administrators 组
有关管理 Microsoft Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。
参数
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
Identity |
必需 |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
此参数指定虚拟目录的名称。还可以指定一个通配符代替默认网站。 |
BasicAuthentication |
可选 |
System.Boolean |
此参数指定是否对 Exchange Web 服务虚拟目录启用了基本身份验证。此参数可以与 FormsAuthentication，或与 DigestAuthentication 和 WindowsAuthentication 一起使用。 |
DigestAuthentication |
可选 |
System.Boolean |
此参数指定是否对虚拟目录启用了摘要式身份验证。 |
DomainController |
可选 |
System.String |
若要指定从 Active Directory 目录服务检索数据的域控制器的完全限定的域名 (FQDN)，请在 cmdlet 中包含 DomainController 参数。 |
ExternalUrl |
可选 |
System.Uri |
此参数指定将用于连接到防火墙外部的 Exchange 服务器的主机名。如果使用安全套接字层 (SSL)，则此设置也很重要。 |
Instance |
可选 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ADWebServicesVirtualDirectory |
使用 Instance 参数可以将整个对象传递给将要处理的 cmdlet。 |
InternalUrl |
可选 |
System.Uri |
此参数指定从防火墙内进行连接的 Exchange 服务器的主机名。如果使用 SSL，则此设置也很重要。 |
WindowsAuthentication |
可选 |
System.Boolean |
此参数用于指定是否允许对 Exchange Web 服务虚拟目录进行 Windows 集成身份验证。 |
输入类型
返回类型
错误
| 错误 | 说明 |
|---|---|
|
|
异常
| 异常 | 说明 |
|---|---|
|
|
示例
以下代码示例将此身份验证方法设置为名为“Contoso”的服务器上名为“EWS”的虚拟目录的基本身份验证。此代码示例还设置了此虚拟目录的外部 URL 和内部 URL。
第二个代码示例使用通配符代替“默认网站”。
Set-WebServicesVirtualDirectory -Identity Contoso\EWS(default web site)-ExternalUrl https://www.contoso.com/EWS/exchange.aspx -ExternalAuthenticationMethods Basic -InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.aspx