View User Profile Migration VMware Horizon 7 Version 7.0 This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.
View User Profile Migration You can find the most up-to-date technical documentation on the VMware Web site at: http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: docfeedback@vmware.com Copyright © 2016 VMware, Inc. All rights reserved. Copyright and trademark information. VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc.
Contents View User Profile Migration 5 1 User Profile Migration Overview 7 Best Practices for Running a User Profile Migration 8 Prerequisites for Running the Profile Migration Utility 9 migprofile.exe Command Usage 9 Migration Configuration File 11 Index 19 VMware, Inc.
View User Profile Migration 4 VMware, Inc.
View User Profile Migration View User Profile Migration describes how to use the View profile migration command-line utility to migrate Windows 7, Windows 8 or 8.1, Windows Server 2008 R2, or Windows Server 2012 R2 user profiles, which use the V2 format, to Windows 10 user profiles, which use the V5 format. You can also migrate Windows XP user profiles, which use the V1 format, to the later Windows versions that use the V2 format.
View User Profile Migration 6 VMware, Inc.
1 User Profile Migration Overview The standalone command-line utility, migprofile.exe, migrates V2 user profiles to V5 user profiles, or V1 user profiles to V2 user profiles. The utility is intended for users who are migrating from legacy machines in a View environment, or from legacy computers in any physical or virtual environment, to machines running later Windows versions in a View environment.
View User Profile Migration n User's local profile on a physical computer or virtual machine. The utility can migrate a single local profile on a computer. To migrate multiple users' local profiles, you can write a script that directs the utility to execute in batch mode. The source environment can comprise physical computers or virtual machines. The source environment does not have to be configured with a remote profile management solution such as View Persona Management or Windows roaming profiles.
Chapter 1 User Profile Migration Overview Prerequisites for Running the Profile Migration Utility Before you run the migprofile.exe utility, verify that your legacy and destination environments satisfy specific prerequisites. n Run the migration utility on a physical computer or virtual machine that runs the destination Windows operating system version. If you are migrating to a V5 user profile, run the utility on a Windows 10 machine.
View User Profile Migration Table 1‑2. migprofile.exe Command-Line Options Option Description /s:source_path The path name of the source V2 or V1 profile path to be migrated. Use the wildcard '*.v2' to indicate that all V2 child folders should be migrated to V5. Use the wildcard '*' to indicate that all V1 child folders should be migrated to V2. This option is mandatory. You must specify the source path either on the command line or in the migration configuration file.
Chapter 1 User Profile Migration Overview The following example migrates the V2 profile for the user ts115 on the computer devvm-win7 to the remote path \\file02\share\profiles. The utility takes ownership of the user profiles during the migration: migprofile.exe /s:\\devvm-win7\c$\Users\ts115.v2 /t:\\file02\share\profiles\ /v2 /takeownership Migration Configuration File You can specify a migration configuration file as a command-line option with the profile migration command.
View User Profile Migration included_registry_keys excluded_registry_keys Migration Configuration File Settings In the migration configuration file, you can specify settings that control the profile migration. Some settings correspond to the migprofile.
Chapter 1 User Profile Migration Overview Source Profile Path Use the source_profile_path setting to specify the path name of the source V1 or V2 profile path to be migrated. source_profile_path or source_profile_path true If you do not specify the source profile path in a command-line option, you must specify this setting in the migration configuration file.
View User Profile Migration Target Profile Path Use the target_profile_path setting to specify the path name of the target V2 or V5 profile after the migration: target_profile_path The utility appends .V2 to the root folder name of a target V2 profile or .V5 to the root folder name of a target V5 profile. Folders to Include Use the included_profile_folders setting to list the source profile folders to include in the migration.
Chapter 1 User Profile Migration Overview Folders to Exclude Use the excluded_profile_folders setting to list the source profile folders to exclude from the migration. This list can exclude folders that are included by default and folders that reside under folders in the included_profile_folders list. Format this setting as a comma-separated list. To specify folders, use the folder identifiers shown in Table 1-3. Do not use folder names.
View User Profile Migration Example Migration Configuration Files You can control a migration by editing settings in a migration configuration file. Example: Migrating V2 Profiles from a Remote Profile Path The following example file converts all remote V2 profiles that reside under the \\file02\share\profiles folder to V5 profiles in the same location. The migrated V5 profiles use the same user names as the V2 profiles. A V5 extension is appended to the users' root folders.
Chapter 1 User Profile Migration Overview Only files from the My Documents, Desktop, and Start Menu profile folders are migrated. The user's registry keys are migrated. \\devvm-winxp\c$\documents and settings\ts115 \\file01\profiles<
View User Profile Migration 18 VMware, Inc.
Index M migprofile.exe command usage 9 syntax 9 migprofile.exe utility, prerequisites 9 V V1 to V2 migration best practices 8 configuration file 11 configuration file settings 12 example configuration files 16 overview 7 View persona management 5 V2 to V5 migration best practices 8 configuration file 11 configuration file settings 12 overview 7 View persona management 5 VMware, Inc.
View User Profile Migration 20 VMware, Inc.