Export Devices Wizard
这个版本的Citrix配置包括一个新的wizard in the provisioning console. The Devices Export Wizard exports existing provisioned devices to the Citrix Virtual Apps and Desktops Delivery Controller.
Note:
Instead of importing devices from Citrix Studio, devices are exported to the Delivery Controller using the remote PowerShell SDK. The remote PowerShell SDK can now communicate with both Customer Managed Delivery Controller and Delivery Controller managed by Citrix Cloud. The Devices Export Wizard is the preferred method for adding existing devices in your Citrix Provisioning farm to a Citrix Virtual Apps and Desktops Delivery Controller. Ability to import Citrix Provisioning target devices to create catalogs in Citrix Studio is deprecated and removed.
Requirements
The following elements are required for the Export Devices Wizard on Citrix Cloud deployments:
- Citrix Virtual Apps and Desktops Delivery Controller in Citrix Cloud. The Delivery Controller has its own database where Citrix Provisioning devices are added to the catalog.
- Citrix云连接器位于本地。使用for setting up Citrix Cloud, this connector acts as the relay between Citrix Cloud and the on-premises resource location.
- Citrix Provisioning console. The console uses the Citrix Virtual Apps and Desktops remote PowerShell SDK to add existing Citrix Provisioning devices to the Citrix Virtual Apps and Desktops Delivery Controller.
- Citrix Provisioning server version 1912 or later. This server communicates with the on-premises hypervisors and database and makes SOAP calls to MAPI.
The following elements are required for the Export Devices Wizard on-premises deployments:
- Citrix Provisioning console. The console installer removes any existing installed PowerShell snap-ins and installs the remote PowerShell SDK.
- Citrix Provisioning server version 1912 or later. This server communicates with the on-premises hypervisors and database and makes SOAP calls to MAPI.
- Citrix Virtual Apps and Desktops Delivery Controller for on-premises setup.
Important considerations
Consider the following when using the Export Devices Wizard:
- TheDevices Export Wizard Summarypage displays the number of devices that are exported to the Citrix Virtual Apps and Desktops Delivery Controller. This page displays this information even if devices fail to export. TheSummarypage displays how many device records were created and how many failed. the names of the failed devices can be found in the CDF trace. To export devices that failed earlier, rerun the Devices Export Wizard. Select the same collections. Add them to the existing Citrix Virtual Apps and Desktops catalog, or create a catalog to add them.
Devices can only be exported to a single Citrix Cloud customer during a single execution of the wizard. If the Citrix Cloud user has multiple cloud customers to manage, and changes occur during the execution of the wizard process, close the wizard and start it again. Use this process to change the Citrix Cloud customer.
When creating a machine catalog for a physical device using the Export Devices Wizard, the following exception may appear:Object reference not set to an instance of an object. To resolve this issue, use the Machine Creation Wizard in Studio to import the physical devices to the Citrix Virtual Apps and Desktops machine catalog. When you are using Citrix DaaS (formerly Citrix Virtual Apps and Desktops service) in Citrix Cloud, the machine catalog appears in theInitial Zone. Manually correct the zone of the machine catalog in Studio. This configuration avoids the errorCannot connect to the PVS serverwhen adding more devices. To manually move the machine catalog to correct zone:
Log into Studio.
In the zones node, manually drag the machine catalog to the desired zone.
Nutanix limitations
Existing provisioned Nutanix devices cannot be exported to Citrix Cloud because a Nutanix VM MAC address cannot be obtained. This limitation is similar to the behavior of the machine creation wizard in the Citrix Studio. To add a Nutanix device to the Citrix Cloud Delivery Controller, create a device using the Citrix Virtual Apps and Desktop Setup Wizard on Citrix Provisioning console.
Architecture
The following image illustrates elements comprising the Citrix Cloud architecture as part of the Devices Export Wizard functionality.
Note:
The on-premises configuration remains unchanged. The Devices Export Wizard functions with the on-premises Citrix Virtual Apps and Desktops Delivery Controller.
The wizard:
- 运行在Citrix配置控制台并添加existing provisioned devices to the Citrix Cloud Delivery Controller.
- uses SOAP and MAPI calls to interact with the Citrix Provisioning server to retrieve information on existing provisioned devices.
- interacts with the Citrix Virtual Apps and Desktops remote PowerShell SDK to communicate with the Customer Managed Delivery Controller and the Citrix Cloud Delivery Controller to add provisioned devices to the machine catalog.
Using the devices export wizard
Use the information in this section to install elements required for Devices Export Wizard functionality.
Important:
For on-premises deployments, the Citrix Virtual Apps and Desktops Delivery Controller is unmodified. No further installation or configuration changes are required. The Citrix Provisioning console installer, version 1912 or later, provides all the necessary components required to use the Export Devices Wizard.
For Citrix Cloud deployments:
- Install the Citrix Cloud Connector.
- Upgrade Citrix Provisioning to version 1912 or later.
For information about provisioning in Citrix Cloud, seeCitrix Provisioning managed by Citrix Cloud. For more information about installations related to Citrix Cloud deployments, seeUsing PVS with the Citrix Cloud Apps and Desktop Service.
To launch the Devices Export Wizard:
- In the Citrix Provisioning console, click theSitesnode.
- Right-click the Site you want to configure, and right-click to expose a contextual menu.
In the context menu, clickExport Devices Wizard.
TheExport Devices Wizardscreen appears.
ClickNextto start the wizard.
- On theCitrix Virtual Desktops Controllerscreen, select the type of Delivery Controller.
If you selectCitrix Cloud:
Enter yourCitrix Cloud credentials. ClickSign In.
After signing in to Citrix Cloud, select the appropriate cloud customer if requested.
If you selectCustomer-Managed Control Plane, enter the controller hostname or address. This will authenticate using your current logged in user.
Click theDevice Typeto export. SelectNext. SelectingVirtual Devicescreates power managed Citrix Virtual Apps and Desktops catalog. Physical devices in the Citrix Virtual Apps and Desktops catalog are unmanaged. When selectingVirtual Devices, the wizard displays theHost Resourcescreen which allows you to click the host or hypervisor. For physical devices, the wizard skips to theActive Directory and Collectionselection screen.
Click the host resource. SelectNext.
When selecting the host resource, you must associate a user name and password. SelectOK.
Click the Active Directory domain and collections that you want to export. SelectNext.
Note:
TheDomainfield lists all domains (trusted and untrusted) for selection.
Use the list to select theVDA version. Devices are required to register with the Delivery Controller referencing the machine catalog. SelectNext.
Tip:
All displayed devices are exported to a single Citrix Virtual Apps and Desktop catalog. You cannot select a device in this list.
Click machine catalog preferences. If you are creating a catalog, specify the name and optionally include a description. SelectNext.
Click the operating system. SelectNext.
Set the user experience for the virtual desktop. SelectNext.
SelectFinishin theSummaryscreen to complete the wizard process.
Once the wizard finishes, use the Machine Catalog Screen to view the Citrix Virtual Apps and Desktops catalog. Ensure that the catalog was created with the associated machines.