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