Citrix Virtual Apps and Desktops

Criar um catálogo AWS EC2

May 31, 2026

Contribuição de:

(/pt-br/citrix-virtual-apps-desktops/2511/install-configure/machine-catalogs-create) descreve os assistentes que criam um catálogo de máquinas. As informações a seguir cobrem detalhes específicos para ambientes de virtualização AWS EC2.

Nota:

Antes de criar um catálogo AWS, você precisa concluir a criação de uma conexão com a AWS. Consulte Conexão com AWS EC2.

Configuração de rede durante a preparação da imagem

Durante a preparação da imagem, uma máquina virtual (VM) de preparação é criada com base na VM original. Esta VM de preparação é desconectada da rede. Para desconectar a rede da VM de preparação, um grupo de segurança de rede é criado para negar todo o tráfego de entrada e saída. Este grupo de segurança de rede persiste e é reutilizado. O nome do grupo de segurança de rede é Citrix.XenDesktop.IsolationGroup-GUID, onde GUID é gerado aleatoriamente.

Tenancy da AWS

A AWS oferece as seguintes opções de tenancy:

Tenancy compartilhada (o tipo padrão) e tenancy dedicada. Tenancy compartilhada significa que várias instâncias do Amazon EC2 de diferentes clientes podem residir na mesma peça de hardware físico.
Tenancy dedicada significa que suas instâncias EC2 são executadas apenas em hardware com outras instâncias que você implantou. Outros clientes não usam a mesma peça de hardware.

Requisitos para provisionamento em hosts AWS

Uma imagem BYOL (traga sua própria licença) importada (AMI). Com hosts dedicados, use e gerencie suas licenças existentes.
Uma alocação de hosts dedicados com utilização suficiente para satisfazer as solicitações de provisionamento.
Habilitar auto-placement.

Opções para configurar a tenancy da AWS

Usar hardware compartilhado. Essa configuração é adequada para a maioria das implantações. Vários clientes compartilham peças de hardware, embora não interajam entre si. Usar hardware compartilhado é a opção menos dispendiosa para executar suas instâncias do Amazon EC2.
Usar host dedicado. Um host dedicado do Amazon EC2 é um servidor físico com capacidade de instância EC2 que é totalmente dedicado, permitindo que você use licenças de software existentes por soquete ou por VM. Os hosts dedicados têm utilização predefinida com base no tipo de instância. Por exemplo, um único host dedicado alocado de tipos de instância C4 Large é limitado a executar 16 instâncias. Consulte o site da AWS para obter mais informações.

Essa configuração é adequada para implantações com restrições de licenciamento ou requisitos de segurança que exigem o uso de um host dedicado. Com um host dedicado, você possui um host físico inteiro e é cobrado por hora. Possuir esse host permite que você crie quantas instâncias EC2 o host permitir, sem custos adicionais.
Usar instância dedicada. Essa configuração é mais adequada para implantações com requisitos específicos de segurança ou conformidade. Com uma instância dedicada, você ainda desfruta dos benefícios de ter um host separado de outros clientes da AWS, mas não paga pelo host inteiro. Você não precisa se preocupar com a capacidade do host, mas é cobrado a uma taxa mais alta pelas instâncias.

Nota:

Você pode excluir qualquer disco de identidade de preparação disponível se não houver uma criação de catálogo ou tarefa de atualização de imagem em andamento.

Para configurar a tenancy da AWS usando o Studio, consulte Criar um catálogo usando o Web Studio e usando o PowerShell, consulte Configurar a tenancy de host dedicado da AWS usando o PowerShell.

Marcar recursos operacionais da AWS

Uma Amazon Machine Image (AMI) representa um tipo de dispositivo virtual usado para criar uma máquina virtual no ambiente Amazon Cloud, comumente referido como EC2. Você usa uma AMI para implantar serviços que usam o ambiente EC2. Ao criar um catálogo para provisionar máquinas usando MCS para AWS, você seleciona a AMI para atuar como a imagem dourada para esse catálogo.

Importante:

A criação de catálogos usando um perfil de máquina e um modelo de inicialização é necessária para usar a marcação de recursos operacionais.

Para criar um catálogo da AWS, você deve primeiro criar uma AMI para a instância que deseja que seja a imagem dourada. O MCS lê as tags dessa instância e as incorpora ao modelo de inicialização. As tags do modelo de inicialização são então aplicadas a todos os recursos Citrix® criados em seu ambiente AWS, incluindo:

Máquinas Virtuais
Discos de VM
Interfaces de rede de VM
Buckets S3
Objetos S3
Modelos de inicialização
AMIs

Você pode marcar recursos operacionais usando o Studio e o PowerShell ao criar um catálogo. Para o Studio, consulte Criar um catálogo usando o Web Studio (página Imagem). Para o PowerShell, consulte Marcar recursos operacionais usando o PowerShell.

Criar um catálogo

Você pode criar um catálogo usando:

Web Studio
PowerShell

Criar um catálogo usando o Web Studio

Clique em Catálogos de Máquinas no painel de navegação esquerdo.
Clique em Criar Catálogo de Máquinas. A página Configuração do Catálogo de Máquinas é exibida.
Na página Tipo de Máquina, selecione um tipo de máquina para o catálogo, por exemplo, SO multissessão.
Na página Gerenciamento de Máquinas, selecione as seguintes configurações:
1. Selecione Máquinas que têm gerenciamento de energia (por exemplo, máquinas virtuais ou PCs blade).
2. Selecione Tecnologia de provisionamento Citrix. Em seguida, selecione Citrix Machine Creation Services™.
3. No campo Recursos, selecione os recursos (zona de disponibilidade ou zona local) que você configurou ao criar a conexão do host e clique em Avançar.
Na página Experiência da área de trabalho, selecione uma área de trabalho aleatória ou estática que você deseja que os usuários tenham ao fazer login.
Na página Imagem:
1. Selecione um modelo de máquina que você deseja usar como imagem mestre para todas as máquinas no catálogo.
2. Se você quiser que as VMs no catálogo herdem as configurações de um perfil de máquina, selecione um perfil de máquina. Por padrão, a caixa de seleção Usar um perfil de máquina é selecionada. Para alterar a origem do perfil de máquina para outra VM ou versão do modelo de inicialização, clique no botão de edição.
3. Selecione a caixa de seleção Aplicar tags de máquina a recursos operacionais para aplicar tags de máquina a recursos operacionais. Esta opção controla se as tags de máquina devem ser aplicadas a cada item criado em seu ambiente AWS que facilita o provisionamento de máquinas. Os recursos operacionais são criados como subprodutos da criação do catálogo. Eles incluem recursos temporários e persistentes, como instâncias de VM de preparação e AMI.
Nota:

A página Segurança aparece somente se você estiver criando um catálogo de máquinas sem atribuir um perfil de máquina.
Na página Máquinas Virtuais:
1. Insira o número de VMs para o catálogo.
2. A especificação de máquina padrão é exibida, que é baseada no perfil da máquina. Para alterá-la, selecione o ícone de edição e selecione uma especificação de máquina.
3. Configure a tenancy do AWS. Consulte Opções para configurar a tenancy do AWS.
4. Você também pode configurar uma VM secundária quando o tamanho da máquina primária atingir a capacidade total. Clique em Tamanho secundário (opcional). Na janela Tamanho da máquina secundária, as VMs listadas têm tipos de VM Spot e Regular. Você pode selecionar até 10 tamanhos de máquina secundários. Uma vez que as 10 VMs são selecionadas, as outras VMs listadas são desabilitadas para seleção posterior. Clique em Avançar. No painel Tamanho da máquina secundária, você pode selecionar vários tamanhos de máquina e arrastar e soltar para alterar a ordem de prioridade. Clique em Concluído. Os tamanhos de máquina selecionados aparecem em Tamanho secundário (opcional). Clique no ícone de edição para editar conforme necessário.
A página Segurança aparece somente se você estiver criando um catálogo de máquinas sem atribuir um perfil de máquina. Use a página Segurança para configurar os grupos de segurança para as VMs. Isso também é aplicável ao editar e clonar um catálogo de máquinas existente.

Se você criar um catálogo de máquinas baseado em perfil de máquina, as configurações do grupo de segurança serão herdadas do perfil de máquina e a página Segurança não aparecerá.
Na página NICs, selecione as NICs (ou ENIs) para as VMs.
Na página Configurações de Disco, escolha se deseja habilitar o cache de write-back.
Na página Identidades da Máquina, configure o Active Directory local ou o Microsoft Entra híbrido para as máquinas no catálogo, selecionando o domínio e criando novas contas AD para as VMs a serem criadas neste catálogo de máquinas. As VMs provisionadas são unidas ao domínio selecionado. Especifique o esquema de nomenclatura de conta para as novas contas AD a serem criadas para as VMs. Clique em Avançar.
Na página Credenciais de domínio, clique em Inserir credenciais para fornecer as credenciais para o domínio selecionado. Insira o nome de usuário e a senha de nível de administrador quando solicitado. Você também pode usar uma conta de serviço se tiver credenciais de domínio já salvas anteriormente, seguindo a documentação do nosso produto.
Clique nas páginas restantes até a página Resumo. Insira um nome para o catálogo de máquinas e selecione Concluir para criar o catálogo de máquinas.

Limitações na criação de um catálogo de máquinas em uma zona local da AWS

Certas zonas locais suportam apenas determinadas configurações de hardware (por exemplo, a zona local de Perth não suporta volumes GP3, apenas GP2).
Como apenas gp2 é universalmente suportado em todas as zonas locais, e nem todas suportam gp3, a criação de disco de ID usa o tipo de volume gp2 por padrão.
Você deve selecionar um perfil de máquina com especificações de hardware que sejam suportadas na zona local desejada.
Os snapshots de AMIs de imagem preparadas e os snapshots de disco de ID são colocados por padrão na região, em vez da zona local (devido às limitações da AWS em relação à visibilidade do suporte a snapshots EBS em zonas locais).
Apenas zonas locais que suportam serviços completos de EC2 e EBS são zonas suportadas.

Criar um catálogo usando PowerShell

Configurar a tenancy de host dedicado da AWS usando o PowerShell

Alternativamente, você pode provisionar hosts dedicados da AWS via PowerShell. Use o cmdlet New-ProvScheme com o parâmetro TenancyType definido como Host.

Marcar recursos operacionais usando PowerShell

Para usar o PowerShell para marcar recursos:

Abra uma janela do PowerShell no host DDC.
Execute o comando asnp citrix para carregar os módulos PowerShell específicos da Citrix.

Para marcar um recurso para uma VM provisionada, use a propriedade personalizada AwsOperationalResourcesTagging. Exemplo:

New-ProvScheme -ProvisioningSchemeName test
-CustomProperties “AwsOperationalResourcesTagging,true”
-MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion"
... <Other <standard provscheme parameters>
<!--NeedCopy-->

Catálogo habilitado para MCSIO

A Otimização de Armazenamento MCS (MCSIO) melhora o desempenho da VM armazenando em cache as operações de disco na memória ou em um disco pequeno de alta velocidade. Você pode criar um catálogo não persistente habilitado para MCSIO usando comandos PowerShell. Para criar tal catálogo, você deve instalar o driver MCSIO durante a instalação ou atualização do VDA durante a preparação da instância AMI. Por padrão, esse driver não é instalado.

Depois que uma AMI MCSIO é preparada (ao instalar o VDA, selecione a opção para incluir o driver MCSIO na instalação), você pode criar um catálogo não persistente habilitado para MCSIO.

Nota:

A opção de configurar o MCSIO com apenas cache de disco (sem cache de memória) usando o Studio foi removida em todos os hipervisores e ambientes de serviço em nuvem.

Criar um catálogo habilitado para MCSIO

Os quatro parâmetros adicionados ao comando PowerShell New-ProvScheme são:

UseWriteBackCache: Ativa o cache (cache de write-back) para o esquema de provisionamento fornecido
WriteBackCacheDiskSize: Especifica o tamanho em GB do disco temporário usado para cache
WriteBackCacheMemorySize: Especifica a quantidade de memória em MB a ser usada para cache. Este é um parâmetro opcional.

Nota:

O valor de WriteBackCacheDiskSize deve ser maior que zero porque é necessário pelo menos 1 GB de armazenamento em disco de cache. O tamanho do disco de cache não deve ser maior que o tamanho do disco do SO.

O valor de WriteBackCacheMemorySize deve ser diferente de zero e menor que o tamanho da memória do catálogo de máquinas.

As propriedades personalizadas que afetam o MCSIO são:

WBCDiskStorageType: Define o tipo de volume, que é usado para o disco temporário no AWS. Este parâmetro aceita um argumento de string no formato volume-type[:iops][:throughput]. A seguir estão os tipos de volume:
- gp2: Não use os parâmetros iops e throughput para este tipo de volume
- gp3: Use os parâmetros iops e throughput para este tipo de volume
- io1: Use apenas o parâmetro iops para este tipo de volume
- io2: Use apenas o parâmetro iops para este tipo de volume
O tipo de volume padrão é gp2.
PersistWBC: Controla se o disco de cache deve ser mantido ou descartado sempre que a instância AWS for desligada. Se definido como true, o disco de cache é mantido. Se definido como false (o padrão), o disco de cache é criado e mantido apenas enquanto a instância AMI estiver ligada.
PersistOSDisk: Controla se o disco do SO deve ser mantido ou descartado sempre que a instância AWS for desligada. Se definido como true, o disco do SO é mantido. Se definido como false (o padrão), o disco do SO é criado e mantido apenas enquanto a instância AMI estiver ligada.

Execute as seguintes etapas na janela do PowerShell para criar um catálogo não persistente habilitado para MCSIO:

Abra a janela do PowerShell.
Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.
Crie um catálogo de broker e um pool de identidade.

Crie o esquema de provisionamento. Por exemplo:

$HostingUnitUid = '0xxxx1d9-bbfc-xxxf-bxxb-exxxxxe008b2'
$MasterImageVM = 'XDHyp:\HostingUnits\ctx-test\aws-apollo-non-persistent-multi-mcsio-vda-win2022 (ami-0bf1810488acbxxxb).template'
$NetworkMap = @{ 'NetworkPath' = 'XDHyp:\HostingUnits\ctx-test\us-east-1a.availabilityzone\10.0.128.0`/17 (vpc-0fa6e41d72507fxxx).network' }
$SecurityGroup = $( 'XDHyp:\HostingUnits\ctx-test\us-east-1a.availabilityzone\private.securitygroup' )
$ServiceOffering = 'XDHyp:\HostingUnits\ctx-test\T3 Medium Instance.serviceoffering'
$CustomProperties = 'WBCDiskStorageType,gp3:6000:250;PersistWBC,false'


$provScheme = New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
-IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot `
- MasterImageVM $MasterImageVM `
-NetworkMap $NetworkMap `
-ServiceOffering $ServiceOffering `
-SecurityGroup $SecurityGroup `
-CustomProperties $CustomProperties `
-UseWriteBackCache -WriteBackCacheDiskSize 16 -WriteBackCacheMemorySize 256
<!--NeedCopy-->

Adicione VMs ao catálogo.

Melhore o desempenho de inicialização com MCSIO

Você pode melhorar o desempenho de inicialização de VMs se habilitar o MCSIO e definir as propriedades personalizadas PersistWBC e PersistOSDisk como tru. Com essa configuração, as VMs podem inicializar mais rapidamente porque não precisam inicializar um novo disco de cache ou recriar um disco raiz a partir de seu modelo.

Crie um catálogo de máquinas baseado em perfil de máquina usando PowerShell

Você pode usar um perfil de máquina para capturar as propriedades de hardware de uma instância EC2 (VM) ou versão de modelo de inicialização e aplicá-las às máquinas provisionadas. As propriedades capturadas podem incluir, por exemplo, propriedades de volume EBS, tipo de instância, otimização EBS, opções de CPU, tipo de locação, capacidade de hibernação, grupos de segurança e outras configurações AWS suportadas.

Você pode usar uma instância AWS EC2 (VM) ou uma versão de modelo de inicialização AWS como entrada do perfil de máquina.

Nota:

As propriedades do volume EBS são derivadas apenas de um perfil de máquina.

Considerações importantes

As considerações importantes ao criar um catálogo de máquinas MCS:

Se você adicionar parâmetros de propriedade de hardware da máquina nos comandos New-ProvScheme e Set-ProvScheme, os valores fornecidos nos parâmetros sobrescreverão os valores no perfil da máquina.
Se você definir AwsCaptureInstanceProperties como true e não definir a propriedade MachineProfile, então apenas as funções IAM e as tags serão capturadas.
Você não pode definir AwsCaptureInstanceProperties e MachineProfile ao mesmo tempo.

Nota:

O AwsCaptureInstanceProperties está obsoleto.
Se um perfil de máquina não for fornecido, você deve fornecer explicitamente os valores das seguintes propriedades:
- Grupo de Segurança
- ENI ou Rede Virtual
Você pode habilitar AwsOperationalResourcesTagging somente se habilitar AwsCaptureInstanceProperties ou especificar um perfil de máquina.

A consideração importante após criar um catálogo de máquinas MCS é:

Você não pode alterar um catálogo de um catálogo baseado em perfil de máquina para um catálogo não baseado em perfil de máquina.

Configurar grupos de segurança em uma entrada de perfil de máquina

Você pode criar um catálogo de máquinas MCS onde as VMs provisionadas recebem grupos de segurança por ENI (Interface de Rede). Para fazer isso, use uma entrada de perfil de máquina (instância EC2 ou modelo de inicialização) que tenha diferentes grupos de segurança mapeados para ENIs distintas. Por exemplo, se a entrada do perfil de máquina tiver ENI A com SG 1 e ENI B com SG 2, as VMs provisionadas também devem ter ENI A com SG 1 e ENI B com SG 2.

Recuperar detalhes da interface de rede

Execute os seguintes comandos para obter a lista de registros de dados da interface de rede, incluindo o SubnetId da interface, grupos de segurança atribuídos e redes atribuídas.

(Get-HypInventoryItem -LiteralPath 'XdHyp:\HostingUnits\cvad-test' – ResourceType vm). AdditionalData
<!--NeedCopy-->

Nota:

O MCS atualmente não permite mais de uma rede por interface de rede.

Criar um catálogo de máquinas usando um perfil de máquina

Para criar um catálogo de máquinas usando um perfil de máquina:

Abra uma janela do PowerShell.
Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.

Crie um pool de identidades se ainda não tiver sido criado. Por exemplo,

New-AcctIdentityPool -IdentityPoolName idPool -NamingScheme ms## -Domain abcdf -NamingSchemeType Numeric
<!--NeedCopy-->

Execute o comando New-ProvScheme. Por exemplo:

New-ProvScheme -ProvisioningSchemeName demet-test-1
-HostingUnitUid aa633238-9xxd-4cf6-80e8-232a758a1xx1
-IdentityPoolUid 34d5b088-e312-416f-907d-16573xxxxxc4
-CleanOnBoot
-MasterImageVM 'XDHyp:\HostingUnits\cvad-test-scalestress\citrix-demet-ami.0 (ami-0ca813xxxxxx061ef).template'
-MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm'
<!--NeedCopy-->

Conclua a criação do catálogo.

Atualizar o perfil da máquina

Para atualizar o perfil da máquina em um catálogo que foi inicialmente provisionado com um perfil de máquina, faça o seguinte. Você também pode alterar o tipo de locação e a capacidade de hibernação da origem do perfil da máquina ao editar um catálogo de máquinas MCS.

Execute o comando Set-ProvScheme. Por exemplo,

Set-ProvScheme `
-ProvisioningSchemeUid "<ID" `
-MachineProfile "XDHyp:\HostingUnits\abc\us-east-1a.availabilityzone\citrix-cvad-machineprofile-instance (i-0xxxxxxxx).vm"
<!--NeedCopy-->

Criar um catálogo com a versão do modelo de inicialização usando PowerShell

Você pode criar um catálogo de máquinas MCS com uma versão de modelo de inicialização como entrada de perfil de máquina. Você também pode atualizar a entrada de um catálogo de perfil de máquina de uma VM para uma versão de modelo de inicialização e de uma versão de modelo de inicialização para uma VM.

No console do AWS EC2, você pode fornecer as informações de configuração da instância de um modelo de inicialização junto com o número da versão. Ao especificar a versão do modelo de inicialização como entrada de perfil de máquina ao criar ou atualizar um catálogo de máquinas, as propriedades dessa versão do modelo de inicialização são copiadas para as VMs VDA provisionadas.

As seguintes propriedades podem ser fornecidas usando a entrada do perfil da máquina ou explicitamente como parâmetros nos comandos New-ProvScheme ou Set-ProvScheme. Se forem fornecidas nos comandos New-ProvScheme ou Set-ProvScheme, elas terão precedência sobre os valores do perfil da máquina dessas propriedades.

Oferta de Serviço
Redes
Tipo de Tenência

Nota:

Se a oferta de serviço não for fornecida no modelo de inicialização do perfil da máquina ou como um parâmetro no comando New-ProvScheme, você receberá um erro apropriado.

Para criar um catálogo usando a versão do modelo de inicialização como entrada de perfil de máquina:

Abra uma janela do PowerShell.
Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.

Obtenha a lista de versões de um modelo de inicialização. Por exemplo:

XDHyp:\HostingUnits\test\test-mp-sard (lt-01xxxxx).launchtemplate> ls | Select FullPath
<!--NeedCopy-->

Crie um pool de identidades, se ainda não tiver sido criado. Por exemplo:

New-AcctIdentityPool `
-IdentityPoolName "abc11" `
-NamingScheme "abc1-##" `
-NamingSchemeType Numeric `
-Domain "citrix-xxxxxx.local" `
-ZoneUid "xxxxxxxx" `
<!--NeedCopy-->

Crie um esquema de provisionamento com uma versão de modelo de inicialização como entrada de perfil de máquina. Por exemplo:

New-ProvScheme `
-ProvisioningSchemeName "MPLT1" `
-HostingUnitUid "c7f71f6a-3f45-4xxx-xxxx-xxxxxxxxxx" `
-IdentityPoolUid "bf3a6ba2-1f80-4xxx-xxxx-xxxxxxxxx" `
-MasterImageVM "XDHyp:\HostingUnits\xxxd-ue1a\apollo-non-persistent-vda-win2022 (ami-0axxxxxxxxxxx).template" `
-CleanOnBoot `
-MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion"
<!--NeedCopy-->

Registre um esquema de provisionamento como um catálogo de broker. Por exemplo:

New-BrokerCatalog -Name "MPLT1" `
-AllocationType Random `
-Description "Machine profile catalog" `
-ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `
-ProvisioningType Mcs `
-SessionSupport MultiSession `
-PersistUserChanges Discard
<!--NeedCopy-->

Conclua a criação do catálogo.

Atualizar a origem do perfil da máquina

Você também pode atualizar a entrada de um catálogo de perfil de máquina de uma VM para uma versão de modelo de inicialização e de uma versão de modelo de inicialização para uma VM. Por exemplo:

Para atualizar a entrada de um catálogo de perfil de máquina de uma VM para uma versão de modelo de inicialização:

 Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
 -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-0bxxxxxxxxxxxx).launchtemplate\lt-0bxxxxxxxxxxxx (1).launchtemplateversion"
 <!--NeedCopy-->

Para atualizar a entrada de um catálogo de perfil de máquina de uma versão de modelo de inicialização para uma VM:

 Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
 -MachineProfile "XDHyp:\HostingUnits\sard-ue1a\us-east-1a.availabilityzone\apollo-non-persistent-vda-win2022-2 (i-08xxxxxxxxx).vm"
 <!--NeedCopy-->

Criptografar discos de SO, ID e WBC

Você pode criar um catálogo persistente e não persistente de VMs com chaves AWS KMS (chave gerenciada pelo cliente e chave gerenciada pela AWS) que podem ser usadas para criptografar o disco do SO, o disco de identidade (ID) e o disco de cache de gravação (WBC).

As chaves gerenciadas pela AWS são rotacionadas automaticamente todos os anos.
As chaves gerenciadas pelo cliente são opcionais para rotação automática e podem ser gerenciadas manualmente.

Você pode consultar os seguintes documentos da AWS para obter mais informações sobre chaves KMS:

Para criptografia de discos de SO, ID e WBC, configure um dos seguintes:

Use uma imagem mestre criptografada (por exemplo, uma AMI criada a partir de uma instância ou snapshot que contém um volume raiz EBS criptografado com chave KMS)
Use uma fonte de perfil de máquina (VM ou modelo de inicialização) que contenha um volume raiz EBS criptografado.

Limitações

Considere as seguintes limitações:

O MCS atualmente suporta apenas um disco na AMI da imagem mestre.
Você não pode criptografar diretamente volumes ou snapshots EBS não criptografados existentes, nem modificar a chave KMS de um volume criptografado existente. Para fazer isso, você deve:
1. Crie um novo snapshot desse volume.
2. Crie um novo volume a partir desse snapshot
3. Criptografe o novo volume.

Consulte os seguintes documentos da AWS:

Criptografar recursos não criptografados
Limitações da criptografia automática ou padrão de volumes EBS: Criptografar automaticamente volumes Amazon EBS existentes e novos.

Criar um catálogo com criptografia de disco

Você pode criar um catálogo de máquinas MCS com criptografia de disco usando:

Imagem mestre
Perfil de máquina

As considerações ao usar a entrada do perfil da máquina são:

A chave KMS da entrada do perfil da máquina tem precedência sobre a chave KMS da imagem mestre.
Se nenhuma entrada de perfil de máquina for fornecida, a chave KMS da AMI da imagem mestre será usada para criptografar os discos das VMs do catálogo.
Se o perfil da máquina tiver Mapeamentos de Dispositivo de Bloco presentes, os dispositivos de bloco presentes no modelo de imagem mestre (AMI) e no perfil da máquina devem corresponder. Por exemplo, se a AMI tiver um dispositivo definido em /dev/sda1, o Perfil da Máquina também deverá ter um dispositivo definido em /dev/sda1.
Se não houver chave na origem do perfil da máquina e a imagem mestre não estiver criptografada, os discos das VMs do catálogo não serão criptografados.
Quando a imagem mestre é criptografada, uma VM de origem de perfil de máquina ou um modelo de inicialização deve ter um volume raiz criptografado para ser considerado uma entrada válida.

Modificar um catálogo existente

Você pode modificar um catálogo existente usando o comando PowerShell Set-ProvScheme para ter:

Uma entrada de perfil de máquina com um volume contendo uma nova chave KMS.
Um AMI de modelo de imagem mestre criptografado com uma nova chave KMS.

Considerações importantes:

Os volumes de novas VMs adicionadas ao catálogo são criptografados com a nova chave KMS.
Para atualizar as configurações de criptografia quando houver um perfil de máquina existente, execute Set-ProvScheme com um novo perfil de máquina.
Você não pode modificar um catálogo existente de volumes criptografados para volumes não criptografados. Você não pode fazer uma atualização de imagem de um AMI mestre criptografado para um AMI mestre não criptografado.

Habilitar NitroTPM e inicialização segura UEFI para instâncias de VM

Ao criar um catálogo, agora você pode selecionar uma imagem mestre (AMI) com NitroTPM e/ou inicialização segura UEFI habilitados. Consequentemente, as VMs provisionadas no catálogo também são habilitadas com NitroTPM e/ou inicialização segura UEFI. Essa implementação garante que as VMs sejam seguras e confiáveis. Para obter mais informações sobre NitroTPM e inicialização segura UEFI, consulte a documentação da Amazon.

Limitações

Você pode usar NitroTPM e Secure Boot atualmente em todas as regiões da AWS (incluindo as regiões AWS GovCloud (US)), exceto na China.
Você não pode habilitar NitroTPM e inicialização segura UEFI em catálogos existentes. Se você deseja um catálogo com NitroTPM e inicialização segura UEFI habilitados, crie um novo catálogo.

Etapas principais

Configure seu ambiente AWS.
Criar uma conexão com a AWS.
Criar uma imagem mestre (AMI) habilitada com NitroTPM e/ou inicialização segura UEFI.
Crie um catálogo de máquinas selecionando a imagem mestre com NitroTPM e inicialização segura UEFI habilitados no menu de criação de catálogo do Web Studio ou ao criar um Esquema de Provisionamento usando comandos PowerShell.

As VMs adicionadas ao catálogo criado têm NitoTPM e inicialização segura UEFI habilitados.

Criar uma AMI que suporte NitroTPM e inicialização segura UEFI

Você pode criar uma AMI a partir de uma VM que tenha NitroTPM e/ou inicialização segura UEFI habilitados.
1. Crie a instância usando as imagens do AWS Marketplace. Por exemplo, procure por TPM-Windows_Server-2022-English-Full-Base on the aws-marketplace.
2. Baixe o VDA de sessão única ou múltipla.
3. Crie uma AMI a partir dessa VM.
Use o comando register-image:
```
--boot-mode (string)
--tpm-support (string)

```
Para obter mais informações, consulte register-image.

Consulte os seguintes documentos da AWS:

Você pode abrir uma janela do PowerShell a partir do host do Delivery Controller™ para verificar se um específico:

a oferta de serviço suporta NitroTPM ou inicialização segura UEFI

 (Get-Item -Path “XDHyp:\HostingUnits\aws\T3 Medium Instance.serviceoffering”).AdditionalData.BootMode
 (Get-Item -Path “XDHyp:\HostingUnits\aws\T3 Medium Instance.serviceoffering”).AdditionalData.NitroTpmSupportVersions
 <!--NeedCopy-->

o modelo suporta NitroTPM ou inicialização segura UEFI

 (Get-HypInventoryItem -LiteralPath “XDHyp:\HostingUnits\aws” -ResourceType “template -Id “ID”).AdditionalData.BootMode

 (Get-HypInventoryItem -LiteralPath “XDHyp:\HostingUnits\aws” -ResourceType “template -Id “ID”).AdditionalData.TpmSupport
 <!--NeedCopy-->

Atualizar a oferta de serviço do catálogo existente

Você pode alterar a oferta de serviço de um catálogo existente usando Set-ProvScheme. A alteração se aplica às VMs recém-adicionadas. No entanto, você recebe erros nos seguintes cenários:

Modo de inicialização das AMIs	A AMI suporta Nitro TPM?	A oferta de serviço suporta NitroTPM e inicialização segura UEFI?
UEFI	Não	Não
BIOS herdado	Sim	Não
UEFI	Sim	Não
UEFI Preferencial	Sim	Não

Copiar tags em VMs

Você pode copiar tags em NICs e discos (disco de identidade, disco de cache de gravação e disco do SO) que são especificados no perfil da máquina para VMs recém-criadas em um catálogo de máquinas MCS. Você pode especificar essas tags em qualquer uma das fontes de perfil da máquina (instância de VM AWS ou versão de modelo de inicialização AWS). Este recurso é aplicável a catálogos de máquinas e VMs persistentes e não persistentes.

Nota:

No console do AWS EC2, você não pode ver os valores de Tag Network Interfaces em Launch Template Version Resource Tags. No entanto, você pode executar o comando PowerShell aws ec2 describe-launch-template-versions --launch-template-id lt-0bb652503d45dcbcd --versions 12 para ver as especificações da tag.

Se uma fonte de perfil de máquina (VM ou versão de modelo de inicialização) tiver duas interfaces de rede (eni-1 e eni-2), e eni-1 tiver a tag t1 e eni-2 tiver a tag t2, então a VM obterá as tags de ambas as interfaces de rede.

Filtrar instâncias de VM usando PowerShell

Uma instância de VM AWS que você usa como VM de perfil de máquina deve ser compatível para que o catálogo de máquinas seja criado e funcione corretamente. Para listar as instâncias de VM AWS que podem ser usadas como VMs de entrada de perfil de máquina, você pode usar o comando Get-HypInventoryItem. O comando pode paginar e filtrar o inventário de VMs disponíveis em uma unidade de hospedagem.

Paginação:

Get-HypInventoryItem suporta dois modos de paginação:

O modo de paginação usa os parâmetros -MaxRecords e -Skip para retornar conjuntos de itens:
- -MaxRecords: O padrão é 1. Isso controla quantos itens retornar.
- -Skip: O padrão é 0. Isso controla quantos itens pular desde o início absoluto (ou fim absoluto) da lista no hipervisor.
O modo de rolagem usa os parâmetros -MaxRecords, -ForwardDirection e -ContinuationToken para permitir a rolagem dos registros:
- -ForwardDirection: O padrão é True. Isso é usado junto com -MaxRecords para retornar o próximo conjunto de registros correspondentes ou o conjunto anterior de registros correspondentes.
- -ContinuationToken: Retorna os itens imediatamente após (ou antes, se ForwardDirection for false), mas não incluindo o item fornecido em ContinuationToken.

Exemplos de paginação:

Para retornar um único registro do modelo de máquina com o nome mais baixo. O campo AdditionalData tem o TotalItemsCount e o TotalFilteredItemsCount:
```
 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template
 
```

Para retornar 10 registros do modelo de máquina com o nome mais baixo:

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 10 | select Name
 <!--NeedCopy-->

Para retornar um array de registros terminando com o nome mais alto:

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ForwardDirection $False -MaxRecords 10 | select Name
 <!--NeedCopy-->

Para retornar um array de registros começando no modelo de máquina associado ao ContinuationToken fornecido:

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ContinuationToken "ami-07xxxxxxxxxx" -MaxRecords 10
 <!--NeedCopy-->

Filtragem:

Os seguintes parâmetros opcionais adicionais são suportados para filtragem. Você pode combinar esses parâmetros com as opções de paginação.

-ContainsName "my_name": Se a string fornecida corresponder a parte de um nome de AMI, a AMI será incluída no resultado Get. Por exemplo:

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -ContainName ‘apollo’ | select Name
 <!--NeedCopy-->

-Tags '{ "Key0": "Value0", "Key1": "Value1", "Key2": "Value2" }': Se uma AMI tiver pelo menos uma dessas tags, ela será incluída no resultado Get. Por exemplo:
```
 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -Tags '{"opex owner": "Not tagged"}' | select Name
 
```
Nota:

Dois valores de tag são suportados. O valor de tag Not Tagged corresponde a itens que não possuem a tag fornecida em sua lista de tags. O valor de tag All values corresponde a itens que possuem a tag, independentemente do valor da tag. Caso contrário, a correspondência ocorre apenas se o item tiver a tag e o valor for igual ao que é fornecido no filtro.

-Id "ami-0a2d913927e0352f3": Se a AMI corresponder ao ID fornecido, ela será incluída no resultado Get. Por exemplo:

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -Id ami-xxxxxxxxxxxxx
 <!--NeedCopy-->

Filtrando no parâmetro AdditionalData:

O parâmetro de filtro AdditionalData lista modelos ou VMs com base em sua capacidade, oferta de serviço ou qualquer propriedade que esteja em AdditionalData. Por exemplo:

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200).AdditionalData
<!--NeedCopy-->

Você também pode adicionar um parâmetro -Warn para indicar as VMs incompatíveis. As VMs são incluídas com um campo AdditionalData chamado Warning. Por exemplo:

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200 -Template "ami-015xxxxxxxxx" -Warn $true).AdditionalData
<!--NeedCopy-->

Lista de SKUs de backup para VMs

As nuvens públicas podem, às vezes, ficar sem capacidade para um tipo específico de instância EC2 (“SKU primário”). Se a configuração da VM primária não estiver disponível, a VM não poderá iniciar, resultando em perda de tempo e interrupção dos negócios. Para resolver esses cenários, forneça uma lista de tipos de instância EC2 de backup (“SKUs de backup”) para os quais o MCS pode recorrer em caso de problemas relacionados à capacidade.

Use uma propriedade personalizada BackupVmConfiguration ao criar ou atualizar um catálogo de máquinas MCS para fornecer uma lista de tipos de instância EC2 de backup (“Lista de SKUs de Backup”).

Se a instância EC2 primária falhar, o MCS tenta recorrer aos tipos de instância EC2 de backup na ordem especificada. Se o MCS não conseguir recorrer a nenhum dos tipos de instância EC2 de backup fornecidos, uma mensagem de erro será exibida. Você pode então tentar ligar a instância EC2 primária novamente. Se isso falhar, o MCS tentará novamente os tipos de instância EC2 de backup.

A lista de SKUs de backup pode ter instâncias sob demanda.

Este recurso é aplicável a catálogos de máquinas MCS persistentes e não persistentes.

Considerações importantes

Você pode fornecer vários tipos de instância EC2 de backup na lista de SKUs de backup.
A lista de SKUs de backup deve ser exclusiva.
Uma instância EC2 de backup não pode ser a mesma que a instância EC2 primária.
As instâncias EC2 de backup devem ser tipos de instância AWS válidos.
Não especifique ofertas de serviço duplicadas. Exemplo: BackupVmConfiguration,t2.small|t3.small|t2.small não é válido.
A oferta de serviço especificada na lista deve ser compatível com a configuração do catálogo de máquinas. Por exemplo, se o catálogo usa UEFI e a oferta de serviço especificada na lista de backup não o suporta, a criação ou atualização do catálogo falha durante a pré-verificação.
Você pode modificar a lista de SKUs de backup de um catálogo existente usando o comando PowerShell Set-ProvScheme. Você pode modificar VMs existentes usando os comandos PowerShell Set-ProvVM e Set-ProvVMUpdateTimeWindow.

Configurar instâncias EC2 de backup

Abra uma janela do PowerShell.
Execute asnp citrix\* para carregar os módulos PowerShell específicos da Citrix.
Crie um catálogo Broker.
Crie um pool de identidades.

Adicione uma lista de instâncias EC2 de backup usando a propriedade personalizada BackupVmConfiguration e crie um esquema de provisionamento. Por exemplo:

$serviceOffering = "XDHyp:\HostingUnits\$hostingUnitName\T3 Medium Instance.serviceoffering"
$customProperties = "AwsCaptureInstanceProperties,false;AwsOperationalResourcesTagging,false;BackupVmConfiguration,t2.small|t2.large|t3.small|t3.large;"
$createdProvScheme = New-ProvScheme -ProvisioningSchemeName $provisioningSchemeName -HostingUnitName $hostingUnitName -IdentityPoolName $provisioningSchemeName -NetworkMapping $networkMapping -SecurityGroup $securityGroupPath -ServiceOffering $serviceOffering -MasterImageVM $masterImageVm -CustomProperties $customProperties
<!--NeedCopy-->

Atualize o BrokerCatalog com o ID exclusivo do esquema de provisionamento.
Crie e adicione VMs ao catálogo.

Criar um catálogo usando instâncias Spot do AWS

Em comparação com as instâncias sob demanda, as instâncias Spot oferecem economia de custos de até 90%. As instâncias Spot podem ser interrompidas pelo Amazon EC2 se a capacidade se tornar indisponível, tornando-as adequadas apenas para aplicativos e desktops não críticos.

Para obter informações sobre instâncias Spot, consulte a documentação do AWS Spot Instances.

Além disso, você pode usar instâncias Spot como tipo de instância EC2 primária e instância EC2 de backup. Você pode fornecer uma lista de tipos de instância EC2 de backup (“SKUs de Backup” que podem ser instâncias sob demanda e Spot) usando o PowerShell, para os quais o MCS pode recorrer em caso de problemas relacionados à capacidade.

Considerações importantes

Você deve criar um catálogo de instâncias Spot apenas com o fluxo de trabalho de perfil de máquina.
Apenas um tipo de solicitação de instância Spot persistente é suportado. Uma solicitação de instância Spot única não é suportada.
Apenas os comportamentos de interrupção Parar e Hibernar são suportados.
Você pode alterar a configuração de um catálogo existente de instâncias sob demanda para instâncias Spot e vice-versa. No entanto, alterar uma instância EC2 de sob demanda para Spot é complexo. Consulte a documentação da AWS Alternar uma instância EC2 de preço sob demanda para preço Spot.
Ao excluir uma instância Spot provisionada, cancele a solicitação de instância Spot existente. Caso contrário, a AWS criará uma nova instância Spot.

Etapas para criar um catálogo usando instâncias Spot da AWS

Crie uma fonte de perfil de máquina com instância Spot. Para as etapas de criação de uma instância Spot, consulte Criar uma solicitação de instância Spot.
Crie um catálogo de máquinas usando um perfil de máquina com o comando PowerShell New-ProvScheme. Você pode atualizar um catálogo usando o comando Set-ProvScheme.

Usar instâncias Spot como SKU de backup

Você pode usar instâncias Spot como tipo de instância EC2 primária e instância EC2 de backup. Você pode fornecer uma lista de tipos de instância EC2 de backup (“SKUs de Backup” que podem ser instâncias sob demanda e Spot) usando o PowerShell, para os quais o MCS pode recorrer em problemas relacionados à capacidade.

Nota:

Você pode especificar instâncias Spot duplicadas na lista de SKUs de backup. Exemplo: BackupVmConfiguration,t2.small:Spot|t2.small|t3.small é válido.

Permissões necessárias

Você precisa das seguintes permissões se usar a instância Spot como uma instância EC2 primária ou de backup:

ec2:DescribeSpotInstanceRequests
ec2:CancelSpotInstanceRequests

Configurar instâncias Spot de backup

Abra uma janela do PowerShell.
Execute asnp citrix\* para carregar os módulos PowerShell específicos da Citrix.
Crie um catálogo de Broker.
Crie um pool de identidades.

Adicione uma lista de instâncias EC2 de backup usando a propriedade personalizada BackupVmConfiguration e crie um esquema de provisionamento. Por exemplo:

$serviceOffering \= "XDHyp:\\HostingUnits\\$hostingUnitName\\T3 Medium Instance.serviceoffering"
$customProperties \= "AwsCaptureInstanceProperties,false;AwsOperationalResourcesTagging,false;BackupVmConfiguration,t2.small|t2.large|t3.small:Spot|t3.large:Spot"
$createdProvScheme \= New-ProvScheme \-ProvisioningSchemeName $provisioningSchemeName \-HostingUnitName $hostingUnitName \-IdentityPoolName $provisioningSchemeName \-NetworkMapping $networkMapping \-SecurityGroup $securityGroupPath \-ServiceOffering $serviceOffering \-MasterImageVM $masterImageVm \-CustomProperties $customProperties
<!--NeedCopy-->

Atualize o BrokerCatalog com o Id exclusivo do esquema de provisionamento.
Crie e adicione VMs ao catálogo.

Onde ir a seguir

Se este for o primeiro catálogo criado, você será guiado para criar um grupo de entrega.
Para revisar todo o processo de configuração, consulte Instalar e configurar.
Para gerenciar catálogos, consulte Gerenciar catálogos de máquinas e Gerenciar um catálogo AWS EC2.

Mais informações

A versão oficial desta documentação do produto está em inglês. Qualquer versão em outro idioma é fornecida apenas para sua conveniência e pode incluir conteúdo traduzido automaticamente. Para obter mais informações, consulte o Aviso Legal sobre Tradução Automática em Cloud Software Group home.

Isso foi útil?

Criar um catálogo AWS EC2

May 31, 2026

Contribuição de:

May 31, 2026

Contribuição de:

Neste artigo

Configuração de rede durante a preparação da imagem
Tenancy da AWS
Marcar recursos operacionais da AWS
Criar um catálogo
Criar um catálogo usando o Web Studio
Criar um catálogo usando PowerShell
Catálogo habilitado para MCSIO
Crie um catálogo de máquinas baseado em perfil de máquina usando PowerShell
Criptografar discos de SO, ID e WBC
Habilitar NitroTPM e inicialização segura UEFI para instâncias de VM
Copiar tags em VMs
Filtrar instâncias de VM usando PowerShell
Lista de SKUs de backup para VMs
Criar um catálogo usando instâncias Spot do AWS
Onde ir a seguir
Mais informações

Isso foi útil?