New-CsAutodiscoverConfiguration

 

上一次修改主题: 2012-04-23

在 site 作用域创建新的自动发现配置设置集合。自动发现服务为 Lync Web Access 或 Microsoft Lync Mobile 等客户端应用程序提供一种方法,用来查找用户的主池或用于加入电话拨入式会议的 URL 等关键资源。

语法

New-CsAutodiscoverConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WebLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

详细说明

客户端应用程序要想充分利用 Microsoft Lync Server 2010,它们需要知道关键 Lync Server 2010 组件的位置。例如,经过身份验证的用户必须能够找到其主池;毕竟,他们只能通过此主池进行身份验证。同样,未经身份验证的用户也必须能够执行诸如找到用于加入会议的 URL 之类的操作。

如果您的所有用户都从组织的防火墙后面进行登录,那么发现这些位置会相对比较简单。但是,随着用户使用 Microsoft Lync Mobile 或 Lync Web Access 从外部位置访问系统,这个相对简单的任务就变得越来越复杂。

在拆分域情形中尤其如此,在这些情形中,组织的某些用户在 Lync Server 的内部部署版本中具有帐户,而其他用户在 Microsoft Office 365 中具有帐户。在这种情况下,用户帐户可能位于不同的 Active Directory 林中。这会带来一个问题:例如,如果一位美国用户从欧洲登录,系统必须能够识别其所在的林,然后将登录请求提交给适当的池。

为解决这些问题,Lync Server 的 2011 年 11 月版本中引入了自动发现服务。当客户端应用程序尝试访问 Lync Server 时,自动发现服务将分析客户端 SIP 地址,然后将该请求重定向至适当的池。客户端应用程序通过向自动发现 URL 发送 HTTP 请求来连接到自动发现服务;管理员必须配置这些 URL,自动发现服务才能运行。(请注意,除了配置 URL 外,管理员还必须创建与这些 URL 对应的 DNS 记录。)

自动发现 URL 将分配给自动发现配置设置;随后,这些设置可应用于 global 作用域或 site 作用域。当您安装 Lync Server 时,系统将为您创建一个全局设置集合。(不过,不会为该集合分配自动发现 URL。)如果单个自动发现设置集合无法满足您的需要,您可以使用 New-CsAutoDiscoverConfiguration cmdlet 在 site 作用域创建其他配置设置。

谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 New-CsAutoDiscoverConfiguration cmdlet:RTCUniversalServerAdmins。

参数

参数 必需 类型 描述

Identity

必需

XDS 标识

要修改的自动发现配置设置集合的唯一标识符。要创建在 site 作用域配置的集合,请使用类似如下的语法:

-Identity "site:Redmond"

WebLinks

可选

PS 列表修饰符

自动发现 URL 的集合。必须使用 New-CsWebLink cmdlet 创建这些 URL。

InMemory

可选

开关参数

创建对象引用,但并不作为永久性更改实际提交对象。如果将使用此参数调用的命令的输出分配给某变量,则可以更改对象引用的属性,然后通过调用 Set-CsAutoDiscoverConfiguration cmdlet 提交这些更改。

Force

可选

开关参数

禁止显示运行此命令时可能出现的任何非严重错误消息。

输入类型

New-CsAutoDiscoverConfiguration 不接受通过管道传递的输入。

返回类型

创建 Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration 对象的新实例。

示例

-------------------------- 示例 1 --------------------------

New-CsAutoDiscoverConfiguration -Identity "site:Redmond"

示例 1 中显示的命令为 Redmond 站点创建一个新的自动发现配置设置集合。因为未加入 WebLinks 参数,所以这些设置将不包含任何自动发现 URL。

-------------------------- 示例 2 --------------------------

$Link1 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscover.fabrikam.com"
$Link2 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscoverInternal.fabrikam.com"

New-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1,$Link2}

上述命令为 Redmond 站点创建一个新的自动发现配置设置集合,并为这些新设置分配一对自动发现 URL:http://LyncDisocver.fabrikam.com 和 http://LyncDiscoverInternal.fabrikam.com。为执行此任务,前两个命令使用 New-CsWebLink cmdlet 创建两个自动发现 URL;然后将新创建的 URL 存储在名为 $Link1 和 $Link2 的变量中。在创建两个 URL 之后,第三个命令使用 New-CsAutoDiscoverConfiguration 创建新的自动发现配置设置。为了将这两个 URL 分配给这些设置,加入了 WebLinks 参数以及参数值 @{Add=$Link1,$Link2}。此语法将使存储在变量 $Link1 和 $Link2 中的值添加到 WebLinks 属性中。