Lorsque votre organisation informatique ou de sécurité présente des restrictions sur l'utilisation des offres Azure Marketplace ou sur les achats Marketplace dans l'abonnement du déploiement d'Horizon Cloud on Microsoft Azure, ou lorsque le déploiement utilise Azure Chine

Cette page de documentation décrit les conditions requises liées à l'utilisation d'Horizon Cloud on Microsoft Azure d'Azure Marketplace pour les processus de déploiement et de mise à niveau, et lorsque votre demande de support nécessite le déploiement d'une JumpBox de dépannage par le support Horizon Cloud.

Ces informations vous concernent si vous ou votre organisation informatique ou de sécurité avez défini des restrictions dans les abonnements du déploiement d'Horizon Cloud on Microsoft Azure concernant l'utilisation des offres Azure Marketplace ou des commandes Azure Marketplace.

En outre, si vous disposez d'un déploiement d'Horizon Cloud on Microsoft Azure dans Azure Chine, vous aurez peut-être besoin de l'aide de l'équipe du support Horizon Cloud, comme décrit dans la section Déploiements dans Azure Chine de cette page.

Introduction

À partir du début de l'année civile 2022, le service a amélioré le code de déploiement et de mise à niveau d'Horizon Cloud on Microsoft Azure pour une utilisation par programmation des offres que nous proposons dans Azure Marketplace.

Cette amélioration accélère le processus de déploiement initial et le processus de mise à niveau, afin d'effectuer des mises à niveau quasi sans interruption de service des instances du gestionnaire d'espace et des instances d'Unified Access Gateway.

Cette amélioration permet également d'exécuter des déploiements et des mises à niveau sans utiliser de comptes de stockage supplémentaires au-delà d'un compte de stockage utilisé pour la fonctionnalité App Volumes.

Relation d'Azure Marketplace aux déploiements, aux mises à niveau et à la JumpBox de support

Pendant les processus de déploiement et de mise à niveau, le code de déploiement et de mise à niveau tente par programmation par appel d'API d'accepter les conditions des offres Horizon Cloud dans Azure Marketplace qui correspondent au publisherID nommé omnissallc.

Entité associée	ID de l'éditeur	ID de l'offre	ID du plan
Gestionnaire d'espace	Omnissallc	omnissa-hcs-podmgr	omnissa-hcs-podmgr
Unified Access Gateway	Omnissallc	omnissa-hcs-uag	omnissa-hcs-uag
JumpBox, si requis par le support Horizon Cloud à des fins de dépannage	Omnissallc	Omnissa-hcs-jumpbox	Omnissa-hcs-jumpbox

Remarque : l'utilisation du portail Azure pour afficher ces offres en accédant à Azure Marketplace n'est pas prise en charge. Horizon Cloud publie ces offres pour l'accès par programmation à l'aide d'appels d'API.

Conditions requises pour les appels d'API du service

La réussite de cette méthode de programmation nécessite que les abonnements Azure du déploiement d'Horizon Cloud on Microsoft Azure répondent aux conditions requises décrites dans les sections suivantes.

Ces éléments permettent aux appels d'API de déploiement et de mise à niveau d'accepter les conditions des offres Horizon Cloud dans Azure Marketplace qui correspondent aux publisherID, offerID et planID du service, comme indiqué dans le tableau précédent.

Ces conditions requises s'appliquent aux abonnements utilisés par les instances du gestionnaire d'espace et aux abonnements utilisés par les instances d'Unified Access Gateway lorsqu'elles sont déployées dans leur propre abonnement.

Si les éléments suivants ne sont pas satisfaits dans l'abonnement Azure, les appels d'API du code de déploiement et de mise à niveau pour accepter les conditions de l'offre échouent, ce qui entraîne les éléments suivants :

• Nouveaux échecs de déploiement impliquant cet abonnement.
• Échecs de mise à niveau pour les instances du gestionnaire d'espace et d'Unified Access Gateway déjà déployées dans cet abonnement.
• Échec du déploiement de la JumpBox de dépannage dans cet abonnement si le support Horizon Cloud en a besoin pour résoudre vos demandes de support.

Une situation particulière est le scénario d'un déploiement d'Horizon Cloud on Microsoft Azure situé dans Azure Chine. Dans Azure Chine, Microsoft ne fournit pas le type de ressource Microsoft.Marketplace.Ordering dont les appels d'API du service ont besoin. Si votre déploiement d'Horizon Cloud on Microsoft Azure réside dans Azure Chine, lisez les instructions de la section Azure Chine - Considérations spéciales.

Condition requise lorsque les principaux de service du déploiement utilisent des rôles personnalisés

Lorsque vous utilisez un rôle personnalisé comme décrit ici, les autorisations suivantes doivent être incluses dans les rôles personnalisés :

Microsoft.MarketplaceOrdering/offertypes/publishers/offers/plans/agreements/read
Microsoft.MarketplaceOrdering/offertypes/publishers/offers/plans/agreements/write

• Pour les nouveaux déploiements d'instances du gestionnaire d'espace ou d'instances d'Unified Access Gateway, les assistants de déploiement de l'interface utilisateur vérifient si le principal de service dispose de ces autorisations dans l'abonnement. Si cette validation échoue, l'interface utilisateur empêche le démarrage du déploiement.
• Pour les mises à niveau, les vérifications préalables du système tentent de confirmer si le principal de service dispose de ces autorisations dans l'abonnement. s'il est manquant, les vérifications préalables signalent une erreur de blocage des mises à jour. La solution consiste à inclure ces autorisations dans le rôle personnalisé.
• Si le support Horizon Cloud doit déployer la JumpBox de dépannage pour répondre à votre demande de support, le processus de déploiement de la JumpBox indique au support Horizon Cloud que les autorisations sont manquantes.

Dans ce scénario, le support Horizon Cloud constate des messages d'erreur consignés selon un modèle, tels que Could not proceed with upgrade as configured subscription has insufficient read permission to use marketplace image offers. Could not proceed with upgrade as configured subscription has insufficient write permission to use marketplace image offers.

Condition requise lorsqu'une stratégie Azure limite les types de ressources Azure autorisés dans les abonnements

La stratégie Azure de certaines organisations informatiques peut spécifier d'interdire toute utilisation des types de ressources Azure, à l'exception des types de ressources spécifiques explicitement autorisés par nom.

Lorsque votre organisation informatique ou de sécurité a défini une telle stratégie Azure qui limite les types de ressources Azure autorisés dans les abonnements Azure de l'organisation, l'ensemble AllowedResourceTypes de la stratégie Azure doit inclure l'autorisation du type Microsoft.MarketplaceOrdering/*de ressource.

Si la stratégie Azure de l'abonnement n'inclut Microsoft.MarketplaceOrdering/*pas , le support Horizon Cloud constate des messages d'erreur consignés dans un modèle tel que Offer with PublisherId: 'omnissallc', OfferId: 'omnissa-hcs-xxxxx' cannot be purchased due to validation errors. Sku 'omnissa-hcs-xxxxxx' of offer 'omnissa-hcs-xxxxxx' by publisher 'omnissallc' is not available to you for deployment per the policy set by your IT Admin, où xxxxx correspond à l'un des ID de plan du tableau précédent.

Autoriser l'accès Microsoft.MarketplaceOrdering/* au type de ressource permet au code de déploiement et de mise à niveau d'effectuer les appels d'API pour accepter les offres d'Horizon Cloud on Microsoft Azure dans Azure Marketplace que le code de déploiement et de mise à niveau utilise.

Si votre équipe informatique ou de sécurité refuse d'autoriser ce type de ressource dans l'abonnement, elle peut utiliser l'option permettant d'ajouter les SKU des offres Horizon Cloud au magasin privé Azure de l'entreprise en effectuant les actions décrites dans la section Ajouter les offres à la collection de magasins privés Azure de l'entreprise. Ensuite, les appels d'API du service peuvent obtenir les offres à partir de là.

Condition requise lorsque votre administrateur d'entreprise a désactivé les achats Azure Marketplace pour son locataire Azure Enterprise

Comme décrit dans la documentation de Microsoft Azure, les administrateurs d'entreprise peuvent désactiver les achats Azure Marketplace pour tous les abonnements Azure sous leur locataire Azure d'entreprise.

Cela permet de limiter les achats Azure Marketplace aux offres de l'éditeur Microsoft. Ces achats limités bloquent les appels d'API du service pour extraire les offres d'Horizon Cloud depuis publisherID omnissallc et, par conséquent, empêchent les processus de déploiement et de mise à niveau qui nécessitent ces appels d'API.

Dans ce scénario, le support Horizon Cloud constate un message d'erreur consigné selon un modèle tel que Cannot complete purchase as your enrollment for this subscription doesn't allow purchase of marketplace paid products. Your Azure enrollment administrator can enable purchase of paid marketplace products..

La solution à cette situation consiste à demander à l'administrateur d'entreprise de créer et de gérer une collection Azure Marketplace privée et d'y ajouter les offres Horizon Cloud en effectuant les actions décrites dans la section suivante Ajouter les offres à la collection de magasins privés Azure de l'entreprise.

Ajouter les offres à la collection de magasins privés Azure de l'entreprise

Microsoft Azure permet de créer et de gérer une collection Azure Marketplace privée à utiliser par vos abonnements. Comme décrit dans la section Créer et gérer une instance privée d'Azure Marketplace, cette fonctionnalité permet aux administrateurs informatiques de préapprouver, d'organiser et de contrôler les solutions tierces que leurs utilisateurs peuvent utiliser à partir de l'instance globale d'Azure Marketplace. Comme décrit sur la page de documentation de Microsoft liée à la phrase précédente, le rôle d'administrateur de Marketplace doit être attribué à l'administrateur qui gère le magasin privé.

Une fois le magasin privé créé pour le locataire Azure d'entreprise, l'administrateur disposant du rôle d'administrateur Marketplace peut ajouter les offres à la collection de magasins privés. l'ajout des offres au magasin privé du locataire permet aux appels d'API du service d'obtenir les offres utilisées pour les déploiements et les mises à niveau.

Microsoft fournit des commandes PowerShell afin d'ajouter des offres d'éditeur spécifiques à une collection de magasins privés.

Suivez la référence de la documentation Microsoft pour connaître les conditions préalables à l'exécution des commandes PowerShell dans la section Ajouter une offre à un Marketplace privé. Cette page Microsoft décrit également les commandes PowerShell que Microsoft fournit à cette fin.

l'exemple suivant illustre les commandes Microsoft PowerShell à utiliser pour ajouter les offres Horizon Cloud à ce magasin privé une fois que les conditions préalables à l'exécution des commandes sont remplies. Le premier Get-AzMarketplacePrivateStore est utilisé pour obtenir les informations du privateStoreIdlocataire Azure. Ensuite, Set-AzMarketplacePrivateStoreOffer est utilisé pour ajouter les offres Horizon Cloud à ce magasin privé.

Get-AzMarketplacePrivateStore

1. Utilisez Get-AzMarketplacePrivateStore pour obtenir les du privateStoreId locataire Azure à utiliser dans l'ensemble de commandes suivant.

   
   Get-AzMarketplacePrivateStore
   
   

2. Utilisez la valeur renvoyée privateStoreId dans les Set-AzMarketplacePrivateStoreOffer commandes pour ajouter tour à tour les offres pour omnissa-hcs-podmgr, omnissa-hcs-uaget omnissa-hcs-jumpbox.

   • Ajoutez l'offre pour les instances du gestionnaire d'espace :

         
     Set-AzMarketplacePrivateStoreOffer -privateStoreId your-tenant-privateStoreID -offerId omnissallc.omnissa-hcs-podmgr -SpecificPlanIdsLimitation @("omnissa-hcs-podmgr")
     

   • Ajoutez l'offre pour les instances d'Unified Access Gateway :

         
     Set-AzMarketplacePrivateStoreOffer -privateStoreId your-tenant-privateStoreID -offerId omnissallc.omnissa-hcs-uag -SpecificPlanIdsLimitation @("omnissa-hcs-uag")
     

   • Ajoutez l'offre pour l'instance de JumpBox de dépannage :

         
     Set-AzMarketplacePrivateStoreOffer -privateStoreId your-tenant-privateStoreID -offerId omnissallc.omnissa-hcs-jumpbox -SpecificPlanIdsLimitation @("omnissa-hcs-jumpbox")
     

3. Vérifiez si les offres sont désormais répertoriées dans le magasin privé du locataire.

   
   Get-AzMarketplacePrivateStoreOffer -PrivateStoreId your-tenant-privateStoreID
   

Azure Chine - Considérations spéciales

Étant donné que Microsoft ne fournit pas le type de ressource Microsoft.Marketplace.Ordering dans Azure Chine, les fonctionnalités du service qui utilisent des appels d'API vers les offres d'Horizon Cloud dans Azure Marketplace ne peuvent pas être prises en charge. Le type Microsoft.Marketplace.Ordering n'est pas répertorié dans cette référence de documentation Microsoft pour les fournisseurs de ressources Azure Chine.

Par conséquent, gardez à l'esprit ces considérations spéciales lorsque vous utilisez un abonnement dans Azure Chine pour un déploiement d'Horizon Cloud on Microsoft Azure.

• Pour un déploiement d'Horizon Cloud on Microsoft Azure existant dans Azure Chine, avant la mise à niveau de ce déploiement, obtenez une assistance auprès du support Horizon Cloud pour configurer votre locataire Horizon Cloud afin qu'il utilise la méthode de mise à niveau précédente, sans appels d'API à Azure Marketplace.
• Lorsque vous planifiez un déploiement dans Azure Chine, avant de commencer ce déploiement, obtenez une assistance auprès du support Horizon Cloud pour configurer votre locataire Horizon Cloud afin que le système de déploiement utilise la méthode de déploiement précédente, sans appels d'API vers Azure Marketplace.
• Si le support Horizon Cloud doit déployer une JumpBox temporaire pour le dépannage d'un déploiement situé dans Azure Chine, le support Horizon Cloud peut configurer temporairement le locataire Horizon Cloud pour activer la capacité de déploiement de la JumpBox temporaire dans l'abonnement sans les appels d'API du service vers Azure Marketplace. Une fois la JumpBox temporaire déployée à des fins de dépannage, le support Horizon Cloud peut réactiver la capacité des appels d'API du service, si le locataire dispose d'espaces déployés dans des abonnements situés dans des régions en plus d'Azure Chine.

Les déploiements et les mises à niveau sans utilisation d'Azure Marketplace prennent plus de temps. En outre, ces déploiements et mises à niveau nécessitent l'utilisation de la JumpBox temporaire pour orchestrer les processus de déploiement et de mise à niveau, ainsi que l'utilisation de comptes de stockage dans l'abonnement pour stocker les images que les appels d'API du service récupèrent à partir du plan de contrôle Horizon Cloud au lieu d'utiliser les offres Horizon Cloud dans Azure Marketplace.