Documentação de produtos
Citrix Virtual Apps and Desktops
Serviço 2607 LTSR Versão Atual 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
Ver PDF

Criar um catálogo VMware

September 15, 2026
Contribuição de: 
C

Criar catálogos de máquinas 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 VMware.

Nota:

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

Criar uma VM mestre

Use uma VM mestre para fornecer desktops e aplicativos de usuário em um catálogo de máquinas. No seu hipervisor:

  1. Instale um VDA na VM mestre, selecionando a opção de otimizar o desktop, o que melhora o desempenho.
  2. Tire um snapshot da VM mestre para usar como backup.

Nota:

Você pode usar o MCS para provisionar VMs no ambiente vSAN 8.0.

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

Você pode criar um catálogo de máquinas MCS usando um perfil de máquina. A origem da entrada do perfil de máquina é um modelo VMware. O perfil de máquina captura as propriedades de hardware de um modelo VMware e as aplica às VMs recém-provisionadas no catálogo.

Nota:

  • A entrada da imagem mestre (snapshot) e a entrada do perfil de máquina (modelo VMware) devem ter o vTPM ativado ou desativado. Esta regra se aplica tanto a New-ProvScheme quanto a Set-ProvScheme.
  • Se a imagem mestre tiver o vTPM ativado, o modelo VMware só poderá vir da mesma origem de VM que a imagem mestre.
  • A política de armazenamento criptografado suporta apenas clone completo.
  • Os catálogos baseados em perfil de máquina utilizam o modelo VMware fornecido para coletar informações do controlador de armazenamento, contando com os discos virtuais anexados. O modelo deve incluir um disco virtual que é necessário para recuperar as informações do controlador de armazenamento usadas para configurar discos virtuais para as máquinas virtuais.

O modelo VMware no perfil da máquina deve existir durante o ciclo de vida do catálogo para permitir o provisionamento de VMs para o catálogo. Sem um modelo VMware, você não pode provisionar novas VMs. Quando um modelo VMware é excluído, você deve fornecer um novo modelo usando o comando Set-ProvScheme.

  • O MCS captura propriedades de um modelo VMware. Você pode criar um novo modelo VMware referenciando as propriedades armazenadas do modelo VMware usando o comando Get-Provscheme.
  • Alternativamente, se o catálogo de máquinas e as VMs provisionadas existirem, uma máquina provisionada pelo MCS também pode ser usada para criar um novo modelo VMware.
  • Quando o MCSIO está ativado, você pode atualizar os tamanhos da memória e do cache de disco após criar os catálogos MCS.

Com base em diferentes sistemas operacionais, você pode criar um catálogo de máquinas com diferentes configurações:

  • Se o Windows 11 estiver instalado na imagem mestre, é um requisito ter o vTPM ativado para a imagem mestre. Portanto, o modelo VMware, que é uma fonte de perfil de máquina, deve ter o vTPM anexado a ele.
  • Se o Windows 10 estiver instalado na imagem mestre sem vTPM anexado, você poderá criar um catálogo de máquinas com um modelo VMware sem vTPM como fonte para o perfil da máquina.

Existe outra configuração onde você pode criar um catálogo de máquinas usando o modo de disco de cópia completa com um modelo de perfil de máquina aplicado com política de armazenamento criptografado.

Para criar um catálogo de máquinas usando comandos PowerShell com perfil de máquina como entrada:

  1. Abra uma janela do PowerShell.
  2. Execute asnp citrix®*.

  3. Execute os seguintes comandos:

    • Para criar um catálogo de máquinas com um modelo VMware com vTPM anexado como fonte para entrada de perfil de máquina e imagem mestre com Windows 11 instalado:

       $identityPool = New-AcctIdentityPool  -IdentityPoolName "<string>"
 -NamingScheme "<string>-###"
 -NamingSchemeType Numeric
 -Domain "<domain name"
 -ZoneUid "<Uid>"  -Scope @()
 <!--NeedCopy-->

       $provScheme =New-ProvScheme  -CleanOnBoot
 -HostingUnitName "vSanRg"
 -IdentityPoolName "<string>"
 -InitialBatchSizeHint 1
 -MasterImageVM "XDHyp:\HostingUnits\<hosting unit name>\<snapshot name>.snapshot"
 -NetworkMapping @{"0"="XDHyp:\HostingUnits\<hosting unit name>\\<network name>.network"}
 -ProvisioningSchemeName "<string>"
 -Scope @() -VMCpuCount 4
 -VMMemoryMB 6144
 -MachineProfile "XDHyp:\HostingUnits\<hosting unit name>\<template name>.template" -TenancyType Shared
 -FunctionalLevel "L7_20"
 <!--NeedCopy-->

       $catalog = New-BrokerCatalog
 -AllocationType "Static"
 -PersistUserChanges  "OnLocal"
 -Description "<string>"
 -IsRemotePC $False
 -MinimumFunctionalLevel 'L7_9'
 -Name "<catalog name>"
 -ProvisioningType 'MCS'
 -Scope @()
 -SessionSupport "SingleSession" -ZoneUid "<Uid>"
 <!--NeedCopy-->

       Set-BrokerCatalog -Name "<string>"
 -ProvisioningSchemeId $provScheme.ProvisioningSchemeUid.Guid
 <!--NeedCopy-->

    • Para criar um catálogo de máquinas com um modelo VMware Non-vTPM como origem para o perfil da máquina e uma imagem mestre com Windows10 instalado:

       $identityPool = New-AcctIdentityPool
 -IdentityPoolName "<string>"
 -NamingScheme "<string>-###" -NamingSchemeType Numeric
 -Domain "<domain name>"
 -ZoneUid "<Uid>"  -Scope @()
 <!--NeedCopy-->

       $provScheme =New-ProvScheme
 -CleanOnBoot -HostingUnitName "<string>"
 -IdentityPoolName "<string>"
 -InitialBatchSizeHint 1
 -MasterImageVM "XDHyp:\HostingUnits\<hosting unit name>\<snapshot name>.snapshot
 -NetworkMapping @{"0"="XDHyp:\HostingUnits\<hosting unit name>\\<string>.network"}
 -ProvisioningSchemeName "<string>"  -Scope @() -VMCpuCount 4  -VMMemoryMB 8192
 -MachineProfile "XDHyp:\HostingUnits\<hosting unit name>\<template name>.template"
 -TenancyType Shared  -FunctionalLevel "L7_20"
 <!--NeedCopy-->

       $catalog = New-BrokerCatalog
 -AllocationType "Static"
 -PersistUserChanges  "OnLocal"
 -Description "<string>"
 -IsRemotePC $False
 -MinimumFunctionalLevel 'L7_9' -Name "<string>" -ProvisioningType 'MCS' -Scope @()
 -SessionSupport "SingleSession" -ZoneUid "<Uid"
 <!--NeedCopy-->

       Set-BrokerCatalog -Name "<string>"
 -ProvisioningSchemeId $provScheme.ProvisioningSchemeUid.Guid
 <!--NeedCopy-->

    • Para criar um catálogo de máquinas usando o modo de disco de cópia completa com o modelo de perfil de máquina aplicado com política de armazenamento criptografado:

       $identityPool = New-AcctIdentityPool
 -IdentityPoolName "<string>"
 -NamingScheme "<string>-###"
 -NamingSchemeType Numeric
 -Domain "<domain name>"
 -ZoneUid "<Uid>"  -Scope @()
 <!--NeedCopy-->

       $provScheme =New-ProvScheme
 -HostingUnitName "<string>"
 -IdentityPoolName "<string>"
 -InitialBatchSizeHint 1
 -MasterImageVM "XDHyp:\HostingUnits\<hosting unit name>\<snapshot name>.snapshot"
 -NetworkMapping @{"0"="XDHyp:\HostingUnits\<hosting unit name>\\<string>.network"}
 -ProvisioningSchemeName "<string>"
 -Scope @() -VMCpuCount 4  -VMMemoryMB 8192 -MachineProfile "XDHyp:\HostingUnits\<hosting unit name>\<template name>.template"
 -TenancyType Shared
 -FunctionalLevel "L7_20" -UseFullDiskCloneProvisioning
 <!--NeedCopy-->

       $catalog = New-BrokerCatalog
 -AllocationType "Static"
 -PersistUserChanges  "OnLocal"
 -Description "<string>"  -IsRemotePC $False
 -MinimumFunctionalLevel 'L7_9'
 -Name "<string>" -ProvisioningType 'MCS' -Scope @()
 -SessionSupport "SingleSession" -ZoneUid "<Uid>"
 <!--NeedCopy-->

       Set-BrokerCatalog -Name "<string>"
 -ProvisioningSchemeId $provScheme.ProvisioningSchemeUid.Guid
 <!--NeedCopy-->

Para atualizar um perfil de máquina, use o comando Set-ProvScheme. Por exemplo:

Set-ProvScheme -ProvisioningSchemeName 'name' -IdentityPoolName 'name' -MachineProfile 'XDHyp:\HostingUnits\<hosting unit name>\<template name>.template'
<!--NeedCopy-->

Verificar várias NICs

Você recebe várias mensagens de erro durante as verificações pré-voo para várias NICs ao usar um perfil de máquina e o parâmetro NetworkMapping nos comandos New-ProvScheme e Set-ProvScheme.

A lista de verificação pré-voo para várias NICs é a seguinte:

  • Apenas a contagem de NICs do modelo de perfil de máquina é usada e validada. A rede para a qual essas NICs apontam não é usada ou validada em relação às redes da unidade de hospedagem.
  • Se a contagem de NICs no modelo de perfil de máquina for maior que o número de redes na unidade de hospedagem, você receberá uma mensagem de erro.

  • Se a contagem de NICs no modelo de perfil de máquina for zero, você receberá uma mensagem de erro. Quando a contagem de NICs no modelo de perfil de máquina for um, então:

    • Se nenhum mapeamento de rede for especificado no comando New-ProvScheme ou Set-ProvScheme, e a rede da unidade de hospedagem for uma, então a rede da unidade de hospedagem será usada.
    • Se o mapeamento de rede for especificado, então o mapeamento de rede especificado será usado se for válido.

  • Quando a contagem de NICs no modelo de perfil de máquina for maior que 1, ou a contagem de redes da unidade de hospedagem for maior que 1, então:

    • É necessário um mapeamento de rede válido no comando, e ele deve fornecer mapeamento para cada NIC (ou seja, a contagem de NetworkMapping deve ser a mesma que a contagem de NICs do perfil da máquina).
    • Várias NICs não podem ser mapeadas para a mesma rede na unidade de hospedagem.
    • A contagem de NetworkMapping e a contagem de NICs do perfil da máquina devem ser menores ou iguais à contagem de redes da unidade de hospedagem.
    • NetworkMapping deve ser fornecido para cada ID de 0 a n-1, onde n é o número de adaptadores de rede no modelo de perfil da máquina.

Provisionar um disco de dados em uma VM criada pelo MCS

Um disco de dados permite o armazenamento de dados persistentes, como logs de eventos, rastreamentos de segurança e dados de aplicativos. Você pode criar e atribuir um disco de dados persistente ou não persistente a uma VM persistente ou não persistente criada pelo MCS de um catálogo de máquinas MCS no VMware.

Provisione o disco de dados a partir da imagem mestre. O disco de dados da imagem mestre preparada é armazenado na pasta <Prov Scheme Name>-dataDisk-<datastoreId>.

Você pode criar catálogos MCS baseados em perfil de máquina e não baseados em perfil de máquina. Para catálogos MCS baseados em perfil de máquina, você pode usar a mesma VM de imagem mestre como a origem do disco de dados para o perfil da máquina.

O disco de dados da VM provisionada deriva propriedades como política de armazenamento e tamanho da imagem mestre. Para catálogos baseados em perfil de máquina, ele pode opcionalmente usar o disco de dados do modelo de VM para derivar as propriedades. Se o modelo de VM não tiver um disco de dados, a política padrão do armazenamento será usada.

O disco de dados da VM provisionada é criado no mesmo diretório que o disco do SO e de identidade.

Cenários de disco de dados suportados

A seguir estão os cenários de disco do SO e disco de dados suportados:

  • Disco do SO persistente com disco de dados persistente
  • Disco do SO não persistente com disco de dados persistente
  • Disco do SO não persistente com disco de dados não persistente

Nota:

Um catálogo de máquinas persistente não pode ter um disco de dados não persistente.

Limitações

As seguintes operações não são atualmente suportadas:

  • Provisionamento de mais de um disco de dados.
  • Redefinição do disco de dados.
  • Atualizar um catálogo MCS com um disco de dados para um catálogo MCS sem disco de dados. Da mesma forma, atualizar um catálogo MCS sem um disco de dados para um catálogo MCS com disco de dados.

Principais etapas

  1. Crie uma VM de imagem mestre com um disco de dados no VMware. Para um catálogo MCS baseado em perfil de máquina, você pode usar a mesma VM de imagem mestre como a origem do disco de dados para o perfil de máquina.
  2. Crie um catálogo de máquinas MCS com VMs provisionadas com disco de dados usando o comando PowerShell New-ProvScheme. Consulte Criar um catálogo com VMs provisionadas com disco de dados.
  3. Adicione VMs ao catálogo usando o comando PowerShell New-ProvVM.
  4. Faça login na VM para verificar se o disco de dados está formatado corretamente. Se houver conteúdo no disco de dados referenciado na VM da imagem mestre, esse conteúdo também estará no disco de dados.

Crie uma VM de imagem mestre com disco de dados no VMware

  1. Crie uma VM com dois discos rígidos. Um é o disco do SO e o segundo é o disco de dados. Siga este guia para adicionar um Novo Disco Rígido (disco de dados) a uma VM existente.
  2. Faça login na VM para inicializar o disco, definir a letra da unidade desejada e adicionar o conteúdo.

Crie um catálogo com VMs provisionadas com disco de dados

Inclua os seguintes parâmetros no comando PowerShell New-ProvScheme para provisionar um catálogo de máquinas MCS com disco de dados.

  • DataDisk: Para especificar o caminho do disco de dados especificado.

  • DataDiskPersistence: Para indicar se o DataDisk é persistente ou não persistente.

    O disco de dados não pode ser não persistente se CleanOnBoot for falso. Você não pode alterar o valor de DataDiskPersistence para um catálogo de máquinas depois de configurado.

Depois de criar o catálogo, adicione VMs usando o comando New-ProvVM.

Atualização de imagem

Execute o comando Publish-ProvMasterVMImage para atualizar a origem do disco do SO e de dados. Após executar o comando Publish-ProvMasterVMImage:

  • As novas VMs são criadas com os discos de SO e de dados atualizados.
  • Os discos não persistentes das VMs existentes são atualizados no próximo ciclo de energia.
  • Os discos persistentes das VMs existentes não são atualizados no próximo ciclo de energia.

Excluir o disco de dados

Se você excluir o catálogo, o disco de dados será excluído, a menos que você use a opção forgetVM ou purgeDBOnly. Se você excluir a VM, o disco de dados será excluído, a menos que você use a opção forgetVM ou purgeDBOnly. Essas condições são aplicáveis apenas a catálogos de máquinas MCS persistentes.

Solução de problemas

Se o catálogo não for criado, consulte CTX294978.

Onde ir em seguida

Mais informações

Criar um catálogo VMware
September 15, 2026
Contribuição de: 
C
September 15, 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.