Start-SPProfileServiceIncrementalReplication

 

適用版本: SharePoint Server 2010

上次修改主題的時間: 2016-11-30

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

Syntax

Start-SPProfileServiceIncrementalReplication -Destination <String[]> -Source <String> [-ActiveDirectoryDomains <String[]>] [-Credential <PSCredential>] [-DoSocialReplication <SwitchParameter>] [-DoUpgrade <SwitchParameter>] [-EnableInstrumentation <SwitchParameter>] [-FeedProperties <String[]>] [-MatchSubtype <SwitchParameter>] [-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 管理] 網頁中設定信任的「我的網站」主機位置。如需如何設定信任的「我的網站」主機位置其他資訊,請參閱<新增或刪除受信任的「我的網站」主機位置 (SharePoint Server 2010)>。

Parameters

參數 必要 類型 描述

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/?linkid=113311&clcid=0x404)。

DoSocialReplication

選用

System.Management.Automation.SwitchParameter

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

DoUpgrade

選用

System.Management.Automation.SwitchParameter

在社交分類中啟用取代無效字元。如果來源為 Office SharePoint Server 2007 User Profile SSP,而目的地為 SharePoint Server 2010 User Profile Service 應用程式,則必須使用此屬性。

EnableInstrumentation

選用

System.Management.Automation.SwitchParameter

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

FeedProperties

選用

System.String[]

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

MatchSubtype

選用

System.Management.Automation.SwitchParameter

將目的地設定檔屬性當成篩選,避免來源與目的地設定檔屬性之間有不相符問題。基於效能考量,建議您除非來源 User Profile Service 應用程式與目的地 User Profile Service 應用程式之間大部分的使用者設定檔屬性都有不相符問題,才使用此參數。

NumberOfRetry

選用

System.Int32

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

Properties

選用

System.String[]

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

ReplicationInterval

選用

System.Int32

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

Timeout

選用

System.Int32

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

WaitTimeBetweenFailures

選用

System.Int32

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

輸入類型

傳回類型

Example

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

get-spprofilepropertycollection -source http://euro.contoso.com:8081 | start-spprofileserviceincrementalreplication -source http://hq.contoso.com:8081 -destination http://euro.contoso.com:8081 -EnableInstrumentation -Credential $mycredential

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

See Also

Reference

Get-SPProfilePropertyCollection
Start-SPProfileServiceFullReplication
Start-SPProfileServiceRecoveryReplication
Stop-SPProfileServiceIncrementalReplication

Concepts

使用者設定檔複製引擎概觀 (SharePoint Server 2010)