Set-UMVirtualDirectory
适用于: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题: 2008-11-10
使用 Set-UMVirtualDirectory cmdlet,可以在安装了客户端访问服务器角色的计算机上修改现有的 Exchange 统一消息虚拟目录。
语法
Set-UMVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Set-UMVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADUMVirtualDirectory>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
详细说明
通过 Set-UMVirtualDirectory cmdlet,可以在 Exchange 2007 客户端访问服务器上修改现有的 Exchange Web 服务虚拟目录。
要运行 Set-UMVirtualDirectory cmdlet,必须为您使用的帐户委派 Exchange Server 管理员角色以及目标服务器的本地 Administrators 组成员身份。
有关管理 Exchange 2007 所需的权限、角色委派以及权利的详细信息,请参阅权限注意事项。
参数
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
Identity |
必需 |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
此参数指定虚拟目录的名称。还可以指定一个通配符代替默认网站。 |
BasicAuthentication |
可选 |
System.Boolean |
此参数指定是否对 Exchange Web 服务虚拟目录启用了基本身份验证。此参数可以与 FormsAuthentication 一起使用,或与 DigestAuthentication 和 WindowsAuthentication 一起使用。 |
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
此参数将导致命令暂停处理。管理员在处理继续之前必须确认该命令将执行的操作。默认值为 |
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 身份验证。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
此参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数,管理员可以查看要发生的更改,而不必应用任何这些更改。默认值为 |
输入类型
返回类型
错误
错误 | 说明 |
---|---|
|
|
异常
异常 | 说明 |
---|---|
|
|
示例
第一个代码示例将 UMserver1 服务器上名为 UnifiedMessaging 的虚拟目录的身份验证方法设置为摘要式身份验证。此代码示例还设置了此虚拟目录的外部 URL 和内部 URL。
第二个代码示例使用通配符代替“默认网站”。
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