Citrix Provisioning

Configuring vDisks for Active Directory management

Integrating Citrix Provisioning and Active Directory allows administrators to:

  • Select the Active Directory Organizational Unit (OU) for the Citrix Provisioning target device computer account.
  • Take advantage of Active Directory management features, such as delegation of control and group policies.
  • Configure the Citrix Provisioning server to automatically manage the computer account passwords of target devices.

Before integrating Active Directory within the farm, verify that the following prerequisites are met:

  • The master target Device was added to the domain before building the vDisk.
  • The Disable Machine Account Password Changes option was selected when the running the image optimization wizard.

After all prerequisites have been verified, new target devices can be added and assigned to the vDisk. A machine account is then created for each target device.


Running the PowerShell command Add-PvsDeviceToDomain without specifying a parameter adds all targets in every site to the computer’s container in Active Directory.

Managing domain passwords

When target devices access their own vDisk in Private Image mode, there are no special requirements for managing domain passwords. However, when a target device accesses a vDisk in standard image mode, the provisioning server assigns the target device its name. If the target device is a domain member, the name and password assigned by the server must match the information in the corresponding computer account within the domain. Otherwise, the target device is not able to log on successfully. For this reason, the provisioning server must manage the domain passwords for target devices that share a vDisk.

To enable domain password management you must disable the Active Directory-(or NT 4.0 Domain) controlled automatic renegotiation of machine passwords. This process is done by enabling the Disable machine account password changes security policy at either the domain or target-device level. The provisioning server provides equivalent functionality through its own Automatic Password Renegotiate feature.

Target devices booted from vDisks no longer require Active Directory password renegotiation. Configuring a policy to disable password changes at the domain level applies to any domain members booting from local hard drives. If policies disabling password changes are not desirable for your environment, disable machine account password changes at the local level. To disable machine account password changes, select the Optimize option when building a vDisk image. The setting is applied to any target devices that boot from the shared vDisk image.


The Citrix Provisioning server does not in any way change or extend the Active Directory schema. The provisioning server’s function is to create or modify computer accounts in Active Directory, and reset passwords.

When domain password management is enabled, it:

  • Sets a unique password for a target device.
  • Stores that password in the respective domain computer account.
  • Gives the information necessary to reset the password at the target device before it logs on to the domain.

Password management process

Password validation process with Active Directory

With password management enabled, the domain password validation process includes:

  • Creating a machine account in the database for a target device, then assign a password to the account.
  • Providing an account name to a target device using the Streaming Service.
  • Having the domain controller validate the password provided by the target device.

Enabling domain management

Each target device that logs on to a domain requires a computer account on the domain controller. This computer account has a password maintained by the Windows desktop OS and is transparent to the user. The password for the account is stored both on the domain controller and on the target device. If the passwords stored on the target device and on the domain controller do not match, the user cannot log on to the domain from the target device.

Domain management is activated by completing the following tasks:

  • Enabling Machine Account Password Management
  • Enabling Automatic Password Management

Enabling machine account password management

To enable machine account password management, complete the following:

  1. Right-click on a vDisk in the Citrix Provisioning console, then select the File Properties menu option.
  2. On the Options tab, select Active Directory machine account password management.
  3. Click OK, then close the properties dialog, then restart the Streaming Service.

Enabling automatic password management

If your target devices belong to an Active Directory domain and are sharing a vDisk, complete the following extra steps.

To enable automatic password support, complete the following:

  1. Right-click on a provisioning server in the console, then select the Properties menu option.
  2. Select the Enable automatic password support option on the Options tab.
  3. Set the number of days between password changes.
  4. Click OK to close the Server Properties dialog.
  5. Restart the Streaming Service.

Managing domain computer accounts

The tasks documented here must be performed using the Citrix Provisioning server, rather than in Active Directory, to take full advantage of product features.

Supporting cross-forest scenarios

To support cross-forest scenarios:

  • Ensure that the DNS is properly set up. See the Microsoft website for information on how to prepare DNS for a forest trust.
  • Ensure the forest functional level of both forests is the same version of Windows Server.
  • Create the forest trust. To create an account in a domain from another forest, create an Inbound Trust from the external forest to the forest where Citrix Provisioning resides.

Parent-child domain scenario

Common cross-domain configurations involve having the Citrix Provisioning server in a parent domain with users from one or more child domains. These users can administer Citrix Provisioning and manage Active Directory accounts within their own domains.

To implement this configuration:

  1. Create a Security Group in the child domain; it can be a Universal, Global, or Local Domain Group. Make a user from the child domain a member of this group.

  2. From the provisioning server console, in the parent domain, make the child domain security group a Citrix Provisioning Administrator.

  3. If the child domain user does not have Active Directory privileges, use the Delegation Wizard in the Active Directory Users & Computers Management Console. Use this method to assign, create, and delete a user’s computer account rights for the specified OU.

  4. Install the Citrix Provisioning Console in the child domain. No configuration is necessary. Log in to the provisioning server as the child domain user.

Cross-forest configuration

This configuration is similar to the cross-domain scenario. However, in this configuration the Citrix Provisioning console, user, and administrator group are in a domain that is in a separate forest. The steps are the same as for the parent-child scenario, except that a forest trust must be established first.


Microsoft recommends that administrators do not delegate rights to the default Computers container. The best practice is to create accounts in the OUs.

Giving access to the Provisioning Console for users in another domain

The groups for administrative roles are limited to groups in the native domain and domains with a two-way trust to the native domain. When granting access, consider:

  • Domain1 represents the domain containing the Provisioning Server and service accounts.
  • Domain2 represents the domain with a two-way trust to Domain1. It contains the user accounts which were granted access to the Provisioning Console.

To grant Provisioning Console access to users from another domain:

  1. Create a Domain Local Group in Domain2, and add the user account to this group.
  2. Log in to the Provisioning Console using an existing administrator account.
  3. Click Farm Properties. Select the Groups tab.
  4. In the Domain drop-down menu, choose Domain2.
  5. Retain the * to view all the groups associated with Domain2, or filter the groups by entering then the name of the Group you want to add. Click Search.
  6. Select the group by clicking the associated checkbox. Click Add.

Adding target devices to a domain


The machine name used for the vDisk image must not be used again within your environment.

  1. Right-click on one or more target devices in the Console window. You can alternatively right-click on the device collection itself to add all target devices in this collection to a domain. Select Active Directory, then select Create machine account. The Create Machine Accounts in Active Directory dialog appears.
  2. From the Domain combo box, select the domain that the target device belongs to or type the domain name.
  3. From the Organization unit (OU) scroll list, select, or type the organization unit to which the target device belongs. The syntax is ‘parent/child,’ lists are comma separated. If nested, the parent goes first.
  4. Click Create Account to create the account in the selected domain. Click Close to exit the dialog.

Removing target devices from a domain

  1. Right-click on one or more target devices in the console window. Alternatively, right-click on the device collection itself to add all target devices in this collection to a domain. Select Active Directory, then select Delete machine account. The Delete Machine Accounts from Active Directory dialog appears.
  2. In the Target Device table, highlight those target devices that you want to remove from the domain, then click Delete Account. Click Close to exit the dialog.

Reset computer accounts


An Active Directory machine account can only be reset when the target device is inactive.

To reset computer accounts for target devices in an Active Directory domain:

  1. Right-click on one or more target devices in the Console window. Alternatively right-click on the device collection itself to add all target devices in this collection to a domain. Then select Active Directory, then select Reset machine account. The Reset Machine Accounts Passwords in Active Directory dialog appears.
  2. In the Target Device table, highlight those target devices to reset, then click Reset Account.
  3. Click Close to exit the dialog.
  4. Disable Windows Active Directory automatic password renegotiation. To disable automatic password renegotiation on your domain controller, enable the following group policy: Domain member: Disable machine account password changes.


    To make this security policy change, you must have sufficient permissions to add and change computer accounts in Active Directory. You have the option of disabling machine account password changes at the domain level or local level. If you disable machine account password changes at the domain level, the change applies to all members of the domain. If you change it at the local level (by changing the local security policy on a target device connected to the vDisk in Private Image mode), the change applies only to the target devices using that vDisk.

  5. Boot each target device.

Adding untrusted domains to the domain list

Citrix Provisioning supports provisioning of target devices in untrusted domains. To add an untrusted domain to the domain list, you must provide valid credentials. If the credentials are valid, the untrusted domain is added to the domain list. You can then create, delete, or reset accounts in Active Directory within the selected domain. To add an untrusted domain:

  1. Click Add domain..

    Image of adding untrusted domain

  2. In the AddDomainDialog, enter the domain name, username, and password for the untrusted domain.

    Image of verifying credentials for untrusted domain

Active directory-based activation

Update how Microsoft Volume Licensing is configured for an individual vDisk using Active Directory-based activation. With this functionality you can specify that the vDisk uses no volume licensing.

vDisk Properties Microsoft Volume Licensing


When using the Microsoft Volume Licensing for a vDisk, consider that Key Management Services (KMS), Multiple Activation Key (MAK) and Active Directory-based activation (ADBA) cannot be used together.

To improve active directory-based activation:

  1. In the vDisk Property screen, set the vDisk Microsoft Licensing property to None.
  2. On the target device, use slmgr-dlv for a Microsoft image, and cscript ospp.vbs/dstatus for a Microsoft Office image.


A known issue exists where VAMT displays errors about duplicate CMID entries for ADBA activated devices. This issue occurs although ADBA does not use CMID. ADBA, despite being similar to KMS, does not use CMID. Microsoft reuses KMS data when compiling CMID information. The following image illustrates a VAMT tool screen for ADBA. The Volume Activation by Type screen displays conflicts for duplicate CMID entries for those devices.

vDisk Properties Microsoft Volume Licensing

Configuring vDisks for Active Directory management