Remove-CsAddressBookConfiguration
上次修改主題的時間： 2012-03-26
移除指定的通訊錄組態設定集合。
語法
Remove-CsAddressBookConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Address Book Server 是 AD DS 與 Microsoft Lync Server 2010 之間的中介伺服器。Address Book Server 可確保儲存在 Lync Server 2010 的使用者資訊會與儲存在 AD DS 的使用者資訊同步。其作法是定期將 Address Book 檔案與使用者資料庫中儲存的資訊同步化。
此外，Address Book Server 會定期產生索引檔案，這些索引檔案可下載到執行 Lync 2010 的電腦上。當使用者搜尋連絡人時，通常會透過這些索引檔案來搜尋，或搜尋儲存在中央管理存放區中的 Address Book 索引檔案。
Address Book 伺服器使用 Address Book 組態設定進行管理，這些設定可決定 Address Book 檔案每隔多久會與使用者資料庫同步，以及每隔多久便會產生這些 Address Book 索引檔案等作業。當您在安裝 Lync Server 時，系統會為您建立一組通用 Address Book 設定。您也可以建立可套用到各個站台的自訂組態設定。這些設定 (如果存在的話) 會套用到在網站運作的任何 Address Book 伺服器，而且優先順序高於通用設定。
New-CsAddressBookConfiguration 指令程式可讓您建立站台層級的通訊錄組態設定。若要移除在站台範圍設定的通訊錄設定，請使用 Remove-CsAddressBookConfiguration 指令程式。請注意，您也可以針對通用設定執行 Remove-CsAddressBookConfiguration，不過無法真正移除通用設定。反之，針對通用設定執行 Remove-CsAddressBookConfiguration 會將所有通用屬性重設為預設值。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsAddressBookConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsAddressBookConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
XdsIdentity |
要移除之通訊錄組態設定集合的唯一識別碼。若要移除通用集合，請使用下列語法：-Identity global。(當您「移除」通用設定時，只需將所有內容重設回預設值)。若要移除站台集合，請使用類似下列的語法：-Identity site:Redmond。請注意，您在指定原則的 Identity 時，無法使用萬用字元。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings 物件。Remove-CsAddressBookConfiguration 接受通訊錄組態物件管線傳送的輸入。
傳回類型
Remove-CsAddressBookConfiguration 不會傳回值或物件。而是此指令程式會移除 Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Remove-CsAddressBookConfiguration -Identity site:Redmond
這個範例使用 Remove-CsAddressBookConfiguration 來刪除 Identity 為 site:Redmond 的通訊錄組態設定。使用 Identity 參數可確保系統只移除指定的通訊錄設定。
-------------------------- 範例 2 --------------------------
Get-CsAddressBookConfiguration -Filter site:* | Remove-CsAddressBookConfiguration
在範例 2 中，會移除在站台範圍設定的所有通訊錄設定集合。為達成此目的，Get-CsAddressBookConfiguration 指令程式可用來擷取已在站台範圍設定的所有通訊錄設定集合；這可藉由使用 Filter 參數和篩選值 "site:*" 來完成。然後將擷取的集合傳送到 Remove-CsAddressBookConfiguration 指令程式，這會移除集合中的所有項目。
-------------------------- 範例 3 --------------------------
Get-CsAddressBookConfiguration | Where-Object {$_.KeepDuration -lt 30.} | Remove-CsAddressBookConfiguration
上述命令會移除所有變更檔案之保留時間早於 30 天的通訊錄設定。為了執行此作業，會使用 Get-CsAddressBookConfiguration 以傳回目前用於組織之所有通訊錄設定的集合。接著將這個集合傳送到 Where-Object，這樣只會選取 KeepDuration 屬性早於 30 天的設定。(請注意這個語法中的 30. - 天數後方還帶有一個句號)。最後，將篩選過的集合傳送到 Remove-CsAddressBookConfiguration，這樣會刪除該集合中的每一個項目。