1 de setembro de 2026

Quando sua organização de TI ou segurança tem restrições para o uso de ofertas do Azure Marketplace ou compras no Marketplace no Horizon Cloud na assinatura da implantação do Microsoft Azure ou quando a implantação usa o Azure China

Esta página de documentação descreve os requisitos relacionados ao uso do Horizon Cloud no Microsoft Azure do Azure Marketplace para os processos de implantação e upgrade, e quando sua solicitação de suporte requer Suporte Horizon Cloud para implantar um jumpbox para solução de problemas.

Essas informações pertencem a você se você ou sua organização de TI ou segurança tiver definido restrições no Horizon Cloud nas assinaturas da implantação do Microsoft Azure em torno do uso de ofertas do Azure Marketplace ou de pedidos do Azure Marketplace.

Além disso, se você tiver um Horizon Cloud sobre a implantação do Microsoft Azure no Azure China, poderá precisar de assistência da equipe de suporte do Horizon Cloud, conforme descrito na seção desta página Implantações no Azure China.

Introdução

A partir do início do ano civil de 2022, o serviço aprimorou o Horizon Cloud no implantador do Microsoft Azure e o código de upgrade para uso programático das ofertas que fornecemos no Azure Marketplace.

Esse aprimoramento torna o processo inicial de implantação e o processo de upgrade mais rápido para obter upgrades quase sem tempo de inatividade das instâncias do gerenciador de pods e instâncias do Unified Access Gateway.

Esse aprimoramento também permite a execução de implantações e upgrades sem usar contas de armazenamento adicionais além da conta de armazenamento usada para o recurso App Volumes.

Relacionamento do Azure Marketplace com implantações, upgrades e jumpbox para suporte

Durante os processos de implantação e upgrade, o implantador e o código de upgrade tentam programaticamente por chamada da API aceitar os termos de Horizon Cloud ofertas no Azure Marketplace que correspondem ao publisherID chamado omnissallc.

Entidade relacionada	ID do editor	ID da oferta	ID do plano
gerenciador de pods	omnissallc	omnissa-hcs-podmgr	omnissa-hcs-podmgr
Unified Access Gateway	omnissallc	Omnissa-HCS-UAG	Omnissa-HCS-UAG
jumpbox, quando necessário pela Horizon Cloud Suporte para circunstâncias de solução de problemas	omnissallc	omnissa-hcs-jumpbox	omnissa-hcs-jumpbox

Observação: Não há suporte para usar o Portal do Azure para visualizar essas ofertas navegando até o Azure Marketplace. Horizon Cloud publica essas ofertas de acesso programático usando chamadas de API.

Requisitos de chamada de API do serviço

O sucesso desse método programático requer que o Horizon Cloud nas assinaturas do Azure da implantação do Microsoft Azure atenda aos requisitos descritos nas seções a seguir.

Esses itens permitem que o implantador e as chamadas de API de upgrade aceitem os termos de Horizon Cloud ofertas no Azure Marketplace que correspondem a publisherID, offerID e planID do serviço, conforme listado na tabela anterior.

Esses requisitos se aplicam tanto às assinaturas usadas pelas instâncias do gerenciador de pods quanto às assinaturas usadas pelas instâncias do Unified Access Gateway quando implantadas na própria assinatura.

Se os seguintes itens não forem atendidos na assinatura do Azure, as chamadas de API do implantador e do código de upgrade para aceitar os termos da oferta falharão, resultando em:

Novas falhas de implantação que envolvem essa assinatura.
Falhas de upgrade para o gerenciador de pods e instâncias do Unified Access Gateway já implantadas nessa assinatura.
Falha ao implantar o jumpbox para solução de problemas nessa assinatura, se necessário, Horizon Cloud Suporte para solucionar problemas com suas solicitações de suporte.

Uma situação especial é o cenário de uma implantação do Horizon Cloud no Microsoft Azure localizada no Azure China. No Azure China, a Microsoft não fornece o tipo de recurso Microsoft.Marketplace.Ordering que as chamadas de API do serviço precisam. Se o seu Horizon Cloud sobre a implantação do Microsoft Azure residir no Azure China, leia as orientações na seção Azure China: considerações especiais.

Requisito quando as entidades de serviço da implantação usam funções personalizadas

Ao usar uma função personalizada conforme descrita aqui, as seguintes permissões devem ser incluídas nas funções personalizadas:


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

Para novas implantações das instâncias do gerenciador de pods ou instâncias do Unified Access Gateway, os assistentes de implantação da UI validam se a entidade de serviço tem essas permissões na assinatura. Se essa validação falhar, a UI impedirá o início da implantação.
Para atualizações, o sistema faz verificações prévias para tentar confirmar se a entidade de serviço tem essas permissões na assinatura. Se estiver ausente, as verificações prévias relatarão um erro de bloqueio de atualização. A solução é incluir essas permissões na função personalizada.
Se Horizon Cloud Suporte precisar implantar o jumpbox para solução de problemas para responder à sua solicitação de suporte, o processo de implantação do jumpbox indicará ao Suporte Horizon Cloud que as permissões estão ausentes.

Nesse cenário, Horizon Cloud Suporte verá mensagens de erro registradas em um padrão, como 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.

Requisito quando uma política do Azure restringe os tipos de recursos do Azure permitidos nas assinaturas

A política do Azure de algumas organizações de TI pode especificar a proibição de todos os tipos de recursos do Azure, exceto para tipos de recursos específicos explicitamente permitidos pelo nome.

Quando sua organização de TI ou de segurança tiver definido essa Política do Azure que restringe os tipos de recursos do Azure permitidos nas assinaturas do Azure da organização, o conjunto AllowedResourceTypes da Política do Azure deverá incluir a permissão para o tipo Microsoft.MarketplaceOrdering/*de recurso .

Se a Política do Azure da assinatura não incluir Microsoft.MarketplaceOrdering/*, Horizon Cloud Suporte verá mensagens de erro registradas em um padrão como , em 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 Adminque xxxxx corresponde a um dos planIDs na tabela anterior.

Permitir o Microsoft.MarketplaceOrdering/* acesso ao tipo de recurso permite que o implantador e o código de upgrade façam chamadas de API para aceitar as Horizon Cloud nas ofertas do Microsoft Azure no Azure Marketplace que o implantador e o código de upgrade usam.

Se sua equipe de TI ou segurança se recusar a permitir esse tipo de recurso na assinatura, ela poderá usar a opção para adicionar as SKUs de oferta do Horizon Cloud à Loja privada do Azure da empresa executando as ações descritas na seção Adicionar as ofertas à coleção de lojas privadas do Azure da empresa. Em seguida, as chamadas de API do serviço podem obter as ofertas de lá.

Requisito quando o administrador da sua empresa desativa a compra do Azure Marketplace para seu tenant empresarial do Azure

Conforme descrito na documentação do Microsoft Azure, os administradores da empresa podem desativar a compra do Azure Marketplace para todas as assinaturas do Azure no tenant da empresa do Azure.

Quando eles fazem isso, a compra do Azure Marketplace é limitada a ofertas do editor da Microsoft. Essa compra limitada bloqueia as chamadas de API do serviço para obter as ofertas de Horizon Cloud do publisherID e, como resultado, impede o omnissallc processo de implantação e upgrade que exigem essas chamadas de API.

Nesse cenário, Horizon Cloud Suporte verá a mensagem de erro registrada em um padrão como 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..

A solução para essa situação é solicitar que o administrador da empresa crie e gerencie uma coleção privada do Azure Marketplace e adicione as ofertas de Horizon Cloud a ela executando as ações na seção a seguir: Adicionar as ofertas à coleção de armazenamentos privados do Azure da empresa.

Adicionar as ofertas à coleção de armazenamentos privados do Azure da empresa

O Microsoft Azure fornece a capacidade de criar e gerenciar uma coleção privada do Azure Marketplace para uso por suas assinaturas. Conforme descrito em criar e gerenciar um Azure Marketplace privado, esse recurso permite que os administradores de TI aprovem, escolham e controlem quais soluções de terceiros seus usuários podem usar no Azure Marketplace global. Conforme descrito na página de documentação da Microsoft vinculada na frase anterior, a função administrador do Marketplace deve ser atribuída ao administrador que gerenciará o armazenamento privado.

Depois que o armazenamento privado for criado para o tenant do Azure da empresa, o administrador com a função de administrador do Marketplace poderá adicionar as ofertas à coleção de armazenamentos privados. Adicionar as ofertas ao armazenamento privado do tenant fornece as chamadas de API do serviço para obter as ofertas usadas para implantações e upgrades.

A Microsoft fornece comandos do PowerShell com o objetivo de adicionar ofertas específicas de editor a uma coleção de armazenamentos privados.

Siga a referência da documentação da Microsoft para os pré-requisitos para executar os comandos do PowerShell em Adicionar uma oferta a um marketplace privado. Essa página da Microsoft também descreve os comandos do PowerShell que a Microsoft fornece para essa finalidade.

O exemplo a seguir ilustrará os comandos do Microsoft PowerShell a serem usados para adicionar as ofertas de Horizon Cloud a esse armazenamento privado depois que os pré-requisitos para executar os comandos forem atendidos. O primeiro Get-AzMarketplacePrivateStore é usado para obter o do tenant privateStoreIddo Azure. Em seguida, Set-AzMarketplacePrivateStoreOffer é usado para adicionar as ofertas de Horizon Cloud a esse armazenamento privado.


Get-AzMarketplacePrivateStore

Use Get-AzMarketplacePrivateStore para obter os tenants privateStoreId do Azure a serem usados no próximo conjunto de comandos.
```
Get-AzMarketplacePrivateStore
```

Use os retornados privateStoreId nos Set-AzMarketplacePrivateStoreOffer comandos para adicionar, por sua vez, as ofertas para omnissa-hcs-podmgr, omnissa-hcs-uage omnissa-hcs-jumpbox.

Adicione a oferta para as instâncias do gerenciador de pods:

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

Adicione a oferta para as instâncias do Unified Access Gateway:

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

Adicione a oferta para a instância do jumpbox para solução de problemas:

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

Verifique se as ofertas agora estão listadas no repositório privado do tenant.


Get-AzMarketplacePrivateStoreOffer -PrivateStoreId your-tenant-privateStoreID

Azure China: considerações especiais

Como a Microsoft não fornece o tipo de recurso Microsoft.Marketplace.Ordering no Azure China, não há suporte para os recursos do serviço que usam chamadas de API para as ofertas da Horizon Cloud no Azure Marketplace. O tipo Microsoft.Marketplace.Ordering não está listado nesta referência de documentação da Microsoft para provedores de recursos do Azure China.

Portanto, tenha em mente essas considerações especiais quando você estiver usando uma assinatura no Azure China para um Horizon Cloud na implantação do Microsoft Azure.

Para um Horizon Cloud existente na implantação do Microsoft Azure no Azure China, antes de atualizar essa implantação, obtenha ajuda do Suporte Horizon Cloud para configurar o tenant do Horizon Cloud para usar o método de upgrade anterior, sem chamadas de API para o Azure Marketplace.
Quando você planeja uma implantação no Azure China, antes de iniciar essa implantação, obtenha ajuda do Suporte de Horizon Cloud para configurar seu tenant Horizon Cloud para que o implantador use o método de implantação anterior, sem chamadas de API para o Azure Marketplace.
Se Horizon Cloud Suporte precisar implantar um jumpbox temporário para solucionar problemas de uma implantação localizada no Azure China, Horizon Cloud Suporte poderá configurar temporariamente o tenant Horizon Cloud para ativar o recurso para implantar o jumpbox temporário na assinatura sem as chamadas de API do serviço para o Azure Marketplace. Depois que o jumpbox temporário for implantado para solução de problemas, Horizon Cloud Suporte poderá reativar o recurso para chamadas de API do serviço, caso o tenant tenha pods implantados em assinaturas localizadas em regiões além do Azure China.

Implantações e upgrades sem o uso do Azure Marketplace demoram mais para serem concluídos. Além disso, tais implantações e upgrades exigirão o uso do jumpbox temporário para orquestrar os processos de implantação e upgrade e o uso de contas de armazenamento na assinatura para manter as imagens que as chamadas de API do serviço recuperarão da camada de controle do Horizon Cloud em vez de usar as ofertas de Horizon Cloud no Azure Marketplace.

Esta página foi útil?