Set-CsAddressBookConfiguration
上次修改主題的時間： 2012-03-25
修改現有的「通訊錄」組態設定集合。
語法
Set-CsAddressBookConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-KeepDuration <UInt32>] [-MaxDeltaFileSizePercentage <UInt32>] [-RunTimeOfDay <DateTime>] [-SynchronizePollingInterval <TimeSpan>] [-UseNormalizationRules <$true | $false>] [-WhatIf [<SwitchParameter>]]
Set-CsAddressBookConfiguration [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-Instance <PSObject>] [-KeepDuration <UInt32>] [-MaxDeltaFileSizePercentage <UInt32>] [-RunTimeOfDay <DateTime>] [-SynchronizePollingInterval <TimeSpan>] [-UseNormalizationRules <$true | $false>] [-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 Server 使用 Address Book 組態設定進行管理，這些設定可決定 Address Book 檔案每隔多久會與使用者資料庫同步，以及每隔多久便會產生這些 Address Book 索引檔案等作業。安裝 Lync Server 時，系統會為您建立一組通用的通訊錄設定。您也可以建立能夠套用到個別網站的自訂組態設定。這些設定 (如果存在的話) 會套用到在網站運作的任何 Address Book Server，而且優先順序高於通用設定。
Set-CsAddressBookConfiguration 指令程式讓您可以修改您的組織中目前使用的任何「通訊錄」組態設定集合。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsAddressBookConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAddressBookConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsIdentity |
指派給通訊錄設定集合的唯一識別碼。若要參考通用設定，請使用此語法：-Identity global。若要參照在此網站範圍設定的集合，請使用如下語法：-Identity site:Redmond。指定 Identity 時，您無法使用萬用字元。 如果省略這個參數，Set-CsAddressBookConfiguration 便會修改通用設定。 |
Instance |
必要 |
AddressBookSettings 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
EnableFileGeneration |
選用 |
切換參數 |
設為 True (預設值) 時，Address Book Server 會產生用戶端可以下載的 Address Book 索引檔案。設為 False 時，不會產生這些索引檔案。這表示用戶端應用程式在搜尋連絡人時，必須使用通訊錄 Web 查詢服務。 |
IgnoreGenericRules |
選用 |
布林值 |
表示 Address Book Server 是否會忽略剖析電話號碼時所使用的一般正規化規則。一般規則就是 Lync Server 2010 內建的規則。這些規則不能變更；但是，藉由將此屬性的值設為 True，即可指示您的 Address Book Server 忽略這些規則，而是使用您自己建立的自訂規則。預設值為 False。 |
KeepDuration |
選用 |
TimeSpan |
指定 Address Book Server 將保留變更檔案的時間長度 (天數)。早於 KeepDuration 屬性值的變更檔案將被刪除。KeepDuration 可以設為 1 和 90 (含) 之間的任何整數值。預設值是 30 天。 |
MaxDeltaFileSizePercentage |
選用 |
整數 |
變更 Active Directory (例如，針對 Lync Server 啟用的新使用者) 時，Address Book Server 通常會在「Delta 檔案」中記錄這些變更，這個檔案僅包含更新的資訊；接著，Lync 2010 可以下載 Delta 檔案，而不是完整的通訊錄檔案。MaxDeltaFileSizePercentage 屬性會決定 Delta 檔案在併入完整的通訊錄檔案之前，可以取得的大小。根據預設，在產生新的通訊錄檔案之前，Delta 檔案的大小可以是完整通訊錄檔案的 20%。到時候 Lync 用戶端將會下載完整檔案而不是 Delta 檔案。 MaxDeltaFileSizePercentage 必須輸入介於 1 和 100 (含) 之間的值來表示百分比。 |
RunTimeOfDay |
選用 |
DateTime |
表示一天中伺服器產生新通訊錄檔案的時間。RunTimeOfDay 屬性使用 24 小時制的時間 (hours:minutes:seconds)，00:00:00 代表午夜，23:59:00 代表 11:59 PM。 預設值是 01:30:00 (1:30 A.M.)。 |
SynchronizePollingInterval |
選用 |
TimeSpan |
表示 Address Book Server 將其資訊與使用者資料庫中儲存之資訊進行同步的頻率。SynchronizePollingInterval 可設為介於 5 秒 (00:00:05) 到 3 小時 (03:00:00) 之間的任何值。預設值為 5 分鐘 (00:05:00)。 |
UseNormalizationRules |
選用 |
布林值 |
表示擷取電話號碼時，Address Book Server 是否應該使用電話的正規化規則。如果設為 False，將擷取電話號碼原本的格式，交由用戶端應用程式決定在顯示這些號碼時是否要套用正規化規則。 預設值為 True。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings 物件。Set-CsAddressBookConfiguration 接受通訊錄組態物件管線傳送的輸入。
傳回類型
Set-CsAddressBookConfiguration 不會傳回值或物件。而是此指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsAddressBookConfiguration -identity site:Redmond -RunTimeOfDay 23:00
RunTimeOfDay 屬性決定「通訊錄」的同步處理在一天中的什麼時候發生，此範例將此屬性設定為 23:00 (11:00 PM 以 24 小時制表示)。使用 Identity 參數，限制變更 Identity 為 site:Redmond 的「通訊錄」組態設定。
-------------------------- 範例 2 --------------------------
Get-CsAddressBookConfiguration -Filter site:* | Set-CsAddressBookConfiguration -RunTimeOfDay 23:00
在範例 2 中，將已在網站範圍設定的所有「通訊錄」設定集合的 RunTimeOfDay 屬性設為 11:00 PM (23:00)。為達成此目的，此命令會先使用 Get-CsAddressBookConfiguration 搭配 Filter 參數，以傳回所有網站特定設定的集合；篩選值 "site:*" 會將傳回的資料限制為已在網站範圍設定的集合。接著將此資訊傳送給 Set-CsAddressBookConfiguration，由其修改集合中每一個 RunTimeOfDay 屬性的值。
-------------------------- 範例 3 --------------------------
Get-CsAddressBookConfiguration | Where-Object {$_.KeepDuration -lt 30} | Set-CsAddressBookConfiguration -KeepDuration 30
前面的命令將任何 KeepDuration 早於 30 天的「通訊錄」設定集合中的 KeepDuration 屬性加以修改。為了執行此作業，會使用 Get-CsAddressBookConfiguration 且不用任何參數，傳回所有針對組織使用而設定的「通訊錄」設定的集合。接著將此集合傳送給 Where-Object 指令程式，這樣只會選取 KeepDuration 屬性小於 30 天的設定。然後將篩選過的集合傳送給 Set-CsAddressBookConfiguration，由其將集合中每一個項目的 KeepDuration 屬性的值變更為 30 天。