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

Gestion des images (Technical Preview)

April 30, 2024
Contributeur: 
C

Introduction

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

  • Mastering : 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 mastering du workflow global de provisioning.

Vous pouvez préparer différentes versions d’image 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 en stockage et en temps, et simplifie le déploiement des machines virtuelles et le processus de mise à jour des images.

Les avantages de cette fonctionnalité de gestion d’images sont les suivants :

  • Générez des images préparées à l’avance sans créer de catalogue.
  • Réutilisez les images préparées dans plusieurs scénarios, tels que la création et la mise à jour d’un catalogue.
  • Réduisez 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 pourrez pas bénéficier des avantages de cette fonctionnalité.

Cas d’utilisation

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

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

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

  • Regroupement logique: vous pouvez créer plusieurs définitions d’images pour :

    • Regrouper logiquement les versions d’images en fonction de différents critères tels que le projet, le département 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 ?

Grâce à la fonctionnalité de gestion des images, MCS dissocie la phase de mastering du workflow 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ées par MCS.

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

Vue d'ensemble de l'image préparée

Définition d’image : les définitions d’image constituent un regroupement logique de versions d’une image. La définition d’image contient les informations suivantes :

  • Pourquoi l’image a été créée.
  • À quel système d’exploitation il est destiné.
  • Autres informations relatives à l’utilisation de l’image.

Un catalogue n’est pas créé à partir d’une définition d’image, mais à partir des versions d’image créées en fonction de cette définition.

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

Sinon, si vous souhaitez utiliser les commandes PowerShell pour créer un schéma de provisioning 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.

Exigences

  • Pour l’image principale Windows, seules les images VDA avec la version 2311 et versions ultérieures, et compatibles MCS/IO sont prises en charge.

Limitations

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

  • Plusieurs cartes d’interface réseau dans Azure
  • Fonctionnalité de disque de données persistant
  • Hibernation pour plusieurs sessions
  • 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éez une image préparée : créez une définition d’image et sa version d’image initiale.
  2. Créez des versions d’image à partir de la version d’image initiale.
  3. Utilisez une version d’image comme image préparée pour créer des catalogues.
  4. Mettez à jour un catalogue de machines avec une autre image préparée.
  5. Gérez les définitions et les versions des images : modifiez le nom et la description des versions d’image, ainsi que la description d’une définition d’image.
  6. Supprimez une version d’image.
  7. Supprimez une définition d’image.

Vous pouvez également gérer les images à l’aide de PowerShell. Consultez la section 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 en utilisant :

Utiliser Web Studio

Consultez les sections suivantes :

Présentation du nœud Images

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

Vue principale du nœud Images

Étiquette Partie Description
A Définitions d’image Répertorie les définitions d’image créées précédemment.
B Versions d’image Affiche les versions d’image de la définition d’image sélectionnée.
C


Détails


  • L’onglet Détails affiche des informations détaillées sur la définition ou la version d’image sélectionnée, telles que l’image principale, la ressource, l’hyperviseur, le nom de la définition d’image, le type de système d’exploitation et le type de session.
  • L’onglet Schéma d’image affiche des informations sur le modèle utilisé pour préparer les images, telles que le disque dur, la taille de la machine, le type de licence, le jeu de cryptage du disque, le profil de la machine, etc.
  • L’onglet Systèmes de provisioning affiche le nom du schéma de provisioning utilisé pour créer le catalogue.
  • L’onglet Dépannage fournit l’état d’erreur de la version d’image sélectionnée.
D Barre d’action Répertorie les actions que vous pouvez effectuer sur les définitions et les versions d’image, telles que Créer une version d’image, Modifier la description, Supprimer la version d’imageet Créer un catalogue.

Créer un catalogue de machines à l’aide d’une 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 d’OS 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 d’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 le VDA 2311 ou version ultérieure est installé sur l’image principale et que le pilote MCSIO est installé sur le VDA.

  4. (Uniquement pour Azure) Sur la page Types de stockage et de licence, 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 de profil.

  5. Sur la page Spécification de 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 processeurs virtuels dérivé du profil de machine. Ce nombre ne peut pas être modifié. Si vous ne sélectionnez aucun 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 d’interface réseau, sélectionnez ou ajoutez des cartes d’interface réseau pour l’image de préparation. Pour chaque carte d’interface réseau, sélectionnez un réseau virtuel associé.

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

    Remarque :

    Les cartes d’interface réseau multiples ne sont pas prises en charge dans Azure.

  7. (Uniquement pour Azure) Sur la page Paramètres du disque, sélectionnez la clé de cryptage gérée par le client (CMEK). Si le profil de la machine ne comprend pas de CMEK, mais que l’image principale en possède une, il présélectionne la CMEK à partir de l’image principale.
  8. Sur la page Description de la version, entrez une description de la version d’image initiale 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. Entrez 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 de gérer différentes itérations ou mises à jour d’une image particulière. Cette fonctionnalité vous permet de gérer plusieurs versions d’une image à différentes fins.

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 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 machine, Cartes d’interface réseauet Paramètres du disque de la boîte de dialogue Créer version d’image.
  3. Ajoutez une description pour la version d’image. Cliquez sur Terminer.

Créer des versions d'image

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 établissant un lien vers l’option d’image préparée dans le workflow de création de catalogue. Consultez la section 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 e, puis 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 du 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 groupe de ressources ou d’utiliser un groupe de ressources existant dans lequel placer les ressources de ce catalogue.
  5. Complétez les paramètres sur les pages suivantes.
  6. Sur la page Résumé, vérifiez les détails du catalogue de machines. Entrez un nom et une description pour le catalogue. 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 panneau de navigation de gauche.
  2. Cliquez sur Créer un catalogue de machines. La page Création d’un catalogue de machines s’affiche. Dans les pages Introduction, Type de machine et Gestion des machines, cliquez sur Suivant.
  3. Sur la page Image :
    1. Sélectionnez une Image préparée.
    2. Sous Image préparée, sélectionnez une version d’image d’une définition d’image.
    3. Cliquez sur le nom de la version d’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 de 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 jeu de cryptage de disque, vous ne pouvez pas supprimer le jeu de cryptage, mais vous pouvez remplacer la clé par une autre clé de cryptage.
  6. (Pour Azure) Sur la page Groupe de ressources, vous pouvez choisir de créer un groupe de ressources ou d’utiliser un groupe de ressources existant dans lequel placer les ressources de ce catalogue.
  7. Complétez les paramètres sur les pages suivantes.
  8. Sur la page Résumé, vérifiez les détails du catalogue de machines. Entrez un nom et une description pour le catalogue. Cliquez sur Terminer.

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

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

  1. Cliquez sur Catalogues de machines dans le panneau de navigation de gauche et sélectionnez le 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. Dans 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 les versions d’image pour gérer l’utilisation des différentes versions et définitions d’image 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 d’image

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

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 les commandes PowerShell pour créer un schéma de provisioning, 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 basée sur la spécification de version d’image principale, 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 provisioning.

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

  1. Créez une image :

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

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

    1. Créez un catalogue de brokers.
    2. Créez un pool d’identités.
    3. Créez un schéma de provisioning avec le paramètre UID de la spécification de version d’image préparée à l’aide de la commande New-ProvScheme.
    4. Liez le catalogue des brokers au schéma de provisioning.
  3. Créez des machines virtuelles dans le catalogue de machines MCS.
  4. Modifiez la spécification de version d’image préparée d’un schéma de provisioning à l’aide de la commande Set-ProvScheme.
  5. Gérez les définitions et les versions d’image : modifiez les versions d’image et les définitions d’image.
  6. Supprimez 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

Les commandes PowerShell détaillées permettant de 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 d’ensemble complet de commandes Powershell permettant de 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 d’ensemble complet de commandes Powershell permettant de 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 figurant 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 principale et une seule spécification de version d’image préparée.
  • Toutes les spécifications de version d’image doivent avoir un profil de machine ou aucune des spécifications de version d’image ne doit avoir un 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 d’ensemble complet de commandes Powershell permettant de 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 d’ensemble complet de commandes Powershell permettant de 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 d’ensemble complet de commandes Powershell permettant de 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

Avant de supprimer une définition d’image, une version d’image et une spécification de version d’image préparée, tenez compte des points suivants :

  • 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 provisioning.

Voici le détail des étapes :

  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 lorsqu’aucune spécification de version d’image préparée ne lui est 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 d’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-->

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

  • Modifiez 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 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 provisioning

  • Obtenez les détails de 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-->

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

  • Obtenez 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ée 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ée dans une version d’image 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 d’une version d’image préparée avec succès 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 de la spécification de version d’image préparée :

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

  • Obtenez les détails du schéma de provisioning à 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-->

  • Obtenez l’historique des spécifications de version d’image préparée d’un schéma de provisioning à 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-->
Gestion des images (Technical Preview)
April 30, 2024
Contributeur: 
C
April 30, 2024
Contributeur: 
C

Dans cet article

Commentaires sur le site | 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.