Documentación de productos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Crear un catálogo de Azure Local

April 7, 2026
Contribución de: 
C C

Crear catálogos de máquinas describe los asistentes que crean un catálogo de máquinas. La siguiente información cubre detalles específicos de los entornos de Azure Local.

Nota:

  • Antes de crear un catálogo de máquinas de Azure Local, debes terminar de crear una conexión a Azure Local. Consulta Conexión a Azure Local.

Requisitos

  • Versión de VDA: 2507 y posteriores
  • No se admite la carga de trabajo de varias sesiones de Windows 10/11

Crear una imagen maestra

Se requiere una imagen maestra para crear un catálogo de máquinas.

MCS utiliza la imagen de VM de Azure Local como imagen maestra. Antes de usar MCS para aprovisionar cargas de trabajo en un clúster de Azure Local, debes preparar una imagen de VM de Azure Local con VDA instalado.

  1. Crea una VM de Azure Local mediante Azure Portal.
  2. Conéctate a la VM de Azure Local creada para instalar VDA y el software necesario.

  3. Crea una tarea programada mediante el Programador de tareas de Windows para ejecutar el siguiente script al iniciar la VM en el contexto del sistema.

    ``` $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 }

    ```

  1. Detén la VM de Azure Local.
  2. Consulta Crear una imagen de VM a partir de una VM de Azure Local existente para crear una imagen de VM de Azure Local a partir de la VM de Azure Local preparada.

Nota:

Cuando preparas una imagen maestra usando una VM de Azure Local con el agente de Azure Connected Machine versión 1.61 o posterior instalado y configurado, la creación del catálogo en MCS falla en el proceso de preparación de la imagen debido a la denegación de acceso al eliminar el archivo de configuración del agente. Como solución alternativa, haz lo siguiente al crear una imagen maestra: Navega hasta C:\ProgramData\AzureConnectedMachineAgent\Config\agentconfig.json, haz clic con el botón derecho en el archivo, selecciona Propiedades y desmarca la casilla de verificación del atributo Solo lectura.

Puedes crear catálogos de Azure Local para crear, entregar y administrar el consumo de energía de las máquinas en tu entorno de Azure Local.

Nota:

-  > -  La longitud del nombre del catálogo no debe superar los 49 caracteres.
-  > -  Evita usar palabras reservadas de Microsoft Azure en el nombre del catálogo o en el esquema de nombres de las máquinas. Consulta el [documento de Microsoft](https://learn.microsoft.com/es-es/azure/azure-resource-manager/troubleshooting/error-reserved-resource-name) para obtener más detalles.

Puedes crear el catálogo usando:

Crear un catálogo con Web Studio

Puedes crear un catálogo de máquinas MCS en el entorno de Azure Local.

En el asistente de configuración del catálogo de máquinas:

  1. En la página Sistema operativo, selecciona SO multisesión o SO de sesión única.
  2. En la página Administración de máquinas:
    1. Selecciona Máquinas con administración de energía (por ejemplo, máquinas virtuales o PC blade).
    2. Selecciona implementar máquinas usando la tecnología de aprovisionamiento de Citrix.
    3. Selecciona la unidad de alojamiento de Azure Local en Citrix Machine Creation Services (MCS).
  3. En la página Experiencia de escritorio, selecciona la opción según el tipo de máquina que hayas seleccionado en la página Tipo de máquina.
  4. En la página Imagen:
    1. Selecciona una imagen maestra. Actualmente, Azure Local no admite imágenes preparadas.
    2. Puedes agregar una nota a la imagen seleccionada.

    Nota:

    -  El tipo de SO se rellena automáticamente después de seleccionar la imagen maestra.
-  No se admite el perfil de máquina.
  5. En la página NIC, selecciona una o varias NIC y asocia una red virtual a cada tarjeta.

  6. En la página Máquinas virtuales:

    1. Especifica cuántas máquinas virtuales quieres crear. Introduce 0 si no quieres crear ninguna. Más tarde, puedes crear VM para un catálogo vacío agregando máquinas.
    2. Elige la cantidad de memoria (en MB) y el número de CPU virtuales que tendrá cada VM.
    3. Configura la caché de reescritura para las máquinas para mejorar el rendimiento de E/S.
  7. Sigue las instrucciones en pantalla para completar los pasos restantes, que no incluyen información específica de Azure Local.

También puedes usar Web Studio para crear catálogos de Azure Local para entregar y administrar el consumo de energía de las máquinas existentes en tu clúster de Azure Local.

En el asistente de configuración del catálogo de máquinas:

  1. En la página Sistema operativo, selecciona SO multisesión o SO de sesión única.
  2. En la página Administración de máquinas, selecciona Máquinas con administración de energía y, a continuación, selecciona Otro servicio o tecnología como método de implementación de máquinas.

  3. En la página Máquinas virtuales, agrega máquinas y sus cuentas de máquina de Active Directory. Puedes:

    • Agregar máquinas manualmente: Haz clic en Agregar máquinas para agregar máquinas manualmente. Aparece la ventana Seleccionar VM. Expande la conexión de Azure Local que creaste anteriormente y selecciona las VM que quieres agregar. Luego, agrega los nombres de las cuentas de máquina asociadas.
    • Agregar máquinas mediante un archivo CSV: Haz clic en Importar desde archivo CSV para agregar máquinas en bloque. Para obtener información sobre cómo usar archivos CSV para agregar máquinas, consulta Usar archivos CSV para agregar máquinas en bloque a un catálogo.
    1. Sigue las instrucciones en pantalla para completar los pasos restantes, que no incluyen información específica de Azure Local.

  • Crear un catálogo con PowerShell

  • Puedes crear un catálogo de máquinas MCS en el entorno de Azure Local usando comandos de PowerShell.

Encabezado del script

Asegúrate de proporcionar los valores de parámetro correctos definidos en el encabezado del script.

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

Crear un catálogo MCS con 1 VM

asnp citrix*

Crear catálogo de máquinas 
New-BrokerCatalog -AllocationType "Random" -IsRemotePC $false -MinimumFunctionalLevel "L7_34" -Name $catalogName -PersistUserChanges "Discard" -ProvisioningType "MCS" -SessionSupport "SingleSession"
<!--NeedCopy-->
Crear grupo de identidades 
New-AcctIdentityPool -AllowUnicode $true -Domain "test.local" -IdentityPoolName $catalogName -IdentityType "ActiveDirectory" -NamingScheme "demoVM#" -NamingSchemeType "Numeric" -OU "CN=Computers,DC=test,DC=local" 
<!--NeedCopy-->
Crear esquema de aprovisionamiento 
New-ProvScheme -CleanOnBoot $true -CustomProperties $customPropertiesXml -HostingUnitName $hostingUnitName -IdentityPoolName $catalogName -MasterImageVM $masterImagePath -NetworkMapping $networkMapping -ProvisioningSchemeName $catalogName -ProvisioningSchemeType "MCS" -VMCpuCount 4 -VMMemoryMB 8192 
<!--NeedCopy-->
Vincular catálogo a esquema de aprovisionamiento 
$schemeUid =(Get-ProvScheme -ProvisioningSchemeName $catalogName).ProvisioningSchemeUid.Guid 

Set-BrokerCatalog -Name $catalogName -ProvisioningSchemeId $schemeUid 
<!--NeedCopy-->
Crear cuenta de AD 
New-AcctADAccount -Count 1 -IdentityPoolName $catalogName 
<!--NeedCopy-->
Aprovisionar VM 
New-ProvVM -ADAccountName "domain\demoVM1" -ProvisioningSchemeName $catalogName 
<!--NeedCopy-->
Agregar máquina al catálogo del agente 
New-BrokerMachine -CatalogName $catalogName -MachineName 'domain\demoVM1'
<!--NeedCopy-->

Pasos siguientes

Más información

Crear un catálogo de Azure Local
April 7, 2026
Contribución de: 
C C
April 7, 2026
Contribución de: 
C C

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.