Documentation produit
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Voir PDF

Créer un catalogue Azure Local

April 8, 2026
Contributeur: 
C C

Créer des catalogues de machines décrit les assistants qui créent un catalogue de machines. Les informations suivantes couvrent les détails spécifiques aux environnements Azure Local.

Remarque :

  • Avant de créer un catalogue de machines Azure Local, vous devez terminer la création d’une connexion à Azure Local. Consultez Connexion à Azure Local.

Exigences

  • Version du VDA : 2507 et ultérieure
  • La charge de travail multi-session Windows 10/11 n’est pas prise en charge

Créer une image principale

Une image principale est requise pour créer un catalogue de machines.

MCS utilise l’image de machine virtuelle Azure Local comme image principale. Avant d’utiliser MCS pour provisionner une charge de travail dans un cluster Azure Local, vous devez préparer une image de machine virtuelle Azure Local avec le VDA installé.

  1. Créez une machine virtuelle Azure Local à l’aide du portail Azure.
  2. Connectez-vous à la machine virtuelle Azure Local créée pour installer le VDA et les logiciels requis.

  3. Créez une tâche planifiée à l’aide du Planificateur de tâches Windows pour exécuter le script suivant au démarrage de la machine virtuelle dans le contexte système.

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

<!--NeedCopy-->
  4. Arrêtez la machine virtuelle Azure Local.
  5. Reportez-vous à Créer une image de machine virtuelle à partir d’une machine virtuelle Azure Local existante pour créer une image de machine virtuelle Azure Local à partir de la machine virtuelle Azure Local préparée.

Remarque :

Lorsque vous préparez une image principale à l’aide d’une machine virtuelle Azure Local avec l’agent Azure Connected Machine version 1.61 ou ultérieure installé et intégré, la création du catalogue dans MCS échoue lors du processus de préparation de l’image en raison d’un refus d’accès lors de la suppression du fichier de configuration de l’agent. Pour contourner ce problème, procédez comme suit lors de la création d’une image principale : accédez à C:\ProgramData\AzureConnectedMachineAgent\Config\agentconfig.json, cliquez avec le bouton droit sur le fichier, sélectionnez Propriétés, puis désactivez la case à cocher de l’attribut Lecture seule.

Créer un catalogue

Vous pouvez créer des catalogues Azure Local pour créer, distribuer et gérer l’alimentation des machines dans votre environnement Azure Local.

Remarque :

-  > -  La longueur du nom du catalogue ne doit pas dépasser 49 caractères.
-  > -  Évitez d’utiliser des mots réservés de Microsoft Azure dans le nom du catalogue ou le schéma de dénomination des machines. Consultez le [document Microsoft](https://learn.microsoft.com/fr-fr/azure/azure-resource-manager/troubleshooting/error-reserved-resource-name) pour plus de détails.

Vous pouvez créer le catalogue à l’aide de :

Créer un catalogue à l’aide de Web Studio

Vous pouvez créer un catalogue de machines MCS dans l’environnement Azure Local.

Dans l’assistant de configuration du catalogue de machines :

  1. Sur la page Système d’exploitation, sélectionnez SE multi-session ou SE mono-session.
  2. Sur la page Gestion des machines :
    1. Sélectionnez Machines dont l’alimentation est gérée (par exemple, machines virtuelles ou PC lames).
    2. Sélectionnez de déployer des machines à l’aide de la technologie de provisioning Citrix.
    3. Sélectionnez l’unité d’hébergement Azure Local sous Citrix Machine Creation Services (MCS).
  3. Sur la page Expérience de bureau, sélectionnez l’option correspondant au type de machine que vous avez sélectionné sur la page Type de machine.
  4. Sur la page Image :
    1. Sélectionnez une image principale. Actuellement, Azure Local ne prend pas en charge les images préparées.
    2. Vous pouvez ajouter une note à l’image sélectionnée.

    Remarque :

    -  Le type de système d’exploitation est automatiquement renseigné après la sélection de l’image principale.
-  Le profil de machine n’est pas pris en charge.
  5. Sur la page Cartes réseau, sélectionnez une ou plusieurs cartes réseau, associez un réseau virtuel à chaque carte.

  6. Sur la page Machines virtuelles :

    1. Spécifiez le nombre de machines virtuelles à créer. Entrez 0 si vous ne souhaitez en créer aucune. Plus tard, vous pourrez créer des machines virtuelles pour un catalogue vide en ajoutant des machines.
    2. Choisissez la quantité de mémoire (en Mo) et le nombre de CPU virtuels de chaque machine virtuelle.
    3. Configurez le cache en écriture différée pour les machines afin d’améliorer les performances d’E/S.
  7. Suivez les instructions à l’écran pour terminer les étapes restantes, qui n’incluent pas d’informations spécifiques à Azure Local.

Vous pouvez également utiliser Web Studio pour créer des catalogues Azure Local afin de distribuer et de gérer l’alimentation des machines existantes dans votre cluster Azure Local.

Dans l’assistant de configuration du catalogue de machines :

  1. Sur la page Système d’exploitation, sélectionnez SE multi-session ou SE mono-session.
  2. Sur la page Gestion des machines, sélectionnez Machines dont l’alimentation est gérée, puis sélectionnez Autre service ou technologie comme méthode de déploiement des machines.

  3. Sur la page Machines virtuelles, ajoutez des machines et leurs comptes de machine Active Directory. Vous pouvez :

    • Ajouter des machines manuellement : cliquez sur Ajouter des machines pour ajouter des machines manuellement. La fenêtre Sélectionner des machines virtuelles apparaît. Développez la connexion Azure Local que vous avez créée précédemment et sélectionnez les machines virtuelles que vous souhaitez ajouter. Ajoutez ensuite les noms de compte de machine associés.
    • Ajouter des machines à l’aide d’un fichier CSV : cliquez sur Importer à partir d’un fichier CSV pour ajouter des machines en bloc. Pour plus d’informations sur l’utilisation des fichiers CSV pour ajouter des machines, consultez Utiliser des fichiers CSV pour ajouter des machines en bloc à un catalogue.
    1. Suivez les instructions à l’écran pour terminer les étapes restantes, qui n’incluent pas d’informations spécifiques à Azure Local.

  • Créer un catalogue à l’aide de PowerShell

  • Vous pouvez créer un catalogue de machines MCS dans l’environnement Azure Local à l’aide de commandes 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.

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

Créer un catalogue MCS avec 1 machine virtuelle

asnp citrix*

Créer un catalogue de machines 
New-BrokerCatalog -AllocationType "Random" -IsRemotePC $false -MinimumFunctionalLevel "L7_34" -Name $catalogName -PersistUserChanges "Discard" -ProvisioningType "MCS" -SessionSupport "SingleSession"
<!--NeedCopy-->
Créer un pool d’identités 
New-AcctIdentityPool -AllowUnicode $true -Domain "test.local" -IdentityPoolName $catalogName -IdentityType "ActiveDirectory" -NamingScheme "demoVM#" -NamingSchemeType "Numeric" -OU "CN=Computers,DC=test,DC=local" 
<!--NeedCopy-->
Créer un schéma de provisioning 
New-ProvScheme -CleanOnBoot $true -CustomProperties $customPropertiesXml -HostingUnitName $hostingUnitName -IdentityPoolName $catalogName -MasterImageVM $masterImagePath -NetworkMapping $networkMapping -ProvisioningSchemeName $catalogName -ProvisioningSchemeType "MCS" -VMCpuCount 4 -VMMemoryMB 8192 
<!--NeedCopy-->
Lier le catalogue au schéma de provisioning 
$schemeUid =(Get-ProvScheme -ProvisioningSchemeName $catalogName).ProvisioningSchemeUid.Guid 

Set-BrokerCatalog -Name $catalogName -ProvisioningSchemeId $schemeUid 
<!--NeedCopy-->
Créer un compte AD 
New-AcctADAccount -Count 1 -IdentityPoolName $catalogName 
<!--NeedCopy-->
Provisionner la machine virtuelle 
New-ProvVM -ADAccountName "domain\demoVM1" -ProvisioningSchemeName $catalogName 
<!--NeedCopy-->
Ajouter une machine au catalogue de brokers 
New-BrokerMachine -CatalogName $catalogName -MachineName 'domain\demoVM1'
<!--NeedCopy-->

Étapes suivantes

Plus d’informations

Créer un catalogue Azure Local
April 8, 2026
Contributeur: 
C C
April 8, 2026
Contributeur: 
C C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.