Start-SPProfileServiceRecoveryReplication
Applies to: SharePoint Server 2010
Recovers user profiles that failed to replicate during full profile replication. This cmdlet will copy and overwrite all user profile properties in the destination User Profile Service application for the specified profiles.
Syntax
Start-SPProfileServiceRecoveryReplication -Destination <String> -FileName <String> -Source <String> [-DoSocialReplication <SwitchParameter>] [-DoUpgrade <SwitchParameter>] [-EnableInstrumentation <SwitchParameter>] [-MatchSubtype <SwitchParameter>] [-Properties <String[]>] [-Timeout <Int32>]
Detailed Description
The Start-SPProfileServiceRecoveryReplication cmdlet replicates user profile information and social data—including social tags, notes, and ratings—for user profiles that failed to replicate during full profile replication. The list of these user profile accounts is saved to an accounts file that is created during full profile replication. The profile information and social data are replicated from the source User Profile service application to the destination User Profile service application.
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
Destination |
Required |
System.String |
Specifies the URL of the My Site Host to where the user profiles are replicated, for example, http://euro.contoso.com:8081/my. |
FileName |
Required |
System.String |
Specifies the location of the accounts file. This file can be either the failed account file created during an instance of full replication or you can manually create a .txt or .rcv file that contains one user profile account per line, for example:Domain1\User1Domain1\User2Domain2\User1Domain2\User2Domain2\User3. |
Source |
Required |
System.String |
Specifies the URL of the My Site Host from where the user profiles are retrieved, for example, http://hq.contoso.com:8081/my. |
DoSocialReplication |
Optional |
System.Management.Automation.SwitchParameter |
Enables replication of social tags, notes, and ratings. Only use this parameter when both the source User Profile service application and the destination User Profile service application are Microsoft SharePoint Server 2010-based. |
DoUpgrade |
Optional |
System.Management.Automation.SwitchParameter |
Enables the replacement of invalid characters in the social taxonomy. This attribute must be used if the source is a Office SharePoint Server 2007 User Profile SSP and the destination is a SharePoint Server 2010 User Profile service application. |
EnableInstrumentation |
Optional |
System.Management.Automation.SwitchParameter |
Enables detailed logging by using the instrumentation log. |
MatchSubtype |
Optional |
System.Management.Automation.SwitchParameter |
Prevents mismatches between source and destination profile properties by using the destination profile properties as a filter. For performance reasons, we recommend that you only use this parameter if most of the user profile properties are mismatched between the source User Profile service application and the destination User Profile service application. |
Properties |
Optional |
System.String[] |
Specifies which user profile properties to replicate, for example, "FirstName" or "AboutMe". You can also use the Get-SPProfilePropertyCollection cmdlet to return a collection of all user profile properties. The default value returns all user profile properties. |
Timeout |
Optional |
System.Int32 |
Specifies the amount of time the User Profile Replication Engine should wait for a response from the Web service before timing out. The default is the Web service timeout. |
Input Types
Return Types
Example
----------Example----------
get-spprofilepropertycollection -source http://euro.contoso.com:8081 | start-spprofileservicerecoveryreplication -source http://hq.contoso.com:8081 -destination http://euro.contoso.com:8081 -EnableInstrumentation -FileName "d:\accounts.txt"
This example retrieves a list of user profiles that failed to replicate during incremental profile replication and replicates the user profile information and social data from the source User Profile service application to the destination User Profile service application.
See Also
Reference
Get-SPProfilePropertyCollection
Start-SPProfileServiceFullReplication
Start-SPProfileServiceIncrementalReplication
Stop-SPProfileServiceIncrementalReplication
Concepts
User Profile Replication Engine overview (SharePoint Server 2010)