Citrix Virtual Apps and Desktops

创建 Nutanix 目录

April 8, 2026

投稿者:

C C

创建计算机目录介绍了创建计算机目录的向导。以下信息涵盖了 Nutanix 虚拟化环境特有的详细信息。

注意：

在创建 Nutanix 目录之前，您需要完成与 Nutanix 的连接创建。请参阅连接到 Nutanix。

使用 Nutanix 计算机模板版本创建计算机目录

使用 Citrix 管理的 Nutanix AHV Prism Central 主机连接创建 MCS 预配的计算机目录时，基础映像是根据 Nutanix VM 模板版本创建的。一个主要优势是 Nutanix Prism Central 允许 VM 模板跨多个群集使用。因此，Citrix 管理员可以将单个 Nutanix VM 模板版本用作多个 MCS 计算机目录的主 VM，即使这些目录位于不同的 Nutanix 群集上。

您还可以选择模板版本作为计算机配置文件的源。主映像的模板版本默认为新目录的计算机配置文件。但是，您可以更改计算机配置文件的模板版本。以下硬件属性是从计算机配置文件中捕获的：CPU、内存、每插槽核心数、GPU 和类别。您甚至可以选择指定 CPU、内存、每插槽核心数属性来覆盖所选计算机配置文件的设置。

注意：
类别是键值对，用于对虚拟机、群集和映像等实体进行分组和管理，以应用策略和自动化。
在创建目录之前，请创建主 VM，并将其转换为 Nutanix Prism Central 中的 VM 模板版本。有关步骤，请参阅 Nutanix 文档。

您可以使用以下方式创建目录：

Web Studio。您还可以使用现有 VM 创建目录。请参阅使用现有计算机（电源管理）创建计算机目录
PowerShell 命令

限制

不支持将多个 NIC 附加到同一子网。
- 由于 Nutanix 的限制，每个 MCS 预配的计算机目录只能分配到 Overlay 网络、VLAN 基本子网和 VLAN 子网中单一类型的网络中的 NIC。
- 在某些情况下，更新非持久性计算机目录的 MCS 主映像可能会导致潜在问题。请参阅 Nutanix Prism Central 中的安全启动和 vTPM。
选择 Nutanix VM 模板作为主映像时，模板名称或模板版本名称不得包含 # 或 & 等字符。

使用 Web Studio 创建计算机目录

在“计算机目录设置”向导中：

在“计算机类型”页面上，选择“多会话操作系统”、“单会话操作系统”或“远程电脑访问”。
在“计算机管理”页面上，选择“电源管理的计算机”和“Citrix Machine Creation Services™”作为部署方法。选择“资源”。
在“桌面体验”页面上，选择两个选项之一。
在“群集”页面上，选择一个群集用于部署 VM。
在“主映像”页面上，单击“主映像”并选择主映像（模板版本）。您可以按名称筛选计算机模板。主映像的模板版本默认为新目录的计算机配置文件。但是，您可以更改计算机配置文件的模板版本。

注意：

您可以将单个 Nutanix VM 模板版本用作多个 MCS 计算机目录的主 VM，即使这些目录位于不同的 Nutanix 群集上。

按名称筛选计算机模板：

查看模板说明：
在“NIC”页面上：
- 选择 NIC 类型以筛选关联的网络。
- 选择主映像包含的一个或多个 NIC，然后为每个 NIC 选择一个关联的虚拟网络。
在“虚拟机”页面上，指示要创建的虚拟机数量，并为每台计算机配置总内存 (MB)、虚拟 CPU 和每个 CPU 的核心数。这些值会自动从计算机配置文件中填充。
在“摘要”页面上，检查计算机目录的详细信息。输入计算机目录的名称和说明。单击“完成”。

导出计算机配置文件

您可以将计算机目录使用的计算机配置文件导出到 JSON 文件。

选择计算机目录并导航到“模板属性”选项卡。
在“计算机配置文件”详细信息下，单击“最新版本”旁边的“导出”。

使用 PowerShell 命令创建计算机目录

打开 PowerShell 窗口。
运行 asnp citrix*。

如果尚未创建身份池，请创建一个。例如：

New-AcctIdentityPool    -Domain "<string>" -IdentityPoolName "<string>" -IdentityType "ActiveDirectory"  -NamingScheme "DemoVM-##" -NamingSchemeType "Numeric" -ZoneUid "GUID" -Scope @()
<!--NeedCopy-->

创建预配方案。

例如：不使用计算机配置文件

New-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=`"00062c63-1fb0-58c9-4fc8-5c2573352378`" /><Property xsi:type=`"StringProperty`" Name=`"CPUCores`" Value=`"1`" /></CustomProperties>" -HostingUnitName "<Hosting unit name>" -IdentityPoolName "<string>" -InitialBatchSizeHint 1  -MasterImageVM "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<template name>.template\<template version name>.templateversion" -NetworkMapping @{"5"="XDHyp:\HostingUnits\<Hosting unit name>\Clusters.folder\<Cluster Name>.cluster\<Network name>.network"} -ProvisioningSchemeName "<Catalog name>" -ProvisioningSchemeType "MCS" -RunAsynchronously -Scope @() -VMCpuCount 2 -VMMemoryMB 10240
<!--NeedCopy-->

例如：使用计算机配置文件

使用计算机配置文件从模板版本捕获硬件属性并将其应用于预配的 VM。如果您未指定计算机配置文件，则硬件属性将从主映像模板版本中捕获。

> **注意：**
>
> -  即使使用计算机配置文件，OS 磁盘、vTPM 和安全启动属性也始终从主映像中捕获。
>     -  由于 OS 磁盘不是从计算机配置文件中读取的，因此您可以创建无盘 VM 并将其转换为可用于计算机配置文件的模板版本。
>     -  由于存储了计算机配置文件模板版本的完整 JSON 规范，因此即使您从 Prism Central 中删除了模板版本，也可以创建 VM。

从计算机配置文件捕获的属性包括：

属性	API 中的属性名称 (GetTemplateVersionById)	备注/参考
CPU	numSockets
RAM	memorySizeBytes
核心	numCoresPerSocket
类别	categories	类别管理
GPU	gpus	GPU 摘要视图

每核心线程数

numThreadsPerCore

aCLI-VM

NUMA 节点	numNumaNodes
启用 VCPU 硬绑定	isVcpuHardPinningEnabled
启用 CPU 直通	isCpuPassthroughEnabled
启用内存过量使用	isMemoryOvercommitEnabled	通过 Prism Central (AHV) 创建 VM
启用 GPU 控制台访问	isGpuConsoleEnabled
启用 CPU 热插拔	isCpuHotplugEnabled
启用 SCSI 控制器	isScsiControllerEnabled

时区 hardwareClockTimezone 通过 Prism Central (AHV) 创建 VM

启用 AHV 品牌	isBrandingEnabled
启用 VGA 控制台	isVgaConsoleEnabled
VM	isAgentVm	通过 Prism Central (AHV) 创建 VM

注意：

使用相同的主映像模板版本，您可以创建具有各种计算机配置文件的不同目录，每个配置文件都具有上述一组独特的属性。例如，您可以分配不同的类别，这些类别可以链接到 Nutanix 策略，调整 CPU/内存，修改内存过量使用设置，或者添加和删除多个 GPU。

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

-  New-ProvScheme -HostingUnitName "<Hosting unit name>" `
-  -IdentityPoolName "<string>" `

-InitialBatchSizeHint 1 `
-MasterImageVM “XDHyp:\HostingUnits<Hosting Unit Name>\Templates.folder<template name>.template<template version name>.templateversion” `
-MachineProfile “XDHyp:\HostingUnits<Hosting Unit Name>\Templates.folder<template name for machine profile>.template<template version name>.templateversion” `
-NetworkMapping @{“0”=”XDHyp:\HostingUnits<Hosting unit name>\Clusters.folder<Cluster Name>.cluster<Network name>.network”} ` -ProvisioningSchemeName “" ` -ProvisioningSchemeType "MCS" `
-CustomProperties $customProperties `
-RunAsynchronously ` -VMCpuCount 2 ` -Scope @()

```

将预配方案注册为代理目录。例如：

    New-BrokerCatalog -AllocationType "Random" -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "<Catalog Name>" -PersistUserChanges "Discard" -ProvisioningType "MCS"    -SessionSupport "MultiSession" -ZoneUid "GUID"  -ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `  -Scope @()
>
<!--NeedCopy-->

使用现有计算机（电源管理）创建计算机目录

您可以使用以下方式创建包含现有计算机（电源管理）的计算机目录：

Web Studio
PowerShell

使用 Web Studio 创建包含现有计算机（电源管理）的计算机目录

在“计算机目录设置”向导中：

在“操作系统”页面上，选择“多会话操作系统”或“单会话操作系统”。
在“计算机管理”页面上，选择“已进行电源管理的计算机”和“其他服务或技术”。
在“虚拟机”页面上，添加计算机及其 Active Directory 计算机帐户。您可以执行以下操作之一：
- 单击“从 CSV 文件导入”以批量添加计算机。
- 单击“添加计算机”以手动添加计算机。“选择 VM”窗口随即出现。展开您之前创建的 Nutanix AHV Prism Central 连接，然后选择要添加的 VM。然后添加关联的计算机帐户名称。
“作用域”和“摘要”页面不包含特定于 Nutanix AHV Prism Central 的信息。

使用 PowerShell 创建包含现有计算机（电源管理）的计算机目录

打开 PowerShell 窗口。
运行 asnp citrix*。

创建目录以包含分配给用户的电源管理 VM。例如：

New-BrokerCatalog -AllocationType "Permanent"  -IsRemotePC $False -MachinesArePhysical $False  -Name "<Catalog Name>" -PersistUserChanges "OnLocal" -ProvisioningType "Manual" -Scope @() -SessionSupport "SingleSession" -ZoneUid "fb202053-8c35-4db2-a299-a8d9538ec6be"
<!--NeedCopy-->

将 VM 添加到目录。例如：

New-BrokerMachine  -CatalogUid 6 -HostedMachineId "d859caf3-4bf0-447b-b012-8af0594c7d88" -HypervisorConnectionUid 1 -IsReserved $False  -MachineName "S-1-5-21-1334627847-1250330507-3910179295-100245"
<!--NeedCopy-->

使用 Nutanix 快照创建计算机目录

本部分介绍如何使用 Nutanix Acropolis (Prism Element) 主机连接创建 MCS 预配的计算机目录。在创建目录之前，请在 Nutanix 中创建主映像和快照。有关详细信息，请参阅 Nutanix 文档。

在“计算机目录设置”向导中：

“容器”或“群集和容器”页面是 Nutanix 特有的。
- 如果您使用 Nutanix AHV XI 作为资源部署计算机，请在“容器”页面上选择一个容器，用于放置 VM 的身份磁盘。
- 如果您使用 Nutanix AHV PC 作为资源部署计算机，您将看到“群集和容器”页面。选择用于部署 VM 的群集，然后选择一个容器。
在“映像”页面上，选择映像快照。如果需要，请使用 Acropolis 控制台重命名快照。如果重命名快照，请重新启动目录创建向导以查看刷新后的列表。
在“虚拟机”页面上，指示虚拟 CPU 的数量和每个 vCPU 的核心数。
在“NIC”页面上，选择 NIC 类型以筛选关联的网络。此选项仅适用于 Nutanix AHV PC 连接。
“计算机身份”、“域凭据”、“作用域”和“摘要”页面不包含 Nutanix 特定的信息。

限制

使用 Nutanix 主机连接（特别是 Nutanix AHV 插件 2.7.1 和 Nutanix AHV 插件 2.5.1）创建 MCS 目录时，预配 VM 的硬盘大小在 Web Studio 上显示不正确。

Nutanix AHV 插件 2.7.1：显示的大小（1 GB）小于实际存储大小。
Nutanix AHV 插件 2.5.1：显示的大小（32 GB）小于实际存储大小。

但是，如果主映像 VM 是 VM 中的快照，则此功能按设计工作。

后续步骤

如果这是创建的第一个目录，Web Studio 会引导您创建交付组
要查看整个配置过程，请参阅安装和配置
要管理目录，请参阅管理计算机目录和管理 Nutanix 目录

创建 Nutanix 目录

使用 Nutanix 计算机模板版本创建计算机目录

限制

使用 Web Studio 创建计算机目录

导出计算机配置文件

使用 PowerShell 命令创建计算机目录

使用现有计算机（电源管理）创建计算机目录

使用 Web Studio 创建包含现有计算机（电源管理）的计算机目录

使用 PowerShell 创建包含现有计算机（电源管理）的计算机目录

使用 Nutanix 快照创建计算机目录

限制

后续步骤

更多信息

在本文中