Citrix Virtual Apps and Desktops

Conexão com o Azure Local

May 31, 2026

Contribuição de:

Criar e gerenciar conexões e recursos descreve os assistentes que criam uma conexão. As informações a seguir cobrem detalhes específicos para ambientes Azure Local.

Criar uma conexão de hospedagem

Você pode criar uma conexão de host usando:

Web Studio
PowerShell

Usar o Web Studio

No Web Studio, abra Hospedagem > Adicionar Conexão e Recursos.
Na página Conexão, siga estas etapas para configurar a conexão:
1. Selecione Criar uma nova conexão.
2. Selecione Microsoft® Azure™ Arc como o tipo de conexão.
3. Selecione um ambiente Azure.
4. Selecione uma zona. As opções são todos os locais de recursos que você configurou.
5. Selecione Outras ferramentas para criar máquinas virtuais.
  
  Nota:
  
  Selecionar Outras ferramentas cria apenas a conexão de hospedagem sem uma unidade de hospedagem.
6. Clique em Avançar.
Na página Detalhes da Conexão, insira os detalhes da conexão seguindo as orientações do Assistente. Se você usar um SPN existente, certifique-se de que o SPN tenha recebido a função de colaborador da assinatura. Verifique Permissões Locais do Azure Necessárias para obter mais informações.
Na página Escopos, selecione um ou mais escopos para esta conexão.
Na página Resumo, verifique a configuração e clique em Concluir.

Usar PowerShell

Cabeçalho do script

Certifique-se de fornecer os valores de parâmetro corretos definidos no cabeçalho do 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-->

Criar uma conexão de hospedagem

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

Criar uma unidade de hospedagem

Você pode criar uma unidade de hospedagem usando:

Web Studio
PowerShell

Criar uma unidade de hospedagem Usar Web Studio

No Web Studio, abra Hospedagem > Adicionar Conexão e Recursos.
Na página Conexão:
- Para criar uma nova conexão de hospedagem junto com uma unidade de hospedagem, selecione Criar uma nova conexão e, em seguida, faça o seguinte:
  1. Selecione Criar uma nova conexão.
  2. Selecione Microsoft® Azure™ Arc como o tipo de conexão.
  3. Selecione um ambiente Azure.
  4. Selecione uma zona. As opções são todos os locais de recursos que você configurou.
  5. Selecione Ferramentas de provisionamento Citrix (Machine Creation Services™ ou Citrix Provisioning) para criar máquinas virtuais.
  6. Clique em Avançar.
- Para criar unidades de hospedagem a partir de uma conexão de host existente, selecione Usar uma conexão existente e, em seguida, escolha a conexão relevante.
Na página Detalhes da Conexão, insira os detalhes da conexão seguindo as orientações do Assistente. Se você usar um SPN existente, certifique-se de que o SPN tenha recebido a função de colaborador da assinatura.
Na página Seleção de Cluster, navegue pelos grupos de recursos e selecione o cluster Azure Local de destino.
Na página Seleção de Armazenamento, selecione pelo menos um dispositivo de armazenamento para cada tipo de dados suportado antes de prosseguir para a próxima página do assistente. Para obter mais informações sobre a seleção de armazenamento, consulte Armazenamento do host.
Na página Rede, insira um nome para os recursos. Esse nome aparece no Studio para identificar a combinação de armazenamento e rede associada à conexão. Selecione uma ou mais redes que as VMs usam.
Na página Resumo, verifique os detalhes e clique em Concluir.

Criar uma unidade de hospedagem usando PowerShell

Cabeçalho do script

Certifique-se de fornecer os valores de parâmetro corretos definidos no cabeçalho do 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-->

Criar uma unidade de hospedagem

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

Permissões necessárias do Azure Local

A função de Colaborador tem acesso total para gerenciar todos os recursos e oferece a melhor compatibilidade daqui para frente, embora inclua mais permissões do que o necessário com o conjunto de recursos atual. Esta seção detalha as permissões mínimas necessárias para o Azure Local.

Permissões mínimas

Gerenciamento de energia de VMs

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

Criar, atualizar ou excluir VMs

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

Onde ir a seguir

Para criar um catálogo de máquinas do Azure Local, consulte Criar um catálogo de máquinas do Azure Local.

Mais informações

A versão oficial desta documentação do produto está em inglês. Qualquer versão em outro idioma é fornecida apenas para sua conveniência e pode incluir conteúdo traduzido automaticamente. Para obter mais informações, consulte o Aviso Legal sobre Tradução Automática em Cloud Software Group home.

Isso foi útil?

Conexão com o Azure Local

May 31, 2026

Contribuição de:

May 31, 2026

Contribuição de:

Isso foi útil?