Citrix DaaS™

查看 PDF

在 AWS EC2 中使用准备好的映像创建目录

August 20, 2026

投稿者:

C C

创建准备好的映像，并使用这些准备好的映像通过以下方式创建 MCS 计算机目录：

工作室
PowerShell 命令

使用准备好的映像创建 MCS 计算机目录的关键步骤如下：

创建映像定义和初始映像版本。
使用映像版本作为准备好的映像来创建目录

创建映像定义和初始映像版本

使用 Studio

要创建映像定义和初始映像版本，请执行以下操作：

在 Studio 中，转到映像节点，然后单击创建映像定义。在简介页面上单击下一步。
在映像定义页面上，为映像定义指定操作系统类型和会话类型。
在映像页面上，选择资源（仅列出适用于所设置连接的资源）、用作创建映像版本模板的主映像，以及用于捕获硬件属性的计算机配置文件。选择一个计算机配置文件以从 VM 实例或启动模板版本捕获硬件属性。
注意：
- 在选择映像之前，请验证主映像是否已安装 VDA 2311 或更高版本，并且 VDA 上是否已安装 MCSIO 驱动程序。
- 支持实例元数据服务 (IMDS) V1 和 V2。
在计算机规范页面上，选择计算机大小。默认选择计算机配置文件（在映像页面上选择）的计算机大小。
在网卡页面上，为准备映像选择或添加网卡。对于每个网卡，选择一个关联的 VPC 子网。
在版本描述页面上，输入所创建的初始映像版本的描述。
在摘要页面上，检查映像定义和所创建的初始映像版本的详细信息。输入映像定义的名称和描述。单击完成。

创建映像版本

映像版本允许管理特定映像的不同迭代或更新。此功能使您能够为不同目的维护映像的多个版本。

要从初始映像版本创建映像版本，请执行以下操作：

注意：

所有映像版本的主机单元必须相同。

转到映像节点，选择一个映像版本或映像定义，然后单击创建映像版本。
在映像定义页面上，您可以更改主机单元，并重新选择该映像版本的主映像和计算机配置文件。
如果希望映像版本的配置与初始配置的映像版本不同，请在创建映像版本对话框的计算机规范和网卡页面上配置设置。
添加映像版本的描述。单击完成。

注意：

如果由于任何原因导致映像版本创建失败，底部的故障排除选项卡会提供重试选项。

使用 PowerShell

创建准备好的映像版本规范的详细 PowerShell 命令如下：

使用 Test-ProvImageDefinitionNameAvailable command 检查可用的映像定义名称。例如，
```
Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>

```

使用 New-ProvImageDefinition 命令创建映像定义。例如，

New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
<!--NeedCopy-->

使用 Add-ProvImageDefinitionConnection 命令在指定的托管连接中为映像定义创建新配置。

Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn
<!--NeedCopy-->

使用 New-ProvImageVersion 命令创建映像版本。例如，

New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
<!--NeedCopy-->

使用 Add-ProvImageVersionSpec 命令将主映像版本规范添加到映像版本。例如，

Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName aws -MasterImagePath "XDHyp:\HostingUnits\aws\win10-2411-ami (ami-00123456789abcdef).template”"
<!--NeedCopy-->

注意：

对于一个托管单元，您只能向一个映像版本添加一个主映像版本规范。

使用 New-ProvImageVersionSpec 命令从主映像版本规范创建准备好的映像版本规范。SourceImageVersionSpecUid 参数派生自 Add-ProvImageVersionSpec 命令。例如，

New-ProvImageVersionSpec
-SourceImageVersionSpecUid  00000000-0000-0000-0000-00000000000
-MachineProfile 'XDHyp:\HostingUnits\aws\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -RunAsynchronously
<!--NeedCopy-->

创建映像定义、映像版本和准备好的映像版本规范的完整 Powershell 命令集示例：

New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession


Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName aws-CustomProperties $CustomProperties

$imageVersion = New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"

$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid `
    -HostingUnitUid $hostingunit.HostingUnitUid `
    -MasterImagePath "XDHyp:\HostingUnits\aws\win10-2411-ami (ami-00123456789abcdef).template”

New-ProvImageVersionSpec -MachineProfile 'XDHyp:\HostingUnits\aws\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid 00000000-0000-0000-0000-00000000000-HostingUnitName aws
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid | Where SourceImageVersionSpecUid-eq $SourceImageVersionSpec.ImageVersionSpecUid
<!--NeedCopy-->

注意：

映像定义中的所有映像版本规范必须属于同一个托管单元。

一个映像版本只能有一个主映像版本规范和一个准备好的映像版本规范。

所有映像版本规范都必须具有计算机配置文件。

跨可用区和区域共享准备好的映像

现在，您可以在同一 AWS 区域内或不同区域中，跨不同的可用区（与不同的托管单元关联）共享单个准备好的映像，以用于您的 AWS EC2 环境。这使您可以使用一个准备好的映像在各种可用区和区域中创建和更新 MCS 计算机目录。当跨不同区域中的不同可用区共享时，准备好的映像版本将从原始区域复制到目标区域。

您可以维护单个准备好的映像，并使用它在与不同托管单元关联的多个可用区和区域中创建和更新计算机目录。这显著减少了您的映像管理开销，确保了跨部署的一致性，并简化了预配过程。您还可以使用来自不同可用区或区域的准备好的映像无缝更新现有计算机目录。

用例

集中式映像管理： 您在一个可用区（例如，us-east-1a）中创建准备好的映像。然后，您可以将此映像共享到同一 us-east-1 AWS 区域内的其他可用区（例如 us-east-1b）或不同 us-west-1 区域中的 us-west-1a。这允许单个映像服务多个托管单元并为您简化维护。
高效的目录创建和更新： 您可以使用在 AZ 1（例如，us-east-1a）中创建的准备好的映像在 AZ 1 中创建新目录。将此映像共享到 AZ 2（例如，us-east-1b）后，您可以使用 AZ 2 中的共享映像在 AZ 2 中创建和更新目录。
跨托管单元和托管连接部署： 如果您的环境在相同或不同的 AWS 区域下有多个托管单元，您可以在这些托管单元之间高效地共享准备好的映像。

限制

在同一 AWS 账户内共享： 在当前实施中，您只能在同一 AWS 账户内共享。

重要注意事项

删除顺序： 要删除原始准备好的映像版本规范，您必须首先删除其所有共享映像版本规范。或者，您必须同时删除原始和共享规范。
映像版本依赖性： 当您删除映像版本时，必须首先删除依赖于该特定映像版本的任何共享配置。从原始（未共享）映像创建的目录可以保持不变。
目录向后兼容性： 您可以更新在此功能引入之前部署的现有计算机目录。使用在与您最初部署目录的可用区或区域不同的可用区或区域中创建的准备好的映像。
完全删除： 当您删除准备好的映像时，您将无法再在您共享或最初创建它的任何可用区中使用它。此外，在删除所有与该准备好的映像版本关联的目录之前，无法删除准备好的映像版本。

先决条件

在配置或使用此功能之前，请确保满足以下条件：

您的环境必须是 AWS EC2 环境。
您必须在同一个 AWS 账户下配置多个托管单元（每个单元可以绑定到不同的可用区）和主机连接（每个连接可以绑定到不同的区域）。

使用 PowerShell 进行配置

目前，您只能使用 PowerShell 命令在绑定到不同托管单元的可用区之间共享准备好的映像。

共享准备好的映像

确保您拥有要共享的准备好的映像的 ImageVersionSpecUid。您可以使用 PowerShell 中的 Get-ProvImageVersionSpec 或类似的 Get- 命令检索此信息。
确定要使准备好的映像可用的可用区的 HostingUnitName（可以是相同或不同的区域）。这是您为该特定可用区配置的托管单元的名称。
运行 Add-ProvImageVersionSpecHostingUnit 命令： 使用以下 PowerShell 命令。将 <ImageVersionSpecUid> 替换为您的映像 Uid，将 <targetHostingUnitName> 替换为目标可用区中您要共享映像版本规范的托管单元的名称：
```
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>

```
成功执行后，您可以在 Studio UI 中看到映像的状态，表明您已将其共享给指定的托管单元。

取消共享准备好的映像

确保您拥有要取消共享的准备好的映像的 ImageVersionSpecUid。
确定要从中删除共享映像的可用区的 HostingUnitName。
运行 Remove-ProvImageVersionSpecHostingUnit 命令： 使用以下 PowerShell 命令。将 <ImageVersionSpecUid> 替换为您的映像 Uid，将 <targetHostingUnitName> 替换为目标可用区中您要从中删除映像版本规范共享的托管单元的名称：
```
Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>

```

创建计算机目录

使用 Studio

从“映像”节点创建计算机目录

使用“映像”节点中的“创建目录”选项，使用映像版本创建目录。

或者，您可以在“计算机目录”节点中创建目录时选择版本，将其链接到目录创建工作流中的准备好的映像选项。请参阅从“计算机目录”节点创建计算机目录。

要从“映像”节点创建 MCS 计算机目录，请执行以下操作：

选择一个映像版本，然后单击“创建目录”。在“简介”页面上单击“下一步”。
在“计算机管理”和“映像”页面上，设置会根据所选映像版本预先选择。在“映像”页面上，为所选的准备好的映像输入备注。
完成以下页面上的设置。
在“摘要”页面上，检查计算机目录的详细信息。输入计算机目录的名称和描述。单击“完成”。
转到“计算机目录”节点以查看创建的计算机目录。

要从“计算机目录”节点创建 MCS 计算机目录，请执行以下操作：

在左侧导航窗格中单击“计算机目录”。
单击“创建计算机目录”。将显示“计算机目录设置”页面。
在“计算机类型”页面上，为目录选择计算机类型，例如“多会话操作系统”。
在“计算机管理”页面上，选择以下设置：
1. 选择“已进行电源管理的计算机（例如，虚拟机或刀片式电脑）”。
2. 选择“Citrix 预配技术”。然后，选择“Citrix Machine Creation Services™”。
3. 在“资源”字段中，选择在创建主机连接时配置的资源（可用区），然后单击“下一步”。
在“桌面体验”页面上，选择用户登录时所需的随机桌面或静态桌面。如果选择静态桌面，请进一步指定是否要保存用户在本地磁盘上所做的更改（持久性或非持久性）。
在“映像”页面上，单击“选择映像”以为计算机目录选择准备好的映像。选择您创建的准备好的版本。单击映像版本名称。要查看有关所选映像版本的更多详细信息，请单击带下划线的版本号。单击“完成”。

与准备好的映像关联的计算机配置文件将显示，并且其硬件属性（例如，实例类型、租用类型、网络映射、安全组、卷属性）用于在目录中创建计算机。要将计算机配置文件源更改为其他 VM 或启动模板版本，请单击编辑按钮。
在“虚拟机”页面上：
1. 输入目录的 VM 数量。
2. 将显示基于计算机配置文件的默认计算机规范。要更改它，请选择编辑图标并选择计算机规范。
在“网卡”页面上，为 VM 选择网卡（或 ENI）。
在“计算机身份”页面上，通过选择域并为将在此计算机目录中创建的 VM 创建新的 AD 帐户，为目录中的计算机配置本地 Active Directory 或 Microsoft Entra 混合加入。预配的 VM 将加入所选域。指定将为 VM 创建的新 AD 帐户的帐户命名方案。单击“下一步”。
在“域凭据”页面上，单击“输入凭据”以提供所选域的凭据。出现提示时输入管理员级别的用户名和密码。如果您之前已按照我们的产品文档保存了域凭据，也可以使用服务帐户。
依次单击其余页面，直到“摘要”页面。为计算机目录输入名称，然后选择“完成”以创建计算机目录。

使用 PowerShell

使用准备好的映像版本规范和计算机配置文件创建目录

使用 New-ProvScheme 命令从准备好的映像版本规范创建 MCS 非持久性计算机目录。例如，

 New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $true] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”]
 <!--NeedCopy-->

使用 New-ProvScheme 命令从准备好的映像版本规范创建 MCS 持久性计算机目录。例如，

 New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $false] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”]
 <!--NeedCopy-->

创建目录的完整 PowerShell 命令集示例：

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "awscatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"

$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "domainname" -IdentityPoolName "awscatalog" -IdentityType "ActiveDirectory"  -NamingScheme "aws##" -NamingSchemeType "Numeric" -Scope @()

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

$Task = New-ProvScheme -ProvisioningSchemeName awscatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName aws -IdentityPoolName awscatalog -CleanOnBoot -Scope @() -SecurityGroup @() -MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm' -RunAsynchronously

Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName awscatalog

Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

在 AWS EC2 中使用准备好的映像创建目录

创建映像定义和初始映像版本

使用 Studio

创建映像版本

使用 PowerShell

跨可用区和区域共享准备好的映像

用例

限制

重要注意事项

先决条件

使用 PowerShell 进行配置

共享准备好的映像

取消共享准备好的映像

创建计算机目录

使用 Studio

从“映像”节点创建计算机目录

从“计算机目录”节点创建计算机目录

使用 PowerShell

使用准备好的映像版本规范和计算机配置文件创建目录

后续步骤

更多信息

在本文中