Export (0) Print
Expand All

Start-SPProfileServiceRecoveryReplication

Published: July 15, 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.

Start-SPProfileServiceRecoveryReplication -Destination <String> -FileName <String> -Source <String> [-DoSocialReplication <SwitchParameter>] [-DoUpgrade <SwitchParameter>] [-EnableInstrumentation <SwitchParameter>] [-MatchSubtype <SwitchParameter>] [-Properties <String[]>] [-Timeout <Int32>]

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.

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.

Input Types

 

Return Types

 

----------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.

Change History

 

Date Description Reason

July 15, 2010

Initial publication

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft