Citrix Virtual Apps and Desktops

Connexion à Azure Local

Créer et gérer des connexions et des ressources décrit les assistants qui créent une connexion. Les informations suivantes couvrent les détails spécifiques aux environnements Azure Local.

  • Créer une connexion d’hébergement

Vous pouvez créer une connexion d’hôte à l’aide de :

Utiliser Web Studio

  1. Dans Web Studio, ouvrez Hébergement > Ajouter une connexion et des ressources.
  2. Sur la page Connexion, suivez ces étapes pour configurer la connexion :

    1. Sélectionnez Créer une nouvelle connexion.
    2. Sélectionnez Microsoft® Azure™ Arc comme type de connexion.
    3. Sélectionnez un environnement Azure.
    4. Sélectionnez une zone. Les options sont tous les emplacements de ressources que vous avez configurés.
    5. Sélectionnez Autres outils pour créer des machines virtuelles.

      Remarque :

      La sélection d’Autres outils crée uniquement la connexion d’hébergement sans unité d’hébergement.

    6. Cliquez sur Suivant.
  3. Sur la page Détails de la connexion, entrez les détails de la connexion en suivant les instructions de l’Assistant. Si vous utilisez un SPN existant, assurez-vous que le rôle de contributeur de l’abonnement a été accordé au SPN. Consultez Autorisations Azure Local requises pour plus d’informations.

  4. Sur la page Étendues, sélectionnez une ou plusieurs étendues pour cette connexion.
  5. Sur la page Résumé, vérifiez la configuration et cliquez sur Terminer.

Utiliser PowerShell

En-tête du script

Assurez-vous de fournir les valeurs de paramètre correctes définies dans l’en-tête du 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-->

Créer une connexion d’hébergement

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

Créer une unité d’hébergement

Vous pouvez créer une unité d’hébergement à l’aide de :

-  [Web Studio](#create-a-hosting-unit-use-web-studio)
-  [PowerShell](#create-a-hosting-unit-using-powershell)

Créer une unité d’hébergement à l’aide de Web Studio

  1. Dans Web Studio, ouvrez Hébergement > Ajouter une connexion et des ressources.
  2. Sur la page Connexion :

    • Pour créer une nouvelle connexion d’hébergement avec une unité d’hébergement, sélectionnez Créer une nouvelle connexion, puis effectuez les opérations suivantes :

      1. Sélectionnez Créer une nouvelle connexion.
      2. Sélectionnez Microsoft® Azure™ Arc comme type de connexion.
      3. Sélectionnez un environnement Azure.
      4. Sélectionnez une zone. Les options sont tous les emplacements de ressources que vous avez configurés.
      5. Sélectionnez Outils de provisionnement Citrix (Machine Creation Services™ ou Citrix Provisioning) pour créer des machines virtuelles.
      6. Cliquez sur Suivant.
    • Pour créer des unités d’hébergement à partir d’une connexion d’hôte existante, sélectionnez Utiliser une connexion existante, puis choisissez la connexion pertinente.

  3. Sur la page Détails de la connexion, entrez les détails de la connexion en suivant les instructions de l’Assistant. Si vous utilisez un SPN existant, assurez-vous que le rôle de contributeur de l’abonnement a été accordé au SPN.
  4. Sur la page Sélection du cluster, parcourez les groupes de ressources et sélectionnez le cluster Azure Local cible.
  5. Sur la page Sélection du stockage, sélectionnez au moins un périphérique de stockage pour chaque type de données pris en charge avant de pouvoir passer à la page suivante de l’assistant. Pour plus d’informations sur la sélection du stockage, consultez Stockage d’hôte.
  6. Sur la page Réseau, entrez un nom pour les ressources. Ce nom apparaît dans Studio pour identifier la combinaison de stockage et de réseau associée à la connexion. Sélectionnez un ou plusieurs réseaux utilisés par les machines virtuelles.
  7. Sur la page Résumé, vérifiez les détails et cliquez sur Terminer.

Créer une unité d’hébergement à l’aide de PowerShell

En-tête du script

Assurez-vous de fournir les valeurs de paramètre correctes définies dans l’en-tête du 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-->

Créer une unité d’hébergement

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

Autorisations Azure Local requises

Le rôle de contributeur dispose d’un accès complet pour la gestion de toutes les ressources et offre la meilleure compatibilité à l’avenir, bien qu’il inclue plus d’autorisations que nécessaire avec l’ensemble de fonctionnalités actuel. Cette section détaille les autorisations minimales requises pour Azure Local.

Autorisations minimales

Gestion de l’alimentation des machines virtuelles

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

Création, mise à jour ou suppression de machines virtuelles

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

Étapes suivantes

Plus d’informations

Connexion à Azure Local