New-CsAddressBookConfiguration
上次修改主題的時間： 2012-03-23
建立新的 Address Book 組態設定集合。
語法
New-CsAddressBookConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-InMemory <SwitchParameter>] [-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，而且優先順序高於通用設定。
網站層級的設定是使用 New-CsAddressBookConfiguration 指令程式所建立。您只能建立網站範圍的設定；如果嘗試在其他範圍建立新設定 (包括在全域範圍)，則命令會失敗。如果上述網站已經包含通訊錄設定集合，您的命令也會失敗。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsAddressBookConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsAddressBookConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別 |
要指派給新的 Address Book 設定集合的唯一識別碼。由於您只能在網站範圍建立新集合，因此，Identity 一律是首碼 "site:"，後面緊接著網站名稱，例如 "site:Redmond"。 |
EnableFileGeneration |
選用 |
切換參數 |
設為 True (預設值) 時，Address Book Server 會產生用戶端可以下載的 Address Book 索引檔案。設為 False 時，不會產生這些索引檔案。這表示用戶端應用程式在搜尋連絡人時，必須使用通訊錄 Web 查詢服務。 |
IgnoreGenericRules |
選用 |
布林值 |
表示 Address Book Server 是否會忽略剖析電話號碼時所使用的一般正規化規則。一般規則就是 Lync Server 2010 內建的規則。這些規則不能變更；但是，藉由將此屬性的值設為 True，即可指示您的 Address Book Server 忽略這些規則，而是使用您自己建立的自訂規則。預設值為 False。 |
KeepDuration |
選用 |
整數 |
指定 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 |
選用 |
日期時間 |
表示一天中伺服器產生新通訊錄檔案的時間。RunTimeOfDay 屬性使用 24 小時制的時間 (hours:minutes:seconds)，00:00:00 代表午夜，23:59:00 代表 11:59 PM。 預設值是 01:30:00 (1:30 A.M.)。 |
SynchronizePollingInterval |
選用 |
時間範圍 |
表示 Address Book Server 將其資訊與使用者資料庫中儲存之資訊進行同步的頻率。SynchronizePollingInterval 可設為介於 5 秒 (00:00:05) 到 3 小時 (03:00:00) 之間的任何值。預設值為 5 分鐘 (00:05:00)。 |
UseNormalizationRules |
選用 |
布林值 |
表示擷取電話號碼時，Address Book Server 是否應該使用電話的正規化規則。如果設為 False，將擷取電話號碼原本的格式，交由用戶端應用程式決定在顯示這些號碼時是否要套用正規化規則。 預設值為 True。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsAddressBookConfiguration 不接受管線傳送的輸入。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
New-CsAddressBookConfiguration -Identity site:Redmond -KeepDuration 15 -SynchronizePollingInterval 00:10:00
以上範例會建立 Identity 為 site:Redmond 的新 Address Book Server 設定集合。若要建立新集合，您必須呼叫 New-CsAddressBookConfiguration 指令程式，並搭配 Identity 參數和其他任何選用的參數 (例如 KeepDuration 和 SynchronizePollingInterval 參數)。
-------------------------- 範例 2 --------------------------
$x = Get-CsAddressBookConfiguration -Identity site:Redmond
New-CsAddressBookConfiguration -Identity site:Paris -KeepDuration $x.KeepDuration -SynchronizePollingInterval $x.SynchronizePollingInterval
範例 2 會針對 Paris 網站建立新的通訊錄設定集合；這個新集合會使用從通訊錄設定 (針對 Redmond 套件所設定) 複製的兩個值 (KeepDuration 和 SynchronizePollingInterval)。為了執行此作業，第一個命令會使用 Get-CsAddressBookConfiguration 以傳回針對 Redmond 網站設定之所有通訊錄設定的集合；此資訊會儲存在名稱為 $x 的變數。
接著，第二個命令會使用 New-CsAddressBookConfiguration 建立 Paris 網站的通訊錄設定。這個命令包含兩個選用的參數 (KeepDuration 和 SynchronizePollingInterval)，其中包括從 site:Redmond 複製的值。例如，KeepDuration 會使用參數值 $x.KeepDuration；該參數值代表從 Redmond 網站複製的 KeepDuration 資訊。
-------------------------- 範例 3 --------------------------
$x = New-CsAddressBookConfiguration -Identity site:Redmond -InMemory
$x.KeepDuration = 15
$x.SynchronizePollingInterval = "00:10:00"
Set-CsAddressBookConfiguration -Instance $x
範例 3 會示範如何使用 InMemory 參數建立通訊錄設定集合的僅記憶體中執行個體、修改記憶體中的這些設定，然後使用 Set-CsAddressBookConfiguration 建立 Identity 為 site:Redmond 的實際集合。為完成以上所有工作，第一個命令會建立通訊錄設定組態的新僅記憶體中執行個體，並將該執行個體以名稱為 $x 的變數儲存。InMemory 參數會確保這些 Address Book 設定僅存在於記憶體中；如果您要終止 Windows PowerShell 工作階段，或刪除變數 $x，這些設定將會消失，因此絕不會套用到 Redmond 網站。
在命令 2 和 3 中，會修改這個虛擬 Address Book 設定的兩個屬性：命令 2 會將 KeepDuration 屬性的值設為 15 天，而命令 3 會將 SynchronizePollingInterval 設為 10 分鐘 (00:10:00)。接著，第四個和最後一個命令會使用 Set-CsAddressBookConfiguration 與 Instance 參數，將虛擬通訊錄設定轉換為在 Redmond 網站設定的實際設定集合。