在 Azure Local 中创建准备好的映像计算机目录

Last published : Nov 13, 2026
创建准备好的映像，并使用这些准备好的映像通过以下方式创建 MCS 计算机目录：
使用准备好的镜像创建 MCS 计算机目录的关键步骤如下：
  1. 创建镜像定义和初始镜像版本。
  2. 使用映像版本作为准备好的映像来创建目录。
Related information
创建准备好的映像计算机目录

使用 Web Studio

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

要创建镜像定义和初始镜像版本，请执行以下操作：
  1. 在 Web Studio 中，转到映像节点，然后单击创建映像定义。在简介页面上单击下一步。
  2. 在映像定义页面上，为映像定义指定操作系统类型和会话类型。
  3. 选择现有资源组或创建新资源组以保存映像资源。
  4. 在映像页面上，选择资源（仅列出适用于所设置连接的资源）和用作创建映像版本模板的映像。
    注意：
    • 在选择映像之前，请验证主映像是否已安装 VDA 2311 或更高版本，并且 VDA 上是否已安装 MCSIO 驱动程序。
    • 对于映像选择，您可以选择 Azure Local 库映像或虚拟机。
  5. 在计算机规范页面上，为准备 VM 选择 CPU 和内存。
  6. 在网卡页面上，为准备映像选择网卡。对于每个网卡，选择关联的虚拟网络。
  7. 在版本描述页面上，输入所创建的初始映像版本的描述。
  8. 在摘要页面上，检查映像定义和所创建的初始映像版本的详细信息。输入映像定义的名称和描述。单击完成。

创建映像版本

映像版本允许管理特定映像的不同迭代或更新。此功能使您能够维护映像的多个版本以用于不同目的。
要从初始映像版本创建映像版本，请执行以下操作：
注意：
所有映像版本的主机单元必须相同。
  1. 转到映像节点，选择一个映像版本或映像定义，然后单击创建映像版本。
  2. 在映像定义页面上，您可以更改托管单元，并重新选择该映像版本的主映像和计算机配置文件。
  3. 如果您希望映像版本的配置与初始配置的映像版本不同，请在创建映像版本对话框的计算机规格和网卡页面上配置设置。
  4. 添加映像版本的描述。单击完成。
注意：
如果映像版本创建因任何原因失败，底部“故障排除”选项卡提供“重试”选项。

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

使用“映像”节点中的“创建目录”选项，使用映像版本创建目录。
或者，您可以在“计算机目录”节点中创建目录时选择版本，将其链接到目录创建工作流中的准备好的映像选项。请参阅从“计算机目录”节点创建计算机目录。
要从映像节点创建 MCS 计算机目录，请执行以下操作：
  1. 选择一个映像版本，然后单击创建目录。在简介页面上单击下一步。
  2. 在桌面体验页面上，选择所需的桌面体验。
  3. 从映像页面到网卡页面，设置是根据所选映像版本预先选择的。
  4. 在“资源组”页面上，您可以选择创建新的资源组或使用现有资源组来放置此目录的资源。
  5. 在以下页面上完成设置。
  6. 在摘要页面上，检查计算机目录的详细信息。输入计算机目录的名称和描述。单击完成。
  7. 转到计算机目录节点以查看创建的计算机目录。

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

要从计算机目录节点创建 MCS 计算机目录，请执行以下操作：
  1. 在左侧导航窗格中单击计算机目录。
  2. 单击“创建计算机目录”。出现“计算机目录设置”页面。依次单击“下一步”通过“简介”和“计算机类型”页面。
  3. 在计算机管理页面上：
    1. 选择“已进行电源管理的计算机（例如，虚拟机或刀片式电脑）”。
    2. 选择“Citrix 预配技术”。然后，选择“Citrix Machine Creation Services™”。
    3. 在资源字段中，列出了属于不同区域的资源。选择任何 Azure 网络资源，然后单击下一步。
  4. 在映像页面上：
    • 对于主映像类型，请按照以下步骤操作：
      1. 选择主映像。
      2. 在主映像下，选择一个映像。该边栏列出了与资源属于同一区域的所有映像。
      3. 点击 完成。
    • 对于准备好的映像类型，请按照以下步骤操作：
      1. 选择准备好的映像。
      2. 在“准备好的映像”下，选择映像定义的映像版本。如有需要，为所选的准备好的映像版本添加备注。
      3. 单击映像版本名称。要查看有关所选映像版本的更多详细信息，请单击带下划线的版本号。
  5. 配置以下页面上的设置。
  6. 在“资源组”页面上，您可以选择创建新的资源组或使用现有资源组来放置此目录的资源。
  7. 在以下页面上完成设置。
  8. 在摘要页面上，检查计算机目录的详细信息。输入计算机目录的名称和描述。单击完成。

使用 PowerShell

创建准备好的映像

创建 Azure Local 准备好的映像版本规范的详细 PowerShell 命令如下：
  1. 使用 Test-ProvImageDefinitionNameAvailable command 检查可用的映像定义名称。例如，
    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
  2. 使用 New-ProvImageDefinition 命令创建映像定义。例如，
    New-ProvImageDefinition -ImageDefinitionName arc-ACG-image-climber-demo -OsType Windows -VDASessionSupport SingleSession -Description "arc ACG image for arc"
  3. 使用 Add-ProvImageDefinitionConnection 命令在指定的托管连接中为映像定义创建新配置。
    Add-ProvImageDefinitionConnection 的 CustomProperties 可以包括以下内容。如果不使用这些参数，则使用默认值。
    ResourceGroups：包含基础磁盘的资源组。
    例如，对于客户提供的资源组：
    $CustomerOwnRsourceGroupProperties = @"
    <CustomProperties xmlns="http:// schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Property xsi:type="StringProperty" Name="ResourceGroups" Value="sz_res_group" />
    </CustomProperties>
    "@    Add-ProvImageDefinitionConnection -HypervisorConnectionName Azurelocal -ImageDefinitionName arc-ACG-image-climber-demo [-CustomProperties $CustomProperties]
  4. 使用 New-ProvImageVersion 命令创建映像版本。例如，
    New-ProvImageVersion -ImageDefinitionName arc-ACG-image-climber-demo
  5. 使用 Add-ProvImageVersionSpec 命令将主映像版本规范添加到映像版本。例如，
    Add-ProvImageVersionSpec -ImageVersionNumber 1 -HostingUnitName network-2 -MasterImagePath XDHyp:\HostingUnits\network-2\image.folder\MST-W11WS-2507-11-10-no-sysprep.galleryimage
    注意：
    您只能为一个主机单元的一个映像版本添加一个主映像版本规范。
  6. 使用 New-ProvImageVersionSpec 命令从主映像版本规范创建准备好的映像版本规范。例如，
    New-ProvImageVersionSpec -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"ResourceGroups`" Value=`"citrix-xd-39d65e7a-f6c0-4772-9e8d-d6eacb36287f-hilxi`" /><Property xsi:type=`"StringProperty`" Name=`"OsType`" Value=`"Windows`" /></CustomProperties>" -NetworkMapping @{"0"="XDHyp:\HostingUnits\network-2\network.folder\VM-Network-2.network"} -SourceImageVersionSpecUid "86c1a467-f900-4434-990a-c4ae39faca10"
创建映像定义、映像版本和准备好的映像版本规范的完整 PowerShell 命令集示例：
## create image definition
New-ProvImageDefinition -ImageDefinitionName arc-ACG-image-climber-demo -OsType Windows -VDASessionSupport SingleSession -Description "arc ACG image for arc"
## create image definition connection
Add-ProvImageDefinitionConnection -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -HypervisorConnectionUid "8eac2ad2-fc81-45d6-9153-9545a779f8d2" -ImageDefinitionUid "39d65e7a-f6c0-4772-9e8d-d6eacb36287f"
## create new image verison
New-ProvImageVersion -ImageDefinitionName arc-ACG-image-climber-demo
## select azure arc ACG image
Import-Module Citrix.Host.Commands
Get-ChildItem -LiteralPath @("XDHyp:\HostingUnits\network-2\image.folder") | select-object fullpath
## add verison spec through Azure Arc ACG
Add-ProvImageVersionSpec -ImageVersionUid "29da7e07-b7e9-4c8c-a5f2-4c03dbcba451" -HostingUnitUid "51305f67-34b3-4b22-a5d2-b6d7deaff9ba" -MasterImagePath XDHyp:\HostingUnits\network-2\image.folder\MST-W11WS-2507-11-10-no-sysprep.galleryimage
## create new version spec
New-ProvImageVersionSpec -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"ResourceGroups`" Value=`"citrix-xd-39d65e7a-f6c0-4772-9e8d-d6eacb36287f-hilxi`" /><Property xsi:type=`"StringProperty`" Name=`"OsType`" Value=`"Windows`" /></CustomProperties>" -NetworkMapping @{"0"="XDHyp:\HostingUnits\network-2\network.folder\VM-Network-2.network"} -SourceImageVersionSpecUid "86c1a467-f900-4434-990a-c4ae39faca10"
注意：
  • 映像定义中的所有映像版本规范必须属于同一托管单元。
  • 一个映像版本只能有一个主映像版本规范和一个准备好的映像版本规范。

使用准备好的映像版本规范创建目录

使用 New-ProvScheme 命令从准备好的映像版本规范创建 MCS 计算机目录。例如，
New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>][-ImageAssignmentNote <string>]
或者，
New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitName <string> -IdentityPoolName <string> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>][-ImageAssignmentNote <string>]
创建目录的完整 PowerShell 命令示例：
New-AcctIdentityPool -IdentityPoolName arc-climbers-local -NamingScheme "arc-c-vm-###" -NamingSchemeType Numeric -Domain "CLIMBERS.LOCAL"
New-ProvScheme -ProvisioningSchemeName arc-ACG-img-climber-3 -HostingUnitName network-2 -IdentityPoolName arc-climbers-local -ImageVersionSpecUid 0525360d-6cb5-4f08-bb2c-aaf5678a0d54
New-BrokerCatalog -ProvisioningSchemeId 93fbcebd-3a7a-499e-9d8d-c09e02021c5a -AllocationType Static -Name arc-ACG-img-climber-3 -PersistUserChanges OnLocal -ProvisioningType MCS -SessionSupport SingleSession

更多信息

  • 映像管理

下一步操作

  • 管理预准备映像计算机目录