Citrix Virtual Apps and Desktops

Créer un catalogue Azure Local

May 31, 2026

Contributeur:

(/fr-fr/citrix-virtual-apps-desktops/2511/install-configure/machine-catalogs-create.html) 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. Voir (/fr-fr/citrix-virtual-apps-desktops/2511/install-configure/connections/connection-azure-local.html).

Exigences

Version du VDA : 2507 et versions ultérieures
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é.

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

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 sous le contexte Système. Cette tâche de planification d’une tâche dans l’image principale n’est requise que pour la version 2511 du VDA ou antérieure.

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

Arrêtez la machine virtuelle Azure Local.
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, et décochez la case d’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 pour plus de détails.

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

Web Studio
PowerShell

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 :

Sur la page Système d’exploitation, sélectionnez SE multi-session ou SE mono-session.
Sur la page Gestion des machines :
1. Sélectionnez Machines gérées par l’alimentation (par exemple, machines virtuelles ou PC lames).
2. Sélectionnez de déployer les 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).
Sur la page Expérience de bureau, sélectionnez l’option en fonction du type de machine que vous avez sélectionné sur la page Type de machine.
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.
Sur la page Cartes réseau, sélectionnez une ou plusieurs cartes réseau, associez un réseau virtuel à chaque carte.
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.
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 fournir et de gérer la puissance des machines existantes dans votre cluster Azure Local.

Dans l’assistant de configuration du catalogue de machines :

Sur la page Système d’exploitation, sélectionnez SE multi-session ou SE mono-session.
Sur la page Gestion des machines, sélectionnez Machines gérées par l’alimentation, puis sélectionnez Autre service ou technologie comme méthode de déploiement des machines.
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 VM apparaît. Développez la connexion Azure Local que vous avez créée précédemment et sélectionnez les VM que vous souhaitez ajouter. Ensuite, ajoutez 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 masse. Pour plus d’informations sur l’utilisation des fichiers CSV pour ajouter des machines, consultez Utiliser des fichiers CSV pour ajouter des machines en masse à un catalogue.
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 VM

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 provisionnement

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 provisionnement

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

New-ProvVM -ADAccountName "domain\demoVM1" -ProvisioningSchemeName $catalogName
<!--NeedCopy-->

Ajouter une machine au catalogue du broker

New-BrokerMachine -CatalogName $catalogName -MachineName 'domain\demoVM1'
<!--NeedCopy-->

Étapes suivantes

S’il s’agit du premier catalogue créé, Web Studio vous guide pour (/fr-fr/citrix-virtual-apps-desktops/2511/install-configure/delivery-groups-create.html) [créer un groupe de mise à disposition].
Pour la gestion de l’alimentation des VM Azure Local, consultez (/fr-fr/citrix-virtual-apps-desktops/2511/install-configure/power-management/power-manage-azure-local-vms.html) [Gérer l’alimentation des VM Azure Local].

Plus d’informations

(/fr-fr/citrix-virtual-apps-desktops/2511/install-configure/connections.html) [Créer et gérer des connexions et des ressources]
(/fr-fr/citrix-virtual-apps-desktops/2511/install-configure/connections/connection-azure-local.html) [Connexion à Azure Local]
(/fr-fr/citrix-virtual-apps-desktops/2511/install-configure/machine-catalogs-create.html) [Créer des catalogues de machines]

La version officielle de la documentation de ce produit est en anglais. Toute version dans une langue autre que l’anglais est fournie uniquement à titre indicatif et peut inclure du contenu traduit automatiquement. Pour en savoir plus, veuillez consulter la clause de non-responsabilité relative à la traduction automatique sur Cloud Software Group home.

Cela vous a-t-il été utile ?

Créer un catalogue Azure Local

May 31, 2026

Contributeur:

May 31, 2026

Contributeur:

Cela vous a-t-il été utile ?