Gestion des images (Aperçu)

Introduction

Le processus de création ou de mise à jour du catalogue MCS comporte deux phases :

• Maîtrise : une image source est convertie en image publiée
• Clonage : de nouvelles machines virtuelles sont créées à partir de l’image publiée

Grâce à la fonctionnalité de gestion des images, MCS sépare la phase de maîtrise du flux de travail global de provisionnement.

Vous pouvez préparer différentes versions d’images MCS (Image préparée) à partir d’une seule image source et les utiliser dans plusieurs catalogues de machines MCS différents. Cette implémentation réduit considérablement les coûts de stockage et de temps, et simplifie le processus de déploiement des machines virtuelles et de mise à jour des images.

Les avantages de l’utilisation de cette fonctionnalité de gestion des images sont :

• Générer des images préparées à l’avance sans créer de catalogue.
• Réutiliser les images préparées dans plusieurs scénarios, tels que la création et la mise à jour d’un catalogue.
• Réduire considérablement le temps de création ou de mise à jour du catalogue.

Remarque :

• Cette fonctionnalité est actuellement applicable aux environnements de virtualisation Azure et VMware.
• Vous pouvez créer un catalogue de machines MCS sans utiliser d’images préparées. Dans ce cas, vous ne bénéficierez pas des avantages de la fonctionnalité.

Cas d’utilisation

Voici quelques cas d’utilisation de la fonctionnalité de gestion d’images :

• Gestion des versions : Les versions d’image vous permettent de :

  • gérer différentes itérations ou mises à jour d’une image particulière.
  • maintenir plusieurs versions d’une image à des fins différentes.

• Regroupement logique : Vous pouvez créer plusieurs définitions d’image pour :

  • regrouper logiquement les versions d’image en fonction de divers critères tels que le projet, le service ou le type d’application et de bureau.
  • gérer les images plus efficacement au sein d’une organisation.

Qu’est-ce qu’une image préparée ?

Avec la fonctionnalité de gestion d’images, MCS dissocie la phase de création de l’image principale du flux de travail global de création ou de mise à jour du catalogue et divise le processus en deux étapes :

1. Créer des images préparées à partir d’une seule image source.
2. Utiliser l’image préparée pour créer ou mettre à jour un catalogue de machines MCS.

Vous pouvez créer les images préparées à l’avance. Vous pouvez utiliser une seule image préparée pour créer ou mettre à jour plusieurs catalogues de machines provisionnés par MCS.

Comprenez comment une image préparée est utilisée dans plusieurs catalogues de machines MCS lorsque vous utilisez le Web Studio à partir de l’image :

Définition d’image : Les définitions d’image sont un regroupement logique de versions d’une image. La définition d’image contient des informations sur :

• pourquoi l’image a été créée
• pour quel OS
• d’autres informations sur l’utilisation de l’image.

Un catalogue n’est pas créé à partir d’une définition d’image, mais à partir des versions d’image qui sont créées sur la base de la définition d’image.

Version d’image : Les versions d’image gèrent le versioning pour la définition d’image. Une définition d’image peut avoir plusieurs versions d’image. Utilisez les versions d’image comme images préparées pour créer ou mettre à jour un catalogue.

Alternativement, si vous souhaitez utiliser des commandes PowerShell pour créer un schéma de provisionnement afin de créer ou de mettre à jour un catalogue, vous devez créer une spécification de version d’image préparée basée sur la spécification de version d’image principale, selon les besoins de votre environnement.

Participer à la préversion technique

Si vous souhaitez participer à la préversion technique, veuillez fournir vos coordonnées ici.

Nous vous aiderons à configurer l’environnement de test et vous fournirons un support technique si nécessaire.

Exigence

• Pour les images principales Windows, seules les images VDA version 2311 ou ultérieure sont prises en charge. Le composant MCS/IO doit être explicitement sélectionné et installé. L’activation ou la désactivation de la configuration MCS I/O doit être déterminée lors de la création ou des mises à jour du catalogue de machines, car elle n’est pas activée par défaut.

Limitations

Actuellement, la fonctionnalité ne prend pas en charge les éléments suivants :

• Plusieurs cartes réseau dans Azure
• Fonctionnalité de disque de données persistant
• Mise en veille prolongée pour les sessions multiples
• Changement de type d’image

Gestion du cycle de vie des images à l’aide de Web Studio

Le cycle de vie de l’image lorsque vous utilisez Web Studio est le suivant :

1. Créer une image préparée : Créez une définition d’image et sa version d’image initiale.
2. Créer des versions d’image à partir de la version d’image initiale.
3. Utiliser une version d’image comme image préparée pour créer des catalogues.
4. Mettre à jour un catalogue de machines avec une image préparée différente.
5. Gérer les définitions et les versions d’image : Modifiez le nom et la description des versions d’image, et la description d’une définition d’image.
6. Supprimer une version d’image.
7. Supprimer une définition d’image.

Vous pouvez également gérer les images à l’aide de PowerShell. Voir Gestion du cycle de vie des images à l’aide de PowerShell.

Créer ou mettre à jour un catalogue à l’aide d’une image préparée

Créez des images préparées et utilisez-les pour créer ou mettre à jour un catalogue de machines MCS à l’aide de :

• Web Studio
• Commandes PowerShell

Utiliser Web Studio

Consultez les rubriques suivantes :

• Comprendre le nœud Images
• Créer une définition d’image et une version d’image initiale
• Créer des versions d’image
• Créer un catalogue de machines à partir du nœud Images
• Créer un catalogue de machines à partir du nœud Catalogues de machines
• Mettre à jour un catalogue de machines avec une image préparée différente
• Gérer les définitions et les versions d’image

Comprendre le nœud Images

Utilisez le nœud Images pour créer et gérer des images préparées par MCS. Sa vue principale est divisée en quatre parties :

Créer un catalogue de machines à l’aide de l’image préparée

Les étapes clés pour créer un catalogue de machines MCS à l’aide de l’image préparée sont les suivantes :

1. Créez la définition d’image et les versions d’image initiales.
2. Utilisez la version d’image comme image préparée pour créer un catalogue.

Créer une définition d’image et une version d’image initiale

Pour créer une définition d’image et la version d’image initiale, procédez comme suit :

1. Connectez-vous à Web Studio et sélectionnez le nœud Images. Cliquez sur Suivant sur la page Introduction.
2. Sur la page Définition d’image, spécifiez le type de système d’exploitation et le type de session pour la définition d’image.

3. Sur la page Image, sélectionnez Ressources et une image principale à utiliser comme modèle pour créer la version de l’image. Vous pouvez cocher la case Utiliser un profil de machine et sélectionner un profil de machine.

   Remarque :

   Avant de sélectionner une image, vérifiez que l’image principale a VDA 2311 ou une version ultérieure installée et que le pilote MCSIO est installé sur le VDA.

4. (Uniquement pour Azure) Sur la page Types de stockage et de licences, sélectionnez le type de stockage et de licence à utiliser dans le cadre du processus de préparation de l’image.

   Remarque :

   Si vous sélectionnez un profil de machine sur la page Image, le type de licence du profil de machine est présélectionné en fonction du paramètre du profil.

5. Sur la page Spécification de la machine :

   • Pour Azure, sélectionnez une taille de machine. Si vous sélectionnez un profil de machine sur la page Image, la taille de machine du profil de machine est sélectionnée par défaut.
   • Pour VMware, si vous sélectionnez un profil de machine, vous pouvez voir le nombre de CPU virtuels dérivé du profil de machine et il est immuable. Si vous ne sélectionnez pas de profil de machine, vous ne pouvez voir que la taille de la mémoire dérivée de l’image principale.

6. Sur la page Cartes réseau, sélectionnez ou ajoutez des cartes réseau pour l’image de préparation. Pour chaque carte réseau, sélectionnez un réseau virtuel associé.

   Pour VMware, si vous ne sélectionnez pas de profil de machine, la carte réseau associée à l’image principale est sélectionnée par défaut. Si vous sélectionnez un profil de machine, les cartes réseau sont dérivées du profil de machine et le nombre est immuable.

   Remarque :

   Plusieurs cartes réseau ne sont pas prises en charge dans Azure.

7. (Uniquement pour Azure) Sur la page Paramètres du disque, sélectionnez la clé de chiffrement gérée par le client (CMEK). Si le profil de machine n’a pas de CMEK mais que l’image principale en a une, il présélectionne la CMEK de l’image principale.
8. Sur la page Description de la version, saisissez une description pour la version initiale de l’image créée.
9. Sur la page Résumé, vérifiez les détails de la définition d’image et de la version d’image initiale créée. Saisissez un nom et une description pour la définition d’image. Cliquez sur Terminer.

Créer des versions d’image

Les versions d’image permettent la gestion de différentes itérations ou mises à jour d’une image particulière. Cette fonctionnalité vous permet de maintenir plusieurs versions d’une image à des fins différentes.

Pour créer des versions d’image à partir de la version d’image initiale, procédez comme suit :

Remarque :

L’unité d’hébergement de toutes les versions d’image doit être la même.

1. Accédez au nœud Images, sélectionnez une version d’image, puis sélectionnez Créer une version d’image.
2. Si vous souhaitez que la configuration de la version d’image soit différente de la version d’image configurée initialement, configurez les paramètres sur les pages Image, Types de stockage et de licence, Spécification de la machine, Cartes réseau et Paramètres de disque de la boîte de dialogue Créer une version d’image.
3. Ajoutez une description pour la version d’image. Cliquez sur Terminer.

Créer un catalogue de machines à partir du nœud Images

Utilisez l’option Créer un catalogue dans le nœud Images pour créer un catalogue à l’aide de la version d’image.

Vous pouvez également sélectionner la version lors de la création d’un catalogue dans le nœud Catalogues de machines, en la liant à l’option d’image préparée dans le flux de travail de création de catalogue. Voir Créer un catalogue de machines à partir du nœud Catalogues de machines

Pour créer un catalogue de machines MCS à partir du nœud Images, procédez comme suit :

1. Sélectionnez une version d’image et cliquez sur Créer un catalogue. Cliquez sur Suivant sur la page Introduction.
2. Sur la page Expérience de bureau, sélectionnez l’expérience de bureau requise.
3. De la page Image à la page Paramètres de disque, les paramètres sont présélectionnés en fonction de la version d’image sélectionnée.
4. (Pour Azure) Sur la page Groupe de ressources, vous pouvez choisir de créer un nouveau groupe de ressources ou d’utiliser un groupe de ressources existant pour placer les ressources de ce catalogue.
5. Terminez les paramètres sur les pages suivantes.
6. Sur la page Résumé, vérifiez les détails du catalogue de machines. Saisissez un nom et une description pour le catalogue de machines. Cliquez sur Terminer.
7. Accédez au nœud Catalogues de machines pour voir le catalogue de machines créé.

Créer un catalogue de machines à partir du nœud Catalogues de machines

Pour créer un catalogue de machines MCS à partir du nœud Catalogues de machines, procédez comme suit :

1. Cliquez sur Catalogues de machines dans le volet de navigation de gauche.
2. Cliquez sur Créer un catalogue de machines. La page Configuration du catalogue de machines apparaît. Cliquez sur Suivant pour passer les pages Introduction, Type de machine et Gestion des machines.
3. Sur la page Image :
   1. Sélectionnez Image préparée.
   2. Sous l’Image préparée, sélectionnez une version d’image d’une définition d’image.
   3. Cliquez sur le nom de la version de l’image. Pour afficher plus de détails sur la version d’image sélectionnée, cliquez sur le numéro de version, qui est souligné.
   4. Si la version d’image sélectionnée est configurée avec un profil de machine, sélectionnez un profil de machine. Si la version d’image sélectionnée n’est pas configurée avec un profil de machine, vous ne pouvez pas choisir d’utiliser un profil de machine.
4. Configurez les paramètres sur les pages suivantes.
5. Sur la page Paramètres du disque, si l’image préparée sélectionnée utilise un ensemble de chiffrement de disque, vous ne pouvez pas supprimer l’ensemble de chiffrement, mais vous pouvez changer la clé pour une autre clé de chiffrement.
6. (Pour Azure) Sur la page Groupe de ressources, vous pouvez choisir de créer un nouveau groupe de ressources ou d’utiliser un groupe de ressources existant pour placer les ressources de ce catalogue.
7. Terminez la configuration sur les pages suivantes.
8. Sur la page Résumé, vérifiez les détails du catalogue de machines. Saisissez un nom et une description pour le catalogue de machines. Cliquez sur Terminer.

Mettre à jour un catalogue de machines avec une image préparée différente

Pour mettre à jour un catalogue de machines MCS existant avec une image préparée différente, procédez comme suit :

1. Cliquez sur Catalogues de machines dans le volet de navigation de gauche et sélectionnez un catalogue de machines que vous souhaitez mettre à jour. Cliquez avec le bouton droit de la souris et sélectionnez Modifier l’image préparée.
2. Sur la page Image, sélectionnez une image préparée.
3. Sur la page Stratégie de déploiement, sélectionnez le moment où vous souhaitez mettre à jour ce catalogue avec l’image préparée sélectionnée.
4. Sur la page Résumé, vérifiez les détails. Cliquez sur Terminer.

Vous pouvez consulter l’historique des modifications d’image apportées à un catalogue. Pour consulter l’historique, procédez comme suit :

1. Sélectionnez un catalogue de machines.
2. Sous l’onglet Propriétés du modèle, dans le champ Image préparée, cliquez sur Afficher l’historique des images.

Gérer les définitions et les versions d’image

Vous pouvez modifier et supprimer les définitions et versions d’images pour gérer l’utilisation des différentes versions et définitions d’images créées.

Modifier une définition d’image

Vous pouvez modifier le nom et la description d’une définition d’image.

Pour modifier une définition d’image, procédez comme suit :

1. Accédez au nœud Images, sélectionnez une définition d’image, puis sélectionnez Modifier la définition d’image.

Modifier la version de l’image

Vous pouvez modifier la description d’une version d’image pour spécifier l’objectif de cette version d’image.

Pour modifier une version d’image, procédez comme suit :

1. Accédez au nœud Images, sélectionnez une version d’image, puis sélectionnez Modifier la description.

Supprimer une version d’image

Pour supprimer une version d’image, procédez comme suit :

1. Accédez au nœud Images, sélectionnez une version d’image, puis sélectionnez Supprimer la version d’image.

Remarque :

Vous ne pouvez pas supprimer une version d’image si elle est utilisée par un catalogue de machines.

Supprimer une définition d’image

Pour supprimer une définition d’image, procédez comme suit :

1. Accédez au nœud Images, sélectionnez une définition d’image, puis sélectionnez Supprimer la définition d’image.

Remarque :

Vous ne pouvez pas supprimer une définition d’image si elle contient une version d’image.

Gestion du cycle de vie des images à l’aide de PowerShell

Si vous souhaitez utiliser des commandes PowerShell pour créer un schéma de provisionnement, vous devez créer une spécification de version d’image préparée basée sur la spécification de version d’image principale, selon les besoins de votre environnement.

Spécification de version d’image principale : Une spécification de version d’image principale est une image spécifique ajoutée ou créée sous une version d’image. Vous pouvez ajouter une image existante dans l’hyperviseur en tant que spécification de version d’image principale ou créer une spécification de version d’image préparée en vous basant sur cette dernière, selon les besoins de votre environnement. La spécification de version d’image préparée peut être utilisée pour plusieurs schémas de provisionnement.

Le cycle de vie d’une image lors de l’utilisation de commandes PowerShell est le suivant :

1. Créer une image :

   1. Créer une définition d’image.
   2. Créer une version d’image.
   3. Ajouter une spécification de version d’image principale.
   4. Créer une spécification de version d’image préparée.

2. Créer un catalogue de machines MCS à l’aide d’une spécification de version d’image préparée :

   1. Créer un catalogue de brokers.
   2. Créer un pool d’identités.
   3. Créer un schéma de provisionnement avec le paramètre Uid de la spécification de version d’image préparée à l’aide de la commande New-ProvScheme.
   4. Lier le catalogue de courtiers au schéma de provisionnement.
3. Créer des machines virtuelles dans le catalogue de machines MCS.
4. Modifier la spécification de version d’image préparée d’un schéma de provisionnement à l’aide de la commande Set-ProvScheme.
5. Gérer les définitions et versions d’images : Modifier les versions et définitions d’images.
6. Supprimer un catalogue de machines MCS : L’ordre de suppression est : spécification de version d’image préparée > spécification de version d’image principale > version d’image > définition d’image. Avant de supprimer la spécification de version d’image, assurez-vous que la spécification de version d’image préparée n’est associée à aucun catalogue de machines MCS.

Utiliser PowerShell

Vous pouvez effectuer les opérations suivantes à l’aide des commandes PowerShell :

• Créer une image préparée

• Créer un catalogue à l’aide de la spécification de version d’image préparée

• Mettre à jour un catalogue à l’aide d’une spécification de version d’image préparée

• Supprimer la définition d’image, la version d’image et la spécification de version d’image préparée

• Gérer la définition d’image et la version d’image

• Obtenir la définition d’image, la version d’image, la spécification de version d’image préparée et les détails du schéma de provisionnement

Créer une image préparée

Les commandes PowerShell détaillées pour créer une spécification de version d’image préparée sont les suivantes :

1. Vérifiez les noms de définition d’image disponibles à l’aide de Test-ProvImageDefinitionNameAvailable command. Par exemple,

   Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
   <!--NeedCopy-->
   

2. Créez une définition d’image à l’aide de la commande New-ProvImageDefinition. Par exemple,

   New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
   <!--NeedCopy-->
   

3. Créez une version d’image à l’aide de la commande New-ProvImageVersion. Par exemple,

   New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
   <!--NeedCopy-->
   

4. Ajoutez une spécification de version d’image principale à la version d’image à l’aide de la commande Add-ProvImageVersionSpec. Par exemple,

   Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName azure -MasterImagePath "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
   <!--NeedCopy-->
   

   Remarque :

   Vous ne pouvez ajouter qu’une seule spécification de version d’image principale à une version d’image pour une unité d’hébergement.

5. Créez une spécification de version d’image préparée à partir de la spécification de version d’image principale à l’aide de la commande New-ProvImageVersionSpec. Par exemple,

   New-ProvImageVersionSpec
   -SourceImageVersionSpecUid  c6e7384c-b2f8-46d6-9519-29a2c57ed3cb
   -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"
   -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously
   <!--NeedCopy-->
   

   Remarque :

   Une unité d’hébergement et un type de préparation ne peuvent avoir qu’une seule instance préparée.

Exemple de l’ensemble complet de commandes Powershell pour créer une définition d’image, une version d’image et une spécification de version d’image préparée dans Azure :

$ImageDefintion = New-ProvImageDefinition
-ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
 $ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName azure -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid  $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
<!--NeedCopy-->

Exemple de l’ensemble complet de commandes Powershell pour créer une définition d’image, une version d’image et une spécification de version d’image préparée dans VMware :

$ImageDefintion = New-ProvImageDefinition -ImageDefinitionName image2 -OsType Windows -VdaSessionSupport SingleSession
$ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\vmware\win10-master.vm\win10-master-snap.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName vmware -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid  $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
<!--NeedCopy-->

Remarque :

• Toutes les spécifications de version d’image dans une définition d’image doivent appartenir à la même unité d’hébergement.
• Une version d’image ne peut avoir qu’une seule spécification de version d’image maître et une seule spécification de version d’image préparée.
• Toutes les spécifications de version d’image doivent soit avoir un profil de machine, soit aucune des spécifications de version d’image ne doit avoir de profil de machine.
• Vous ne pouvez pas spécifier de groupe de ressources lors de la création d’une spécification de version d’image.

Créer un catalogue à l’aide d’une spécification de version d’image préparée

Créez un catalogue de machines MCS à partir de la spécification de version d’image préparée à l’aide de la commande New-ProvScheme. Par exemple,

New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
<!--NeedCopy-->

Ou,

New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitName <string> -IdentityPoolName <string> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
<!--NeedCopy-->

Exemple de l’ensemble complet de commandes PowerShell pour créer un catalogue dans Azure :

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "azurecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "azure.local" -IdentityPoolName "azurecatalog" -IdentityType "ActiveDirectory"  -NamingScheme "azure##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName azure -IdentityPoolName azurecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2s.serviceoffering" -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"StorageAccountType`" Value=`"StandardSSD_LRS`" /></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName azurecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

Exemple de l’ensemble complet de commandes PowerShell pour créer un catalogue dans VMware :

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "vmwarecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "vmware.local" -IdentityPoolName "vmwarecatalog" -IdentityType "ActiveDirectory"  -NamingScheme "vmware##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image2 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName vmwarecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName vmware -IdentityPoolName vmwarecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName vmwarecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

Mettre à jour un catalogue à l’aide d’une spécification de version d’image préparée

Vous pouvez mettre à jour un catalogue à l’aide de la commande Set-ProvSchemeImage. Par exemple,

Set-ProvSchemeImage -ProvisioningSchemeUid <Guid> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
<!--NeedCopy-->

Ou,

Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
<!--NeedCopy-->

Exemple de l’ensemble complet de commandes PowerShell pour mettre à jour un catalogue :

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 2 -Filter "PreparationType -eq 'Mcs'"
Set-ProvSchemeImage -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
<!--NeedCopy-->

Supprimer la définition d’image, la version d’image et la spécification de version d’image préparée

Tenez compte des éléments suivants avant de supprimer une définition d’image, une version d’image et une spécification de version d’image préparée :

• Une définition d’image ne peut pas être supprimée si elle contient une version d’image.
• Une version d’image ne peut pas être supprimée si elle contient une spécification de version d’image.
• Une spécification de version d’image principale ne peut pas être supprimée si elle est utilisée par une autre spécification de version d’image préparée.
• Une spécification de version d’image préparée ne peut pas être supprimée si elle est utilisée par un schéma de provisionnement.

Les étapes détaillées sont les suivantes :

1. Supprimez une spécification de version d’image préparée. Par exemple,

   $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
   Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
   <!--NeedCopy-->
   

   Remarque :

   La spécification de version d’image principale ne peut être supprimée que s’il n’y a pas de spécification de version d’image préparée associée.

2. Supprimez la spécification de version d’image principale. Par exemple,

   $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
   Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
   <!--NeedCopy-->
   

3. Supprimez une version d’image. Par exemple,

   Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
   <!--NeedCopy-->
   

4. Supprimez une définition d’image. Par exemple,

   Remove-ProvImageDefinition -ImageDefinitionName image1
   <!--NeedCopy-->
   

Exemple de l’ensemble complet de commandes PowerShell :

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Gérer la définition d’image et la version d’image

Vous pouvez renommer et modifier une définition d’image, et modifier une version d’image.

• Renommez une définition d’image à l’aide de la commande Rename-ProvImageDefinition. Par exemple :

   Rename-ProvImageDefinition -ImageDefinitionUid <Guid> -NewImageDefinitionName <string>
   <!--NeedCopy-->
  

  Ou,

   Rename-ProvImageDefinition -ImageDefinitionName <string> -NewImageDefinitionName <string>
   <!--NeedCopy-->
  

• Modifier une définition d’image à l’aide de la commande Set-ProvImageDefinition. Par exemple :

   Set-ProvImageDefinition -ImageDefinitionUid <Guid> [-Description <string>]
   <!--NeedCopy-->
  

  Ou,

   Set-ProvImageDefinition -ImageDefinitionName <string> [-Description <string>]
   <!--NeedCopy-->
  

• Modifier une version d’image à l’aide de la commande Set-ProvImageVersion. Par exemple :

   Set-ProvImageVersion -ImageVersionUid <Guid> [-Description <string>]
   <!--NeedCopy-->
  

  Ou,

   Set-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> [-Description <string>]
   <!--NeedCopy-->
  

Obtenir les détails de la définition d’image, de la version d’image, de la spécification de version d’image préparée et du schéma de provisionnement

• Obtenir les détails de la définition d’image à l’aide de la commande Get-ProvImageDefinition. Par exemple :

   Get-ProvImageDefinition [-ImageDefinitionName <string>] [-ImageDefinitionUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <int>] [-Skip <int>] [-SortBy <string>] [-Filter <string>]
   <!--NeedCopy-->
  

• Obtenir les détails de la version d’image à l’aide de la commande Get-ProvImageVersion. Par exemple :

  • Pour répertorier les versions d’image dans une définition d’image,

     Get-ProvImageVersion -ImageDefinitionUid <Guid>
     <!--NeedCopy-->
    

    Ou,

     Get-ProvImageVersion -ImageDefinitionName <string>
     <!--NeedCopy-->
    

  • Pour obtenir le détail d’une version d’image,

     Get-ProvImageVersion -ImageVersionUid <Guid>
     <!--NeedCopy-->
    

    Ou,

     Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int>
     <!--NeedCopy-->
    

• Obtenir la spécification de version d’image préparée à l’aide de la commande Get-ProvImageVersionSpec. Par exemple :

  • Pour répertorier toutes les spécifications de version d’image préparées dans une version d’image,

     Get-ProvImageVersionSpec -ImageVersionUid <Guid>
     <!--NeedCopy-->
    

  • Pour répertorier les spécifications de version d’image principale dans une spécification de version d’image préparée,

     Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"'
     <!--NeedCopy-->
    

  • Pour répertorier les spécifications de version d’image préparées dans une version d’image, qui est associée à une image principale,

     Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"'
     <!--NeedCopy-->
    

  • Pour obtenir les spécifications de version d’image préparée réussies dans une version d’image,

     Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -and ImageVersionSpecStatus -eq "Complete"'
     <!--NeedCopy-->
    

  • Pour obtenir le détail d’une spécification de version d’image préparée,

     Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
     <!--NeedCopy-->
    

• Obtenir les détails du schéma de provisionnement à l’aide de la commande Get-ProvScheme. Par exemple :

   Get-ProvScheme [[-ProvisioningSchemeName] <String>] [-ProvisioningSchemeUid <Guid>] [-ScopeId <Guid>] [-ScopeName <String>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
   <!--NeedCopy-->
  

• Obtenir l’historique des spécifications de version d’image préparée d’un schéma de provisionnement à l’aide de la commande Get-ProvSchemeImageVersionSpecHistory. Par exemple :

   Get-ProvSchemeImageVersionSpecHistory [-ProvisioningSchemeName <String>] [-ProvisioningSchemeUid <Guid>] [-ImageVersionSpecUid <Guid>] [-ImageVersionSpecHistoryUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
   <!--NeedCopy-->