Citrix Virtual Apps and Desktops

查看 PDF

管理 Nutanix 目录

September 3, 2026

投稿者:

C C

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

注意：

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

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

网络工作室
PowerShell

使用 Web Studio

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

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

注意：

当前，克隆选项不可用。

更改主映像

要更改目录的主映像，请按照以下步骤操作：

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

注意：

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

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

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

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

更改网卡

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

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

更改 VM 配置

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

在“计算机目录”页面上，右键单击要修改的计算机目录，然后选择“编辑计算机目录”。
在“虚拟机”页面上，使用向上或向下箭头，或直接输入值来调整 VM 的内存、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"
<!--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-->

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

可以使用特定的命令行参数配置某些设置。这些命令行参数（例如 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-->

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

重置持久性虚拟机中的操作系统磁盘，尤其是那些启用了 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 管理的计算机目录，包括持久型和非持久型。
仅限电源管理的计算机目录，其中包含由第三方技术预配的 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 安装向导创建的计算机目录。
回滚限制：
- 仅当您在初始迁移后未修改目录时，才允许回滚已迁移的目录。
- 执行“清理源资源”操作时，它会清除迁移状态。这可以防止任何后续回滚。
不可重新迁移：已迁移的计算机目录不支持重新迁移。
多主机连接虚拟机：不支持迁移包含从多个主机连接导入的虚拟机的仅电源管理的计算机目录。

重要注意事项

Nutanix 群集管理：托管 Nutanix AHV 群集必须注册到 Nutanix Prism Central。
主映像模板创建：对于 MCS 计算机目录，迁移命令提供了一个选项，可从计算机目录主映像的原始快照在 Prism Central 上生成一个 VM 模板版本。此 VM 模板版本以后可用作 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 模板版本）。

创建新的 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 上创建主映像 VM 模板版本。
验证迁移完成情况：执行迁移 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 目录

使用 Web Studio

更改主映像

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

更改网卡

更改 VM 配置

使用 PowerShell

更改主映像

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

更改 NIC 和 VM 的配置

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

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

优势

适用性

系统要求

限制

重要注意事项

迁移和回滚所需的权限

如何迁移

迁移计算机目录

回滚已迁移的目录

清理源资源

更多信息

在本文中