Quick Start

Prerequisites

• You have downloaded profmage.exe.
• You have your organization's license key from the web portal.
• You have a source user account (e.g., OldUser).
• You have a target user account (e.g., NewUser) created on the machine or available in the target domain.
• You are running profmage.exe as a local Administrator.
  • Running under the source user is valid, but not recommended.

Steps

1. Open PowerShell as Administrator.

   • Right-click the Start button and select Windows PowerShell (Admin) or Terminal (Admin).

2. Navigate to the executable.

   cd path\to\folder\containing\profmage

3. Run the Migration Command. Replace OldUser and NewUser with your actual usernames.

   .\profmage.exe --old-user OldUser --new-user NewUser --license-key <key>

   If you are migrating to a different domain, include --new-domain in your parameters:

   .\profmage.exe --old-user OldUser --new-user NewUser --new-domain target.local --license-key <key>

   See our CLI Reference for more info on Profmage's CLI options.

4. Reboot (if switching domains).

   Restart-Computer

5. Login as the New User.

   • Log in with the NewUser credentials.

   On the first login, you will see a full-screen "Repairing Appx packages..." overlay. Do not interrupt this process. This is a critical post migration process.

   Once the overlay disappears and the desktop loads, your migration is complete!