Documentação de produtos
Citrix DaaS™
Ver PDF

Criar um catálogo VMware

May 4, 2026
Contribuição de: 
C C

Criar catálogos de máquinas descreve os assistentes que criam um catálogo de máquinas.

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.

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 a New-ProvScheme e 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 de 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 as 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 de memória e 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 de 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 o 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* para carregar os módulos PowerShell específicos do Citrix.

  3. Execute os seguintes comandos:

    • Para criar um catálogo de máquinas com 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 modelo VMware sem vTPM como fonte para perfil de máquina e imagem mestre com Windows 10 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 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 “" -IsRemotePC $False -MinimumFunctionalLevel 'L7_9' -Name "" -ProvisioningType 'MCS' -Scope @() -SessionSupport "SingleSession" -ZoneUid ""

    <!--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--> ```
  • 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 é um:

    • 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 um mapeamento de rede for especificado, 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:

    • Mapeamento de rede válido é necessário 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).
    • Múltiplas 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 preparado é armazenado na pasta `<Prov Scheme Name>-dataDisk-<datastoreId>`.
<!--NeedCopy-->

  • 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, então a política padrão do Armazenamento é usada.

  • O disco de dados da VM provisionada é criado no mesmo diretório que o disco do SO e o disco 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

Observação:

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

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

  • Provisionamento de mais de um disco de dados.
  • Redefinição do disco de dados.
  • Atualização de um catálogo MCS com um disco de dados para um catálogo MCS sem disco de dados. Da mesma forma, a atualização de um catálogo MCS sem um disco de dados para um catálogo MCS com disco de dados.
  1. Criar 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 da 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, então esse conteúdo também estará no disco de dados.

  5. 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.
  6. Faça login na VM para inicializar o disco, definir a letra da unidade desejada e adicionar o conteúdo.

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.

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

  • As novas VMs são criadas com os discos do 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.

Se você excluir o catálogo, o disco de dados é excluído, a menos que você use a opção forgetVM ou purgeDBOnly. Se você excluir a VM, o disco de dados é 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.

Se o catálogo falhar ao ser criado, consulte CTX294978.

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