/ Downloads / Citrix Cloud Services / Product Software / Automated Configuration for Virtual Apps and Desktops

Automated Configuration for Virtual Apps and Desktops

Release Date: Mar 6, 2025

What's new

Automated Configuration 3.0.117 has been updated to a new version with features including:

  • A new field SuppressUserIdentityCheck can be set to true in the CustomerInfo.yml file. This will have ACT ignore any identity checks when migrating for customers having identity related issues
  • Fix for Group Policy add failing with invalid tag filters, ACT will check for whether the tag exists and adds it if not existing prior to adding the policy
  • Fix for certain Admin role permissions that are hidden being skipped in a migration
  • Fixed a host connection bug where a setting in the fault field was being incorrectly read, preventing the host connection from being added
  • An error related to the issue above where machine catalogs would fail writing a fixup when the host connection read fails has also been fixed

Automated Configuration for Virtual Apps and Desktops 3.0.117

Mar 6, 2025
13.0 MB - (.msi) Download File

Version: 3.0.117

Checksums
  • SHA-256 - 2fd12e7912a78f10ba8215f3db7d8eb435b593c768b66d23727ca8870afb7edf

Changelog from previous versions

Version 3.0.115:

  • ACT will no longer remove MCS Discard (Non-persistent) Catalogs, instead the catalog will be skipped and a fixup will be reported
  • Fix for Admin roles failing to update, potentially blocking migration

Version 3.0.114:

  • Improved Set-CvadAcSiteActiveStateCloud to allow for filtering with a specific ResourceLocation
  • Added a new property to the CustomerInfo.yml file called AdditionalInitializeDiagnostics that provides some more Initialize logging when set to True
  • Fixed Backup-CvadAcToFile not properly saving MCS catalog ProvisioningScheme data
  • Fixed permissions that were applicable to Cloud being removed when the target site was OnPrem

Version 3.0.111:

  • Improved Set-CvadAcSiteActiveStateCloud and Set-CvadAcSiteActiveStateOnPrem cmdlets to allow for filtering using either IncludeByName or ExcludeByName
  • Minor bug fixes

Version 3.0.110:

  • Enhanced ACT to check whether a host connection is valid prior to adding a machine to a machine catalog. If it is not ready or faulting then the machine will be skipped and a fixup will be reported
  • Fixed issue with GPO group policy users in filter not being added to a policy due to domain case-sensitvity mismatch ex: DOMAIN\User 1 vs domain\User 1
  • Fixed Host Connections being skipped when restoring from a folder rather than the default location
  • Fixed Site verification failure occurring in other languages

Version 3.0.107:

  • Backup and Import/Merge/Restore support added for MCS machine catalogs (applicable to Cloud 118 and above)
  • Enhanced UserZonePreference component to also backup applications
  • ACT will now detect if Provisioning Schemes are missing from the machine catalog (MCS), if they are then the tool will skip the catalog and write a fixup
  • Fixed resource pools not applying prefix/suffix values, causing the migration of hosting managed catalogs to fail when using site merging
  • Fixed Host Connections in Admin Scopes not being written to the AdminScope.yml file
  • Other minor bugfixes

Version 3.0.106:

  • Added support for exporting GPO Group Policies 
  • Added support for RDS AutoScaling OnPrem
  • Added new component for Backup/Restore, BackupSchedules pertaining to Backup/Restore feature in WebStudio
  • Minor bug fixes

Version 3.0.100:

  • Fixed export issues, including StoragePath not being included for certain Host Connections as well as missing associated Application Groups or Delivery Groups for Applications
  • Fixed Backup-CvadAcToFile failing to backup information for several components with users in languages that aren't English
  • Other minor fixes

What is the Automated Configuration tool for Virtual Apps and Desktops?

This tool is designed to help automate the migration of Virtual Apps and Desktop configuration (such as policies, applications, machine catalogs, and others) from one or more On-Premises site(s) to the Citrix Virtual Apps and Desktop service (CVADs) hosted on Citrix Cloud. It can also be used to migrate information between different Cloud regions or tenants. The migration can be performed in stages by executing the tool multiple times, allowing administrators to easily achieve the desired configuration state.

Why use the Automated Configuration tool?

IT Administrators, particularly those dealing with large environments, find migration to be a very tedious process. And since it tends to be specific to their use cases, they often must write their own automation to accomplish this successfully. Citrix wants to ease this process by providing a tool that addresses customer use cases and automates the migration.

How is the Automated Configuration tool implemented?

Citrix has leveraged industry standard configuration as code mechanism to help automate the migration process. Essentially, with this tool, we discover and export one or more on-premises sites as a collection of configuration files and use custom commands to import configuration in stages into Citrix Virtual Apps and Desktops service. Admins can also run the tool multiple times, enabling them to achieve the desired configuration state easily.

Use cases supported

  • On-prem to cloud migration. (On-prem versions supported - All LTSR version and last two CRs)
  • Cloud site to cloud site migration

Detailed documentation

Please refer to the product documentation for more details.

Additional resources

Eula External Eula itEula