Set-CsUserReplicatorConfiguration
上次修改主題的時間： 2012-03-25
修改使用者複寫器組態設定的現有集合。使用者複寫器會定期從 Active Directory 網域服務 (AD DS) 擷取最新的使用者帳戶資訊，然後將新資訊與 Microsoft Lync Server 2010 所儲存的現行使用者資料同步。
語法
Set-CsUserReplicatorConfiguration [-Identity <XdsIdentity>] [-ADDomainNamingContextList <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-ReplicationCycleInterval <TimeSpan>] [-WhatIf [<SwitchParameter>]]
Set-CsUserReplicatorConfiguration [-ADDomainNamingContextList <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-ReplicationCycleInterval <TimeSpan>] [-WhatIf [<SwitchParameter>]]
詳細描述
雖然 Lync Server 2010 會維護它自己的使用者帳戶資料庫和使用者帳戶資料，但 Lync Server 2010 仍依賴 AD DS 作為使用者資訊的基本來源。例如，建立新的 Active Directory 使用者帳戶時，您必須提供關於使用者帳戶的基本資訊 (例如，Active Directory 顯示名稱)。不過，如果使用者已啟用 Lync Server，則無需指定新的顯示名稱。這是因為 Lync Server 會使用已經儲存於 AD DS 中的顯示名稱。
使用者帳戶資訊 (包括 Active Directory 顯示名稱) 會隨著時間的推移而變更。例如，結婚的使用者可能變更姓氏，於是也需要變更其顯示名稱。為了確保 Lync Server 資料庫和 AD DS 保持同步，Lync Server 必須定期檢查 AD DS、擷取最新的使用者帳戶更新，然後據以修改 Lync Server 使用者資料庫。這個介於 AD DS 和 Lync Server 之間的同步是由使用者複寫器來完成。
安裝 Lync Server 時，會為您建立使用者複寫器組態設定的通用集合。根據預設，這些設定會用來管理整個組織的 User Replicator。使用者複寫器的管理包含識別 Lync Server 必須同步的網域，以及指出使用者複寫器為使用者帳戶更新檢查 AD DS 的時間頻率。根據預設，User Replicator 會探索所有可用的網域並進行同步。不過，您可以使用 AdDomainNamingContextList 內容，將同步化限制為特定的一組網域：出現在 AdDomainNamingContextList 內容中的網域。
您也可以在服務範圍上建立其他集合，但僅限於使用 Microsoft Lync Online 2010。
Set-CsUserReplicatorConfiguration 指令程式可讓您修改目前用於組織的所有使用者複寫器設定。您可以使用這個指令程式，從使用者複寫器必須同步的網域清單中新增或移除網域，以及修改複寫循環之間的時間間隔。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsUserReplicatorConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回已指派此指令程式的所有 RBAC 角色清單 (包括您自行建立的任何自訂角色存取控制 (RBAC) 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUserReplicatorConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要修改之使用者複寫器組態設定的唯一識別碼。若要修改通用設定，請使用此語法：-Identity global。 |
Instance |
選用 |
UserReplicatorConfiguration 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
ADDomainNamingContextList |
選用 |
PS 清單修改程式 |
使用者複寫器必須同步之 Active Directory 網域的辨別名稱。例如，若要新增網域至清單，請使用如下語法： -ADDomainNamingContextList @{Add="dc=fabrikam,dc=com"} 如果您設定此屬性為 Null 值，則使用者複寫器會探索所有可用的網域並與其同步。如果此內容不為 Null，使用者複寫器將只會與 ADDomainNamingContextList 中指定的網域同步。 |
ReplicationCycleInterval |
選用 |
TimeSpan |
表示在 AD DS 中檢查使用者帳戶更新之前，使用者複寫器的等待時間。複寫循環間隔可以是 1 秒和 23 小時、59 分和 59 秒之間的任何時間值，預設值為 1 分鐘。間隔必須使用時:分:秒的格式表示。例如，此語法設定時間間隔為 1 小時 15 分： -ReplicationCycleInterval 01:15:00 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration 物件。Set-CsUserReplicatorConfiguration 接受使用者複寫器組態物件管線傳送的輸入。
傳回類型
Set-CsUserReplicatorConfiguration 不會傳回任何物件或值。而是指令程式修改 Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration 物件的通用執行個體 (僅這類執行個體)。
範例
-------------------------- 範例 1 ------------------------
Set-CsUserReplicatorConfiguration -Identity global -ReplicationCycleInterval "00:05:00"
下述命令設定通用使用者複寫器設定的 ReplicationCycleInterval 值為五分鐘 (00 小時:05分鐘：00 秒) 的 A/V Edge 組態設定。
-------------------------- 範例 2 ------------------------
Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList $Null
範例 2 所示的命令會清除 ADDomainNamingContextList 屬性的值。此工作透過包含 ADDomainNamingContextList 參數，並設定參數值為 Null 來完成。透過將此值設定為 Null，使用者複寫器將自動探索所有可用的網域並進行同步。
-------------------------- 範例 3 ------------------------
Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList @{Add="dc=fabrikam,dc=com"}
範例 3 將其他名稱新增至通用使用者複寫器設定的 ADDomainNamingContextList 屬性。為了執行這項作業，會使用語法 @{Add=}，以及新增網域的辨別名稱。執行這個命令之後，fabrikam.com 會新增至網域名稱的清單中。若要設定通用設定，讓清單上只有 fabrikam.com，請使用此語法：
-ADDomainNamingContextList @{Replace="dc=fabrikam,dc=com"}
當 AdDomainNamingContextList 內容已設定為 Null 值以外的任何值時，使用者複寫器將只會與內容值中所列的網域同步。即使部署中有其他網域，還是會維持此情況。
-------------------------- 範例 4 ------------------------
Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList @{Remove="dc=fabrikam,dc=com"}
範例 4 從通用使用者複寫器組態設定的 ADDomainNamingContextList 屬性中移除網域 fabrikam.com。為了執行這項作業，會使用語法 @{Remove=}，以及網域的辨別名稱 (DN) (dc=fabrikam,dc=com)。