Documentation produit
Citrix Virtual Apps and Desktops
Current Release Service 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
Voir PDF

Créer un catalogue Azure Local

July 9, 2026
Contributeur: 
C C

(/fr-fr/citrix-virtual-apps-desktops/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. Consultez Connexion à Azure Local.

Prérequis

  • 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 une image de VM 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 VM Azure Local avec le VDA installé.

  1. Créez une VM Azure Local à l’aide du portail Azure.
  2. Connectez-vous à la VM 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 VM 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 ou antérieure du VDA.

    $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 VM Azure Local.
  5. Reportez-vous à Créer une image de VM à partir d’une VM Azure Local existante pour créer une image de VM Azure Local à partir de la VM 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 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 les 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 :

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 gérées par l’alimentation (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 en fonction du 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 processeurs 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 fournir et de gérer la puissance 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 gérées par l’alimentation, 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 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.
  4. 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

Charger les modules 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

Plus d’informations

Créer un catalogue Azure Local
July 9, 2026
Contributeur: 
C C
July 9, 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.