Citrix Virtual Apps and Desktops

Identity pool of on-premises Active Directory joined machine identity

This article describes how to create identity pool of on-premises Active Directory joined machine identity.

Use Web Studio

The following information is a supplement to the guidance in Create machine catalogs.

  1. On the Machine Identities page:

    1. Select identity type as On-premises Active Directory.
    2. Select an Active Directory account option:

      • Create new Active Directory accounts:
        • If you select Create new Active Directory accounts and do not use an existing identity pool, select a domain for those accounts and specify an account naming scheme.

        To find a specific domain quickly, type the domain name in the search box at the top of the Location (domain) dropdown and click Enter. Web Studio shows a progress indicator while it retrieves the matching domain. If the domain you typed is on the domain exclusion list, Web Studio notifies you that the domain is excluded and provides a link to Settings > Site settings > Add domains to exclusion list, where you can review or remove it.

        Note:

        To speed up domain lookups in environments with many forests or partially reachable trusts, add unreachable or unneeded domains to the exclusion list. For more information, see Configure the domain exclusion list.

        • If you select Create new Active Directory accounts and use an existing identity pool to create new accounts, then select an identity pool from the list.
      • Use existing Active Directory accounts: You can browse or import from CSV file, and reset password or specify the same password for all accounts.
    3. Click Next.
  2. On the Domain credentials page, select a service account or enter credentials manually. For information on service accounts, see On-premises Active Directory service accounts.

Modify the service account association

To change the associated service account or add an association to an existing MCS machine catalog, use the Edit Machine Catalog page.

  • To add a service account, click Select service account on the Service Account page.
  • To change the service account association, click the edit icon on the Service Account page.

Use PowerShell

You can associate an on-premises service account with an MCS created machine catalog by associating an on-premises service account with the identity pool. You can create an identity pool or update an existing identity pool to associate it with a service account.

For example: To create a new identity pool and associate it with a service account, run the following:

New-AcctIdentityPool -IdentityType ActiveDirectory -IdentityPoolName MyPool -NamingScheme Acc#### -Domain MyDomain.com -NamingSchemeType Numeric -OU "CN=MyOU,DC=MyDomain,DC=com" -ServiceAccountUid $serviceAccountUid
<!--NeedCopy-->

For example: To update an existing identity pool to associate it with a service account, run the following:

$identityPoolUid = (Get-ProvScheme -ProvisioningSchemeName "MyProvScheme").IdentityPoolUid
Set-AcctIdentityPool -IdentityPoolUid $identityPoolUid -ServiceAccountUid $serviceAccountUid
<!--NeedCopy-->

Note:

The $serviceAccountUid must be a valid UID of an on-premises Active Directory service account.

Identity pool of on-premises Active Directory joined machine identity