产品文档
Citrix Virtual Apps and Desktops 7 2311
查看 PDF

管理计算机目录

June 2, 2026
投稿者: 
C C

注意：

您可以通过两种不同的管理控制台来管理您的 Citrix Virtual Apps and Desktops™ 部署：它们分别是 Web Studio（基于 Web 的控制台）和 Citrix Studio（基于 Windows 的控制台）。本文档仅详细介绍 Web Studio 的使用。有关 Citrix Studio 的更多信息，请查阅 Citrix Virtual Apps and Desktops 7 2212 或更早版本中的相应文章。

本节介绍

您可以从计算机目录中添加或删除计算机、重命名、更改描述或管理目录的 Active Directory 计算机帐户。

维护目录还可能包括确保每台计算机都具有最新的操作系统更新，包括防病毒更新、操作系统升级或配置更改。

  • 包含使用 Machine Creation Services™ (MCS) 创建的池化随机计算机的目录通过更新目录中使用的主映像，然后更新计算机来维护计算机。此方法使您能够高效地更新大量用户计算机。
  • 对于包含静态、永久分配计算机的目录以及远程 PC 访问计算机目录，您可以在 Web Studio 之外管理用户计算机的更新。可以使用第三方软件分发工具单独或集体执行此任务。

有关创建和管理到主机管理程序的连接的信息，请参阅连接和资源。

注意：

MCS 无法支持 Windows 10 IoT Core 和 Windows 10 IoT Enterprise 版本的操作系统。有关更多详细信息，请访问查阅 微软网站。

关于持久性实例

更新使用持久或专用实例创建的 MCS 目录时，为该目录创建的任何新计算机都将使用更新后的映像。现有实例将继续使用原始实例。更新映像的过程与任何其他类型的目录相同。请考虑以下事项：

  • 对于持久磁盘目录，现有计算机不会更新到新映像，但添加到目录的任何新计算机都将使用新映像。
  • 对于非持久磁盘目录，计算机映像将在下次计算机重置时更新。
  • 对于持久性计算机目录，更新映像也会更新使用该映像的目录实例。
  • 对于非持久性目录，如果希望不同计算机使用不同的映像，则这些映像必须位于单独的目录中。

管理计算机目录

您可以通过两种方式管理计算机目录：

Use Web Studio

本节详细介绍了如何使用 Web Studio 管理目录：

向目录中添加计算机

开始之前：

  • 确保虚拟化主机具有足够的处理器、内存和存储，以容纳这些额外的机器。
  • 确保您有足够的未使用的 Active Directory 计算机帐户。如果您使用的是现有帐户，则可以添加的计算机数量受可用帐户数量的限制。
  • 如果您使用 Web Studio 为其他计算机创建 Active Directory 计算机帐户，则必须具有相应的域管理员权限。

要向目录中添加计算机，请执行以下操作：

  1. 登录到 Web 工作室。
  2. 在左侧窗格中选择计算机目录。
  3. 选择一个计算机目录，然后在操作栏中选择添加计算机。
  4. 选择要添加的虚拟机数量。
  5. 如果现有 Active Directory 帐户不足以容纳您要添加的 VM 数量，请选择创建帐户的域和位置。指定帐户命名方案，使用井号标记指示连续数字或字母出现的位置。请勿在 OU 名称中使用正斜杠 (/)。名称不能以数字开头。例如，命名方案 PC-Sales-##（选择 0-9）将生成名为 PC-Sales-01、PC-Sales-02、PC-Sales-03 等的计算机帐户。
  6. 如果您使用现有的 Active Directory 帐户，请浏览到这些帐户，或者单击导入并指定一个包含帐户名称的 .csv 文件。确保有足够的帐户可用于您要添加的所有计算机。Web Studio 管理这些帐户。您可以允许 Web Studio 重置所有帐户的密码，也可以指定帐户密码（所有帐户的密码必须相同）。

计算机在后台创建，创建大量计算机时可能需要很长时间。即使您关闭 Web Studio，计算机创建也会继续。

从目录中删除计算机

从计算机目录中删除计算机后，用户将无法再访问它，因此在删除计算机之前，请确保：

  • 用户数据已备份或不再需要。
  • 所有用户均已注销。启用维护模式可阻止新连接连接到计算机。
  • 计算机已关机。

要从目录中删除计算机，请执行以下操作：

  1. 登录到 Web 工作室。
  2. 在左侧窗格中选择计算机目录。
  3. 选择一个目录，然后在操作栏中选择查看计算机。
  4. 选择一台或多台计算机，然后在操作栏中选择删除。

选择是否删除正在移除的计算机。如果选择删除计算机，请指示这些计算机的 Active Directory 帐户是保留、禁用还是删除。

编辑目录

  1. 在描述页面上，更改目录描述。
  2. 在左侧窗格中选择计算机目录。
  3. 选择一个目录，然后在操作栏中选择编辑计算机目录。
  4. 在范围页面上，更改范围。

  5. 您可能会看到其他页面，具体取决于目录类型。

    对于使用 Azure Resource Manager 映像创建的目录，以下页面可见。请记住，您所做的更改仅适用于以后添加到目录的计算机。现有计算机保持不变。

    • 在虚拟机页面上，更改要创建计算机的计算机大小和可用区。

      注意：

      • 仅显示目录支持的计算机大小。
      • 如有必要，选择仅显示其他计算机目录中使用的计算机大小以筛选计算机大小列表。

    • 在计算机配置文件页面上，选择是使用还是更改计算机配置文件。

    • （仅当目录配置了专用组主机时可见）在专用主机组页面上，选择是否更改主机组。

    • 在存储和许可证类型页面上，选择是否更改存储类型、许可证类型和 Azure 计算机库设置（仅当正在使用将准备好的映像放置在 Azure 库中时可用）。

    注意：

    如果新选择的设置不支持当前计算机大小，则会出现警告对话框，通知您更改设置将重置计算机大小设置。如果您选择继续，虚拟机菜单旁边会出现一个红点，提示您选择新的计算机大小。

    • 在许可证类型页面上，选择是否更改 Windows 许可证或 Linux 许可证设置。

    对于远程电脑访问目录，以下页面可见：

    • 在“电源管理”页面上，更改电源管理设置并选择电源管理连接。
    • 在“组织单位”页面上，添加或删除 Active Directory OU。
  6. 单击“应用”以应用所做的更改，然后单击“保存”以退出。

重命名目录

  1. 请登录到 Web Studio 界面。
  2. 在左侧窗格中选择“计算机目录”。
  3. 选择一个目录，然后在操作栏中选择“重命名计算机目录”。
  4. 输入新名称。

将目录移动到其他区域

如果您的部署包含多个区域，则可以将目录从一个区域移动到另一个区域。

将目录移动到除包含该目录中 VM 的管理程序之外的其他区域会影响性能。

  1. 请登录到 Web Studio 界面。
  2. 在左侧窗格中选择“计算机目录”。
  3. 选择一个目录，然后在操作栏中选择“移动”。
  4. 选择要将目录移动到的区域。

删除目录

在删除目录之前，请确保：

  • 所有用户均已注销，并且没有断开连接的会话正在运行。
  • 目录中的所有计算机均已启用维护模式，以便无法建立新连接。
  • 目录中的所有计算机均已关机。
  • 该目录未与任何交付组关联。换句话话说，该交付组不包含来自此目录的任何计算机。

要删除目录：

  1. 请登录到 Web Studio 界面。
  2. 在左侧窗格中选择 计算机目录。
  3. 选择一个目录，然后在操作栏中选择 Delete Machine Catalog。
  4. 指示是否删除目录中的计算机。如果选择删除计算机，请指示是保留、禁用还是删除这些计算机的 Active Directory 计算机帐户。

管理目录中的 Active Directory 计算机帐户

要管理计算机目录中的 Active Directory 帐户，您可以：

  • 通过从单会话操作系统和多会话操作系统目录中删除 Active Directory 计算机帐户来释放未使用的计算机帐户。然后，这些帐户可用于其他计算机。
  • 添加帐户，以便在将更多计算机添加到目录时，计算机帐户已就绪。请勿在 OU 名称中使用正斜杠 (/)。

要管理活动目录帐户：

  1. 登录到 Web Studio 控制台。
  2. 在左侧窗格中选择计算机目录。
  3. 选择一个目录，然后在操作栏中选择管理 AD 帐户。

  4. 选择是添加还是删除计算机帐户。如果添加帐户，请指定如何处理帐户密码：要么全部重置，要么输入一个适用于所有帐户的密码。

    如果您不知道当前帐户密码，则可以重置密码；您必须具有执行密码重置的权限。输入密码时，密码会在帐户导入时更改。删除帐户时，选择 Active Directory 中的帐户是保留、禁用还是删除。

指示当您从目录中删除计算机或删除目录时，Active Directory 帐户是保留、禁用还是删除。

更新目录

建议您在更新目录中的计算机之前保存主映像的副本或快照。数据库会保留每个计算机目录所用主映像的历史记录。回滚或还原目录中的计算机以使用主映像的先前版本。如果用户遇到您部署到其桌面的更新问题，请执行此任务。这可以最大程度地减少用户停机时间。请勿删除、移动或重命名主映像。您无法还原目录以使用它们。

计算机更新后，会自动重新启动。

更新或创建主映像

在更新计算机目录之前，请更新现有主映像或在主机管理程序上创建一个主映像。

  1. 在您的管理程序上，为当前 VM 创建快照并为快照指定一个有意义的名称。如果需要，此快照可用于还原（回滚）目录中的计算机。
  2. 如有必要，请启动主映像并登录。
  3. 安装更新或对主映像进行任何必要的更改。
  4. 关闭虚拟机电源。
  5. 为虚拟机创建快照。为其指定一个有意义的名称，以便在 Web Studio 中更新目录时可以识别。尽管 Web Studio 可以创建快照，但 Citrix 建议您使用虚拟机管理程序管理控制台创建快照。然后在 Web Studio 中选择该快照。此过程使您能够提供有意义的名称和描述，而不是自动生成的名称。对于 GPU 主映像，您只能通过 XenServer® 控制台更改主映像。

更改主映像版本

要准备并将更新推出到目录中的所有计算机：

  1. 请登录到 Web Studio 界面。
  2. 在左侧窗格中选择 计算机目录。
  3. 选择一个目录，然后在操作栏中选择 Change Master Image。
  4. 在 Master Image 页面上，选择要推出的主机和映像。

    提示：

    对于 MCS 创建的目录，您可以通过为映像添加备注来注释其映像。备注最多可包含 500 个字符。每次更改主映像时，无论是否添加备注，都会创建一个与备注相关的条目。如果您在未添加备注的情况下更新目录，则该条目显示为 null (-)。要查看映像的备注历史记录，请选择目录，单击底部窗格中的 Template Properties，然后单击 View note history。

  5. 在 Rollout Strategy 页面上，选择何时使用新的主映像更新计算机目录中的计算机：在下次关机时或立即更新。

    注意：

    推出策略页面不适用于持久性虚拟机，因为推出仅适用于非持久性虚拟机。

  6. 验证 Summary 页面上的信息，然后单击 Finish。每台计算机更新后会自动重新启动。

要跟踪更新进度，请在计算机目录中找到该目录，以查看内联进度条和分步进度图。

当直接使用 PowerShell SDK 而非 Web Studio 更新目录时，请指定一个虚拟机管理程序模板 (VMTemplates)。将其用作映像或映像快照的替代方案。

推出策略：

在下次关机时更新映像将立即影响所有当前未使用的计算机，即没有活动用户会话的计算机。正在使用的系统将在当前活动会话结束时接收更新。请考虑以下事项：

  • 在新会话启动之前，必须先在适用的计算机上完成更新。
  • 对于单会话操作系统计算机，当计算机未使用或用户未登录时，计算机将立即更新。
  • 对于具有子计算机的多会话操作系统，不会自动重新启动。要应用更新后的主映像，请使用 Studio、PowerShell 或 Workspace 重新启动计算机。从计算机或虚拟机管理程序重新启动不会应用更新。

提示：

通过使用主机连接的高级设置来限制正在重新启动的计算机数量。使用这些设置可以修改给定目录所采取的操作；高级设置因虚拟机管理程序而异。

回滚主映像的更改

推出更新或新的主映像后，可以将其回滚。如果新更新的计算机出现问题，则可能需要此过程。回滚时，目录中的计算机将回滚到上次正常工作的映像。需要较新映像的任何新功能将不再可用。与推出一样，回滚计算机包括重新启动。

  1. 请登录到 Web Studio 界面。
  2. 在左侧窗格中选择计算机目录。
  3. 选择目录，然后在操作栏中选择回滚主映像。
  4. 指定何时将较早的主映像应用到计算机，如上一节中针对推出操作所述。

回滚仅应用于需要恢复的计算机。未通过新的或更新的主映像进行更新的计算机不会收到通知消息，也不会被强制注销。

要跟踪回滚进度，请在 计算机目录 中找到该目录，以查看内联进度条和分步进度图。

更改功能级别或撤销所做的更改

在将计算机上的 VDA 升级到较新版本后，更改计算机目录的功能级别。Citrix 建议将所有 VDA 升级到最新版本，以启用对所有最新功能的访问。

在更改计算机目录的功能级别之前：

  • 启动已升级的计算机，使其向控制器注册。此过程允许 Web Studio 确定目录中的计算机需要升级。

若要更改目录的功能级别，请执行以下步骤：

  1. 请登录到 Web Studio 界面。
  2. 在左侧窗格中选择 计算机目录。
  3. 选择目录。下部窗格中的 详细信息 选项卡显示版本信息。
  4. 选择 更改功能级别。如果 Web Studio 检测到目录需要升级，它会显示一条消息。按照提示操作。如果一台或多台计算机无法升级，则会显示一条消息解释原因。为确保所有计算机正常运行，Citrix 建议您在单击 更改 继续之前解决计算机问题。

目录更改完成后，您可以通过选择目录，然后在操作栏中选择 撤消功能级别更改 来将计算机恢复到其以前的 VDA 版本。

克隆目录

在克隆目录之前，请注意以下几点注意事项：

  • 您无法更改与 操作系统 和 计算机管理 相关的设置。克隆的目录会从原始目录继承这些设置。
  • 克隆目录可能需要一些时间才能完成。如有必要，选择 隐藏进度 以在后台运行克隆。
  • 克隆的目录继承原始目录的名称并带有后缀 Copy。您可以更改名称。请参阅 重命名目录。
  • 克隆完成后，请务必将克隆的目录分配给交付组。
  1. 登录 Web Studio，然后在左侧窗格中选择 计算机目录。
  2. 选择一个目录，然后在操作栏中选择 克隆。
  3. 在 克隆选定的计算机目录 窗口中，查看克隆目录的设置并根据需要配置设置。选择 下一步 以继续到下一页。
  4. 在 摘要 页面上，查看设置摘要并选择 完成 以开始克隆。
  5. 如有必要，选择 隐藏进度 以在后台运行克隆。

使用文件夹组织目录

您可以创建文件夹来组织目录，以便于访问。例如，您可以按映像类型或组织结构来组织目录。

创建目录文件夹

在开始之前，请首先规划如何组织目录。请考虑以下事项：

  • 您可以将文件夹嵌套最多五层（不包括默认根文件夹）。
  • 目录文件夹可以包含目录和子文件夹。
  • Web Studio 中的所有节点（例如 计算机目录 和 应用程序 节点）在后端共享一个文件夹树。为避免在重命名或移动文件夹时与其他节点发生名称冲突，建议您为不同节点中的一级文件夹指定不同的名称。

要创建目录文件夹，请按照以下步骤操作：

  1. 在左侧窗格中选择“计算机目录”。
  2. 在文件夹层次结构中，选择一个文件夹，然后在“操作”栏中选择“创建文件夹”。
  3. 输入新文件夹的名称，然后单击“完成”。

提示：

如果将文件夹创建在意外位置，可以将其拖动到正确位置。

移动目录

您可以在文件夹之间移动目录。详细步骤如下：

  1. 在左侧窗格中选择“计算机目录”。
  2. 按文件夹查看目录。您还可以打开文件夹层次结构上方的“查看所有”以一次性查看所有目录。
  3. 右键单击目录，然后选择“移动计算机目录”。
  4. 选择要将目录移动到的文件夹，然后单击“完成”。

提示：

您可以将目录拖动到文件夹。

管理目录文件夹

您可以删除、重命名和移动目录文件夹。

只有当文件夹及其子文件夹不包含目录时，才能删除该文件夹。

要管理文件夹，请执行以下步骤：

  1. 在左侧窗格中选择 计算机目录。

  2. 在文件夹层次结构中，选择一个文件夹，然后根据需要选择 操作 栏中的一个操作：

    • 要重命名文件夹，请选择 重命名文件夹。
    • 要删除文件夹，请选择 删除文件夹。
    • 要移动文件夹，请选择 移动文件夹。
  3. 请按照屏幕上的指示完成剩余的步骤。

Use PowerShell

本节详细介绍了如何使用 PowerShell 管理目录：

  • 检索与目录关联的警告和错误
  • 向映像添加描述
  • 重置操作系统磁盘
  • 更改现有预配方案的网络设置
  • 管理计算机目录版本(/zh-cn/citrix-virtual-apps-desktops/2311/install-configure/machine-catalogs-manage.html#manage-versions-of-a-machine-catalog)
  • 将非计算机配置文件型计算机目录转换为计算机配置文件型计算机目录(/zh-cn/citrix-virtual-apps-desktops/2311/install-configure/machine-catalogs-manage.html#convert-a-non-machine-profile-based-machine-catalog-to-machine-profile-based-machine-catalog)
  • 修复活动计算机帐户的身份信息(/zh-cn/citrix-virtual-apps-desktops/2311/install-configure/machine-catalogs-manage.html#repair-the-identity-information-of-active-computer-accounts)
  • 更改现有计算机目录上的缓存配置(/zh-cn/citrix-virtual-apps-desktops/2311/install-configure/machine-catalogs-manage.html#change-cache-configuration-on-an-existing-machine-catalog)

获取与某个目录相关联的警告和错误信息

您可以获取历史错误和警告，以了解 MCS 计算机目录的问题并修复这些问题。

使用 PowerShell 命令，您可以执行以下操作：

  • 获取错误或警告列表
  • 将警告状态从 新建 更改为 已确认
  • 删除这些错误或警告

要运行 PowerShell 命令，请执行以下操作：

  1. Open a PowerShell window.
  2. Run asnp citrix* to load the Citrix-specific PowerShell modules.

要获取错误和警告列表：

运行 Get-ProvOperationEvent 命令。

  • 无参数：获取所有错误和警告
  • 带有 LinkedObjectType 和 LinkedObjectUid 参数：获取与特定预配方案关联的所有错误和警告
  • 带有 EventId 参数：获取与此事件 ID 匹配的特定错误或警告
  • 带有 Filter 参数：按自定义筛选器获取错误或警告

要将错误或警告的状态从 新建 更改为 已确认：

运行 Confirm-ProvOperationEvent 命令。

  • 带有 EventId 参数：设置与此事件 ID 匹配的特定错误或警告的状态。您可以从 Get-ProvOperationEvent 命令的输出中获取特定错误或警告的 EventId
  • 带有 LinkedObjectType 和 LinkedObjectUid 参数：设置与特定预配方案关联的所有错误和警告的状态
  • 带有 All 参数：将所有错误和警告的状态设置为 已确认

要删除错误或警告：

运行 Remove-ProvOperationEvent 命令。

  • 带有 EventId 参数：删除与此事件 ID 匹配的特定错误或警告。您可以从 Get-ProvOperationEvent 命令的输出中获取特定错误或警告的 EventId
  • 带有 LinkedObjectType 和 LinkedObjectUid 参数：删除与特定预配方案关联的所有错误和警告
  • 带有 All 参数：删除所有错误和警告

有关详细信息，请参阅 Citrix PowerShell 开发工具包。

向映像添加描述

您可以添加有关计算机目录映像更新相关更改的描述性信息。此功能可用于在创建目录时或更新目录的现有主映像时添加描述。您还可以显示目录中每个主映像的信息。使用以下命令添加或查看映像描述：

  • 要在使用主映像创建计算机目录时添加备注，请在 NewProvScheme 命令中使用参数 MasterImageNote。例如：

     C:\PS>New-ProvScheme -ProvisioningSchemeName <name> -HostingUnitName <name> -IdentityPoolName <name> -MasterImageVM
 XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\Base.snapshot -MasterImageNote "Note"
 <!--NeedCopy-->

  • 要更新与计算机目录关联的主映像，请在 Publish-ProvMasterVMImage 命令中使用参数 MasterImageNote。例如：

     C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName <name> -MasterImageVM XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\base.snapshot -MasterImageNote "Note"
 <!--NeedCopy-->

  • 若要显示每个映像的详细信息，请使用名为 Get-ProvSchemeMasterVMImageHistory 的命令。例如：

     C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall
 <!--NeedCopy-->

要跟踪回滚进度，请在计算机目录中找到该目录，以查看内联进度条和分步进度图。

在某些情况下无法回滚，包括以下情况。（回滚主映像选项不可见）。

  • 您没有执行回滚操作的权限。
  • 目录不是使用 MCS 创建的。
  • 目录是使用操作系统磁盘映像创建的。
  • 用于创建目录的快照已遭到数据损坏。
  • 用户对目录中计算机的更改不会保留。
  • 目录中的计算机正在运行。

重置操作系统磁盘

使用 PowerShell 命令 Reset-ProvVMDisk 重置 MCS 创建的计算机目录中持久性 VM 的操作系统磁盘。目前，此功能适用于 AWS、Azure、XenServer、Google Cloud、SCVMM 和 VMware 虚拟化环境。

要成功运行 PowerShell 命令，请确保：

  • 目标 VM 位于持久性 MCS 目录中。
  • MCS 计算机目录正常运行。
  • 这意味着预配方案和主机存在，并且预配方案具有正确的条目。
  • 管理程序未处于维护模式。
  • 目标 VM 已关机并处于维护模式。

执行以下步骤以重置操作系统磁盘：

  1. 打开一个 PowerShell 命令行窗口。
  2. Run asnp citrix* to load the Citrix-specific PowerShell modules.

  3. 通过以下任一方式运行 PowerShell 命令 Reset-ProvVMDisk：

    • 将 VM 列表指定为逗号分隔列表，并对每个 VM 执行重置：

       Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS
 <!--NeedCopy-->

    • 将 VM 列表指定为 Get-ProvVM 命令的输出，并对每个 VM 执行重置：

       (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS
 <!--NeedCopy-->

    • 按名称指定单个 VM：

       Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
 <!--NeedCopy-->

    • 为 Get-ProvVM 命令返回的每个 VM 创建单独的重置任务。这种方式效率较低，因为每个任务都会执行相同的冗余检查，例如管理程序功能检查、每个 VM 的连接检查。

       Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
 <!--NeedCopy-->

  4. 将出现一个确认提示，其中列出了要重置的 VM，并附带一条警告消息，指出这是一个不可恢复的操作。如果您不提供答案并按 Enter，则不会执行任何进一步操作。

    注意：

    在重置过程完成之前，请勿将虚拟机移出维护模式或将其开机。

    您可以运行 PowerShell 命令 -WhatIf 来打印它将执行的操作，然后退出而不执行该操作。

    您还可以通过以下任一方法来绕过确认提示：

    • 提供 -Force 参数：

       Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force
 <!--NeedCopy-->

    • 提供 -Confirm:$false 参数：

       Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
 <!--NeedCopy-->

    • 在运行 Reset-ProvVMDisk 之前，将 $ConfirmPreference 更改为 None：

       PS C:\Windows\system32> $ConfirmPreference='None'
 PS C:\Windows\system32> $ConfirmPreference
 None
 PS C:\Windows\system32> Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
 <!--NeedCopy-->
  5. 运行 Get-ProvTask 以获取 Reset-ProvVMDisk 命令返回的任务状态。

对现有预配方案的网络设置进行修改

您可以更改现有预配方案的网络设置，以便在新子网上创建新的虚拟机。在 Set-ProvScheme 命令中使用参数 -NetworkMapping 来更改网络设置。

注意：

此功能在 Citrix 虚拟应用和桌面产品 2203 LTSR CU3 及更高版本中受支持。

要更改现有预配方案的网络设置，请执行以下操作：

  1. 在 PowerShell 命令行窗口中，运行命令 asnp citrix* 以加载 PowerShell 的相关模块。
  2. 运行 (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps 以获取要更改的网络路径。

  3. 将变量分配给新的网络设置。例如：

    $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
<!--NeedCopy-->
  4. 运行 Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap。
  5. 运行 (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps 以验证现有预配方案的新网络设置。

管理计算机目录版本

当 MCS 计算机目录使用 Set-ProvScheme 命令更新时，当前配置将保存为一个版本。然后，您可以使用 PowerShell 命令管理计算机目录的各个版本。您可以：

  • 查看计算机目录的版本列表
  • 使用任何以前的版本更新计算机目录
  • 如果某个版本未被该计算机目录的 VM 使用，则手动删除该版本
  • 更改计算机目录保留的最大版本数（默认为 99）

一个版本包含有关计算机目录的以下信息：

  • 虚拟机CPU数量
  • 虚拟机内存（MB）
  • 自定义属性
  • 服务产品
  • 计算机配置文件
  • 网络映射
  • 安全群组

运行以下命令（作为示例提供）以管理计算机目录的各个版本。

  • 要查看计算机目录各个版本的配置详细信息：

     Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog
 <!--NeedCopy-->

  • 要查看计算机目录特定版本的配置详细信息：

     Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2
 <!--NeedCopy-->

  • 若要查看与计算机目录关联的版本总数：

    ``` (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count

  • 要使用任何以前的版本更新计算机目录：

     Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2

  • 如果某个版本未被该计算机目录的任何虚拟机使用，则手动删除该版本：

     Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3

  • 要设置计算机目录要保留的最大版本数（默认为 99）。此设置应用于所有目录。例如，在此情况下，所有 MCS 预配的目录将最多保留 15 个版本。

     Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15

如果版本数达到最大版本数，并且计算机目录中的任何虚拟机正在使用旧版本，则无法创建新版本。在这种情况下，请执行以下操作之一：

  • 对计算机目录可保留的最大版本数量的限制进行提高。
  • 更新使用旧版本的一些虚拟机，以便这些旧版本不再被任何虚拟机引用，并且可以删除。

将非计算机配置文件型计算机目录转换为计算机配置文件型计算机目录

您可以使用虚拟机、模板规范（对于 Azure）或启动模板（对于 AWS）作为计算机配置文件输入，将非计算机配置文件型计算机目录转换为计算机配置文件型计算机目录。添加到目录的新虚拟机将从计算机配置文件中获取属性值，除非被显式自定义属性覆盖。

注意：

现有的基于计算机配置文件的计算机目录无法更改为非基于计算机配置文件的计算机目录。

为此：

  1. 创建一个包含 VM 且不带计算机配置文件的持久或非持久计算机目录。
  2. 打开 PowerShell 命令行窗口。

  3. 运行 Set-ProvScheme 命令，将计算机配置文件中的属性值应用于添加到计算机目录的新 VM。例如：

    • 在 Azure 的情况下：

       Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits\<HostingUnitName>\machineprofile.folder\<ResourceGroupName>\<TemplateSpecName>\<VersionName>

    • 对于 AWS：

       Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\<launch-template>.launchtemplate\<launch-template-version>.launchtemplateversion"

修复活动计算机帐户的身份识别信息

您可以重置存在身份相关问题的活动计算机帐户的身份信息。您可以选择仅重置计算机密码和信任密钥，或重置身份磁盘的所有配置。此实现适用于持久和非持久 MCS 计算机目录。

注意：

目前，此功能仅支持 Azure 和 VMware 虚拟化环境。

前提条件

确保满足以下条件才能成功重置身份磁盘：

  • 关闭 VM 并将其设置为维护模式
  • 不要在 PowerShell 命令中包含参数 -OS

重置身份磁盘

要重置身份磁盘：

  1. Open the PowerShell window.
  2. 运行 asnp citrix* 以加载 思杰 特定的 PowerShell 模块。

  3. 执行身份信息重置操作。

    • 要仅重置计算机密码和信任密钥，请运行以下命令：

       Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo

      关于命令中使用的各项参数，其说明如下：

      • IdentityAccountName：必须修复的身份帐户的名称。
      • PrivilegedUserName：对身份提供程序（AD 或 AzureAD）具有写入权限的用户帐户。
      • PrivilegedUserPassword: 特权用户的密码。
      • Target：修复操作的目标。它可以是 IdentityInfo，用于修复帐户密码/信任密钥；也可以是 UserCertificate，用于修复混合 AzureAD 加入的计算机身份的用户证书属性。

    • 要重置身份磁盘的所有配置，请按以下顺序运行以下命令：

       Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo


       Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity

    • 要完全重新创建身份磁盘：

       Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate

  4. 键入 y 以确认操作。您也可以使用 -Force 参数跳过确认提示。例如：

    Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force
  5. 运行 Get-ProvVM -ProvisioningSchemeName <name -VMName <name> 以检查更新的身份磁盘设置。身份磁盘的属性（例如，IdentityDiskId）必须更新。StorageId 和 IdentityDiskIndex 不得更改。

更改现有计算机目录上的缓存配置

创建启用了 MCSIO 的非持久性目录后，可以使用 Set-ProvScheme 命令修改以下参数：

  • 回写缓存内存大小
  • 回写缓存磁盘大小

此功能目前适用于以下情况：

  • 谷歌云平台和微软 Azure 环境，以及
  • 启用了 MCSIO 的非持久性目录

必备条件

修改缓存配置的必备条件如下：

  • 更新到最新版本的 VDA（2308 或更高版本）。

  • 为现有计算机目录启用参数 UseWriteBackCache。使用 New-ProvScheme 创建启用了 UseWriteBackCache 的计算机目录。例如：

     New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
 -IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot `
 -MasterImageVM $MasterImage `
 -ServiceOffering $ServiceOffering `
 -NetworkMap $NetworkMap `
 -SecurityGroup $SecurityGroup `
 -UseWriteBackCache -WriteBackCacheDiskSize 8

对缓存配置进行更改

Run the Set-ProvScheme command. For example:

Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128

注意：

  • WriteBackCacheDiskSize 的值必须大于零，因为至少需要 1 GB 的缓存磁盘存储。
  • WriteBackCacheMemorySize 的值必须小于计算机目录内存大小。
  • 这些更改仅影响在更改后添加到目录的新 VM。现有 VM 不受这些更改的影响。

故障排除

后续步骤

有关管理特定云服务目录的信息，请参阅：

管理计算机目录
June 2, 2026
投稿者: 
C C
June 2, 2026
投稿者: 
C C

在本文中

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