Set-CsAutodiscoverConfiguration
上一次修改主题： 2012-04-23
修改现有的自动发现配置设置集合。自动发现服务为 Lync Web Access 或 Microsoft Lync Mobile 等客户端应用程序提供一种方法，用来查找用户的主池或用于加入电话拨入式会议的 URL 等关键资源。
语法
Set-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WebLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsAutodiscoverConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 作用域创建其他配置设置。接下来，您可以使用 Set-CsAutoDiscoverConfiguration cmdlet 在全局集合或任何 site 作用域集合中添加或删除自动发现 URL。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsAutoDiscoverConfiguration cmdlet：RTCUniversalServerAdmins。
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
XDS 标识 |
要修改的自动发现配置设置集合的唯一标识符。要修改全局设置，请使用以下语法： -Identity "global" 要修改在 site 作用域配置的集合，请使用类似如下的语法： -Identity "site:Redmond" 如果未指定此参数，则 Set-CsAutoDiscoverConfiguration 将自动修改全局设置。 |
Instance |
可选 |
AutoDiscoverConfiguration 对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
WebLinks |
可选 |
PS 列表修饰符 |
自动发现 URL 的集合。必须使用 New-CsWebLink cmdlet 创建这些 URL。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
输入类型
Set-CsAutoDiscoverConfiguration 接受通过管道传递的 Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration 对象的输入。
返回类型
无。Set-CsAutoDiscoverConfiguration 会修改 Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration 对象的实例。
示例
-------------------------- 示例 1 --------------------------
$Link1 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscover.fabrikam.com"
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1}
示例 1 中显示的命令向分配给 Redmond 站点的自动发现配置设置添加一个新的自动发现 URL (http://LyncDiscover.fabrikam.com) 。为执行此操作，示例中的第一个命令使用 New-CsWebLink cmdlet 创建一个新自动发现 URL；此 URL 将存储在名为 $Link1 的变量中。第二个命令使用 Set-CsAutoDiscoverConfiguration 将新 URL 添加到已分配给这些设置的所有 URL 中。这一点是通过使用 WebLinks 参数和参数值 @{Add=$Link1} 实现的。
-------------------------- 示例 2 --------------------------
$Link1 = Get-CsAutoDiscoverConfiguration -Identity "site:Redmond" | Select-Object -ExpandProperty WebLinks | Where-Object {$_.Token -eq "Fabrikam"}
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Remove=$Link1}
上述命令演示了如何从自动发现配置设置集合中删除 URL。为执行此操作，集合中的第一个命令将检索要删除的 URL（Token 等于“Fabrikam”的 URL）的对象引用。这是通过以下方式实现的：首先调用 Get-CsAutoDiscoverConfiguration cmdlet 以检索 Redmond 站点的自动发现设置，然后将此集合通过管道传递给 Select-Object cmdlet，后者使用 ExpandProperty 参数来“展开”WebLinks 属性。（展开某个属性时，将提供对该属性中存储的单个对象的 Get-CsAutoDiscoverConfiguration 访问。）随后，这些 WebLinks 对象将通过管道传递给 Where-Object cmdlet，后者将选择一个 Token 属性等于“Fabrikam”的对象。然后将该 WebLinks 对象存储在名为 $Link1 的变量中。
此后，示例中的第二个命令使用 Set-CsAutoDiscoverConfiguration 删除存储在 $Link1 中的对象。为执行此操作，该命令将使用 WebLinks 参数和参数值 @{Remove=$Link1}。
-------------------------- 示例 3 --------------------------
$Link2 = New-CsWebLink -Token "Contoso" -Href "http://LyncDiscover.contoso.com"
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Replace=$Link2}
示例 3 演示了如何用单个 URL（本例中）替换现有的自动发现 URL 集合。为完成此任务，示例中的第一个命令使用 New-CsWebLink cmdlet 创建一个新的自动发现 URL (http://LyncDiscover.contoso.com)；生成的 URL 存储在名为 $Link2 的变量中。然后，第二个命令将使用 Set-CsAutoDiscoverConfiguration 和 WebLinks 参数删除之前分配给 Redmond 站点的所有 URL，并用 URL http://LyncDiscover.contoso.com 取代它们。为执行此操作，该命令将使用 Replace 方法而非 Add 或 Remove 方法。
-------------------------- 示例 4 --------------------------
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks $Null
示例 4 中显示的命令删除已分配给 Redmond 站点的所有自动发现 URL。为执行此操作，该命令将 WebLinks 属性设为空值；这将删除以前分配给此属性的所有 URL。