Citrix Virtual Apps and Desktops

创建 Nutanix 目录

March 18, 2026

投稿者:

创建计算机目录介绍了用于创建计算机目录的向导。以下信息涵盖了 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 预配的计算机目录只能分配一种类型的网络中的 NIC，包括叠加网络、VLAN 基本子网和 VLAN 子网。
在某些情况下，更新非持久性计算机目录的 MCS 主映像可能会导致潜在问题。请参阅 Nutanix Prism Central 中的安全启动和 vTPM。
选择 Nutanix VM 模板作为主映像时，模板名称或模板版本名称不得包含 # 或 & 等字符。

使用 Web Studio 创建计算机目录

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

在 Machine Type（计算机类型）页面上，选择 Multi-session OS（多会话操作系统）、Single-session OS（单会话操作系统）或 Remote PC Access（远程电脑访问）。
在 Machine Management（计算机管理）页面上，选择 Machines that are power managed（电源管理的计算机）和 Citrix Machine Creation Services™ 作为部署方法。选择 Resources（资源）。
在 Desktop Experience（桌面体验）页面上，选择两个选项之一。
在 Cluster（群集）页面上，选择用于部署 VM 的群集。
在 Master Image（主映像）页面上，单击 Master Image（主映像）并选择主映像（模板版本）。您可以按名称筛选计算机模板。主映像的模板版本默认为新目录的计算机配置文件。但是，您可以更改计算机配置文件的模板版本。

注意：

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

按名称筛选计算机模板：

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

导出计算机配置文件

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

选择计算机目录并导航到 Templates Properties（模板属性）选项卡。
在 Machine Profile（计算机配置文件）详细信息下，单击 Last version（最新版本）旁边的 Export（导出）。

使用 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。如果您未指定计算机配置文件，则硬件属性将从主映像模板版本中捕获。

注意：

即使使用计算机配置文件，操作系统磁盘、vTPM 和安全启动属性也始终从主映像中捕获。

由于未从计算机配置文件中读取操作系统磁盘，因此您可以创建无盘 VM 并将其转换为可用于计算机配置文件的模板版本。

由于存储了计算机配置文件模板版本的完整 JSON 规范，因此即使您从 Prism Central 中删除了模板版本，也可以创建 VM。

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

属性	API 中的属性名称 (GetTemplateVersionById)	备注/参考
CPU	numSockets
RAM	memorySizeBytes
Core	numCoresPerSocket
Categories	categories	类别管理
GPU	gpus	GPU 摘要视图
Threads Per Core	numThreadsPerCore	aCLI-VM
Numa Nodes	numNumaNodes
Enable VCPU Hard Pinning	isVcpuHardPinningEnabled
Enable CPU Passthrough	isCpuPassthroughEnabled
Enable Memory Overcommit	isMemoryOvercommitEnabled	通过 Prism Central (AHV) 创建 VM
Enable GPU Console Access	isGpuConsoleEnabled
Enable CPU Hot Plug	isCpuHotplugEnabled
Enable SCSI Controller	isScsiControllerEnabled
Timezone	hardwareClockTimezone	通过 Prism Central (AHV) 创建 VM
Enable AHV branding	isBrandingEnabled
Enable VGA Console	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 "<Catalog name>" `
           -ProvisioningSchemeType "MCS" `
           -CustomProperties $customProperties `
           -RunAsynchronously `
           -VMCpuCount 2 `
           -Scope @()

<!--NeedCopy-->

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

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 创建包含现有计算机（电源管理）的计算机目录

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

在 Operating System（操作系统）页面上，选择 Multi-session OS（多会话操作系统）或 Single-session OS（单会话操作系统）。
在 Machine Management（计算机管理）页面上，选择 Machines that are power managed（电源管理的计算机）和 Other service or technology（其他服务或技术）。
在 Virtual Machines（虚拟机）页面上，添加计算机及其 Active Directory 计算机帐户。您可以执行以下操作之一：
- 单击 Import from CSV file（从 CSV 文件导入）以批量添加计算机。
- 单击 Add Machines（添加计算机）以手动添加计算机。此时将显示 Select VMs（选择 VM）窗口。展开您之前创建的 Nutanix AHV Prism Central 连接，然后选择要添加的 VM。然后添加关联的计算机帐户名称。
Scopes（范围）和 Summary（摘要）页面不包含特定于 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 文档。

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

Container（容器）或 Cluster and Container（群集和容器）页面是 Nutanix 特有的。
- 如果您使用 Nutanix AHV XI 作为资源部署计算机，请在 Container（容器）页面上，选择一个容器来放置 VM 的身份磁盘。
- 如果您使用 Nutanix AHV PC 作为资源部署计算机，您将看到 Cluster and Container（群集和容器）页面。选择要用于部署 VM 的群集，然后选择一个容器。
在 Image（映像）页面上，选择映像快照。如果需要，请使用 Acropolis 控制台重命名快照。如果重命名快照，请重新启动目录创建向导以查看刷新后的列表。
在 Virtual Machines（虚拟机）页面上，指示虚拟 CPU 的数量和每个 vCPU 的内核数量。
在 NICs（网卡）页面上，选择 NIC 类型以筛选关联的网络。此选项仅适用于 Nutanix AHV PC 连接。
Machine Identities（计算机身份）、Domain Credentials（域凭据）、Scopes（范围）和 Summary（摘要）页面不包含 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 快照创建计算机目录

限制

后续步骤

更多信息

在本文中