Get-CsAddressBookConfiguration
上一次修改主题： 2012-03-23
返回有关通讯簿配置设置的信息。
语法
Get-CsAddressBookConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAddressBookConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
通讯簿服务器是 Active Directory 域服务 (AD DS) 与 Microsoft Lync Server 2010 之间的中介。通讯簿服务器可确保 Lync Server 2010 中存储的用户信息与 Active Directory 中存储的用户信息同步。这是通过定期将通讯簿文件与用户数据库中存储的信息同步来实现的。
此外，通讯簿服务器可定期生成索引文件，这些文件会下载到运行 Lync 2010 的计算机中。当用户搜索联系人时，将在这些索引文件中搜索，或者在中央管理存储中存储的通讯簿索引文件内搜索。
通讯簿服务器使用通讯簿配置设置进行管理；这些设置可确定通讯簿文件与用户数据库的同步频率，以及这些通讯簿索引文件的生成频率等内容。安装 Lync Server 2010 时，会自动为您创建一组全局通讯簿设置。您也可以创建能够应用于各个站点的自定义配置设置。这些设置（如果存在）应用于站点中运行的任何通讯簿服务器，并且优先于全局设置。
可以使用 Get-CsAddressBookConfiguration cmdlet 返回有关组织中当前使用的任何（或所有）通讯簿设置的信息。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsAddressBookConfiguration cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAddressBookConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要返回的通讯簿设置集合的唯一标识符。要引用全局设置，请使用以下语法：-Identity global。要引用在 site 作用域配置的集合，请使用以下类似语法：-Identity site:Redmond。 请注意，在指定 Identity 时不能使用通配符。如果需要使用通配符，请改用 Filter 参数。 如果未指定此参数，则 Get-CsAddressBookConfiguration 将返回组织中使用的所有通讯簿设置的集合。 |
Filter |
可选 |
字符串 |
使您可以使用通配符，以便返回一个或多个通讯簿设置集合。例如，要返回在 site 作用域配置的所有设置的集合，请使用以下语法：-Filter site:*。要返回在 Identity 中包含字符串值“EMEA”的所有设置的集合，请使用以下语法：-Filter *EMEA*。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而不是从中央管理存储本身检索通讯簿配置数据。 |
输入类型
无。Get-CsAddressBookConfiguration 不接受通过管道传递的输入。
返回类型
Get-CsAddressBookConfiguration 返回 Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsAddressBookConfiguration
上述示例返回有关组织中使用的所有通讯簿配置设置的信息。如果您调用不带任何其他参数的 Get-CsAddressBookConfiguration，则这是默认行为。
-------------------------- 示例 2 --------------------------
Get-CsAddressBookConfiguration -Identity site:Redmond
示例 2 返回有关 Identity 为 site:Redmond 的通讯簿配置设置的信息。
-------------------------- 示例 3 --------------------------
Get-CsAddressBookConfiguration -Filter site:*
在上述示例中，使用 Filter 参数及筛选器值“site:*”以返回有关已在 site 作用域应用的所有通讯簿配置设置的信息。提供的筛选器值返回 Identity 以字符串值“site:”开头的所有通讯簿设置的信息。
-------------------------- 示例 4 --------------------------
Get-CsAddressBookConfiguration | Where-Object {$_.UseNormalizationRules -eq $True}
在示例 4 中，将返回所有通讯簿配置设置（其中，这些设置使用规范化规则来解析电话号码）的信息。为此，该命令首先使用 Get-CsAddressBookConfiguration 返回组织中所有通讯簿设置的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会仅选择 UseNormalizationRules 属性等于 True 的设置。