Get-CsAutodiscoverConfiguration
上一次修改主题： 2012-04-23
返回有关组织中当前正在使用的自动发现配置设置的信息。自动发现服务为 Lync Web Access 或 Microsoft Lync Mobile 等客户端应用程序提供一种方法，用来查找用户的主池或用于加入电话拨入式会议的 URL 等关键资源。
语法
Get-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAutodiscoverConfiguration [-Filter <String>] [-LocalStore <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 作用域。Get-CsAutoDiscoverConfiguration cmdlet 提供了一种返回有关组织中当前正在使用的自动发现设置（和自动发现 URL）的信息的方法。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsAutoDiscoverConfiguration cmdlet：RTCUniversalServerAdmins。
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
XDS 标识 |
要检索的自动发现配置设置集合的唯一标识符。要检索全局设置，请使用以下语法： -Identity "global" 要检索在 site 作用域配置的设置，请使用类似如下的语法： -Identity "site:Redmond" 如果不包含此参数，则 Get-CsAutoDiscoverConfiguration 将返回组织中当前正在使用的所有自动发现配置设置。 |
Filter |
可选 |
字符串 |
使您可以在指定要返回的自动发现配置设置时使用通配符。例如，以下语法返回在 site 作用域配置的所有设置： -Filter "site:*" 请注意，不能在同一命令中同时使用 Identity 和 Filter 参数。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本中检索自动发现配置数据，而不是从中央管理存储自身中进行检索。 |
输入类型
Get-CsAutoDiscoverConfiguration 不接受通过管道传递的输入。
返回类型
Get-CsAutoDiscoverConfiguration 返回 Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsAutoDiscoverConfiguration
示例 1 中显示的命令返回组织中当前正在使用的所有自动发现配置设置。
-------------------------- 示例 2 --------------------------
Get-CsAutoDiscoverConfiguration -Identity "global"
在示例 2 中，仅返回一个自动发现配置设置集合：global 集合。
-------------------------- 示例 3 --------------------------
Get-CsAutoDiscoverConfiguration -Filter "site:*"
上述命令返回分配给 site 作用域的所有自动发现配置设置。为执行此操作，加入了 Filter 参数以及筛选器值“site:*”；此筛选器值确保仅返回 Identity 以字符串值“site:”开头的设置。根据定义，Identity 以“site:”开头的任何设置都是在 site 作用域配置的设置。
-------------------------- 示例 4 --------------------------
Get-CsAutoDiscoverConfiguration | Where-Object {$_.WebLinks -like "*fabrikam.com"}
示例 4 中显示的命令返回包括 fabrikam.com 的自动发现 URL 的所有自动发现配置设置。为执行此任务，该命令首先使用 Get-CsAutoDiscoverConfiguration 返回组织中当前正在使用的所有自动发现设置的集合。然后，将此集合通过管道传递给 Where-Object cmdlet，后者仅选择 WebLinks 属性包括字符串值“fabrikam.com”的那些设置