Rename users Home Drive folder when UPN changes

Question

Hi folks,

I already have a great script (thank you) that monitors our HR system for adds/removes/changes of our staff and reflects those changes in AD via scheduled task.

I would like to setup a Business Rule that monitors "AFTER CHANGING LOGON NAME OF USER", the home directory of that user will be 'renamed' to the new logon name.

eg.

username = jsmith home drive = \\server\users\jsmith

user gets married and changes name to jblack. Existing daily script will pick up this change in the HR system and will amend the account (name, display name, logon name etc etc). HERE is where the business rule will be invoked and will rename the existing home drive folder (jsmith) to jblack

result - username = jblack home drive = \\server\users\jblack

Or, is there a more efficient way of doing this? Could I possibly incorporate it into the existing script?

Thanks

Corey

Answer 1

Hello Corey,

The best way to achieve what you want is to create a Business Rule triggered after changing a username. To create such a Business Rule:

1. Create a new Business Rule.

2. On the 2nd step of the Create Business Rule wizard, select User and After Updating a User.
   

3. On the 3rd step, add the Run a program or PowerShell script action and paste the following script that renames a user's home folder:
   

    $homeDirectoryPath = "%homeDirectory%"
   
    # Check whether the home directory exists
    if(!(Test-Path -Path $homeDirectoryPath))
    {
        $Context.LogMessage("The home directory path is invalid", "Warning")
        return
    }
   
    # Rename the home directory
    $homeDirectory = Get-Item -Path $homeDirectoryPath
    $newHomeDirectoryPath = $homeDirectory.Parent.FullName + "\%username%"
   
    $Context.TargetObject.MoveHomeDirectory($newHomeDirectoryPath, $NULL)
   

4. Enter a short description for the script and click OK.

5. Now, you need to configure when the home folder must be renamed. Right-click the action you've just added and click Add Condition.
   

6. Select the If <property> changed condition type.

7. Specify If User Logon Name (pre-Windows 2000) has changed.
   

8. Click OK.

9. Also, you need to run the script only if a user has a home folder. Right-click the action and click Add Condition again.

10. Select the If <property> <relation> <value> condition type.

11. Specify If Home Directory is not empty.
    

12. Click OK and finish creation of the Business Rule.

Comments

Perfect as usual.

Thanks guys. Always a great help.