Citrix Virtual Apps and Desktops

Conexión a Azure Local

May 31, 2026

Contribución de:

Crear y administrar conexiones y recursos describe los asistentes que crean una conexión. La siguiente información cubre detalles específicos de los entornos de Azure Local.

Crear una conexión de alojamiento

Puede crear una conexión de host mediante:

Web Studio
PowerShell

Usar Web Studio

En Web Studio, abra Alojamiento > Agregar conexión y recursos.
En la página Conexión, siga estos pasos para configurar la conexión:
1. Seleccione Crear una conexión nueva.
2. Seleccione Microsoft® Azure™ Arc como tipo de conexión.
3. Seleccione un entorno de Azure.
4. Seleccione una zona. Las opciones son todas las ubicaciones de recursos que configuró.
5. Seleccione Otras herramientas para crear máquinas virtuales.
  
  Nota:
  
  Seleccionar Otras herramientas crea solo la conexión de alojamiento sin una unidad de alojamiento.
6. Haga clic en Siguiente.
En la página Detalles de la conexión, introduzca los detalles de la conexión siguiendo las indicaciones del Asistente. Si utiliza un SPN existente, asegúrese de que se le haya concedido el rol de colaborador de la suscripción. Consulte Permisos locales de Azure necesarios para obtener más información.
En la página Ámbitos, seleccione uno o varios ámbitos para esta conexión.
En la página Resumen, compruebe la configuración y haga clic en Finalizar.

Usar PowerShell

Encabezado del script

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

$azureSubscription = "" # Azure Subscription ID

$azureTenantId = "" # Microsoft Entra Tenant ID

$appClientId = "" # Client ID of an Microsoft Entra application which is grant with sufficient permissions

$appClientSecret = "" # Client secret of above client ID

$appClientSecretExpirationDateTimestamp = "" # Client secret expiration date in epoch timestamp format

$region = "" # Azure region of your Azure Local cluster

$resourceGroupName = "" # Azure resource group of your Azure Local cluster

$zoneUid = "" # Zone UID of your resource location

$hostingConnectionName = "" # Name of the created hosting connection
<!--NeedCopy-->

Crear una conexión de alojamiento

asnp citrix*

[SecureString]$appClientSecretSecureString = $appClientSecret | ConvertTo-SecureString -AsPlainText -Force

$conn = New-Item -ConnectionType "Custom" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"SubscriptionId`" Value=`"$azureSubscription`" /><Property xsi:type=`"StringProperty`" Name=`"ManagementEndpoint`" Value=`"https://management.azure.com/`" /><Property xsi:type=`"StringProperty`" Name=`"AuthenticationAuthority`" Value=`"https://login.microsoftonline.com/`" /><Property xsi:type=`"StringProperty`" Name=`"TenantId`" Value=`"$azureTenantId`" /></CustomProperties>" -HypervisorAddress @("https://management.azure.com/") -Path @("XDHyp:\Connections\$hostingConnectionName") -Persist -PluginId "AzureArcFactory" -Scope @() -SecurePassword $appClientSecretSecureString -UserName $appClientId -ZoneUid $zoneUid

New-BrokerHypervisorConnection -HypHypervisorConnectionUid $conn.HypervisorConnectionUid

Set-HypHypervisorConnectionMetadata -HypervisorConnectionUid $conn.HypervisorConnectionUid -Name Citrix_Orchestration_Hypervisor_Secret_Allow_Edit -Value true

Set-HypHypervisorConnectionMetadata -HypervisorConnectionUid $conn.HypervisorConnectionUid -Name Citrix_Orchestration_Hypervisor_Secret_Expiration_Date -Value $appClientSecretExpirationDateTimestamp
<!--NeedCopy-->

Crear una unidad de alojamiento

Puede crear una unidad de alojamiento mediante:

Web Studio
PowerShell

Crear una unidad de alojamiento con Web Studio

En Web Studio, abra Alojamiento > Agregar conexión y recursos.
En la página Conexión:
- Para crear una nueva conexión de alojamiento junto con una unidad de alojamiento, seleccione Crear una conexión nueva y, a continuación, haga lo siguiente:
  1. Seleccione Crear una conexión nueva.
  2. Seleccione Microsoft® Azure™ Arc como tipo de conexión.
  3. Seleccione un entorno de Azure.
  4. Seleccione una zona. Las opciones son todas las ubicaciones de recursos que configuró.
  5. Seleccione Citrix provisioning tools (Machine Creation Services™ o Citrix Provisioning) para crear máquinas virtuales.
  6. Haga clic en Siguiente.
- Para crear unidades de alojamiento a partir de una conexión de host existente, seleccione Usar una conexión existente y, a continuación, elija la conexión pertinente.
En la página Detalles de la conexión, introduzca los detalles de la conexión siguiendo las instrucciones del asistente. Si utiliza un SPN existente, asegúrese de que se le haya concedido el rol de colaborador de la suscripción.
En la página Selección de clúster, explore los grupos de recursos y seleccione el clúster local de Azure de destino.
En la página Selección de almacenamiento, seleccione al menos un dispositivo de almacenamiento para cada tipo de datos compatible antes de poder pasar a la siguiente página del asistente. Para obtener más información sobre la selección de almacenamiento, consulte Almacenamiento de host.
En la página Red, introduzca un nombre para los recursos. Este nombre aparece en Studio para identificar la combinación de almacenamiento y red asociada a la conexión. Seleccione una o varias redes que utilicen las máquinas virtuales.
En la página Resumen, compruebe los detalles y haga clic en Finalizar.

Crear una unidad de alojamiento mediante PowerShell

Encabezado del script

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

$resourceGroupName = "" # Azure resource group of your Azure Local cluster

$clusterName = "" # Name of your Azure Local cluster

$storagePathName = "" # Storage path in your Azure Local cluster that wants to be used in this hosting unit

$logicalNetworkName = "" # Logical network in your Azure Local cluster that wants to be used in this hosting unit

$zoneUid = "" # Zone UID of your resource location

$hostingConnectionName = "" # Name of the created hosting connection

$hostingUnitName = "" # Name of the created hosting unit
<!--NeedCopy-->

Crear una unidad de alojamiento

asnp citrix*

$guid = (New-Guid).Guid

New-HypStorage -StoragePath @("XDHyp:\Connections\$hostingConnectionName\$region.region\$resourceGroupName.resourcegroup\cluster.folder\$clusterName.cluster\storage.folder\$storagePathName.storage") -StorageType "TemporaryStorage" -JobGroup $guid

New-Item -Path XDHyp:\HostingUnits -Name $hostingUnitName -HypervisorConnectionName $hostingConnectionName -RootPath "XDHyp:\Connections\$hostingConnectionName\$region.region\$resourceGroupName.resourcegroup\cluster.folder\$clusterName.cluster" -NetworkPath "XDHyp:\Connections\$hostingConnectionName\$region.region\$resourceGroupName.resourcegroup\cluster.folder\$clusterName.cluster\network.folder\$logicalNetworkName.network" -StoragePath "XDHyp:\Connections\$hostingConnectionName\$region.region\$resourceGroupName.resourcegroup\cluster.folder\$clusterName.cluster\storage.folder\$storagePathName.storage" -JobGroup $guid
<!--NeedCopy-->

Permisos necesarios de Azure Local

El rol de Colaborador tiene acceso total para administrar todos los recursos y proporciona la mejor compatibilidad en el futuro, aunque incluye más permisos de los necesarios con el conjunto de funciones actual. Esta sección detalla los permisos mínimos necesarios para Azure Local.

Permisos mínimos

Gestión de energía de VM

"Microsoft.Resources/tenants/read",

"Microsoft.Resources/subscriptions/read",

"Microsoft.Resources/subscriptions/locations/read",

"Microsoft.Resources/subscriptions/resourceGroups/read",

"Microsoft.AzureStackHCI/VirtualMachines/Read",

"Microsoft.AzureStackHCI/virtualMachineInstances/Read",

"Microsoft.AzureStackHCI/LogicalNetworks/Read",

"Microsoft.AzureStackHCI/StorageContainers/Read",

"Microsoft.AzureStackHCI/Clusters/Read",

"Microsoft.AzureStackHCI/VirtualMachineInstances/start/action",

"Microsoft.AzureStackHCI/VirtualMachineInstances/stop/action",

"Microsoft.AzureStackHCI/VirtualMachineInstances/restart/action"

"Microsoft.ExtendedLocation/CustomLocations/Read",

"Microsoft.KubernetesConfiguration/extensions/read",

"Microsoft.HybridCompute/machines/read"
<!--NeedCopy-->

Crear, actualizar o eliminar máquinas virtuales

"Microsoft.Resources/tenants/read",

"Microsoft.Resources/subscriptions/read",

"Microsoft.Resources/subscriptions/locations/read",

"Microsoft.Resources/subscriptions/resourceGroups/read",

"Microsoft.Resources/subscriptions/resourceGroups/write",

"Microsoft.Resources/subscriptions/resourceGroups/delete",

"Microsoft.HybridCompute/machines/read",

"Microsoft.HybridCompute/machines/write",

"Microsoft.HybridCompute/machines/delete",

"Microsoft.AzureStackHCI/Clusters/Read",

"Microsoft.AzureStackHCI/VirtualMachines/Read",

"Microsoft.AzureStackHCI/VirtualMachines/Write",

"Microsoft.AzureStackHCI/VirtualMachines/Delete",

"Microsoft.AzureStackHCI/virtualMachineInstances/Read",

"Microsoft.AzureStackHCI/virtualMachineInstances/Write",

"Microsoft.AzureStackHCI/virtualMachineInstances/Delete",

"Microsoft.AzureStackHCI/VirtualMachineInstances/start/action",

"Microsoft.AzureStackHCI/VirtualMachineInstances/stop/action",

"Microsoft.AzureStackHCI/VirtualMachineInstances/restart/action",

"Microsoft.AzureStackHCI/LogicalNetworks/Read",

"Microsoft.AzureStackHCI/LogicalNetworks/join/action",

"Microsoft.AzureStackHCI/StorageContainers/Read",

"Microsoft.AzureStackHCI/StorageContainers/deploy/action",

"Microsoft.AzureStackHCI/GalleryImages/Read",

"Microsoft.AzureStackHCI/GalleryImages/Write",

"Microsoft.AzureStackHCI/GalleryImages/Delete",

"Microsoft.AzureStackHCI/GalleryImages/deploy/action",

"Microsoft.AzureStackHCI/NetworkInterfaces/Read",

"Microsoft.AzureStackHCI/NetworkInterfaces/Write",

"Microsoft.AzureStackHCI/NetworkInterfaces/Delete",

"Microsoft.AzureStackHCI/VirtualHardDisks/Read",

"Microsoft.AzureStackHCI/VirtualHardDisks/Write",

"Microsoft.AzureStackHCI/VirtualHardDisks/Delete",

"Microsoft.AzureStackHCI/VirtualHardDisks/upload/action",

"Microsoft.AzureStackHCI/marketplaceGalleryImages/deploy/action",

"Microsoft.ExtendedLocation/CustomLocations/Read",

"Microsoft.ExtendedLocation/customLocations/deploy/action",

"Microsoft.KubernetesConfiguration/extensions/read",

"Microsoft.Compute/disks/read",

"Microsoft.Compute/disks/write",

"Microsoft.Compute/disks/delete",

"Microsoft.Compute/disks/beginGetAccess/action",

"Microsoft.Compute/disks/endGetAccess/action",

"Microsoft.Compute/snapshots/read",

"Microsoft.Compute/snapshots/write",

"Microsoft.Compute/snapshots/delete",

"Microsoft.Compute/snapshots/beginGetAccess/action",

"Microsoft.Compute/snapshots/endGetAccess/action"
<!--NeedCopy-->

Pasos siguientes

Para crear un catálogo de máquinas de Azure Local, consulte Crear un catálogo de máquinas de Azure Local.

Más información

La documentación oficial de este producto está en inglés. Las versiones en otros idiomas se ofrecen solo como referencia y pueden incluir contenido traducido de forma automática. Para obtener más información, consulte la cláusula de exención de responsabilidad sobre traducción automática en Cloud Software Group home.

¿Le ha resultado útil?

Conexión a Azure Local

May 31, 2026

Contribución de:

May 31, 2026

Contribución de:

¿Le ha resultado útil?