Citrix DaaS

Gérer les catalogues de machines d’images préparées

Vous pouvez mettre à jour un catalogue de machines MCS avec une autre image préparée et gérer les définitions et les versions d’images à l’aide des méthodes suivantes :

  • Studio
  • PowerShell

Utiliser Studio

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.

    Remarque

    Applicable à Azure : vous pouvez également choisir une image avec ACG non activé, puis sélectionner la case à cocher Placer l’image préparée dans Azure Compute Gallery pour placer l’image dans la galerie.

  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.

Utiliser PowerShell

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, les opérations suivantes peuvent être effectuées :

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

Or,

  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 catalogue de machines MCS.
  • Une unité hôte ne peut pas être supprimée si elle est utilisée par une autre spécification de version d’image préparée.

Voici le détail des étapes :

  1. Supprimez le catalogue de machines. Par exemple, les opérations suivantes peuvent être effectuées :

      Remove-ProvScheme -ProvisioningScheneName decouplingCatalog
    <!--NeedCopy-->
    
  2. Supprimez la spécification de version d’image préparée partagée. Par exemple, les opérations suivantes peuvent être effectuées :

      Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest
    <!--NeedCopy-->
    
  3. Supprimez une spécification de version d’image préparée. Par exemple, les opérations suivantes peuvent être effectuées :

      $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
    
      Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
    <!--NeedCopy-->
    
  4. Supprimez la spécification de version d’image principale. Par exemple, les opérations suivantes peuvent être effectuées :

      $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
    
      Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronousl
    <!--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.

  5. Supprimez une version d’image. Par exemple, les opérations suivantes peuvent être effectuées :

      Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
    <!--NeedCopy-->
    
  6. Supprimez la configuration de la définition d’image dans la connexion hôte spécifiée. Par exemple, les opérations suivantes peuvent être effectuées :

      Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx
    <!--NeedCopy-->
    
  7. Supprimez une définition d’image. Par exemple, les opérations suivantes peuvent être effectuées :

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

Exemple de l’ensemble complet de commandes PowerShell lorsque l’image préparée n’est pas partagée entre unités hôtes :

  Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

  $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

  Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

  $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

  Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

  Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

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

Exemple de l’ensemble complet de commandes PowerShell lorsque l’image préparée est partagée entre unités hôtes :

  Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

  Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> 
  -HostingUnitName AzureWest

  $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

  Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

  $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

  Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

  Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

  Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx

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

    Or,

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

    Or,

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

    Or,

       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 d’une 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 d’une 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-->
      

      Or,

         Get-ProvImageVersion -ImageDefinitionName <string>
       <!--NeedCopy-->
      
    • Pour obtenir le détail d’une version d’image :

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

      Or,

         Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int>
       <!--NeedCopy-->
      
  • Obtenez la spécification d’une 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 d’un 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-->
    

Informations supplémentaires

Gérer les catalogues de machines d’images préparées