Citrix Provisioning

Using the Streamed VM Setup Wizard

Using the Wizard

The Provisioning Services Streamed VM Setup Wizard assists in deploying a Provisioning Services streamed vDisk to a number of cloned virtual machines (VMs).

Use the wizard to:

  • Create VMs on a supported hosted hypervisor from an existing template:
    • XenServer
    • Hyper-V via SCVMM
    • ESX via V-Center
  • Create Provisioning Services target devices within a Collection
  • Assign a vDisk image that is in Standard Image mode to the VMs

Before running the wizard, be sure that the following prerequisites are met:

  • One or more hypervisor hosts exist with a configured template.

  • A Device Collection exists in the Provisioning Services Site .

  • A vDisk in Standard Image mode exists, to be associated with selected VM template.

  • Template VM Requirements:

    • Boot order: Network/PXE first in list (as with physical machines).

    • Hard disks: If using local write cache, an NTFS formatted disk large enough for the cache must exist. Otherwise, no hard disks are required.

    • Network: Static MAC addresses. If using XenServer, address cannot be 00-00-00-00-00-00

  • The Provisioning Services Console user account was added to a PVS SiteAdmin group or above.

  • When creating new accounts in the Console, the user needs the Active Directory Create Accounts permission. To use existing accounts, Active Directory accounts have to already exist in a known OU for selection.

  • If importing an Active Directory .CSV file, use the following format: <name>,<type>,<description>. The .CSV file must contain the column header. For example, the .CSV file contents is as follows:



    The trailing comma must be present to signify three values, even if there is no description. This is the same formatting used by Active Directory Users and Computers MMC when exporting the contents of an organizational unit.

  • If running a vCenter server on alternate ports, the following registry modifications must be made in order to connect to it from Provisioning Services:

    • Create a new key HKLM\Software\Citrix\ProvisioningServices\PlatformEsx
    • Create a new string in the PlatformEsx key named ‘ServerConnectionString’ and set it to ‘http://{0}:PORT#/sdk’ Note: If using use port 300, ServerConnectionString= http://{0}:300/sdk

This wizard creates VMs, associates Provisioning Services target devices to those VMs, and assigns a shared vDisk to them.

The wizard is run directly from a Provisioning Services Console.

  1. Right-click on the Site icon in the Console tree panel, then select the Streamed VM Setup Wizard… menu option. The Welcome to the Streamed VM Setup Wizard appears.
  2. Click Next to begin the setup.
  3. Select the type of hypervisor to connect to, then enter the required connection credentials.
  4. Click Next to verify the connection. Note: For convenient reuse, the most recently used hypervisor and username will be cached in the registry of the local machine running this instance of the Console. Note: XenServer 5.5 Update 2 hypervisors are not supported in the 5.6.1 Streamed VM Setup Wizard. System Center Virtual Machine Management (SCVMM) servers require PowerShell 2.0 to be installed.
  5. Optional. On the Hypervisor cluster screen, select the hypervisor host or cluster to host the VMs, then click Next.
  6. Select one VM template from the specified host, then click Next.
  7. On the Collection and vDisk page, select the collection in which to add VMs.
  8. Select a single shared vDisk within to assign to VMs within that collection, then click Next.
  9. Set the number of VMs to create, the number of vCPUs, and the amount of Memory each new virtual machine will use.
  10. Enable the radio button next to one of the following methods used for adding Active Directory computer accounts, then click Next:
    • Create new accounts
    • Import existing accounts Note: An Active Directory administrator will need to delegate rights to the Provisioning Services Console user to allow Active Directory account creation. Note: The domain and OU default to those of the current user. Note: New computer names to be created are first validated that they do not already exist as computers in Active Directory, VMs, or target devices.
  11. If the Create new accounts method is selected:
    • Click Next. The Active Directory accounts and location screen appears.
    • Select the appropriate domain from the Domain drop-down box, then select from the OUs listed for that Domain.
    • In the Account naming scheme drop-down box, select a valid naming scheme consisting of at least one hash symbol (#) that is 15 characters or less. Additionally, select a number/character fill option that will dynamically replace the hash symbols in the specified naming scheme, incrementing by one for each VM as they are created. If the Import existing accounts is selected:
    • Click Next. The Active Directory accounts and location page appears.
    • Click Browse to browse for an Active Directory Organizational Unit to import Active Directory account names, or click Import to import account names from a CSV file. Note: The Required count displays the number of virtual machines previously specified to be created. The Added count displays the number of validated entries added to appear in the list.
  12. Review all configuration settings, and then click Next to confirm and finish configurations. Note: Clicking Cancel cancels the configuration of any additional machines, and the quantity of successfully configured machines displays under the Progress bar. If the wizard fails or is cancelled in the middle of an operation, any progress made is retained. If cleanup of existing progress is required, it must be done manually, which includes removing the following:
    • Provisioning Services target devices created in the selected Collection.
    • VMs created in any of the selected hosts hypervisors.
    • Active Directory computer accounts that were created.


When using the setup wizard to specify names associated with storage devices, do not use a comma (,). Names associated with storage devices are retained by XenDesktop and separated by commas. For example, Storage 1, Storage 2, Storage 3. If a storage name includes a comma (for instance, ‘Storage1,East’) PVS erroneously recognizes this as two separate storage devices.

Using the Streamed VM Setup Wizard