Product documentation
Citrix DaaS™
View PDF

Connection to Amulet Hotkey CoreStation (Preview)

April 24, 2026
Contributed by: 
C

Create and manage connections and resources describes the general wizards for creating a connection. The following information covers details specific to Amulet Hotkey CoreStation. You can currently create a connection to the Amulet Hotkey CoreStation using PowerShell commands.

Note:

Before creating a connection to Amulet Hotkey CoreStation, you need to first finish setting up your Amulet Hotkey CoreStation account. See Amulet Hotkey CoreStation virtualization environments

Create a connection

You can create a connection to Amulet Hotkey CoreStation using:

Create a connection using Studio

  1. In the Add Connection and Resources page, select Amulet Hotkey CoreStation as the connection type.
  2. Enter the connection address of your Amulet Hotkey CoreStation enclosure Manager. You can use an IP address, host name, or FQDN for the address.

  3. Enter your enclosure administrative credentials and a friendly connection name.

    Connection setup stops when either of the situations occurs:

    • DaaS receives a public CA-signed certificate with errors: An error message appears. Follow the on-screen instructions to fix the issue. Otherwise, you can’t proceed with connection creation.
    • DaaS receives a private CA-signed certificate: A warning page appears. Compare the received thumbprint with the server’s for the certificate validity. If it’s valid, select Trust certificate and click OK to proceed with connection creation. DaaS will then trust the certificate and store the thumbprint for future validation.

Create a connection using PowerShell commands

When you create a connection using PowerShell command, provide the following information:

  • IP: Amulet Hotkey CoreStation IP Address
  • Username: Amulet Hotkey CoreStation username
  • Password: Amulet Hotkey CoreStation password

Example:

Get-ConfigZone
Get-HypHypervisorPlugin
New-Item `
    -ConnectionType "Custom" `
    -HypervisorAddress $IP `
    -Metadata @{"Citrix_Orchestration_Hypervisor_Secret_Allow_Edit"="false"} `
    -Path @("XDHyp:\Connections\$connectionName") `
    -Persist `
    -PluginId "AmuletHotkeyCoreStationFactory" `
    -Scope @() `
    -SecurePassword $Password `
    -UserName $UserName `
    -ZoneUid $ZoneUid `
    -SslThumbprint $SslThumbprint
New-BrokerHypervisorConnection -HypHypervisorConnectionUid $HypervisorConnectionID
<!--NeedCopy-->

Note:

The -SslThumbprint parameter is required only for private CA-signed certificates.

Certificate and thumbprint validation

For creating a successful connection to Amulet Hotkey CoreStation, the certificate must not have errors and the thumbprint must have a correct value. Following are the use cases related to the certificate and thumbprint validation:

Scenario Result
Public CA-signed certificate has errors. The connection is not created successfully. See the error details and resolve the issue.
Public CA-signed certificate without errors. The connection is created successfully, and the SslThumbprints value is Null.
Private CA-signed certificate without errors and a sslthumbprint value. The connection is created successfully with a correct SslThumbprints value.
Private CA-signed Certificate with an incorrect thumbprint value. The connection is not created successfully.
Private CA-signed Certificate without errors. (no thumbprint provided) The connection is created successfully. The SSlThumbprints is Null when creating the connection. The SSlThumbprints value is updated to a value by the site service.

Manage connections

Fix certificate issues

Citrix DaaS blocks an Amulet Hotkey CoreStation connection when certificate issues arise, preventing you from delivering and managing workloads on associated Amulet Hotkey CoreStation nodes. You’ll see an error icon next to the connection in the Host connections list.

See the following table for specific issues and solutions.

Issue solution
A certificate error occurs to the public CA-signed certificate. Click the connection and select the Troubleshoot tab. View the error details and resolve the issue.
The received certificate is private CA-signed or expired.




Edit the host connection to update the certificate thumbprint. Details steps:
  1. Select the connection and click Edit Connection.
  2. On the Connection Properties page, click Edit settings.
  3. Enter the password to connect to the Amulet Hotkey CoreStation enclosure, and then click Save.
  4. On the Warning page that appears, compare the received thumbprint with the server’s for certificate validity.
  5. If they are the same, select Trust certificate and then click OK.

Update thumbprint value

After creating the connection, you can update the thumbprint value of a connection using the Set-Item PowerShell command. Follow the steps to update the thumbprint value.

  1. Get the connection details of a connection. For example:

    Get-Item -LiteralPath xdhyp:\connections\AmuletCon-101
<!--NeedCopy-->

  2. Update the thumbprint value. For example:

    Set-Item -LiteralPath xdhyp:\connections\AmuletCon-101 -Username Administrator -SslThumbprint xxxxxxxxxxx12AD048480631BB7AB10D69xxxxx
<!--NeedCopy-->

  3. Check the updated thumbprint value. For example:

    Get-Item -LiteralPath xdhyp:\connections\AmuletCon-101
<!--NeedCopy-->

Note:

The update fails if you provide an incorrect thumbprint value in the Set-Item command.

Where to go next

More information

Connection to Amulet Hotkey CoreStation (Preview)
April 24, 2026
Contributed by: 
C
April 24, 2026
Contributed by: 
C

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.