Documentação de produtos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Gerenciar um catálogo VMware

January 23, 2026
Contribuição de: 
C

Gerenciar catálogos de máquinas descreve os assistentes que gerenciam um catálogo de máquinas. As informações a seguir cobrem detalhes específicos para ambientes de virtualização VMware.

Nota:

Antes de gerenciar um catálogo VMware, você precisa concluir a criação de um catálogo VMware. Consulte Criar um catálogo VMware.

Atualizar o ID da pasta de um catálogo de máquinas

Você pode atualizar o ID da pasta de um catálogo de máquinas MCS especificando o FolderId nas propriedades personalizadas do comando Set-ProvScheme. As VMs criadas após a atualização do ID da pasta são criadas sob este novo ID de pasta. Se esta propriedade não for especificada em CustomProperties, as VMs serão criadas na pasta onde a imagem mestre está localizada.

Execute as seguintes etapas para atualizar o ID da pasta de um catálogo de máquinas.

  1. Abra um navegador da Web e insira o URL para o vSphere Web Client.

  2. Insira as credenciais e clique em Login.

  3. Crie uma pasta de posicionamento de VM no vSphere Web Client.

  4. Abra uma janela do PowerShell.

  5. Execute asnp citrix®* para carregar os módulos PowerShell específicos da Citrix.

  6. Especifique o FolderID em CustomProperties de Set-ProvScheme. Neste exemplo, o valor do ID da pasta é group-v2406.

    Set-ProvScheme -ProvisioningSchemeUid "50bb319c-2e83-4a37-9ea1-94f630687372" -CustomProperties "<CustomProperties xmlns=""http://schemas.citrix.com/2014/xd/machinecreation"" xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance""><Property xsi:type=""StringProperty"" Name=""FolderId"" Value=""group-v2406"" /></CustomProperties>"
<!--NeedCopy-->
  7. Adicione uma VM ao catálogo de máquinas usando o Studio.
  8. Verifique a nova VM no vSphere Web Client. A nova VM é criada na nova pasta.

Encontrar o ID da pasta no vSphere

Acesse o Managed Object Browser (MOB) em qualquer sistema de servidor ESXi ou vCenter para encontrar o ID da pasta das VMs.

O MOB é um aplicativo de servidor baseado na web disponível embutido em todos os sistemas de servidor ESX/ESXi e vCenter. Este utilitário vSphere permite visualizar informações detalhadas sobre objetos como VMs, datastores e pools de recursos.

  1. Abra um navegador da web e insira http://x.x.x.x/mob, onde x.x.x.x é o endereço IP do vCenter Server ou host ESX/ESXi. Por exemplo, https://10.60.4.70/mob.
  2. Na página Home do MOB, clique no valor da propriedade content.
  3. Clique no valor de rootFolder.
  4. Clique no valor de childEntity.
  5. Clique no valor de vmFolder.
  6. Você pode encontrar o ID da pasta no valor de childEntity.

Migração de armazenamento de VMs

Você pode mover o armazenamento em disco de VMs existentes de um armazenamento antigo para um novo armazenamento. Durante a migração, o MCS retém os recursos da VM, como gerenciamento de energia, redefinição do disco do SO e assim por diante. Você também pode adicionar novas VMs ao catálogo de máquinas usando o novo armazenamento em disco. Para fazer isso, use o comando PowerShell Move-ProvVMDisk.

Atualmente, você só pode migrar VMs persistentes de clone completo.

O novo armazenamento deve satisfazer as seguintes condições:

  • Deve estar no mesmo cluster do armazenamento antigo.
  • O host no qual a VM está sendo executada deve ter acesso aos datastores antigo e novo.

Você pode executar as seguintes tarefas:

  • Migrar o armazenamento em disco
  • Descontinuar o armazenamento antigo

Migrar o armazenamento em disco

Para migrar o armazenamento em disco:

  1. Adicione um novo armazenamento a uma unidade de hospedagem existente. Altere o armazenamento antigo para Substituído. Você pode fazer isso usando o Web Studio ou comandos PowerShell.

    • Se estiver usando o Web Studio, consulte Editar armazenamento.
    • Se estiver usando comandos PowerShell:
      • Execute Add-Hyphostingunitstorage para adicionar o novo armazenamento à unidade de hospedagem existente.
      • Execute Set-Hyphostingunitstorage com Substituído como true para desabilitar a criação de novas VMs no armazenamento antigo.
  2. Desligue as VMs e ative o Modo de Manutenção.

  3. Mova o armazenamento em disco das VMs para o novo armazenamento e atualize as informações de armazenamento. Por exemplo:

    Move-ProvVMDisk -ProvisioningSchemeName "myFullCloneProvScheme" -VMName ("VMware-TestVM01", "VMware-TestVM02") -DiskType OS,Identity -DestinationStorageId datastore1,datastore1
<!--NeedCopy-->

  4. Obtenha o ID da tarefa da migração. Por exemplo:

    ,(Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName xxxxx -DiskType OS,Identity -DestinationStorageId datastore1,datastore1
<!--NeedCopy-->

  5. Verifique o status da migração.

    • (Get-ProvTask -TaskID xxxxxxxxx).DiskMovedVirtualMachines: Fornece a lista de VMs com migração de disco bem-sucedida, incluindo as VMs que já foram migradas para o novo armazenamento.
    • (Get-ProvTask -TaskID xxxxxxxxx).DiskMoveFailedVirtualMachines: Fornece a lista de VMs com migração falha.
    • (Get-ProvTask -TaskID xxxxxxxxx).NotStartedVirtualMachines: Fornece a lista de VMs cuja migração ainda não foi iniciada.
    • Get-ProvVM -ProvisioningSchemeName xxxxx -VMName "VMware-TestVM01: Fornece as propriedades da VM atualizadas após a migração. Verifique as propriedades como StorageId, AssignedImage, BootedImage, IdentityDiskId, IdentityDiskStorage e LastBootTime.

Após migrar os discos de VMs criadas pelo MCS com snapshot, você pode ver o aviso Consolidation is required in the VSphere Client. Para consolidar e evitar perda de dados:

  1. Faça um backup da VM VMware. Por exemplo, transfira todos os arquivos da VM para outra pasta em um datastore.
  2. Depois de ver o aviso, clique em Consolidar e, em seguida, clique em OK para confirmar a consolidação.

Descontinuar o armazenamento antigo

Para descontinuar o armazenamento antigo após a migração do disco das VMs:

  1. Obtenha as informações sobre os discos base e a contagem de máquinas em cada armazenamento em disco da unidade de hospedagem. Por exemplo:

    $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
$result
$result.ProvResourceInStorage | Format-List -Property *
<!--NeedCopy-->

    Após uma migração bem-sucedida, o MCS remove automaticamente o disco base obsoleto e não há máquinas no armazenamento antigo. Portanto, após executar o comando, certifique-se de que não há máquinas e disco base no armazenamento antigo.

  2. Execute Remove-Hyphostingunitstorage para remover completamente o armazenamento antigo da unidade de hospedagem. Você também pode usar o Web Studio para remover o armazenamento antigo.

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
Prep VM “CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “XdConfig:”XdProvisioned=True”
VM no catálogo “CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “XdConfig:”XdProvisioned=True”

Mais informações

Gerenciar um catálogo VMware
January 23, 2026
Contribuição de: 
C
January 23, 2026
Contribuição de: 
C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.