Citrix Virtual Apps and Desktops

Criar um catálogo de instâncias gerenciadas do Amazon WorkSpaces Core

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 das instâncias gerenciadas do Amazon WorkSpaces Core.

Nota:

Atualmente, a criação de catálogos de VMs persistentes e não persistentes (a propriedade CleanOnBoot é True ou False) é suportada.

Pré-requisitos

Antes de criar um catálogo de instâncias gerenciadas do Amazon WorkSpaces Core, você precisa concluir a criação de:

Uma conexão com as instâncias gerenciadas do Amazon WorkSpaces Core. Consulte Conexão com as instâncias gerenciadas do Amazon WorkSpaces Core
Uma imagem preparada. Consulte Criar uma imagem preparada para instâncias gerenciadas do Amazon WorkSpaces Core.

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.

Um catálogo de máquinas baseado em perfil de máquina

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, tipo de locação, tipo de instância, grupos de segurança, mapeamentos de rede, propriedades de volume EBS, otimização EBS, opções de CPU, capacidade de hibernação 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 da máquina.

Nota:

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

O Instance Metadata Service (IMDS) V2 é o único suportado, e não o IMDS V1. Para obter informações, consulte Como funciona o Instance Metadata Service Versão 2.

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 WorkSpaces Core de diferentes clientes podem residir na mesma peça de hardware físico. Tenancy dedicada significa que suas instâncias do Amazon WorkSpaces Core são executadas apenas em hardware com outras instâncias que você implantou.

Nota:

As instâncias dedicadas são as únicas suportadas (hosts dedicados não são suportados atualmente). Outros clientes não usam a mesma peça de hardware.

O tipo de tenancy é capturado do perfil da máquina

Ao usar o MCS para criar um catálogo para provisionar máquinas na AWS, o tipo de tenancy é capturado do perfil da máquina.

Hardware compartilhado: Esta 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.
Instância dedicada: Esta 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 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. Além disso, as Instâncias Dedicadas fornecem suporte limitado para Bring Your Own License (BYOL).

Criar um catálogo

Uma imagem preparada e um perfil de máquina são necessários para criar catálogos de instâncias gerenciadas do Amazon WorkSpaces Core. Você pode usar uma instância de VM da AWS ou uma versão de modelo de inicialização da AWS como entrada do perfil da máquina.

Você pode criar um catálogo usando:

Web Studio
PowerShell

Criar um catálogo usando o Web Studio

Criar um catálogo de máquinas a partir do nó Imagens

Use a opção Criar catálogo no nó Imagens para criar um catálogo usando a versão da imagem.

Alternativamente, você pode selecionar a versão ao criar um catálogo no nó Catálogos de Máquinas, vinculando à opção de imagem preparada no fluxo de trabalho de criação de catálogo. Consulte Criar um catálogo de máquinas a partir do nó Catálogos de Máquinas.

Para criar um catálogo de máquinas MCS a partir do nó Imagens, faça o seguinte:

Selecione uma versão da imagem e clique em Criar catálogo. Clique em Avançar na página Introdução.
Nas páginas Gerenciamento de Máquinas e Imagem, as configurações são pré-selecionadas com base na versão da imagem selecionada. Na página Imagem, insira uma nota para a imagem preparada selecionada.
Conclua as configurações nas páginas seguintes.
Na página Resumo, verifique os detalhes do catálogo de máquinas. Insira um nome e uma descrição para o catálogo de máquinas. Clique em Concluir.
Vá para o nó Catálogos de Máquinas para ver o catálogo de máquinas criado.

Criar um catálogo de máquinas a partir do nó Catálogos de Máquinas

Para criar um catálogo de máquinas MCS a partir do nó Catálogos de Máquinas, faça o seguinte:

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 com 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. Se uma área de trabalho estática for selecionada, especifique ainda se você deseja salvar as alterações que o usuário faz no disco local (persistente ou não persistente).
Na página Imagem, clique em Selecionar uma imagem para selecionar uma imagem preparada para o catálogo de máquinas. Selecione a versão preparada que você criou. Clique no nome da versão da imagem. Para ver mais detalhes sobre a versão da imagem selecionada, clique no número da versão, que está sublinhado. Clique em Concluído.

O perfil da máquina associado à imagem preparada aparece e suas propriedades de hardware (por exemplo, tipo de instância, tipo de locação, mapeamentos de rede, grupos de segurança, propriedades de volume) são usadas para criar máquinas nos catálogos. Para alterar a origem do perfil da máquina para outra VM ou versão de modelo de inicialização, clique no botão de edição.
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.
Na página NICs, selecione as NICs (ou ENIs) para as VMs.
Na página Identidades da Máquina, configure o tipo de identidade da máquina para as máquinas no catálogo:
1. Para configurar máquinas ingressadas no domínio (Active Directory local ou Microsoft Entra híbrido), selecione o domínio e crie novas contas AD para as VMs a serem criadas neste catálogo de máquinas. As VMs provisionadas são ingressadas no domínio selecionado. Para provisionar máquinas não ingressadas no domínio, selecione a opção de não ingresso no domínio.
2. Especifique o esquema de nomenclatura de conta para as novas contas a serem criadas para as VMs.
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 nossa documentação do 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 certas 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 padroniza o uso do tipo de volume gp2.
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 preparada e os snapshots de disco de ID são padronizados para serem colocados 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 as zonas locais que suportam serviços completos de EC2 e EBS são zonas suportadas.

Criar um catálogo usando PowerShell

Criar um catálogo usando uma especificação de versão de imagem preparada e perfil de máquina

Crie um catálogo de máquinas não persistentes do MCS a partir da especificação de versão de imagem preparada usando o comando New-ProvScheme. Por exemplo,

 New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $true] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”]
 <!--NeedCopy-->

Crie um catálogo de máquinas persistentes do MCS a partir da especificação de versão de imagem preparada usando o comando New-ProvScheme. Por exemplo,

 New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $false] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”]
 <!--NeedCopy-->

Exemplo do conjunto completo de comandos Powershell para criar um catálogo:

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "wsccatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"

$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "domainname" -IdentityPoolName "wsccatalog" -IdentityType "ActiveDirectory"  -NamingScheme "aws##" -NamingSchemeType "Numeric" -Scope @()

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

$Task = New-ProvScheme -ProvisioningSchemeName wsccatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName wsc -IdentityPoolName wsccatalog -CleanOnBoot -Scope @() -SecurityGroup @() -MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm' -RunAsynchronously

Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName wsccatalog

Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

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 versão de 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

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 modelo de inicialização 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" `
-ImageVersionSpecUid ‘24dfb047-e867-527g-896c-25664xxxxx1t’ `
-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 e ID

Você pode criar um catálogo 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 e o disco de identidade (ID).

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 e ID, configure uma das seguintes opções:

Use uma imagem preparada que esteja 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 origem 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 de imagem preparada.
Você não pode criptografar diretamente volumes ou snapshots EBS existentes não criptografados, nem modificar a chave KMS de um volume criptografado existente. Para fazer isso, você deve:
1. Criar um novo snapshot desse volume.
2. Criar um novo volume a partir desse snapshot
3. Criptografar 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 EBS existentes e novos da Amazon.

Criar um catálogo com criptografia de disco

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

Imagem preparada (criada usando o gerenciamento de imagem a partir de uma imagem mestre que possui disco criptografado)
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 preparada.
Se nenhuma entrada de perfil de máquina for fornecida, a chave KMS da AMI da imagem preparada 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 preparada (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 deve ter um dispositivo definido em /dev/sda1.
Se não houver chave na origem do perfil da máquina e a imagem preparada não estiver criptografada, os discos das VMs do catálogo não serão criptografados.
Quando a imagem preparada é 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.
Uma imagem preparada criada a partir da imagem mestre com AMI criptografada usando gerenciamento de imagem.

Considerações importantes:

Os volumes das 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 uma AMI de imagem preparada criptografada para uma AMI de imagem preparada não criptografada.

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

Ao criar um catálogo, agora você pode selecionar uma imagem preparada (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 tanto o NitroTPM quanto o 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 o NitroTPM e o Secure Boot UEFI em catálogos existentes. Se você deseja um catálogo com NitroTPM e Secure Boot UEFI habilitados, crie um novo catálogo.

Etapas principais

Configure seu ambiente AWS.
Crie uma conexão com a AWS.
Crie uma imagem mestre (AMI) habilitada com NitroTPM e/ou Secure Boot UEFI.
Crie uma imagem preparada a partir da imagem mestre. Consulte Criar uma imagem preparada para instâncias gerenciadas do Amazon WorkSpaces Core.
Crie um catálogo de máquinas selecionando a imagem preparada com NitroTPM e Secure Boot 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 Secure Boot UEFI habilitados.

Crie uma AMI que suporte NitroTPM e Secure Boot UEFI

Você pode criar uma AMI a partir de uma VM que tenha NitroTPM e/ou Secure Boot UEFI habilitados.
1. Crie a instância usando as imagens do AWS Marketplace. 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 no host do Delivery Controller™ para verificar se um específico:

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

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 Legado	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 oferece suporte a 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 ignorar 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 depois (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 da tag Não Marcado corresponde a itens que não possuem a tag fornecida em sua lista de tags. O valor da tag Todos os valores corresponde a itens que possuem a tag, independentemente do valor da tag. Caso contrário, a correspondência ocorre somente 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-->

Filtragem 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 Aviso. Por exemplo:

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

Onde ir em seguida

Para gerenciar um catálogo do Amazon Workspaces Core, consulte Gerenciar um catálogo de instâncias gerenciadas do Amazon WorkSpaces Core

Mais informações

Ambientes de virtualização AWS
Conexão com instâncias gerenciadas do Amazon WorkSpaces Core
Gerenciamento de imagens
Criar uma imagem preparada para instâncias gerenciadas do Amazon WorkSpaces Core(/pt-br/citrix-virtual-apps-desktops/2511/install-configure/create-prepared-image-amazon-wsc.html)
Para exemplos de PowerShell do GitHub do Amazon WorkSpaces Core, consulte citrix-mcs-sdk-samples-Amazon WorkSpaces Core.

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 de instâncias gerenciadas do Amazon WorkSpaces Core

May 31, 2026

Contribuição de:

May 31, 2026

Contribuição de:

Neste artigo

Pré-requisitos
Configuração de rede durante a preparação da imagem
Um catálogo de máquinas baseado em perfil de máquina
Tenancy da AWS
Criar um catálogo
Criar um catálogo usando o Web Studio
Criar um catálogo usando PowerShell
Criptografar discos de SO e ID
Habilitar NitroTPM e inicialização segura UEFI para instâncias de VM
Copiar tags em VMs
Filtrar instâncias de VM usando PowerShell
Onde ir em seguida
Mais informações

Isso foi útil?