MigrateSPUsers: Sharepoint 2003 user account migration tool

January 30, 2008   9:10

At my current Sharepoint 2003 to 2007 migration project, we have to migrate Sharepoint 2003 users to a different domain server. On my world wide web search I bumped into an utility called “SPUserUtil” that was part of the “SharePoint Utility Suite”, but unfortunately the author decided to take the project offline and it is no longer available.

This blog post from Alexander Windel provided enough information about the process of migrating Sharepoint users. For WSS sites you can use the “stsadm -o migrateuser” command, but this is not enough for a Sharepoint 2003 Portal Server. The problem is that you’ll also need to use code to call the function PortalAccountMigrationManager.MigrateAccount() in the object model.

Last evening I created a small Sharepoint user migration utility, to make our life a bit easier. It will run both commands for you and it will allow you to migrate a larger batch of Sharepoint users at once.

Step 1)
Scan for users in your site collection to create the basic user xml file:
MigrateSPUsers.exe -detectusers http://mysitecollection -userfile users.xml

Step 2)
Edit the user xml file. Remove users that should not be migrated or add missing users. Change the “NewLogin” nodes to include the new account information.

Step 3)
Start the Sharepoint user migration by providing the tool the following parameters
MigrateSPUsers.exe -migrateusers -userfile users.xml
or for a Sharepoint Portal Server use
MigrateSPUsers.exe -migrateusers -userfile users.xml -portal -ignoresidhistory

Step 4)
Done! Check your Sharepoint site to see if all your users are correctly migrated.

Please note that you have to run this application at the Sharepoint server with enough user rights. The server should also contain the .Net2 runtimes. This utility is for use with Sharepoint 2003 only and it is for use on your own risk.

Click here to download MigrateSPUsers v1.0

Posted in SharePoint, Tools | Permalink | Read 7 comments

7 Comments »

1. Any plans on adapting this tool for 2007?

   Thanks!

   Ben

   Comment by Ben Marshall — September 9, 2008 @ 4:07 pm

2. Hi Ben! When I have some spare time I will try to create a moss2007 version.

   Comment by Edwin Vriethoff — October 12, 2008 @ 9:30 am

3. Can you please share the source code?

   Comment by Ram — March 23, 2009 @ 4:35 pm

4. What if the AD server has been replaced, not renamed? I need to remap the SIDs, but not change any logins.

   Would that be possible using this program?

   Comment by jos — May 6, 2010 @ 4:48 pm

5. And, is it possible to migrate groups?

   Thanks for a great utility!

   Comment by jos — May 7, 2010 @ 12:12 am

6. Excellent utility. Thank you!

   Comment by Dhong — March 16, 2011 @ 4:38 pm

7. Hello and thanks for the utility. Quick question this migrates permissons like STSADM but not the users configuration like if they have added links etc. How can that be migrated?

   Comment by Craig — August 26, 2011 @ 3:45 pm

RSS feed for comments on this post. TrackBack URL

Leave a comment