Start-SPProfileServiceFullReplication
Applies to: SharePoint Server 2010
Replicates all selected user profile properties from the source User Profile service application to the destination User Profile service application. The User Profile Replication Engine will run as a modal Windows PowerShell 2.0 cmdlet until the replication is complete.
Syntax
Start-SPProfileServiceFullReplication -Destination <String> -Source <String> [-ActiveDirectoryDomains <String[]>] [-DoSocialReplication <SwitchParameter>] [-DoUpgrade <SwitchParameter>] [-EnableInstrumentation <SwitchParameter>] [-MatchSubtype <SwitchParameter>] [-MaxNumberOfThreads <Int32>] [-NumberOfRetry <Int32>] [-Properties <String[]>] [-StartAtIndex <Int32>] [-Timeout <Int32>]
Detailed Description
The Start-SPProfileServiceFullReplication cmdlet replicates all selected user profile information and social data—including social tags, notes, and ratings—from the source User Profile Service application to the destination User Profile service application. Replication begins at the start index and can be stopped by pressing CTRL+C.
Note
It may take several seconds for all threads to stop once you have pressed CTRL+C.
If full replication is interrupted, check the log file for the last successful entry and restart using the StartAtIndex parameter.
The account running this cmdlet must be an administrator for the 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. |
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. |
ActiveDirectoryDomains |
Optional |
System.String |
Specifies the Active Directory Domain Services (AD DS) accounts to be replicated, for example, "headquarters" or "Europe".The default value returns all AD DS domains. |
DoSocialReplication |
Optional |
System.Management.Automation.SwitchParameter |
Enables replication of social tags, notes, and ratings. Only use when both source and destination User Profile service applications 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. |
MaxNumberOfThreads |
Optional |
System.Int32 |
Specifies the maximum number of replication threads allowed on the server that is running the User Profile Replication Engine. The default value is 25. The actual number of running threads will be decided dynamically by the User Profile Replication Engine. |
NumberOfRetry |
Optional |
System.Int32 |
Specifies the number of times that the User Profile Replication Engine should attempt to restart in the event of a failure, for example, a network disconnection. The default value is 10. |
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. |
StartAtIndex |
Optional |
System.Int32 |
Specifies which profile index in the profile database should be used as the start index. The default value is 0. |
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 value is the Web service timeout. |
Input Types
Return Types
Example
----------Example----------
get-spprofilepropertycollection -source http://euro.contoso.com:8081 | start-spprofileservicefullreplication -source http://hq.contoso.com:8081 -destination http://euro.contoso.com:8081 -EnableInstrumentation -MaxNumberOfThreads 3 -DoSocialReplication
This example gets a collection of all user profile properties and replicates all user profile information and social data from hq.contoso.com to euro.contoso.com.
See Also
Reference
Get-SPProfilePropertyCollection
Start-SPProfileServiceIncrementalReplication
Start-SPProfileServiceRecoveryReplication
Stop-SPProfileServiceIncrementalReplication
Concepts
User Profile Replication Engine overview (SharePoint Server 2010)