Gerenciar um catálogo AWS

Last published : Nov 13, 2026
(/pt-br/citrix-virtual-apps-desktops/2407/install-configure/machine-catalogs-manage.html) descreve os assistentes que gerenciam um catálogo de máquinas. As informações a seguir cobrem detalhes específicos para ambientes de nuvem AWS.
Observação:
Antes de gerenciar um catálogo AWS, você precisa terminar de criar um catálogo AWS. Consulte (/pt-br/citrix-virtual-apps-desktops/2407/install-configure/machine-catalogs-create/create-machine-catalog-aws.html).
Related information
Gerenciar catálogos de máquinas

Remover tags

Ao criar um catálogo ou uma VM, as tags criadas pelo MCS são criadas nos seguintes recursos:
  • Máquina virtual
  • Volume do disco raiz
  • Volume do disco de identidade
  • NIC
  • Imagem do disco raiz (AMI)
  • Modelo de inicialização
  • Snapshot da AMI ou do disco raiz
Você pode remover VMs e catálogos de máquinas do banco de dados Citrix® e remover as tags criadas pelo MCS. Você pode usar:
  • Remove-ProvVM com o parâmetro ForgetVM para remover VMs e tags criadas pelo MCS de uma única VM ou de uma lista de VMs de um catálogo de máquinas.
  • Remove-ProvScheme com o parâmetro ForgetVM para remover um catálogo de máquinas do banco de dados da Citrix e recursos de um catálogo de máquinas.
Este recurso é aplicável apenas a VMs persistentes.
Para fazer isso:
  1. Abra uma janela do PowerShell.
  2. Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.
  3. Desbloqueie a VM antes de remover as VMs. Por exemplo:
    Unlock-ProvVM -ProvisioningSchemeName "<name>" -VMID "<id"
  4. Execute um dos seguintes comandos para remover VMs, catálogo de máquinas e tags criadas pelo MCS dos recursos.
    • Execute Remove-ProvVM com ForgetVM para remover VMs do banco de dados Citrix e tags das VMs. Por exemplo:
      Remove-ProvVM -ProvisioningSchemeName "<name>" -VMName "<name>" -ForgetVM
    • Execute Remove-ProvScheme para remover o catálogo de máquinas do banco de dados da Citrix e recursos de um catálogo de máquinas. Por exemplo:
      Run Remove-ProvScheme -ProvisioningSchemeName "<name>" -ForgetVM
  5. Verifique se a VM foi removida do Delivery Controller™, mas não do hipervisor.
    1. Execute Get-ProvVM -ProvisioningSchemeName "<name>" -VMName "<name>". Isso não deve retornar nada.
    2. Vá para o console AWS EC2. Você deve ver as VMs, no entanto, as tags foram removidas. As tags dos seguintes recursos são removidas:
      • Máquina virtual
      • Volume do disco raiz
      • Volume do disco de identidade
      • NIC
  6. Se você remover o catálogo de máquinas, verifique se o catálogo foi removido do Delivery Controller.
    1. Execute Get-ProvScheme -ProvisioningSchemeName "forgetvmdemo". Isso deve retornar um erro.
    2. Verifique no console do AWS EC2 se os seguintes recursos foram removidos.
      • Imagem do disco raiz (AMI)
      • Modelo de inicialização
      • Snapshot da AMI ou do disco raiz

Identificar recursos criados pelo MCS

A seguir estão as tags que o MCS adiciona aos recursos. As tags na tabela são representadas como "chave":"valor".
Nome do recurso Tag
Disco de ID "Name": "VMName_IdentityDisk"
"XdConfig": "XdProvisioned=true"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Imagem "XdConfig": "XdProvisioned=true"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
NIC "Descrição": "XD NIC"
"XdConfig": "XdProvisioned=true"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Disco do SO "Name": "VMName_rootDisk"
"XdConfig": "XdProvisioned=True"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
[when AwsCaptureInstanceProperties = true] "Recurso Citrix": ""
[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] "RecursoOperacionalCitrix": ""
PrepVM "Nome": "Preparação - Nome do Catálogo - xxxxxxxxxx"
"XdConfig": "XdProvisioned=true"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
[when AwsCaptureInstanceProperties = true] "Recurso Citrix": ""
[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] "CitrixOperationalResource": ""
Instantâneo publicado "XdConfig": "XdProvisioned=true"
Se não for um snapshot para Volume Worker AMI, então "CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Modelo [when AwsCaptureInstanceProperties = true] "XdConfig": "XdProvisioned=true"
[when AwsCaptureInstanceProperties = true] "CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
[when AwsCaptureInstanceProperties = true] "CitrixResource": ""
[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] "CitrixOperationalResource": ""
VM no catálogo "XdConfig": "XdProvisioned=true"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
[when AwsCaptureInstanceProperties = true] "CitrixResource": ""
[when AwsCaptureInstanceProperties = true] "aws:ec2launchtemplate:id":"lt-xxxx"
[when AwsCaptureInstanceProperties = true] "aws:ec2launchtemplate:version": "n"
[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] "CitrixOperationalResource": ""
AMI de trabalho de volume "XdConfig": "XdProvisioned=true"
Bootstrapper do worker de volume "Nome": "XenDesktop® Temp"
"XdConfig": "XdProvisioned=true"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] "CitrixVolumeWorkerBootstrapper": ""
Instância do worker de volume "Nome": "Citrix.XD.Volumeworker-xxxx-xx-xx-xx-xxxx"
"XdConfig": "XdProvisioned=true"

Mais informações