Migration Modes
Profile Magician supports several modes to handle different migration scenarios, from single ad-hoc fixes to mass automated deployments.
1. Single User Migration
The standard mode for migrating one specific user to another. Useful for break/fix scenarios or manual domain joins.
.\profmage.exe --old-user <source> --new-user <target> --license-key <key>- --old-user: The username of the existing profile on the machine.
- --new-user: The username of the new account (Local, Domain, or Entra ID) that will inherit the profile.
2. Batch Migration (All Users)
This mode scans the machine for all local profiles and attempts to migrate them. By default, it looks for a user with the same username on the target domain.
.\profmage.exe --all-users --new-domain <TargetDomain> --license-key <key>Example:
If the machine has local users john and jane, running --all-users --new-domain contoso.com will attempt to migrate:
- Local
john->contoso\john - Local
jane->contoso\jane
If matching usernames are found on the source machine and target domain.
3. CSV-Mapped Migration
For more control during bulk migrations (e.g., when usernames change), you can provide a CSV file mapping old users to new users.
.\profmage.exe --all-users --csv mapping.csv --new-domain <TargetDomain> --license-key <key>mapping.csv format:
The file should have no header and contain olduser,newuser pairs.
john.doe,jdoe
jane.smith,jsmith4. Cloud Configuration (Job ID)
The recommended mode for enterprise deployments. Configure the job in the web portal and simply pass the Job ID to the client.
In order to scope out the migration plan for each machine, its recommended to run our telemetry mode first for cloud jobs.
.\profmage.exe --job-id <UUID> --config-password <Password> --send-telemetryThis will submit the current state of each profile found in the cloud config, allowing valuable insight into the state of each profile.
More info on this can be found in our Cloud Configurations document.
Once you have validated the state of each machine, you can execute the migration by specifying your job ID and password.
.\profmage.exe --job-id <UUID> --config-password <Password>This will execute the migration, collect the final resulting telemetry, and submit the log archive to the cloud job overview.