How to Manually Create Hyper-V GEN2 Provisioning Services Target Devices
Article ID: CTX216823
Updated On:
Description
This article describes how to manually configure Hyper-V GEN2 virtual machines for usage as target devices on Provisioning Services (PVS) 7.8 through to PVS 1912.
Note: Since product updates in PVS 2112, the steps below are not required. So these steps are not required on the latest PVS current releases, and not required on the latest cumulative updates for PVS LTSR 2203 and 2402.
PVS and Gen2 VMs without SCVMM
- CVAD set up wizard is the only Citrix supported method of creating Hyper-V Gen2 VMs for use with PVS. Citrix support does not directly support manual creation of Gen2 VMs.
- Requirement for creating Gen2 VM target devices is that the NIC used for streaming has a specific VSID, which is consistently configured on all target devices (for PVS releases 7.8 through to 1912)
- Once Gen2 VMs are created and configured correctly, the PVS environment is supported to stream to those VMs.
Instructions
To add a NIC with a specific VSID
All of below should be completed in customer's time; Citrix support would not provide further directions on this:
- Review following guide: https://blogs.msdn.microsoft.com/taylorb/2013/07/15/adding-a-network-adapter-to-a-vm-using-the-hyper-v-wmi-v2-namespace/
- The script can be customized to the customers environment, specific point of interest when adding NIC with VSID, is $Msvm_SyntheticEthernetPortSettingData.VirtualSystemIdentifiers
- The GUID specified here should be "{c40165e3-3bce-43f6-81ec-8733731ddcba}"
- On PVS servers 7.8 and above, there a similar script, which is used to achieve similar results when using CVAD setup wizard, path: "C:\ProgramData\Citrix\Provisioning Services\PvsGen2.cr\pvsgen2.ps1"
- Important: This streaming adaptor needs to be added in a consistent hardware position. To ensure this, remove all network adaptors from the VM prior to adding the specific PVS streaming adaptor.
Manually using the PVS powershell script: pvsgen2.ps1
- Copy the script from the PVS server to the Hyper-V host.
- Remove all network adaptors from the Hyper-V VM which is being configured.
- Edit the script, set variable $vmName to the name of your Gen2 vm as it is displayed on hyper-V.
- Within an administrative PowerShell session, run the script.
- In Hyper-V console, reconfigure the newly added network adaptor (which will be named PVS Streaming Adapter)
- Configure the network, and add a static MAC address configured to match the MAC address of the PVS target in the PVS console.
Recommendation
These configuration steps, should be completed on the master virtual machine prior to capturing the vDisk. This will ensure master/golden/parent and subsequent target virtual machines all have a consistent hardware layout and configuration, which will enable successful PVS streaming of the vDisk.
Issue/Introduction
Additional Information
