Start-SPProfileServiceIncrementalReplication

 

適用版本:SharePoint Server 2013

上次修改主題的時間:2016-12-16

使用「複寫引擎」Windows 服務,將選取的設定檔屬性之變更從來源 User Profile Service 應用程式複寫至目的地 User Profile Service 應用程式。

Start-SPProfileServiceIncrementalReplication -Destination <String[]> -Source <String> [-ActiveDirectoryDomains <String[]>] [-Credential <PSCredential>] [-DoSocialReplication <SwitchParameter>] [-EnableInstrumentation <SwitchParameter>] [-FeedProperties <String[]>] [-MaxNumberOfThreads <Int32>] [-NumberOfRetry <Int32>] [-Properties <String[]>] [-ReplicationInterval <Int32>] [-Timeout <Int32>] [-WaitTimeBetweenFailures <Int32>]

Start-SPProfileServiceIncrementalReplication Cmdlet 會針對選取的使用者設定檔屬性,將使用者設定檔資訊及社交資料 (包括社交標記、記事及評等) 的變更,從來源 User Profile Service 應用程式複寫至目的地 User Profile Service 應用程式。第一次執行此 Cmdlet 時,您必須為「使用者設定檔複寫引擎」Windows 服務提供認證。這些認證可以使用 Get-credentials Cmdlet 擷取而得。啟動執行後,您可以檢視檢測記錄,查看是否有任何變更。

如果因故需要停止設定檔累加複寫,請使用 Stop-SPProfileServiceIncrementalReplication Cmdlet。請勿使用 Windows MMC 嵌入式管理單元,以手動啟動或停止「使用者設定檔服務複寫引擎」Windows 服務的方式,來啟動或停止設定檔累加複寫。

您必須先在管理中心的 [User Profile Service 管理] 網頁中設定信任的「我的網站」主機位置。如需如何設定信任的「我的網站」主機位置其他資訊,請參閱<Add or delete a trusted My Site host location (SharePoint Server 2010)>。

 

參數 必要 類型 描述

Destination

必要

System.String[]

指定複寫使用者設定檔的目的地「我的網站」主機 URL,例如 http://euro.contoso.com:8081/my。

Source

必要

System.String

指定擷取使用者設定檔的來源「我的網站」主機 URL,例如 http://hq.contoso.com:8081/my。

ActiveDirectoryDomains

選用

System.String[]

指定要複寫的 Active Directory 網域服務 (AD DS) 帳戶,例如 "headquarters" 或 "Europe"。預設值會傳回所有 AD DS 網域。

Credential

選用

System.Management.Automation.PSCredential

指定第一次執行此 Cmdlet 時的「使用者設定檔複寫引擎」Windows 服務認證,或想要隨時變更「複寫引擎」服務認證。若要取得「使用者設定檔複寫引擎」Windows 服務認證,請使用 Get-Credential Cmdlet。如需詳細資訊,請參閱 Get-Credential (https://go.microsoft.com/fwlink/p/?LinkID=113311)。

DoSocialReplication

選用

System.Management.Automation.SwitchParameter

啟用複寫社交標記、記事及評等。只有當來源 User Profile Service 應用程式與目的地 User Profile Service 應用程式都是以 SharePoint Server 2013 為基礎時,才能使用此參數。

EnableInstrumentation

選用

System.Management.Automation.SwitchParameter

使用檢測記錄以啟用詳細記錄功能。

FeedProperties

選用

System.String[]

指定當複寫指定之使用者設定檔屬性的變更時,應忽略信任的「我的網站」主機位置清單。

MaxNumberOfThreads

選用

System.Int32

指定執行「使用者設定檔複寫引擎」的伺服器上允許的複寫執行緒數上限。值的範圍介於 1 到 100 之間。預設值是 25。正在執行的實際執行緒數目將由「使用者設定檔複寫引擎」動態判定。

NumberOfRetry

選用

System.Int32

指定在發生失敗 (例如,網路中斷連線) 的情況下,「使用者設定檔複寫引擎」應嘗試重新啟動的次數。預設值為 3。

Properties

選用

System.String[]

指定要複寫的使用者設定檔屬性,例如,"FirstName" 或 "AboutMe"。您也可以使用 Get-SPProfilePropertyCollection Cmdlet 傳回所有使用者設定檔屬性的集合。預設值會傳回所有使用者設定檔屬性。

ReplicationInterval

選用

System.Int32

指定每次重複執行複寫之間相隔的時間 (以秒為單位)。預設值為 5。

Timeout

選用

System.Int32

指定「使用者設定檔複寫引擎」在逾時前應等待 Web 服務傳回回應的時間。預設值為 Web 服務逾時時間。

WaitTimeBetweenFailures

選用

System.Int32

指定「使用者設定檔複寫引擎」複寫使用者設定檔失敗後,在<Start-SPProfileServiceRecoveryReplication>程序開始之前應等待的時間 (以秒為單位)。預設值為 300。

----------範例----------

Start-SPProfileServiceIncrementalReplication -source http://hq.contoso.com:8081 -destination http://euro.contoso.com:8081 -EnableInstrumentation -Credential $mycredential

此範例會將所有使用者設定檔屬性的變更從 hq.contoso.com 複寫至 euro.contoso.com,並追蹤檢測記錄中的任何變更。

顯示: