产品文档

Citrix DaaS™

查看 PDF

管理 Nutanix 目录

May 4, 2026

投稿者:

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

注意：

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

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

Studio
PowerShell

使用 Studio

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

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

注意：

当前，克隆选项不可用。

更改主映像

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

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

注意： > > - 对于使用 Nutanix AHV Prism Central 主机连接插件通过 MCS 预配的非持久性目录，更新主映像以在 Legacy 和 UEFI 之间切换引导配置会阻止现有虚拟机在其下次启动时启动。
-  更新主映像时，仅更新操作系统磁盘。硬件属性保持不变。要更新硬件属性，请参阅 [添加或更改计算机配置文件](#add-or-change-machine-profile)、[更改 NIC](#change-nics) 和 [更改虚拟机配置](#change-vms-configuration)。

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

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

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

1. “虚拟机”页面必须反映根据所选计算机配置文件模板版本更新的配置。

更改 NIC

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

在“计算机目录”页面上，右键单击要修改的计算机目录，然后选择“编辑计算机目录”。
在“NIC”页面上：
- 选择 NIC 类型。
- 如果所选目录是使用计算机配置文件创建的，则 NIC 数量与计算机配置文件的 NIC 数量一致，无法更改。为每个 NIC 选择一个关联的虚拟网络。

- 如果所选目录是在没有计算机配置文件的情况下创建的，请单击“添加 NIC”以增加 NIC 数量，或单击“删除”以删除所选 NIC。选中或清除复选框以选择 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 和 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 中的子网映射匹配。

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

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

<!--NeedCopy-->

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

某些配置可以使用特定的命令行参数进行配置。这些命令行参数（例如 CustomProperties 中的 VMCpuCount、VMMemoryMB 和 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-->

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

将计算机目录迁移到 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 的已知问题，Nutanix Prism Central 7.3 需要 AOS 7.3。

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

重要注意事项

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

迁移和回滚所需的权限

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

Prism Element 管理员：

创建虚拟机

Prism Central 管理员：

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

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

如何迁移

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

迁移计算机目录

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

创建新的 Nutanix AHV Prism Central 主机连接：在迁移之前，将托管 Nutanix AHV 群集注册到 Nutanix Prism Central，并建立指向目标 Nutanix Prism Central 实例的新 Nutanix AHV Prism Central 主机连接。此连接将作为您迁移的目录的目标。有关详细信息，请参阅 Nutanix AHV Prism Central 主机连接。
迁移现有计算机目录：对于现有计算机目录，请使用 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 上创建主映像虚拟机模板版本。
验证迁移完成情况：执行迁移 cmdlet 后，监视 PowerShell 窗口中的任务状态以确保其成功完成。迁移完成后，目录将移动到步骤 1 中创建的目标主机连接。您必须看到状态为“已完成”，任务类型为 SwitchProvCatalog。以下是验证迁移完成情况的建议步骤：
- 在 Studio 中检查目录的状态。
- 验证目录中的虚拟机现在是否与新的目标管理程序连接关联。
- 验证目录中的虚拟机是否显示正确的电源状态。
- 通过添加或删除计算机或发出电源操作来测试已迁移计算机目录的功能，确保目录正常运行。

回滚已迁移的目录

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

重要提示：

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

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

<!--NeedCopy-->

清理源资源

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

重要提示：

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

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

<!--NeedCopy-->

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

管理 Nutanix 目录

使用 Studio

更改主映像

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

更改 NIC

更改虚拟机配置

使用 PowerShell

更改主映像

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

更改 NIC 和 VM 的配置

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

优势

适用性

系统要求

限制

重要注意事项

迁移和回滚所需的权限

如何迁移

迁移计算机目录

回滚已迁移的目录

清理源资源

更多信息

在本文中