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