创建 Azure Local 目录

Last published : Nov 13, 2026
创建计算机目录 介绍了创建计算机目录的向导。以下信息涵盖了 Azure Local 环境特有的详细信息。
注意:
在创建 Azure Local 计算机目录之前,您需要完成与 Azure Local 的连接。请参阅连接到 Azure Local。

要求

  • VDA 版本:2507 及更高版本
  • 不支持 Windows 10/11 多会话工作负载

创建主映像

创建计算机目录需要主映像。
MCS 使用 Azure Local VM 映像作为主映像。在使用 MCS 在 Azure Local 群集中预配工作负载之前,您需要准备一个已安装 VDA 的 Azure Local VM 映像。
  1. 使用 Azure 门户创建 Azure Local VM。
  2. 连接到创建的 Azure Local VM 以安装 VDA 和所需的软件。
  3. 使用 Windows 任务计划程序创建一个计划任务,以便在虚拟机启动时在系统上下文中运行以下脚本。
    $tagFileName = 'E6DA6616-8EC4-48E0-BE93-58CE6ACE3CFB.tag'

    $foundDrive = $null

    foreach ($drive in Get-PSDrive -PSProvider FileSystem) {

    $tagPath = Join-Path $drive.Root $tagFileName

    if (Test-Path $tagPath) {

        $foundDrive = $drive.Root

        break

    }

    }


    if ([string]::IsNullOrEmpty($foundDrive)) { exit 0 }

    $installScript = Join-Path $foundDrive 'install.ps1'

    if (Test-Path $installScript) {

    powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installScript

    } else { exit 1 }

    sc.exe stop mocguestagent 2>$null

    sc.exe delete mocguestagent 2>$null

    Remove-Item 'HKLM:\SYSTEM\CurrentControlSet\Services\EventLog\Application\mocguestagent' -Recurse -Force -ErrorAction SilentlyContinue

    $setupComplete = 'C:\Windows\Setup\Scripts\SetupComplete.cmd'

    if (Test-Path $setupComplete) { & $setupComplete }
  4. 停止 Azure Local 虚拟机。
  5. 请参阅从现有 Azure Local VM 创建 VM 映像,以从准备好的 Azure Local VM 创建 Azure Local VM 映像。
注意:
当您使用已安装并载入 Azure Connected Machine 代理版本 1.61 或更高版本的 Azure Local VM 准备主映像时,由于删除代理配置文件时访问被拒绝,MCS 中的目录创建在映像准备过程中失败。作为一种解决方法,在创建主映像时执行以下操作:导航到 C:\ProgramData\AzureConnectedMachineAgent\Config\agentconfig.json,右键单击该文件,选择属性,然后清除只读属性复选框。

创建目录

您可以创建 Azure Local 目录,以在 Azure Local 环境中创建、交付和电源管理计算机。
注意:
  • 目录名称的长度不得超过 49 个字符。
  • 避免在目录名称或计算机命名方案中使用 Microsoft Azure 保留字。有关详细信息,请参阅 Microsoft 文档。
您可以使用以下方式创建目录:

使用 Web Studio 创建目录

您可以在 Azure Local 环境中创建 MCS 计算机目录。
在“计算机目录设置”向导中:
  1. 在“操作系统”页面上,选择“多会话操作系统”或“单会话操作系统”。
  2. 在计算机管理页面上:
    1. 选择已进行电源管理的计算机(例如,虚拟机或刀片式 PC)。
    2. 选择使用 Citrix 预配技术部署计算机。
    3. 在 Citrix Machine Creation Services (MCS) 下选择 Azure Local 托管单元。
  3. 在桌面体验页面上,根据您在“计算机类型”页面上选择的计算机类型选择选项。
  4. 在映像页面上:
    1. 选择主映像。目前,Azure Local 不支持准备好的映像。
    2. 您可以向所选映像添加备注。
    注意:
    • 选择主映像后,操作系统类型将自动填充。
    • 不支持计算机配置文件。
  5. 在网卡页面上,选择一个或多个网卡,并将虚拟网络与每个网卡关联。
  6. 在“虚拟机”页面上:
    1. 指定要创建的虚拟机数量。如果您不想创建任何虚拟机,请输入 0。稍后,您可以通过添加计算机为空目录创建 VM。
    2. 选择每个 VM 的内存量(以 MB 为单位)和虚拟 CPU 数量。
    3. 为计算机配置回写缓存以提高 I/O 性能。
  7. 按照屏幕上的说明完成剩余步骤,这些步骤不包含 Azure Local 特有的信息。
您还可以使用 Web Studio 创建 Azure Local 目录,以交付和管理 Azure Local 集群中现有计算机的强大功能。
在“计算机目录设置”向导中:
  1. 在“操作系统”页面上,选择“多会话操作系统”或“单会话操作系统”。
  2. 在“计算机管理”页面上,选择“已进行电源管理的计算机”,然后选择“其他服务或技术”作为部署计算机的方式。
  3. 在虚拟机页面上,添加计算机及其 Active Directory 计算机帐户。您可以:
    • 手动添加计算机:单击添加计算机以手动添加计算机。此时将显示选择 VM窗口。展开您之前创建的 Azure Local 连接,然后选择要添加的 VM。然后添加关联的计算机帐户名称。
    • 使用 CSV 文件添加计算机:单击从 CSV 文件导入以批量添加计算机。有关使用 CSV 文件添加计算机的信息,请参阅使用 CSV 文件批量将计算机添加到目录。
  4. 按照屏幕上的说明完成剩余步骤,这些步骤不包含 Azure Local 特有的信息。

使用 PowerShell 创建目录

您可以使用 PowerShell 命令在 Azure Local 环境中创建 MCS 计算机目录。

脚本头

请确保提供脚本头中定义的正确参数值。
$catalogName = "" # Name of the catalog you want to create

$masterImageResourceGroupName = "" # Name of resource group that the master Azure Local VM image resides in

$catalogResourceGroup = "" # Name of resource group that the created VMs reside in

$masterImage = "" # Name of the master Azure Local VM image you want to use

$vNet = "" # Name of the logical network that the created VMs should be attached to

$masterImagePath = "XDHyp:\HostingUnits\$hostingUnitName\image.folder\$masterImageResourceGroupName.resourcegroup\$masterImage"

$networkMapping = @{"0"="XDHyp:\HostingUnits\$hostingUnitName\\network.folder\$vNet.network"}

$customPropertiesXml = "<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=`"$catalogResourceGroup`" /><Property xsi:type=`"StringProperty`" Name=`"OsType`" Value=`"Windows`" /></CustomProperties>"

创建包含 1 个 VM 的 MCS 目录

运行 asnp citrix*
创建计算机目录
New-BrokerCatalog -AllocationType "Random" -IsRemotePC $false -MinimumFunctionalLevel "L7_34" -Name $catalogName -PersistUserChanges "Discard" -ProvisioningType "MCS" -SessionSupport "SingleSession"
创建身份池
New-AcctIdentityPool -AllowUnicode $true -Domain "test.local" -IdentityPoolName $catalogName -IdentityType "ActiveDirectory" -NamingScheme "demoVM#" -NamingSchemeType "Numeric" -OU "CN=Computers,DC=test,DC=local"
创建预配方案
New-ProvScheme -CleanOnBoot $true -CustomProperties $customPropertiesXml -HostingUnitName $hostingUnitName -IdentityPoolName $catalogName -MasterImageVM $masterImagePath -NetworkMapping $networkMapping -ProvisioningSchemeName $catalogName -ProvisioningSchemeType "MCS" -VMCpuCount 4 -VMMemoryMB 8192
将目录链接到预配方案
$schemeUid =(Get-ProvScheme -ProvisioningSchemeName $catalogName).ProvisioningSchemeUid.Guid

Set-BrokerCatalog -Name $catalogName -ProvisioningSchemeId $schemeUid
创建 AD 帐户
New-AcctADAccount -Count 1 -IdentityPoolName $catalogName
预配 VM
New-ProvVM -ADAccountName "domain\demoVM1" -ProvisioningSchemeName $catalogName
将计算机添加到代理目录
New-BrokerMachine -CatalogName $catalogName -MachineName 'domain\demoVM1'

下一步操作

更多信息