产品文档
Citrix Virtual Apps and Desktops
Current Release Service 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
查看 PDF

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

July 9, 2026
投稿者: 
C

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

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

  1. 创建映像定义以及其初始映像版本。
  2. 使用映像版本作为预准备映像来创建目录。

Use Web Studio

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

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

  1. 在 Web Studio 中，转到映像节点，然后单击创建映像定义。在简介页面上，单击下一步。
  2. 在映像定义页面上，为映像定义指定操作系统类型和会话类型。
  3. 选择现有资源组或创建新资源组以保存映像资源。

  4. 在映像页面上，选择资源（仅列出适用于所设置连接的资源）以及用作创建映像版本模板的映像。

    注意：

    • 在选择映像之前，请验证主映像是否已安装 VDA 2311 或更高版本，并且 VDA 上是否已安装 MCSIO 驱动程序。
    • 对于映像选择，您可以选择 Azure 本地库映像或虚拟机。
  5. 在计算机规范页面上，为准备虚拟机选择 CPU 和内存。
  6. 在网卡页面上，为准备映像选择网卡。对于每个网卡，选择一个关联的虚拟网络。
  7. 在版本描述页面上，输入所创建的初始映像版本的描述。
  8. 在摘要页面上，检查映像定义和所创建的初始映像版本的详细信息。输入映像定义的名称和描述。单击完成。

创建映像版本

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

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

注意：

所有映像版本的托管单元必须相同。

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

注意：

如果映像版本创建因任何原因失败，底部“故障排除”选项卡提供“重试”选项。

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

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

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

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

  1. 选择一个映像版本，然后单击“创建目录”。在“简介”页面上单击“下一步”。
  2. 在“桌面体验”页面上，选择所需的桌面体验。
  3. 从“映像”页面到“NIC”页面，设置会根据所选映像版本预先选择。
  4. 在“资源组”页面上，您可以选择创建新的资源组或使用现有资源组来放置此目录的资源。
  5. 完成以下页面上的所有设置。
  6. 在“摘要”页面上，检查计算机目录的详细信息。输入计算机目录的名称和描述。单击“完成”。
  7. 转到“计算机目录”节点以查看创建的计算机目录。

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

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

  1. 在左侧导航窗格中单击“计算机目录”。
  2. 单击“创建计算机目录”。“计算机目录设置”页面随即显示。在“简介”和“计算机类型”页面上单击“下一步”。

  3. 在“计算机管理”页面上：

    1. 选择“已进行电源管理的计算机（例如，虚拟机或刀片式 PC）”。
    2. 选择 Citrix 预配技术。然后，选择 Citrix 机器创建服务™。
    3. 在“资源”字段中，列出了属于不同区域的资源。选择任何 Azure 网络资源，然后单击“下一步”。

  4. 在“映像”页面上：

    • 对于主映像类型，请执行以下步骤：

      1. 选择“主映像”。
      2. 在“主映像”下，选择一个映像。该面板列出了与“资源”属于同一区域的所有映像。
      3. 单击“完成”。

    • 对于准备好的映像类型，请执行以下步骤：

      1. 选择“准备好的映像”。
      2. 在“准备好的映像”下，选择映像定义的映像版本。如果需要，为所选的准备好的映像版本添加备注。
      3. 单击映像版本名称。要查看有关所选映像版本的更多详细信息，请单击带下划线的版本号。
  5. 请在以下页面上配置相关设置。
  6. 在“资源组”页面上，您可以选择创建新的资源组，或使用现有资源组来放置此目录的资源。
  7. 请完成以下页面上的所有设置。
  8. 在“摘要”页面上，检查计算机目录的详细信息。输入计算机目录的名称和描述。单击“完成”。

Use PowerShell

创建准备好的映像

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

  1. 使用 Test-ProvImageDefinitionNameAvailable command 检查可用的映像定义名称。例如，

    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
<!--NeedCopy-->

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

    New-ProvImageDefinition -ImageDefinitionName arc-ACG-image-climber-demo -OsType Windows -VDASessionSupport SingleSession -Description "arc ACG image for arc"
<!--NeedCopy-->

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

    Add-ProvImageDefinitionConnection -HypervisorConnectionName Azurelocal -ImageDefinitionName arc-ACG-image-climber-demo [-CustomProperties $CustomProperties]
<!--NeedCopy-->

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

    New-ProvImageVersion -ImageDefinitionName arc-ACG-image-climber-demo
<!--NeedCopy-->

  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
<!--NeedCopy-->

    注意：

    只能为一个托管单元的一个映像版本添加一个主映像版本规范。

  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"
<!--NeedCopy-->

创建映像定义、映像版本和准备好的映像版本规范的完整 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"
<!--NeedCopy-->

注意：

  • 映像定义中的所有映像版本规范都必须属于同一个托管单元。
  • 一个映像版本只能有一个主映像版本规范和一个准备好的映像版本规范。

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

使用 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>]
<!--NeedCopy-->

或者，

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>]
<!--NeedCopy-->

创建目录的完整 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
<!--NeedCopy-->

更多信息

后续步骤

在 Azure Local 中创建预准备映像计算机目录
July 9, 2026
投稿者: 
C
July 9, 2026
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.