Configure a Hyper-V VM

This topic provides an example of using the Virtual Machine Configuration wizard to set up the virtual machine configuration for a Hyper-V virtual machine.

This example assumes that you have used Hyper-V Manager to set up the virtual machine as explained in Set up a Hyper-V VM for Install Capture or all of the following are true:

  1. Start AppDNA.

  2. From the AppDNA menus, choose Edit > Settings.

  3. On the Virtual Machines tab, click New and then click Next.

  4. In the Virtual Machine Configuration Details step, enter a name and a description for the virtual machine configuration, click Hyper-V, and then click Next.

  5. Specify the Hyper-V Host Details for the Hyper-V server or client:

    • Hyper-V server – Specify the IP address or DNS name of the Hyper-V host server. Then enter the user name and password of the account to use to connect to Hyper-V. The user name must include the machine name, using the form machinename\user. If this is your domain account, enter your domain-qualified user name (for example, domain\user or

      Citrix recommends that you use a dedicated Hyper-V user account whose password is set to never expire rather than your standard domain account.

      Important: If the password changes in the future, you will need to run this wizard again to enter the new password.

    • Hyper-V client – Enter localhost in the Hostname / IP Address box and leave the Username and Password boxes blank. (In this configuration, you must be running AppDNA on the same machine as the Hyper-V client.)

  6. In the Hyper-V Virtual Machine step, select the virtual machine that you want to use.

    This should be a dedicated virtual machine for use with Install Capture run from this AppDNA client.

  7. In the Hyper-V Snapshot Selection step, select the virtual machine snapshot that you want to use. If you set up the virtual machine as explained in Set up a Hyper-V VM for Install Capture, this is the snapshot you took as the final step. If there are no snapshots in the list, click Create to take a snapshot of the virtual machine now.

    The wizard performs a series of checks. If any of these fail, see Hyper-V Snapshot Selection for troubleshooting information. The wizard then opens the virtual machine in the console. This may take a few minutes, particularly if the guest OS needs to be started. If you did not perform the virtual machine setup steps, perform them in virtual machine when it opens in the console. You will have an opportunity to take another snapshot at the end of the wizard.

  8. In the Virtual Machine Connection step, you can generally accept the default values, because the wizard attempts to retrieve the guest operating system’s machine name for you and you do not normally need to change the Remote Admin TCP port.

    For more information about this step and instructions for finding out the IP address of the virtual machine, see Virtual Machine Connection.

  9. In the Capture Output Location step, select Copy results to network share (faster) and specify the output folder that you created on the AppDNA machine earlier. Make sure you use a UNC path and identify the client or server machine by its host name or IP address – for example, \\AppDNAMachine\AppDNAOutput.

  10. In the Virtual Machine State step, select Power off the VM and take a snapshot (Recommended), and then click Next and Finish.

    This closes the wizard and returns you to the Install Capture page in the Settings dialog box, where you should now see the virtual machine configuration.

  11. Click Save.

The virtual machine configuration now appears in the list of virtual machine configurations on the Install Capture tab in the Import Applications screen.

Configure a Hyper-V VM