Get-CsAddressBookConfiguration
上次修改主題的時間： 2012-03-23
傳回 Address Book 組態設定的相關資訊。
語法
Get-CsAddressBookConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAddressBookConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
Address Book 伺服器是 Active Directory 網域服務 (AD DS) 與 Microsoft Lync Server 2010 之間的媒介。Address Book 伺服器可確保儲存在 Lync Server 2010 的使用者資訊會與儲存在 Active Directory 的使用者資訊同步。其作法是定期將 Address Book 檔案與使用者資料庫中儲存的資訊同步化。
此外，Address Book Server 會定期產生索引檔案，這些索引檔案可下載到執行 Lync 2010 的電腦上。當使用者搜尋連絡人時，通常會透過這些索引檔案來搜尋，或搜尋儲存在中央管理存放區中的 Address Book 索引檔案。
Address Book 伺服器使用 Address Book 組態設定進行管理，這些設定可決定 Address Book 檔案每隔多久會與使用者資料庫同步，以及每隔多久便會產生這些 Address Book 索引檔案等作業。當您在安裝 Lync Server 2010 時，系統會為您建立一組通用 Address Book 設定。您也可以建立可套用到各個網站的自訂組態設定。這些設定 (如其存在) 會套用到在網站運作的任何 Address Book 伺服器，而且優先順序高於通用設定。
您可以使用 Get-CsAddressBookConfiguration 指令程式傳回您目前用於組織的任何 (或所有) Address Book 設定相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsAddressBookConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有已接受此指令程式指派的角色型存取控制 (RBAC) 角色清單 (包括任何由您自行建立的 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAddressBookConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsIdentity |
要傳回之通訊錄設定集合的唯一識別碼。若要參照通用設定，請使用此語法：-Identity global。若要參照在此網站範圍設定的集合，請使用如下語法：-Identity site:Redmond。 請注意，在指定 Identity 時無法使用萬用字元。如果您必須使用萬用字元，請改為包含 Filter 參數。 如果未指定此參數，則 Get-CsAddressBookConfiguration 會傳回目前用於組織的所有通訊錄設定集合。 |
Filter |
選用 |
字串 |
可讓您使用萬用字元傳回 Address Book 設定的一或多個集合。例如，若要傳回在此網站範圍所設定之所有設定集合，請使用此語法：-Filter site:*。若要傳回在 Identity 中任何位置出現字串值 "EMEA" 的所有設定集合，請使用以下語法：-Filter *EMEA*。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區本機複本擷取 Address Book 組態資料，而不是從中央管理存放區本身擷取。 |
輸入類型
無。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:*" 傳回已在網站範圍設定的所有通訊錄組態設定相關資訊。提供的篩選值會傳回 Identity 開頭為字串值 "site:" 的所有 Address Book 設定資訊。
-------------------------- 範例 4 --------------------------
Get-CsAddressBookConfiguration | Where-Object {$_.UseNormalizationRules -eq $True}
範例 4 會傳回已設定為使用正規化規則剖析電話號碼的所有 Address Book 組態設定資訊。為了執行這項工作，命令先使用 Get-CsAddressBookConfiguration 傳回組織中所有 Address Book 設定的集合。該集合便會被傳送到 Where-Object 指令程式，這樣只會選取 UseNormalizationRules 屬性等於 True 的設定。