产品文档
Citrix DaaS™
查看 PDF

管理 Nutanix 目录

August 20, 2026
投稿者: 
C C

管理计算机目录 介绍了管理计算机目录的向导。以下信息涵盖了 Nutanix AHV Prism Central 环境特有的详细信息。

注意：

在 Nutanix AHV Prism Central 上管理计算机目录之前，您需要完成在 Nutanix AHV Prism Central 上创建计算机目录。请参阅创建 Nutanix 目录。

您可以使用以下方式在 Nutanix AHV Prism Central 上管理计算机目录：

使用 Studio

以下是使用 Studio 在 Nutanix AHV Prism Central 上管理计算机目录的选项：

选项 描述
添加计算机 创建虚拟机并将其添加到计算机目录。
删除计算机目录 删除计算机目录。您可以选择同时删除虚拟机，或保留持久性虚拟机不变。
更改主映像 更改用作目录中所有 VM 模板的主映像。
添加或更改计算机配置文件 更改计算机配置文件的模板版本，或将计算机配置文件添加到现有目录。
管理配置集 将目录绑定到 Workspace Environment Management™ 配置集，或切换到其他配置。
编辑计算机目录 修改目录的配置，例如 NIC 和虚拟机。
查看计算机 跳转到“搜索”节点以查看属于该目录的所有 VM。
重命名计算机目录 更改目录名称。
升级 VDA 按目录升级 VDA。此功能仅适用于静态持久性计算机。
更改功能级别 选择目录的最低功能级别。设置功能级别可使所有功能可用。
测试计算机目录 测试目录是否存在错误或警告。
管理标签 创建、编辑和删除标签。选择要应用于目录的标签。
移动计算机目录 将目录移动到另一个文件夹。

注意：

当前，克隆选项不可用。

更改主映像

要更改目录的主映像，请执行以下步骤：

  1. 在计算机目录页面上，右键单击要更新的计算机目录，然后选择更改主映像。

  2. 在更改主映像页面上，单击选择映像。

    AHV Prism Central 主机连接

  3. 在选择映像页面上，展开模板并选择要用作主映像的模板版本。您可以按名称筛选计算机模板。
  4. 在推出策略页面上，选择您希望何时应用更新。

注意：

  • 对于使用 Nutanix AHV Prism Central 主机连接插件的 MCS 预配的非持久性目录，更新主映像以在 Legacy 和 UEFI 之间切换启动配置，会阻止现有 VM 在下次启动时启动。
  • 更新主映像时，仅更新操作系统磁盘。硬件属性保持不变。要更新硬件属性，请参阅添加或更改计算机配置文件、更改网卡和更改 VM 配置。

添加或更改计算机配置文件

要为目录添加或更改计算机配置文件，请执行以下步骤：

  1. 在计算机目录页面上，右键单击要修改的计算机目录，然后选择编辑计算机目录。

  2. 在计算机配置文件页面上，

    • 如果计算机目录已有计算机配置文件，请单击铅笔图标以选择其他计算机配置文件模板版本。您可以按模板名称进行筛选。确认计算机配置文件设置。
    • 如果计算机目录没有计算机配置文件，请选择“使用计算机配置文件”并选择一个计算机配置文件。确认计算机配置文件设置。
  3. 虚拟机页面必须反映根据所选计算机配置文件模板版本更新的配置。

更改网卡

要更改目录的网卡，请执行以下步骤：

  1. 在计算机目录页面上，右键单击要修改的计算机目录，然后选择编辑计算机目录。

  2. 在网卡页面上：

    • 选择一个 NIC 类型。

    • 如果所选目录是使用计算机配置文件创建的，则 NIC 数量与计算机配置文件的 NIC 数量一致，且无法更改。为每个 NIC 选择一个关联的虚拟网络。

      带有机器配置文件的 AHV Prism Central 网卡

    • 如果所选目录不是使用计算机配置文件创建的，请单击 添加 NIC 以增加 NIC 数量，或单击 删除 以删除选定的 NIC。选中或清除复选框以选择 NIC，并为每个 NIC 选择一个关联的虚拟网络。

      不带机器配置文件的 AHV Prism Central 网卡

更改 VM 配置

要更改 VM 的配置（包括内存、CPU 计数和每个 vCPU 的核心数），请执行以下步骤：

  1. 在 计算机目录 页面上，右键单击要修改的计算机目录，然后选择 编辑计算机目录。

  2. 在 虚拟机 页面上，使用向上或向下箭头，或直接输入值来调整 VM 的内存、CPU 计数和每个 vCPU 的核心数。

    AHV Prism Central 主机连接

使用 PowerShell

更改主映像

所需参数为：

  • ProvisioningSchemeName：要编辑的预配方案的名称。
  • MasterImage：新主映像的字面路径。

运行以下命令。例如：

Set-ProvSchemeMetadata  -Name "ImageManagementPrep_DoImagePreparation" -ProvisioningSchemeName "<ProvisioningSchemeName>" -Value "True"

Publish-ProvMasterVMImage  -MasterImageVM "<Literal path to the new master image- template version> -ProvisioningSchemeName "<ProvisioningSchemeName>" -RunAsynchronously
<!--NeedCopy-->

注意：

更新主映像时，仅更新操作系统磁盘。硬件属性保持不变。要更新硬件属性，请参阅添加或更改计算机配置文件、更改 NIC和更改 NIC 和 VM 配置。

添加或更改计算机配置文件

使用 Set-ProvScheme 命令：

  • 使用新的计算机配置文件更新目录，或
  • 更新没有计算机配置文件的现有目录，以开始使用计算机配置文件作为硬件规范的来源。

注意：

这不会更新目录中现有 VM 的硬件规范。只有添加到目录中的新 VM 才具有给定计算机配置文件中的硬件规范。

要更改计算机配置文件或将现有目录转换为开始使用计算机配置文件：

Set-ProvScheme -ProvisioningSchemeName <ProvScheme Name> `
               -MachineProfile "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
               -NetworkMapping @{"0"="XDHyp:\HostingUnits\<Hosting unit name>\Clusters.folder\<Cluster Name>.cluster\<Network name>.network"}
<!--NeedCopy-->

计算机配置文件必须至少有一个 NIC，并且计算机配置文件中的 NIC 数量必须与 NetworkMapping 中的子网映射匹配。

模板版本的 NIC 总数可以从其清单项的 AdditionalData 中使用以下方法获取：

$tv = Get-Item -Path "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
$tv.AdditionalData.TotalNics
<!--NeedCopy-->

要更改具有覆盖硬件规范的计算机配置文件：

某些配置可以使用特定的命令行参数进行配置。这些命令行参数（例如 VMCpuCount 和 VMMemoryMB 以及 CPUCores 在 CustomProperties 中）优先于计算机配置文件模板版本中的值。

$customProperties = @"
    <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <StringProperty Name="ClusterId" Value="00062c63-1fb0-58c9-4fc8-5c2573352378" />
        <StringProperty Name="CPUCores" Value="2" />
    </CustomProperties>
"@

Set-ProvScheme -ProvisioningSchemeName <ProvScheme Name> `
               -MachineProfile "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion" `
               -CustomProperties $customProperties `
               -VMCpuCount 4 `
               -VMMemoryMB 4096
<!--NeedCopy-->

更改 NIC 和 VM 的配置

所需的参数包括：

  • ProvisioningSchemeName：要编辑的预配方案的名称。
  • NetworkMapping：更新的网络映射。

运行以下命令。例如：

Set-ProvScheme  -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"ClusterId`" Value=`"000xxxx-1fb0-xxxxx-4fc8-5c257335xxxx`" /><Property xsi:type=`"StringProperty`" Name=`"CPUCores`" Value=`"1`" /></CustomProperties>"  -NetworkMapping @{"6"="XDHyp:\HostingUnits\<Hosting Unit Name>\Clusters.folder\<Cluster Name>\<Network name>.network"} -ProvisioningSchemeName "<ProvisioningSchemeName>" -VMCpuCount 4
<!--NeedCopy-->

重置持久性 VM 的操作系统磁盘

重置持久性 VM（尤其是启用了 vTPM 的 VM）中的操作系统磁盘可能会破坏依赖 vTPM 密钥和 BitLocker 的应用程序，从而可能导致无法启动。因此，此功能允许：

  • 重置持久性 VM 的操作系统磁盘并保留 VM 硬件配置。
  • 管理已启用 vTPM 的 VM，以避免在磁盘交换期间破坏 vTPM 依赖项。

您可以使用 Reset-ProvVMDisk PowerShell 命令重置持久性 VM 的操作系统磁盘。

  • 对于已启用 vTPM 的 VM：使用原始硬件信息从恢复点创建新的 VM，从而保留 vTPM 密钥。
  • 对于未启用 vTPM 的 VM：替换操作系统磁盘。

有关示例，请参阅重置操作系统磁盘。

将计算机目录迁移到 Citrix 管理的 Nutanix AHV Prism Central 主机连接

将您的 Citrix 计算机目录及其关联的 VM 从现有的 Nutanix AHV（适用于 Prism Element）和 Nutanix AHV PC（适用于 Azure 上的 NC2）主机连接迁移到 Citrix 管理的 Nutanix AHV Prism Central 主机连接。对于迁移，请使用 PowerShell 命令，这些命令还包括在出现问题时的快速回滚选项，以及在迁移后清理源资源的命令。

优势

  • 中断最小化：您可以顺利过渡到 Nutanix AHV Prism Central 插件。这对您现有的部署影响最小。
  • 无缝升级路径：它为您升级基础架构并利用新的管理界面提供了清晰且受支持的路径。
  • 数据完整性和安全性：回滚选项可确保在出现不可预见的问题时将环境恢复到其原始状态。这降低了风险。
  • 资源效率：成功迁移后，您可以清理源资源。这优化了存储和管理开销。
  • 灵活性：它支持由 MCS 和第三方技术预配的目录的迁移。这提供了更广泛的适用性。

适用性

此功能适用于 Nutanix AHV（适用于 Prism Element）和 Nutanix AHV PC（适用于 Azure 上的 NC2）主机连接下的计算机目录：

  • 由 MCS 管理的计算机目录，包括持久类型和非持久类型。
  • 仅限电源管理的计算机目录，其中包含由第三方技术预配的 VM。

系统要求

  • Nutanix AHV Prism Element (PE) AOS 版本：您需要最低 6.8 版本。
  • Nutanix Prism Central (PC) 版本：您需要最低 2024.3 版本。

注意：

Nutanix Prism Central 7.3 由于 Nutanix 已知问题，需要 AOS 7.3。

限制

  • 不支持 PVS 目录：此功能不支持使用 Citrix Provisioning Services (PVS) Xendesktop 安装向导创建的计算机目录。
  • 回滚限制：
    • 仅当您在初始迁移后未修改目录时，才允许回滚已迁移的目录。
    • 当您执行“清理源资源”操作时，它会清除迁移状态。这会阻止任何后续回滚。
  • 不可重新迁移：已迁移的计算机目录不支持重新迁移。
  • 多主机连接虚拟机：不支持迁移包含从多个主机连接导入的虚拟机的仅限电源管理的计算机目录。

重要注意事项

  • Nutanix 群集管理：托管 Nutanix AHV 群集必须注册到 Nutanix Prism Central。
  • 主映像模板创建：对于 MCS 计算机目录，迁移命令提供了一个选项，可用于从计算机目录主映像的原始快照在 Prism Central 上生成虚拟机模板版本。此虚拟机模板版本以后可用作 Prism Central 主机连接下计算机目录的 MCS 主映像。默认情况下，此选项未启用。
  • 回滚先决条件：
    为了能够成功回滚，原始源环境（包括主机连接、基本磁盘）必须保持不变。在确认迁移成功之前，您还必须避免对已迁移的计算机目录进行任何配置更改以及添加/删除虚拟机。 确认后，您可以执行最终的“清理源资源”操作，但请注意，这是一个不可逆的步骤，将使回滚无法进行。

迁移和回滚所需的权限

要迁移目录或回滚，您需要以下权限：

Prism Element 管理员：

  • 创建虚拟机

Prism Central 管理员：

  • 创建 VM 模板
  • 删除 VM 模板
  • 删除 VM 恢复点
  • 删除虚拟机

有关 Citrix 管理的 Nutanix AHV Prism Central 主机连接所需的特定权限的完整列表，请参阅所需权限。

如何迁移

您可以通过专用 PowerShell cmdlet 管理此功能。一般工作流程涉及三个主要操作：迁移、回滚和清理源资源。

迁移计算机目录

  • 此操作将计算机目录及其关联的 VM 从源 Nutanix AHV 或 Nutanix AHV PC 主机连接移动到目标 Citrix 管理的 Nutanix AHV Prism Central 主机连接。
  • 对于 MCS 预配的目录，此过程会在目标连接中创建新的基本磁盘。
  • 您可以选择从原始主映像快照在目标连接中创建主 VM 等效项（VM 模板版本）。
  1. 创建新的 Nutanix AHV Prism Central 主机连接：在迁移之前，将托管 Nutanix AHV 群集注册到 Nutanix Prism Central，并建立指向目标 Nutanix Prism Central 实例的新 Nutanix AHV Prism Central 主机连接。此连接用作迁移目录的目标。有关详细信息，请参阅Nutanix AHV Prism Central 主机连接。

  2. 迁移现有计算机目录：对于现有计算机目录，请使用 Switch-ProvCatalog PowerShell cmdlet 启动到 Citrix 管理的 Nutanix AHV Prism Central 主机连接的迁移。

    c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -DestinationHypervisorConnectionName "DestinationConnection" -DestinationHostingUnitName "DestinationUnit" -CreateMasterImageAtDestination
<!--NeedCopy-->
    • 将 <Catalog_UID> 替换为您希望迁移的计算机目录的唯一标识符。使用以下 PowerShell cmdlet 通过目录名称 Get-BrokerCatalog -Name <Catalog Name> 查找 BrokerCatalogUid。
    • DestinationConnection 是在步骤 1 中创建的新 Nutanix AHV Prism Central 主机连接的名称。
    • DestinationUnit 是您在 DestinationConnection 中为托管单元指定的名称，计算机目录将驻留在此托管单元中。
    • -CreateMasterImageAtDestination 参数是可选的。它会在目标 Prism Central 上创建主映像 VM 模板版本。

  3. 验证迁移完成情况：执行迁移 cmdlet 后，在 PowerShell 窗口中监视任务状态，确保其成功完成。迁移完成后，目录将移动到在步骤 1 中创建的目标主机连接。您必须看到任务类型为 SwitchProvCatalog 的“已完成”状态。以下是验证迁移完成情况的建议步骤：

    • 在 Studio 中检查目录的状态。
    • 验证目录中的 VM 现在是否与新的目标管理程序连接相关联。
    • 验证目录中的 VM 是否显示正确的电源状态。
    • 通过添加或删除计算机或执行电源操作来测试已迁移计算机目录的功能，确保目录正常运行。

回滚已迁移的目录

此操作会将计算机目录及其 VM 恢复到其原始源主机连接。它会删除您在迁移过程中创建的任何资源。

重要提示：

仅当您在迁移后未修改目录且未运行清理源资源操作时，才执行回滚。原始源连接保持不变，并且仍包含其基本磁盘。

c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -Rollback
<!--NeedCopy-->

清理源资源

成功迁移后，此操作会从原始管理程序连接中删除源资源，例如基本磁盘。

重要提示：

执行此命令时，它会清除迁移状态。这使得后续回滚变得不可能。

c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -CleanupSourceResources
<!--NeedCopy-->

在继续之前，您会收到一个确认提示，因为此操作不可逆。确认提示以完成清理。

更多信息

管理 Nutanix 目录
August 20, 2026
投稿者: 
C C
August 20, 2026
投稿者: 
C C

在本文中

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