Citrix Virtual Apps and Desktops

管理一个 Nutanix 目录

July 9, 2026

投稿者:

C C

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

注意：

在 Nutanix AHV Prism Central 上对计算机目录执行管理操作之前，您需要确保已经完成了在该 Nutanix AHV Prism Central 平台上创建计算机目录的整个过程。请参阅创建 Nutanix 目录。

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

Web 工作室
PowerShell

Use Web Studio

以下列出了使用 Web Studio 在 Nutanix AHV Prism Central 上管理计算机目录的可用选项：

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

注意：

目前，克隆选项不可用。

更改主映像

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

在计算机目录页面上，右键单击要更新的计算机目录，然后选择更改主映像。
在更改主映像页面上，单击选择映像。
在选择映像页面上，展开一个模板并选择要用作主映像的模板版本。您可以按名称筛选计算机模板。
在推出策略页面上，选择您希望何时应用更新。

注意：

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

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

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

在计算机目录页面上，右键单击要修改的计算机目录，然后选择编辑计算机目录。
在计算机配置文件页面上，
- 如果计算机目录已具有计算机配置文件，则单击铅笔图标以选择其他计算机配置文件模板版本。您可以按模板名称进行筛选。确认计算机配置文件设置。
- 如果计算机目录没有计算机配置文件，则选择“使用计算机配置文件”并选择一个计算机配置文件。确认计算机配置文件设置。
虚拟机页面必须反映根据所选计算机配置文件模板版本更新的配置。

更改 NIC

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

在计算机目录页面上，右键单击要修改的计算机目录，然后选择编辑计算机目录。
在NIC页面上：
1. 选择 NIC 类型
2. 选择或清除复选框以选择 NIC，并为每个 NIC 选择关联的虚拟网络。

更改虚拟机配置

要更改虚拟机的配置，包括内存、CPU 计数和每个 vCPU 的核心数，请按照以下步骤操作：

在计算机目录页面上，右键单击要修改的计算机目录，然后选择编辑计算机目录。
在虚拟机页面上，使用向上或向下箭头，或直接输入值来调整虚拟机的内存、CPU 计数和每个 vCPU 的核心数。

使用 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 和虚拟机配置。

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

使用 Set-ProvScheme 命令：

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

注意：

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

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

Set-ProvScheme -ProvisioningSchemeName <ProvScheme Name> `
               -MachineProfile "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
<!--NeedCopy-->

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

可以使用以下方法从其库存项目的 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，以及 CustomProperties 中的 CPUCores）优先于计算机配置文件模板版本中的值。

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

更改网卡和虚拟机的配置

所需的参数为：

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

重置持久性虚拟机的操作系统磁盘

重置持久性虚拟机中的操作系统磁盘，尤其是那些启用了 vTPM 的虚拟机，可能会破坏依赖 vTPM 密钥和 BitLocker 的应用程序，并可能阻止启动。因此，此功能允许：

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

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

对于已启用 vTPM 的虚拟机：使用原始硬件信息从恢复点创建新虚拟机，并保留 vTPM 密钥。
对于非 vTPM 虚拟机：操作系统磁盘将被替换。

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

将计算机目录进行迁移到由 Citrix 负责管理的 Nutanix AHV Prism Central 主机连接的具体配置

将您的 Citrix 计算机目录及其关联的虚拟机从现有的 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 管理的计算机目录，包括持久型和非持久型。
仅限电源管理的计算机目录，其中包含由第三方技术预配的虚拟机。

系统必备要求

Nutanix AHV Prism Element (PE) AOS Version: You require a minimum of 6.8.
Nutanix Prism Central (PC) 版本：您需要使用 2024.3 或更高版本才能满足要求。

注意：

Nutanix Prism Central 7.3 必须与 AOS 7.3 版本配套使用，因为 Nutanix 方面存在一个已知的技术问题。

限制事项

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

重要注意事项

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

在进行迁移和回滚操作时所需的权限

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

负责管理 Prism Element 的管理员：

Create Virtual Machine

Prism Central administrator:

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

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

如何迁移

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

迁移计算机目录

此操作将计算机目录及其关联的虚拟机从源 Nutanix AHV 或 Nutanix AHV PC 主机连接移动到目标 Citrix 管理的 Nutanix AHV Prism Central 主机连接。
对于 MCS 预配的目录，此过程会在目标连接中创建新的基础磁盘。
您可以选择从原始主映像快照在目标连接中创建等效的主 VM（VM 模板版本）。

创建新的 Nutanix AHV 棱镜中心主机连接：在迁移之前，请将托管 Nutanix AHV 群集注册到 Nutanix 棱镜中心，并建立一个指向目标 Nutanix 棱镜中心实例的新 Nutanix AHV 棱镜中心主机连接。此连接将作为您迁移的目录的目标。有关详细信息，请参阅Nutanix AHV 棱镜中心主机连接。
迁移现有计算机目录：对于现有计算机目录，请使用 Switch-ProvCatalog PowerShell cmdlet 启动到 Citrix 管理的 Nutanix AHV Prism Central 主机连接的迁移。
```
c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -DestinationHypervisorConnectionName "DestinationConnection" -DestinationHostingUnitName "DestinationUnit" -CreateMasterImageAtDestination

```
- 将 <Catalog_UID> 替换为您要迁移的计算机目录的唯一标识符。使用以下 PowerShell cmdlet 按目录名称 Get-BrokerCatalog -Name <Catalog Name> 查找 BrokerCatalogUid。
- DestinationConnection 是在步骤 1 中创建的新 Nutanix AHV Prism Central 主机连接的名称。
- DestinationUnit 是您为在 DestinationConnection 中将驻留计算机目录的托管单元指定的名称。
- -CreateMasterImageAtDestination 参数是可选的。它会在目标 Prism Central 上创建主映像 VM 模板版本。
验证迁移完成情况：执行迁移 cmdlet 后，请在 PowerShell 窗口中监视任务状态，以确保其成功完成。迁移完成后，目录将移动到在步骤 1 中创建的目标主机连接。您必须看到任务类型为 SwitchProvCatalog 的已完成状态。以下是验证迁移完成情况的建议步骤：
- 在 Studio 中检查目录的状态。
- 验证目录中的 VM 现在是否已与新的目标虚拟机管理程序连接关联。
- 验证目录中的 VM 是否显示正确的电源状态。
- 通过添加或删除计算机或执行电源操作来测试已迁移计算机目录的功能，以确保目录正常运行。

回滚已迁移的目录

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

重要：

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

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

清理不再使用的源资源

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

重要：

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

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

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

管理一个 Nutanix 目录

Use Web Studio

更改主映像

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

更改 NIC

更改虚拟机配置

使用 PowerShell 命令进行管理

更改主映像

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

更改网卡和虚拟机的配置

重置持久性虚拟机的操作系统磁盘

将计算机目录进行迁移到由 Citrix 负责管理的 Nutanix AHV Prism Central 主机连接的具体配置

优势

适用范围

系统必备要求

限制事项

重要注意事项

在进行迁移和回滚操作时所需的权限

如何迁移

迁移计算机目录

回滚已迁移的目录

清理不再使用的源资源

更多信息

在本文中