Citrix Virtual Apps and Desktops

连接到 Amulet Hotkey 核心站（预览版）

July 9, 2026

投稿者:

创建和管理连接和资源介绍了创建连接的通用向导。以下信息涵盖了 Amulet Hotkey CoreStation 的具体详细信息。您目前可以使用 PowerShell 命令创建到 Amulet Hotkey CoreStation 的连接。

注意：

在创建到 Amulet Hotkey 核心站的连接之前，您需要首先完成您的 Amulet Hotkey 核心站帐户的设置。

建立一个连接

You can create a connection to the Amulet Hotkey CoreStation using PowerShell commands.

使用 PowerShell 命令创建连接时，请提供以下信息：

IP：阿穆莱特热键核心站 IP 地址
用户名：阿穆莱特热键核心站用户名
Password: Amulet Hotkey CoreStation password

示例：

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-->

注意：

仅私有 CA 签名的证书才需要 -SslThumbprint 参数。

证书和指纹的验证检查

要成功创建到 Amulet Hotkey CoreStation 的连接，证书不得有错误，并且指纹必须具有正确的值。以下是与证书和指纹验证相关的用例：

公共CA签名的证书存在错误。连接创建失败。查看错误详细信息并解决问题。
公共CA签名的证书无错误。连接创建成功，且 SslThumbprints 值为 Null。
私有CA签名的证书无错误且具有 sslthumbprint 值。连接创建成功，且 SslThumbprints 值正确。
私有CA签名的证书具有不正确的指纹值。连接未能成功建立。
私有CA签名的证书无错误。连接创建成功。创建连接时，SSlThumbprints 为 Null。SSlThumbprints 值由站点服务更新为某个值。

对连接进行管理

修复证书问题

当出现证书问题时，Citrix Virtual Apps and Desktops 会阻止 Amulet Hotkey CoreStation 连接，从而阻止您在关联的 Amulet Hotkey CoreStation 节点上交付和管理工作负载。您将在“主机连接”列表中看到连接旁边显示一个错误图标。

请参阅下表了解具体问题和解决方案。

问题	解决方案
公共CA签名的证书发生证书错误。	单击连接并选择“故障排除”选项卡。查看错误详细信息并解决问题。
收到的证书是私有CA签名的或已过期。	编辑主机连接以更新证书指纹。详细步骤如下：
	选择连接，然后点击编辑连接。在连接属性页面上，点击编辑设置。输入密码以连接到 Amulet Hotkey CoreStation 机箱，然后点击保存。在出现的警告页面上，将收到的指纹与服务器的指纹进行比较，以验证证书的有效性。如果它们相同，请选择信任证书，然后点击确定。

更新指纹的值

创建连接后，您可以使用 Set-Item PowerShell 命令更新连接的指纹值。请按照以下步骤更新指纹值。

获取连接的连接详细信息。例如：

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

对指纹值进行更新。例如：

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

检查更新后的指纹值。例如：

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

注意：

如果 Set-Item 命令中提供的指纹值不正确，则更新失败。

下一步操作

如果您处于初始部署过程中，请参阅创建计算机目录。
For Amulet Hotkey CoreStation information, see Create an Amulet Hotkey CoreStation machine catalog.