产品文档
Citrix Virtual Apps and Desktops
Current Release Service 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR

创建并管理连接和各项资源

June 2, 2026
投稿者: 
C

重要提示：

自 Citrix Virtual Apps and Desktops™ 7 2006 起，如果您的当前部署使用以下任何技术，则只有在删除使用这些技术的生命周期终止 (EOL) 项目后，才能将部署升级到当前版本。

  • 个人虚拟磁盘 (PvD)
  • 应用磁盘™
  • Public cloud host types: Citrix CloudPlatform, Microsoft Azure Classic

有关详细信息，请参阅删除 PVD、AppDisks 和不受支持的主机。

注意：

Starting with version 2511, Citrix Web Studio (web-based) is the only management console for Citrix Virtual Apps and Desktops™. Citrix Studio (MMC-based) has been removed from the installer. This article applies only to Web Studio. For information about Citrix Studio, see the equivalent article in Citrix Virtual Apps and Desktops 7 2212 or earlier.

如果您想将公共云主机连接用于部署，则需要混合权利许可证才能完成全新安装或升级到当前版本。

当安装程序检测到一个或多个不受支持的技术或没有混合权利许可证的主机连接时，升级会暂停或停止，并显示一条解释性消息。安装程序日志中包含详细信息。有关详细信息，请参阅升级部署。

混合权利许可证对主机连接的影响

根据混合权利许可证的授权，公共云主机的连接在以下三种情况下会受到影响：

  • 要创建到公共云主机的新主机连接，您必须拥有混合权利许可证。

  • 如果您拥有混合权利许可证但许可证已过期，则到公共云主机的现有连接将被标记为无权访问并进入维护模式。当现有主机连接处于维护模式时，您无法执行以下操作：

    • 添加或修改主机连接
    • 创建目录并更新映像
    • 执行电源操作

  • 当未授权的主机连接变为已授权时，现有托管连接将重新启用。

Introduction

在创建站点时，您可以选择性地创建与托管资源的第一个连接。之后，您可以修改该连接并创建其他连接。配置连接涉及从支持的虚拟机管理程序中选择连接类型，以及从该连接的可用资源中选择存储和网络。

只读管理员可以查看连接和资源详细信息。您必须是完全管理员才能执行连接和资源管理任务。有关详细信息，请参阅委派管理。

在何处查找有关连接类型的信息

您可以使用受支持的虚拟化平台在 Citrix Virtual Apps 或 Citrix Virtual Desktops 环境中托管和管理计算机。(/zh-cn/citrix-virtual-apps-desktops/2511/system-requirements.html)文章列出了支持的类型。

有关详细信息，请参阅以下信息源：

  • XenServer (formerly Citrix Hypervisor™):

  • 努坦尼克斯 阿克罗波利斯：

  • 威睿：

  • Microsoft Hyper-V:

  • 公共云主机连接（AWS、Google Cloud、Microsoft Azure、Nutanix 云和合作伙伴解决方案以及 VMware 云和合作伙伴解决方案）： 有关公共云主机的信息，请参阅 设置资源类型。

    注意：

    这些信息源将引导您查阅 Citrix DaaS™ 文档。如果您熟悉 Citrix DaaS 产品中的公共云主机，则本地版本存在一些差异。在本地 Virtual Apps and Desktops 中，管理界面称为 Web Studio。服务大约每四周发布一次更新。因此，您可能会发现服务中提供的某些功能在本地版本中不可用。

主机存储

当由受支持的管理程序管理时，存储产品将受到支持。Citrix 支持部门会协助这些存储产品供应商解决问题，并根据需要将这些问题记录在知识中心。

预配计算机时，数据按类型分类：

  • 操作系统 (OS) 数据，包括主映像。
  • 临时数据。此数据包括写入到 MCS 预配计算机的所有非持久性数据、Windows 页面文件、用户配置文件数据以及与 ShareFile 同步的任何数据。每次计算机重新启动时，此数据都会被丢弃。

为每种数据类型提供单独的存储可以减少每个存储设备的负载并提高性能，从而充分利用主机的可用资源。它还允许为不同的数据类型使用适当的存储——对于某些数据而言，持久性和弹性比其他数据更重要。

存储可以是共享的（集中放置，独立于任何主机，所有主机使用）或虚拟机管理程序本地的。例如，中央共享存储可以是一个或多个 Windows Server 2012 群集存储卷（带或不带附加存储），或者来自存储供应商的设备。中央存储还可能提供自己的优化，例如虚拟机管理程序存储控制路径和通过合作伙伴插件的直接访问。

在本地存储临时数据可以避免遍历网络来访问共享存储。它还可以减少共享存储设备的负载。共享存储可能更昂贵，因此在本地存储数据可以降低成本。必须权衡这些优势与虚拟机管理程序服务器上可用存储的充足性。

创建连接时，您可以选择两种存储管理方法之一：虚拟机管理程序共享的存储，或虚拟机管理程序本地的存储。

在一个或多个 XenServer 主机上使用本地存储来存储临时数据时，请确保池中的每个存储位置都具有唯一的名称。（要在 XenCenter® 中更改名称，请右键单击存储并编辑名称属性。）

虚拟机管理程序共享的存储

虚拟机管理程序共享的存储方法集中存储需要长期持久性的数据，提供集中备份和管理。该存储包含操作系统磁盘。

选择此方法时，您可以选择是否使用本地存储（在同一虚拟机管理程序池中的服务器上）来存储临时计算机数据。此方法不需要像共享存储中的数据（称为 临时数据缓存）那样高的持久性或弹性。本地磁盘有助于减少到主操作系统存储的流量。此磁盘在每次计算机重新启动后都会清除。通过直写式内存缓存访问该磁盘。如果将本地存储用于临时数据，则预配的 VDA 将绑定到特定的虚拟机管理程序主机。如果该主机发生故障，则 VM 无法启动。

例外：使用群集共享卷 (CSV) 时，微软 System Center Virtual Machine Manager 不允许在本地存储上使用临时数据缓存磁盘。

创建一个连接以在本地存储临时数据，然后为每个 VM 的缓存磁盘大小和内存大小启用并配置非默认值。默认值根据连接类型量身定制，并且在大多数情况下都足够。有关详细信息，请参阅创建计算机目录。

虚拟机管理程序还可以通过在本地读取缓存磁盘映像来提供优化技术。例如，XenServer 提供了 IntelliCache™，它可以减少到中央存储的网络流量。

虚拟机管理程序本地的存储

虚拟机管理程序本地的存储方法将数据本地存储在虚拟机管理程序上。使用此方法，主映像和其他操作系统数据将传输到站点中的虚拟机管理程序。此过程发生在初始计算机创建和未来的映像更新时。此过程会导致管理网络上出现大量流量。映像传输也耗时，并且映像在不同时间对每个主机可用。

创建连接和管理资源

您可以在创建站点时选择性地创建第一个连接。站点创建向导包含以下部分中描述的与连接相关的页面。

如果您在创建站点后创建连接，请从步骤 1 开始。

重要提示：

在创建连接之前，必须提供主机资源（存储和网络）。

  1. Sign in to Web Studio.
  2. 在左侧窗格中选择托管。
  3. 在操作栏中选择添加连接和资源。
  4. 向导将引导您完成以下页面（特定页面内容取决于所选的连接类型）。完成每个页面后，单击下一步，直到到达摘要页面。

Connection

创建连接向导中的连接页面(/zh-cn/citrix-virtual-apps-desktops/2511/media/add-conn-connection.png)

在连接页面上：

  • 要创建连接，请选择创建新连接。要基于与现有连接相同的主机配置创建连接，请选择使用现有连接，然后选择相关连接。
  • 在连接类型字段中选择您正在使用的管理程序。仅当您使用混合权利许可证时，公共云主机连接才会显示在下拉列表中。或者，您可以使用 PowerShell 命令 Get-HypHypervisorPlugin [-ZoneUid] $rluid [-IncludeUnavailable] false/true 来获取以下信息：
    • 所有 Citrix 支持的管理程序插件列表，包括第三方插件。
    • 管理程序插件的可用性。如果可用性状态为 false，可能的原因是管理程序插件未正确安装，或者您没有混合权利许可证。
  • 连接地址和凭据字段会根据所选的连接类型而有所不同。请填写所需的信息。
  • 输入连接名称。此名称将显示在 Web Studio 中。
  • 选择用于创建虚拟机的工具：Web Studio 工具（例如机器创建服务™ 或 Citrix 预配）或其他工具。

存储资源管理

存储管理

有关存储管理类型和方法的信息，请参阅主机存储。

如果您正在配置与 Hyper-V 或 VMware 主机的连接，请浏览并选择群集名称。其他连接类型不要求提供群集名称。

选择存储管理方法：由虚拟机管理程序共享的存储或虚拟机管理程序本地存储。

  • 如果您选择由虚拟机管理程序共享的存储，请指明是否要将临时数据保留在可用的本地存储上。（您可以在使用此连接的计算机目录中指定非默认的临时存储大小。）例外：使用群集共享卷 (CSV) 时，Microsoft System Center Virtual Machine Manager 不允许在本地存储上使用临时数据缓存磁盘。在 Web Studio 中配置该存储管理设置将失败。

如果您在 XenServer 池中使用共享存储，请指明是否要使用 IntelliCache 来减少共享存储设备上的负载。请参阅将 IntelliCache 用于 XenServer 连接。

注意：

在 XenServer、VMware 和 SCVMM 虚拟化环境中，可以将回写缓存 (WBC) 磁盘与操作系统磁盘置于同一存储位置。为此，请勿选择优化可用本地存储上的临时数据。

存储选项选择

“创建连接”向导中的“存储选择”页面

有关存储选择的详细信息，请参阅主机存储。

为每个可用数据类型选择至少一个主机存储设备。您在上一页选择的存储管理方法会影响此页面上可供选择的数据类型。在继续向导的下一页之前，请为每个支持的数据类型选择至少一个存储设备。

注意：

  • 在 XenServer、VMware 和 SCVMM 虚拟化环境中，如果您将可用操作系统存储列表配置为与可用临时存储列表相同，则 MCS 会将回写缓存 (WBC) 磁盘放置在与操作系统磁盘相同的存储位置。
  • 如果您选择至少两个或更多操作系统数据存储位置，则会出现使用最少负载方法优化存储负载平衡选项。此选项允许您选择负载最低的存储库进行磁盘分配。 使用最少负载方法优化存储负载平衡选项图像
  • 摘要页面指示该选项是已启用还是已禁用，具体取决于您的选择。详细信息面板显示存储分配方法的更改。您可以使用操作系统存储页面上的编辑存储选项进行调整。或者，您可以使用 PowerShell 实现相同的目标。请参阅适用于 VM 的灵活存储位置选项。

如果您在存储管理页面上选择使用管理程序共享的存储并选择优化可用本地存储上的临时数据，则可以在存储选择页面上获得更多配置选项。例如，您可以选择要用于临时数据的本地存储设备（在同一管理程序池中）。

显示当前选定的存储设备数量（在前面的图中，“已选择 1 个存储设备”）。当您将鼠标悬停在该条目上时，将显示选定的设备名称。

  1. 单击选择以更改要使用的存储设备。
  2. 在选择存储对话框中，选中或清除存储设备复选框，然后单击确定。

网络

在网络页面上，输入资源的名称。此名称将显示在 Web Studio 中，用于标识与连接关联的存储和网络组合。

选择一个或多个供 VM 使用的网络。

摘要

在摘要页面上，查看您的选择。完成后，单击完成。

请记住：在本地存储临时数据允许您在创建包含使用此连接的计算机的计算机目录时，为临时数据存储配置非默认值。请参阅创建计算机目录。

编辑连接设置

请勿使用此过程重命名连接或创建连接。这些连接是不同的操作。仅当当前主机具有新地址时才更改地址。将地址输入到不同的计算机将中断连接的计算机目录。

您无法更改连接的 GPU 设置，因为访问此资源的计算机目录必须使用适当的 GPU 专用主映像。创建连接。

  1. 登录到 Web 工作室。
  2. 在左窗格中选择 Hosting。
  3. 选择连接，然后在操作栏中选择 编辑连接。
  4. 按照编辑连接时可用的设置指导进行操作。
  5. 完成后，单击 应用 以应用所做的任何更改并保持窗口打开，或者单击 保存 以应用更改并关闭窗口。

连接属性 页面：

  • 要更改连接地址和凭据，请选择 编辑设置…，然后输入新信息。

  • 要为 XenServer 连接指定高可用性服务器，请选择 编辑服务器… 并选择服务器。Citrix 建议您选择池中的所有服务器，以便在池主服务器发生故障时允许与 XenServer 进行通信。

    注意：

    如果您正在使用 HTTPS 并希望配置高可用性服务器，请勿为池中的所有服务器安装通配符证书。每个服务器都需要一个单独的证书。

高级 页面：

  • 对于 Microsoft System Center Configuration Manager (ConfMgr) 局域网唤醒连接类型（该类型与远程电脑访问结合使用），请输入 ConfMgr 唤醒代理、幻数据包和数据包传输信息。

  • 限制阈值设置使您能够指定连接上允许的最大电源操作数。当电源管理设置允许过多或过少的计算机同时启动时，这些设置会有所帮助。每种连接类型都有特定的默认值，这些默认值适用于大多数情况，并且不得更改。

  • “同时操作（所有类型）”设置指定两个值：此连接上可同时发生的最大绝对数量，以及使用此连接的所有计算机的最大百分比。您必须同时指定绝对值和百分比值。实际应用的限制是这两个值中较低的一个。

    例如，在包含 34 台计算机的部署中，如果“同时操作（所有类型）”设置为绝对值 10 和百分比值 10，则实际应用的限制为 3（即 34 的 10% 四舍五入到最接近的整数，这小于 10 台计算机的绝对值）。

  • “每分钟最大新操作数”是一个绝对数字。没有百分比值。

  • 仅在 Citrix 支持代表的指导或明确的文档说明下，才可在“连接选项”字段中输入信息。

“共享租户”页面：

添加与此连接的订阅共享 Azure 计算库的租户和订阅。因此，在创建或更新目录时，您可以从这些租户和订阅中选择共享映像。

  • 输入与此连接关联的应用程序的“应用程序 ID”和“应用程序密钥”。通过此信息，您可以向 Azure 进行身份验证。我们建议您定期更改密钥以确保安全。
  • 指定共享租户和订阅。您最多可以添加八个共享租户。对于每个租户，您最多可以添加八个订阅。
  • 完成后，单击“保存”和“应用”。

仅在 Citrix 支持代表的指导下，才可在“连接选项”字段中输入信息。

编辑网络

您可以更改连接的网络。请执行以下操作：

  1. 转至“托管”。
  2. 选择连接下的目标资源，然后在操作栏中选择“编辑网络”。
  3. 为虚拟机选择一个或多个要使用的网络。
  4. 点击 保存 以保存您的更改并退出。

开启或关闭连接的维护模式

开启连接的维护模式可防止任何新的电源操作影响存储在该连接上的任何计算机。当计算机处于维护模式时，用户无法连接到该计算机。如果用户已连接，则维护模式将在他们注销时生效。

  1. 登录到 Web Studio 控制台。
  2. 在左侧窗格中选择 托管。
  3. 选择连接。要开启维护模式，请在操作栏中选择 开启维护模式。要关闭维护模式，请选择 关闭维护模式。

您还可以为单个计算机开启或关闭维护模式。此外，您还可以为计算机目录或交付组中的计算机开启或关闭维护模式。

删除一个连接

删除连接可能会导致大量计算机被删除和数据丢失。请确保受影响计算机上的用户数据已备份或不再需要。

在删除连接之前，请确保：

  • 所有用户都已从连接上存储的计算机注销。
  • 没有正在运行的断开连接的用户会话。
  • 已为池化和专用计算机开启维护模式。
  • 连接使用的计算机目录中的所有计算机均已关机。

当您删除某个目录引用的连接时，该计算机目录将变得不可用。如果此连接被某个目录引用，您可以选择删除该目录。在删除目录之前，请确保它未被其他连接使用。

  1. 登录 网络工作室。
  2. 在左侧窗格中选择 Hosting。
  3. 选择连接，然后在操作栏中选择 Delete Connection。
  4. 如果此连接上存储有计算机，系统会询问您是否必须删除这些计算机。如果需要删除，请指定如何处理关联的 Active Directory 计算机帐户。

重命名或测试连接

  1. 登录 网络工作室。
  2. 在左侧窗格中选择 Hosting。
  3. 选择连接，然后在操作栏中选择 重命名连接 或 测试连接。

测试 TLS 证书信任

如果由于不受信任的证书导致主机连接中断，您可以在 Web Studio 中重新信任该证书。要重新信任：

  1. 在左侧窗格中选择 Hosting。
  2. 右键单击要重新信任证书的连接，然后选择 Test TLS Certificate Trust。
  3. 在后续窗口中输入密码，然后单击 Save。
    • 如果证书必须重新信任，则会弹出一个警告对话框，其中包含信任证书的选项。
    • 如果证书已受信任，则会弹出一个成功对话框，显示证书已受信任。

查看连接上的计算机详细信息

  1. 登录到 Web Studio 控制台。
  2. 在左侧窗格中选择 Hosting。
  3. 选择连接，然后在操作栏中选择 View Machines。

上方窗格列出了通过该连接访问的计算机。选择一台计算机可在下方窗格中查看其详细信息。还提供了开放会话的会话详细信息。

使用搜索功能快速查找计算机。可以从窗口顶部的列表中选择一个已保存的搜索，也可以创建一个搜索。您可以通过键入计算机名称的全部或部分进行搜索，也可以构建一个表达式用于高级搜索。要构建表达式，请单击 Unfold，然后从属性和运算符列表中进行选择。

管理连接上的计算机

  1. 请登录到 Web Studio 界面。
  2. 在左侧窗格中选择 Hosting。
  3. 选择一个连接，然后在 Action 窗格中选择 View Machines。
  4. 在操作栏中选择以下选项之一。某些操作可能不可用，具体取决于计算机状态和连接主机类型。
操作 详细说明
启动 如果计算机已关机或已暂停，则启动计算机。
暂停 暂停计算机而不将其关闭，并刷新计算机列表。
关闭计算机 向操作系统发出关机请求。
强制关机 强制关闭计算机电源，并刷新计算机列表。
重新启动 请求操作系统关机，然后再次启动计算机。如果操作系统无法执行此操作，桌面将保持其当前状态。
启用维护模式 暂时停止与计算机的连接。用户无法连接到处于此状态的计算机。如果用户已连接，则维护模式将在他们注销时生效。（您还可以为通过连接访问的所有计算机启用或禁用维护模式，如上所述。）
从交付组中移除 从交付组中移除计算机不会将其从交付组使用的计算机目录中删除。只有在没有用户连接到计算机时，才能移除计算机。在移除计算机时，请启用维护模式以暂时阻止用户连接。
删除 删除计算机后，用户将无法再访问它，并且计算机将从计算机目录中删除。在删除计算机之前，请确保所有用户数据都已备份或不再需要。只有在没有用户连接到计算机时，才能删除计算机。在删除计算机时，请启用维护模式以暂时阻止用户连接。

对于涉及计算机关机的操作，如果计算机在 10 分钟内未关机，则会强制关闭其电源。如果 Windows 在关机期间尝试安装更新，则存在在更新完成之前计算机被强制关闭电源的风险。

编辑存储

您可以显示用于存储使用连接的 VM 的操作系统和临时数据的服务器的状态。您还可以指定要用于存储每种数据类型的服务器。

  1. 请登录到 Web Studio 界面。
  2. 在左侧窗格中选择托管。
  3. 选择连接，然后在操作栏中选择编辑存储。
  4. 在左侧窗格中，选择数据类型：操作系统或临时。
  5. 选中或清除所选数据类型的一个或多个存储设备的复选框。
  6. 单击确定。

列表中的每个存储设备都包含其名称和存储状态。有效的存储状态值为：

  • 正在使用： 存储正在用于创建计算机。
  • 已取代： 存储仅用于现有计算机。此存储中不添加新计算机。
  • 未使用： 存储未用于创建计算机。

如果清除当前正在使用的设备的复选框，其状态将更改为已取代。现有计算机将继续使用该存储设备（并且可以向其写入数据），因此即使该位置停止用于创建计算机，它也可能变满。

删除、重命名或测试资源

  1. 登录到网络工作室。
  2. 在左侧窗格中选择托管。
  3. 选择资源，然后在操作栏中选择相应的条目：删除资源、重命名资源或测试资源。

适用于 VM 的灵活存储位置选项

计算机目录中的 VM 分配有各种存储服务 (SR)。为了平衡不同存储中的 VM 分配，您有两个选项：

  • 增强型当前循环分配方法：MCS 不再总是从相同的固定 SR 开始分配，而是从上次使用的 SR 之后的 SR 开始分配。
  • 基于最小负载的分配方法：将 VM 放置在当前负载最小的 SR 上，通过比较同一计算机目录中每个 SR 上的 VM 总数来确定。例如，如果一个计算机目录包含 100 个 VM，分布如下：SR1 上有 20 个 VM，SR2 上有 30 个 VM，SR3 上有 50 个 VM，则新 VM 将首先分配给 SR1。此方法可确保 SR1、SR2 和 SR3 之间的负载均衡。

此功能：

  • 适用于所有本地部署的虚拟机管理程序（VMware、XenServer 和 Hyper-V）
  • 仅适用于操作系统磁盘存储。
  • 不适用于现有 VM

为了实施基于负载的分配选项，请在创建或更新主机连接时添加自定义属性 Name="StorageBalanceType" Value="VMCountBasedLeastLoad。如果您不使用此自定义属性和值，则默认应用增强型循环方法。

例如：

  • 在创建主机连接时：

     New-Item -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"StorageBalanceType`" Value=`"VMCountBasedLeastLoad`" /></CustomProperties>" -HypervisorConnectionName "Xen-Connection" -NetworkPath @("XDHyp:\Connections\Xen-Connection\Network 0.network") -Path @("XDHyp:\HostingUnits\XS-Network") -PersonalvDiskStoragePath @() -RootPath "XDHyp:\Connections\Xen-Connection\" -StoragePath @("XDHyp:\Connections\Xen-Connection\NFS virtual disk storage.storage")
 <!--NeedCopy-->

  • 在更新主机连接时：

     Set-Item  -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"StorageBalanceType`" Value=`"VMCountBasedLeastLoad`" /></CustomProperties>" -Path @("XDHyp:\HostingUnits\XS-Network")
 <!--NeedCopy-->

检测孤立的 Azure 资源

孤立资源是系统中未使用的资源，它们可能导致不必要的开销。

除了云管理员之外，在主机下具有使用主机连接检测虚拟机管理程序中的孤立资源权限的任何新创建的角色都将能够检测孤立资源。

此功能允许您检测 Citrix 虚拟应用和桌面 站点中主机上的孤立 Azure 资源。

请按照 Web Studio 中的步骤操作：

  1. 从管理中，在左侧窗格中选择托管。
  2. 选择一个连接，然后选择操作栏中的检测孤立资源。检测孤立资源对话框显示孤立资源报告。
  3. 要查看孤立资源报告，请选择查看报告。

或者，您可以使用 PowerShell 检测孤立的 Azure 资源。有关详细信息，请参阅检索孤立资源列表。

要了解孤立资源背后的原因以及如何进一步操作，请参阅使用 Citrix 有效管理孤立的 Azure 资源。

连接计时器

您可以使用策略设置配置三个连接计时器：

  • 最长连接计时器： 确定用户设备与虚拟桌面之间不间断连接的最长持续时间。使用会话连接计时器和会话连接计时器间隔策略设置。
  • 连接空闲计时器： 确定在没有用户输入的情况下，用户设备与虚拟桌面之间不间断连接的维护时长。使用会话空闲计时器和会话空闲计时器间隔策略设置。
  • 断开连接计时器： 确定断开连接的锁定虚拟桌面在会话注销之前可以保持锁定的时长。使用断开连接的会话计时器和断开连接的会话计时器间隔策略设置。

当您更新任何这些设置时，请确保它们在您的部署中保持一致。

有关详细信息，请参阅策略设置文档。

获取所有孤立资源的列表

您可以获取由 MCS 创建但不再由 MCS 跟踪的孤立资源列表。这目前适用于 Azure 环境。要获取此列表，可以使用 PowerShell 命令。您可以使用连接进行筛选。

默认情况下，完全管理员和云管理员角色具有此权限。要允许其他角色执行此操作，请在主机下为其分配使用主机连接检测虚拟机管理程序中的孤立资源权限。有关详细信息，请参阅创建和管理角色。

注意：

  • 如果任何预配或映像更新正在进行中，PowerShell 命令将被拒绝。
  • 标记有所有 Citrix 标签的客户管理资源将被检测为孤立资源。但是，如果您向该资源添加另一个标签 CitrixDetectIgnore，并将其值设置为 true，则在检测孤立资源时将忽略该资源。

限制事项

  • 只有内置的完全管理员或云管理员角色管理员用户才能运行 PowerShell 命令并获取孤立资源列表。
  • 为避免对孤立资源进行不正确的识别，请勿在筛选孤立资源期间启动虚拟机。
  • 在可能出现繁重工作负载的情况下，大约 2,000 条记录会显示为孤立。

若要显示孤立资源列表：

  1. Open a PowerShell window.

  2. 运行以下命令：

    1. 获取连接唯一标识符。连接唯一标识符是 HypervisorConnectionUid 属性的值。

      Get-ChildItem xdhyp:\connections | where { $_.PluginId -like 'Azure*' }"
<!--NeedCopy-->

    2. 获取孤立资源的列表。

      get-provorphanedresource -HypervisorConnectionUid <connection uid>
<!--NeedCopy-->

要显示来自订阅 ID 的孤立资源列表：

  1. Open a PowerShell window.

  2. 运行以下命令：

    1. 使用订阅 ID 查找连接的唯一标识符 (UID)。连接的唯一标识符 (UID) 是 HypervisorConnectionUid 属性的值。

      Get-ChildItem xdhyp:\connections | where { $_.CustomProperties -match '<subscriptionId>' }
<!--NeedCopy-->

    2. 获取孤立资源的列表：

      get-provorphanedresource -HypervisorConnectionUid <connection uid>
<!--NeedCopy-->

注意：

在删除之前，请务必仔细检查资源。

将 WinHttp (netsh) 代理服务器设置用于托管连接

此功能增强允许托管连接使用 WinHttp (netsh) 代理服务器设置。这使得代理设置更简单，并且与用于其他 Citrix 服务的代理设置配置保持一致。

此功能适用于以下几种类型的虚拟化环境：

  • 赛恩服务器
  • 谷歌云
  • 微软阿祖尔
  • 能腾
  • 红帽 欧鹏希夫特
  • 威睿

要将 Delivery Controllers 上为托管连接配置的 WinHttp (netsh) 代理服务器用于托管连接，您可以在托管连接中包含此自定义属性。

<Property xsi:type="StringProperty" Name="UseWinHttpProxyForHypervisorTraffic" Value="True" />
<!--NeedCopy-->
  • 当此自定义属性设置为 True 时，如果通过 netsh winhttp set proxy 命令在计算机上设置了 WinHttp 代理服务器，则对虚拟机管理程序的 API 调用将通过该代理服务器路由。
  • 当此自定义属性设置为 False 时，API 调用将忽略在 DDC 上配置的所有代理服务器（包括 WinINet 代理和 .net 代理）。
  • 当托管连接中不存在此自定义属性时，将使用计算机的 WinINet 或 .net 代理服务器配置。这是现有行为。

使用场景

  • 示例 1：托管连接上未设置自定义属性

    托管连接将读取 WinINet 代理配置，然后读取 .net 代理配置，如果已配置，则使用代理设置。如果未配置任何代理，则创建直接连接。这是现有行为，并将继续按原样工作。

  • 示例 2：托管连接上设置了自定义属性，值为 True

    托管连接将仅读取 WinHttp 代理设置，如果存在，则使用代理设置。如果不存在，则托管连接不使用任何代理设置。

  • 示例 3：托管连接上设置了自定义属性，值为 False

    托管连接将不读取计算机上的任何代理配置设置，并将尝试在没有代理的情况下连接到虚拟机管理程序。

先决条件

在使用 PowerShell 创建主机连接时设置自定义属性之前，请确保在所有桌面交付控制器上配置 WinHTTP 代理。

配置操作步骤

通过 CLI 创建使用 WinHttp 代理设置的新托管连接：

$CustomProperties = "<CustomProperties  xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`">
<!-- Include any other hypervisor specific custom properties here -->
<Property xsi:type=`"StringProperty`" Name=`"UseWinHttpProxyForHypervisorTraffic`" Value=`"True`" />
</CustomProperties>"

New-Item -ConnectionType $ConnectionType -HypervisorAddress @('https://hypervisorhost1.example.com') -Path @('XDHyp:\Connections\$ConnectionName') -Password $Password -UserName $User -CustomProperties $CustomProperties
<!--NeedCopy-->

在现有托管连接上设置自定义属性：

  1. 如果存在，从托管连接复制现有自定义属性。

    dir XDHyp:\Connections
<!--NeedCopy-->

  2. 复制托管连接的自定义属性并添加以下内容，然后将其保存到变量中。

    $CustomProperties
<Property xsi:type=`"StringProperty`" Name=`"UseWinHttpProxyForHypervisorTraffic`" Value=`"True`" />
<!--NeedCopy-->

    示例：

    Example:
$CustomProperties = "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`">
<Property xsi:type=`"StringProperty`" Name=`"SubscriptionId`" Value=`"123`" />
<Property xsi:type=`"StringProperty`" Name=`"ManagementEndpoint`" Value=`"https://management.azure.com/`" />
<Property xsi:type=`"StringProperty`" Name=`"AuthenticationAuthority`" Value=`"https://login.microsoftonline.com/`" />
<Property xsi:type=`"StringProperty`" Name=`"StorageSuffix`" Value=`"core.windows.net`" />
<Property xsi:type=`"StringProperty`" Name=`"TenantId`" Value=`"123abc`" />
<Property xsi:type=`"StringProperty`" Name=`"SharedTenants`" Value=`"`[ { 'Tenant':'123abc', 'Subscriptions':['345', '567'] } ]`"` /><Property xsi:type=`"StringProperty`" Name=`"UseWinHttpProxyForHypervisorTraffic`" Value=`"True`" />
</CustomProperties>"
<!--NeedCopy-->

    如果现有自定义属性为空，请设置自定义属性：

    $CustomProperties = "<CustomProperties  xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`">
<Property xsi:type=`"StringProperty`" Name=`"UseWinHttpProxyForHypervisorTraffic`" Value=`"True`" />
</CustomProperties>"
<!--NeedCopy-->

  3. 运行 Set-Item 命令以更新现有托管连接。

    Set-Item -CustomProperties $CustomProperties -LiteralPath @("XDHyp:\Connections\$ConnectionName") -PassThru -UserName $User -SecurePassword $Password
<!--NeedCopy-->

后续步骤

有关连接到特定主机类型的信息，请参阅：

如果您处于初始部署过程中，请创建计算机目录。

创建并管理连接和各项资源
June 2, 2026
投稿者: 
C
June 2, 2026
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.