Auf dieser Dokumentationsseite werden die Anforderungen im Zusammenhang mit der Horizon Cloud on Microsoft Azure-Nutzung von Azure Marketplace für die Bereitstellungs- und Upgrade-Prozesse beschrieben sowie für den Fall, dass Ihre Support-Anfrage die Bereitstellung einer Jumpbox zur Fehlerbehebung durch den Horizon Cloud-Support erfordert.
Diese Informationen beziehen sich auf Sie, wenn Sie oder Ihre IT- oder Sicherheitsorganisation in den Abonnements der Horizon Cloud on Microsoft Azure-Bereitstellung Einschränkungen für die Verwendung von Azure Marketplace-Angeboten oder Azure Marketplace-Bestellungen festgelegt haben.
Wenn Sie über eine Horizon Cloud on Microsoft Azure-Bereitstellung in Azure China verfügen, benötigen Sie möglicherweise die Unterstützung des Horizon Cloud-Supportteams, wie im Abschnitt Bereitstellungen in Azure China dieser Seite beschrieben.
Einführung
Ab Anfang des Kalenderjahres 2022 hat der Dienst den Horizon Cloud on Microsoft Azure-Bereitsteller- und Upgrade-Code für die programmgesteuerte Nutzung von Angeboten, die wir im Azure Marketplace bereitstellen, verbessert.
Durch diese Verbesserung werden der anfängliche Bereitstellungs- und Upgrade-Prozess schneller ausgeführt, um Upgrades der Pod-Manager-Instanzen und Unified Access Gateway-Instanzen nahezu ohne Ausfallzeiten zu erreichen.
Diese Verbesserung ermöglicht auch die Ausführung von Bereitstellungen und Upgrades ohne die Verwendung zusätzlicher Speicherkonten über das für die App Volumes-Funktion verwendete Speicherkonto hinaus.
Beziehung von Azure Marketplace zu Bereitstellungen, Upgrades und der Support-Jumpbox
Während der Bereitstellungs- und Upgrade-Prozesse versucht der Bereitsteller- und Upgrade-Code programmgesteuert per API-Aufruf, die Bedingungen der Horizon Cloud-Angebote im Azure Marketplace zu akzeptieren, die der publisherID mit dem Namen entsprechen omnissallc.
| Verwandte Einheit | publisherID | Angebots-ID | planID |
|---|---|---|---|
| Pod-Manager | Omnissallc | Omnissa-HCS-Podmgr | Omnissa-HCS-Podmgr |
| Unified Access Gateway | Omnissallc | Omnissa-HCS-UAG | Omnissa-HCS-UAG |
| Jumpbox, wenn dies vom Horizon Cloud-Support zur Fehlerbehebung benötigt wird | Omnissallc | Omnissa-HCS-Jumpbox | Omnissa-HCS-Jumpbox |
Hinweis: Die Verwendung des Azure-Portals zum Anzeigen dieser Angebote durch Navigieren zum Azure Marketplace wird nicht unterstützt. Horizon Cloud veröffentlicht diese Angebote für den programmgesteuerten Zugriff mithilfe von API-Aufrufen.
Die API-Aufrufanforderungen des Diensts
Für den Erfolg dieser programmgesteuerten Methode müssen die Azure-Abonnements der Horizon Cloud on Microsoft Azure-Bereitstellung die in den folgenden Abschnitten beschriebenen Anforderungen erfüllen.
Diese Elemente sorgen dafür, dass die Bereitsteller- und Upgrade-API-Aufrufe die Bedingungen der Horizon Cloud-Angebote im Azure Marketplace akzeptieren, die der publisherID, offerID und planID des Diensts entsprechen, wie in der obigen Tabelle aufgeführt.
Diese Anforderungen gelten sowohl für die Abonnements, die von den Pod-Manager-Instanzen verwendet werden, als auch für Abonnements, die von den Unified Access Gateway-Instanzen verwendet werden, wenn sie in einem eigenen Abonnement bereitgestellt werden.
Wenn die folgenden Elemente im Azure-Abonnement nicht erfüllt sind, schlagen die API-Aufrufe des Bereitsteller- und Upgrade-Codes zum Akzeptieren der Angebotsbedingungen fehl, was zu folgendem Ergebnis führt:
- Neue Bereitstellungsfehler im Zusammenhang mit diesem Abonnement.
- Upgradefehler für Pod-Manager- und Unified Access Gateway-Instanzen, die bereits in diesem Abonnement bereitgestellt wurden.
- Fehler beim Bereitstellen der Fehlerbehebungs-Jumpbox in diesem Abonnement, wenn dies vom Horizon Cloud-Support benötigt wird, um Ihre Support-Anfragen zu beheben.
Eine besondere Situation stellt das Szenario einer Horizon Cloud on Microsoft Azure-Bereitstellung in Azure China dar. In Azure China stellt Microsoft den Ressourcentyp Microsoft.Marketplace.Ordering nicht bereit, den die API-Aufrufe des Diensts benötigen. Wenn sich Ihre Horizon Cloud on Microsoft Azure-Bereitstellung in Azure China befindet, lesen Sie die Anleitung im Abschnitt Azure China – Besondere Überlegungen.
Anforderung, wenn die Dienstprinzipale der Bereitstellung benutzerdefinierte Rollen verwenden
Wenn Sie eine benutzerdefinierte Rolle wie hier beschrieben verwenden, müssen die folgenden Berechtigungen in den benutzerdefinierten Rollen enthalten sein:
Microsoft.MarketplaceOrdering/offertypes/publishers/offers/plans/agreements/read
Microsoft.MarketplaceOrdering/offertypes/publishers/offers/plans/agreements/write
- Für neue Bereitstellungen der Pod-Manager-Instanzen oder Unified Access Gateway-Instanzen überprüfen die Bereitstellungsassistenten der Benutzeroberfläche, ob der Dienstprinzipal über diese Berechtigungen im Abonnement verfügt. Wenn diese Validierung fehlschlägt, verhindert die Benutzeroberfläche den Start der Bereitstellung.
- Bei Upgrades versuchen die Systemvorabprüfungen zu bestätigen, ob der Dienstprinzipal über diese Berechtigungen im Abonnement verfügt. Fehlen sie, wird in den Vorabprüfungen ein Fehler gemeldet, der die Aktualisierung blockiert. Das Problem wird behoben, indem diese Berechtigungen in die benutzerdefinierte Rolle aufgenommen werden.
- Wenn der Horizon Cloud-Support die Jumpbox für die Fehlerbehebung bereitstellen muss, um auf Ihre Support-Anfrage zu reagieren, zeigt der Jumpbox-Bereitstellungsprozess dem Horizon Cloud-Support an, dass die Berechtigungen fehlen.
In diesem Szenario werden dem Horizon Cloud-Support Fehlermeldungen angezeigt, die in einem Muster protokolliert werden, wie z. B. 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.
Anforderung, wenn eine Azure-Richtlinie die in den Abonnements zulässigen Azure-Ressourcentypen einschränkt
Die Azure-Richtlinie einiger IT-Organisationen legt möglicherweise fest, dass die gesamte Verwendung von Azure-Ressourcentypen außer bestimmten Ressourcentypen, die explizit nach Namen zulässig sind, nicht zulässig ist.
Wenn Ihre IT- oder Sicherheitsorganisation eine solche Azure-Richtlinie festgelegt hat, die die in den Azure-Abonnements der Organisation zulässigen Azure-Ressourcentypen einschränkt, muss der Satz AllowedResourceTypes der Azure-Richtlinie die Zulassung des Ressourcentyps Microsoft.MarketplaceOrdering/*enthalten.
Wenn die Azure-Richtlinie des Abonnements nicht enthält Microsoft.MarketplaceOrdering/*, werden dem Horizon Cloud-Support Fehlermeldungen angezeigt, die in einem Muster protokolliert werden, 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 Adminwie z. B. , wobei xxxxx einer der planIDs in der obigen Tabelle entspricht.
Indem Sie den Zugriff auf den Microsoft.MarketplaceOrdering/* Ressourcentyp zulassen, können der Bereitsteller und der Upgrade-Code die API-Aufrufe durchführen, um die Horizon Cloud on Microsoft Azure-Angebote im Azure Marketplace zu akzeptieren, die der Bereitsteller- und der Upgrade-Code verwenden.
Wenn Ihr IT- oder Sicherheitsteam diesen Ressourcentyp im Abonnement nicht zulässt, kann es die Option verwenden, um die Horizon Cloud-Angebots-SKUs zum Azure Private Store des Unternehmens hinzuzufügen, indem es die Aktionen ausführt, die im Abschnitt Hinzufügen der Angebote zur Azure Private Store-Sammlung des Unternehmens beschrieben sind. Dann können die API-Aufrufe des Diensts die Angebote von dort abrufen.
Anforderung, wenn Ihr Unternehmensadministrator den Azure Marketplace-Kauf für seinen Azure Enterprise-Mandanten deaktiviert hat
Wie in der Microsoft Azure-Dokumentation beschrieben, können Unternehmensadministratoren den Azure Marketplace-Kauf für alle Azure-Abonnements unter ihrem Azure-Unternehmensmandanten deaktivieren.
Wenn sie dies tun, wird der Azure Marketplace-Kauf auf Angebote des Microsoft-Herausgebers beschränkt. Dieser eingeschränkte Kauf blockiert die API-Aufrufe des Diensts zum Abrufen der Horizon Cloud-Angebote von publisherID omnissallc und verhindert infolgedessen den Bereitstellungs- und Upgrade-Prozess, für den diese API-Aufrufe erforderlich sind.
In diesem Szenario wird dem Horizon Cloud-Support eine Fehlermeldung angezeigt, die in einem Muster protokolliert wird, 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.wie z. B.
Die Lösung für diese Situation besteht darin, den Unternehmensadministrator aufzufordern, eine private Azure Marketplace-Sammlung zu erstellen und zu verwalten und die Horizon Cloud-Angebote hinzuzufügen, indem Sie die Aktionen im folgenden Abschnitt Hinzufügen der Angebote zur Azure Private Store-Sammlung des Unternehmens ausführen.
Hinzufügen der Angebote zur Azure Private Store-Sammlung des Unternehmens
Microsoft Azure bietet die Möglichkeit, eine private Azure Marketplace-Sammlung für die Verwendung durch Ihre Abonnements zu erstellen und zu verwalten. Wie unter Erstellen und Verwalten eines privaten Azure Marketplace beschrieben, können IT-Administratoren mit dieser Funktion vorab genehmigen, kuratieren und steuern, welche Drittanbieterlösungen ihre Benutzer über den globalen Azure Marketplace verwenden können. Wie auf der im vorigen Satz verknüpften Microsoft-Dokumentationsseite beschrieben, muss die Rolle des Marketplace-Administrators dem Administrator zugewiesen werden, der den Private Store verwalten wird.
Sobald der Private Store für den Azure-Mandanten des Unternehmens erstellt wurde, kann der Administrator mit der Rolle Marketplace-Administrator die Angebote zur Private Store-Sammlung hinzufügen. Das Hinzufügen der Angebote zum Private Store des Mandanten ermöglicht die API-Aufrufe des Diensts, um die Angebote abzurufen, die für Bereitstellungen und Upgrades verwendet werden.
Microsoft stellt PowerShell-Befehle bereit, um bestimmte Herausgeberangebote zu einer Private Store-Sammlung hinzuzufügen.
Befolgen Sie die Microsoft-Dokumentationsreferenz für die Voraussetzungen für die Ausführung der PowerShell-Befehle unter Hinzufügen eines Angebots zu einem privaten Marketplace. Auf dieser Microsoft-Seite werden auch die PowerShell-Befehle beschrieben, die Microsoft zu diesem Zweck bereitstellt.
Das folgende Beispiel veranschaulicht die Microsoft PowerShell-Befehle, die verwendet werden sollen, um die Horizon Cloud-Angebote zu diesem Private Store hinzuzufügen, nachdem die Voraussetzungen für die Ausführung der Befehle erfüllt sind. Die erste Get-AzMarketplacePrivateStore wird verwendet, um die privateStoreId. Dann Set-AzMarketplacePrivateStoreOffer wird verwendet, um die Horizon Cloud-Angebote zu diesem Private Store hinzuzufügen.
Get-AzMarketplacePrivateStore
-
Verwenden Sie
Get-AzMarketplacePrivateStore, um die Azure-MandantenprivateStoreIdabzurufen, die im nächsten Befehlssatz verwendet werden sollen.Get-AzMarketplacePrivateStore -
Verwenden Sie die in den
Set-AzMarketplacePrivateStoreOfferBefehlen zurückgegebeneprivateStoreId, um ihrerseits die Angebote füromnissa-hcs-podmgr,omnissa-hcs-uagundomnissa-hcs-jumpboxhinzuzufügen.-
Fügen Sie das Angebot für die Pod-Manager-Instanzen hinzu:
Set-AzMarketplacePrivateStoreOffer -privateStoreId your-tenant-privateStoreID -offerId omnissallc.omnissa-hcs-podmgr -SpecificPlanIdsLimitation @("omnissa-hcs-podmgr") -
Fügen Sie das Angebot für die Unified Access Gateway-Instanzen hinzu:
Set-AzMarketplacePrivateStoreOffer -privateStoreId your-tenant-privateStoreID -offerId omnissallc.omnissa-hcs-uag -SpecificPlanIdsLimitation @("omnissa-hcs-uag") -
Fügen Sie das Angebot für die Jumpbox-Instanz zur Fehlerbehebung hinzu:
Set-AzMarketplacePrivateStoreOffer -privateStoreId your-tenant-privateStoreID -offerId omnissallc.omnissa-hcs-jumpbox -SpecificPlanIdsLimitation @("omnissa-hcs-jumpbox")
-
-
Überprüfen Sie, ob die Angebote jetzt im Private Store des Mandanten aufgeführt sind.
Get-AzMarketplacePrivateStoreOffer -PrivateStoreId your-tenant-privateStoreID
Azure China – Besondere Überlegungen
Da Microsoft den Ressourcentyp Microsoft.Marketplace.Order in Azure China nicht bereitstellt, können die Funktionen des Diensts, die API-Aufrufe für die Angebote von Horizon Cloud in Azure Marketplace verwenden, nicht unterstützt werden. Der Typ Microsoft.Marketplace.Order ist in dieser Microsoft-Dokumentationsreferenz für Azure China-Ressourcenanbieter nicht aufgeführt.
Beachten Sie daher diese besonderen Überlegungen, wenn Sie ein Abonnement in Azure China für eine Horizon Cloud on Microsoft Azure-Bereitstellung verwenden.
- Für eine vorhandene Horizon Cloud on Microsoft Azure-Bereitstellung in Azure China erhalten Sie vor dem Upgrade dieser Bereitstellung Unterstützung vom Horizon Cloud-Support, um Ihren Horizon Cloud-Mandanten für die Verwendung der vorherigen Upgrade-Methode ohne API-Aufrufe an den Azure Marketplace zu konfigurieren.
- Wenn Sie eine Bereitstellung in Azure China planen, bevor Sie mit dieser Bereitstellung beginnen, wenden Sie sich an den Horizon Cloud-Support, um Ihren Horizon Cloud-Mandanten so zu konfigurieren, dass der Bereitsteller die vorherige Bereitstellungsmethode ohne API-Aufrufe an den Azure Marketplace verwendet.
- Wenn der Horizon Cloud-Support eine temporäre Jumpbox zur Fehlerbehebung bei einer Bereitstellung in Azure China bereitstellen muss, kann der Horizon Cloud-Support vorübergehend den Horizon Cloud-Mandanten konfigurieren, um die Funktion zur Bereitstellung der temporären Jumpbox im Abonnement ohne die API-Aufrufe des Diensts im Azure Marketplace zu aktivieren. Nachdem die temporäre Jumpbox zur Fehlerbehebung bereitgestellt wurde, kann Horizon Cloud Support die Funktion für die API-Aufrufe des Diensts erneut aktivieren, falls der Mandant Pods in Abonnements bereitgestellt hat, die sich zusätzlich zu Azure China in Regionen befinden.
Bereitstellungen und Upgrades ohne Verwendung des Azure Marketplace dauern länger. Außerdem erfordern solche Bereitstellungen und Upgrades die Verwendung der temporären Jumpbox, um die Bereitstellungs- und Upgrade-Prozesse zu orchestrieren, sowie die Verwendung von Speicherkonten im Abonnement, um die Images zu speichern, die die API-Aufrufe des Diensts von der Horizon Cloud-Steuerungsebene abrufen, anstatt die Horizon Cloud-Angebote im Azure Marketplace zu verwenden.
War diese Seite hilfreich?