book
Article ID: CTX235596
calendar_today
Updated On:
Description
Deleting a connection can result in the deletion of large numbers of machines and loss of data. Ensure that user data on affected machines is backed up or no longer required.
Before deleting a connection, ensure that:
- All users are logged off from the machines stored on the connection.
- No disconnected user sessions are running.
- Maintenance mode is turned on for pooled and dedicated machines.
- All machines in Machine Catalogs used by the connection are powered off.
A Machine Catalog becomes unusable when you delete a connection that is referenced by that catalog. If this connection is referenced by a catalog, you have the option to delete the catalog. Before you delete a catalog, make sure it is not used by other connections.
Instructions
You can use either of below methods to delete hosting connection
METHOD 1:
- Select Configuration > Hosting in the Studio navigation pane.
- Select the connection and then select Delete Connection in the Actions pane.
- If this connection has machines stored on it, you are asked whether the machines should be deleted. If they are to be deleted, specify what should be done with the associated Active Directory computer accounts.
METHOD 2:
Use below PowerShell cmdlet to delete hosting connection.
- Open Powershell as Admin and run: asnp Citrix*
- Get the list of Connections: LS XDHyp:\Connections\
- Copy the value of FullPath from the Connection which should be deleted (example: XDHyp:\Connections\TestConnection)
- Remove connection: Remove-Item -Path "HostingConnectionPath" (example: Remove-Item -Path "XDHyp:\Connections\TestConnection")