Gerenciar um catálogo Nutanix
(/pt-br/citrix-virtual-apps-desktops/2511/install-configure/machine-catalogs-manage) descreve os assistentes que gerenciam um catálogo de máquinas. As informações a seguir cobrem detalhes específicos para ambientes Nutanix AHV Prism Central.
Nota:
Antes de gerenciar um catálogo de máquinas no Nutanix AHV Prism Central, você precisa concluir a criação de um catálogo de máquinas no Nutanix AHV Prism Central. Consulte (/pt-br/citrix-virtual-apps-desktops/2511/install-configure/machine-catalogs-create/create-machine-catalog-nutanix).
Você pode gerenciar um catálogo de máquinas no Nutanix AHV Prism Central usando:
Usar o Web Studio
A seguir estão as opções para gerenciar um catálogo de máquinas no Nutanix AHV Prism Central usando o Web Studio:
| Opção | Descrição |
|---|---|
| Adicionar Máquinas | Crie e adicione VMs ao catálogo de máquinas. |
| Excluir Catálogo de Máquinas | Exclua um catálogo de máquinas. Você pode optar por excluir VMs ao mesmo tempo ou deixar as VMs persistentes intactas. |
| Alterar Imagem Mestra | Altere a imagem mestra usada como modelo para todas as VMs no catálogo. |
| Adicionar ou alterar Perfil de Máquina | Altere a versão do modelo do perfil da máquina ou adicione um perfil de máquina a um catálogo existente. |
| Gerenciar Conjunto de Configurações | Vincule um catálogo a um conjunto de configurações do Workspace Environment Management™ ou mude para uma configuração diferente. |
| Editar Catálogo de Máquinas | Modifique as configurações do catálogo, como NICs e Máquinas Virtuais. |
| Visualizar Máquinas | Vá para o nó Pesquisar para ver todas as VMs que pertencem ao catálogo. |
| Renomear Catálogo de Máquinas | Altere o nome do catálogo. |
| Atualizar VDAs | Atualize os VDAs por catálogo. Este recurso se aplica apenas a máquinas persistentes estáticas. |
| Alterar Nível Funcional | Selecione o nível funcional mínimo para o catálogo. Definir um nível funcional torna todos os recursos disponíveis. |
| Testar Catálogo de Máquinas | Verifique se o catálogo tem erros ou avisos. |
| Gerenciar Tags | Crie, edite e exclua tags. Selecione as tags para aplicar ao catálogo. |
| Mover Catálogo de Máquinas | Mova o catálogo para outra pasta. |
Nota:
Atualmente, a opção Clonar não está disponível.
Alterar imagem mestre
Para alterar a imagem mestre de um catálogo, siga estas etapas:
- Na página Catálogos de Máquinas, clique com o botão direito do mouse no catálogo de máquinas que você deseja atualizar e selecione Alterar Imagem Mestre.
-
Na página Alterar Imagem Mestre, clique em Selecionar uma imagem.

- Na página Selecionar uma imagem, expanda um modelo e selecione uma versão do modelo para usar como imagem mestre. Você pode filtrar modelos de máquina por nome.
- Na página Estratégia de Implantação, escolha quando você deseja que a atualização seja aplicada.
Nota:
Para um catálogo não persistente provisionado por MCS com o plug-in de conexão do host Nutanix AHV Prism Central, a atualização da imagem mestre para alternar a configuração de inicialização entre Legacy e UEFI impede que as VMs existentes iniciem na próxima inicialização. Ao atualizar a imagem mestre, apenas o disco do SO é atualizado. As propriedades de hardware permanecem inalteradas. Para atualizar as propriedades de hardware, consulte Adicionar ou alterar o perfil da máquina, Alterar NICs e Alterar a configuração das VMs.
Adicionar ou alterar o perfil da máquina
Para adicionar ou alterar um perfil de máquina para um catálogo, siga estas etapas:
- Na página Catálogos de Máquinas, clique com o botão direito do mouse no catálogo de máquinas que você deseja modificar e selecione Editar Catálogo de Máquinas.
-
Na página Perfil da Máquina,
- Se o catálogo de máquinas já tiver um perfil de máquina, clique no ícone de lápis para selecionar uma versão diferente do modelo de perfil de máquina. Você pode filtrar pelo nome do modelo. Confirme as configurações do perfil da máquina.
- Se o catálogo de máquinas não tiver um perfil de máquina, selecione Usar um perfil de máquina e selecione um perfil de máquina. Confirme as configurações do perfil da máquina.
- A página Máquinas Virtuais deve refletir a configuração atualizada de acordo com a versão do modelo de perfil de máquina selecionada.
Alterar NICs
Para alterar as NICs de um catálogo, siga estas etapas:
- Na página Catálogos de Máquinas, clique com o botão direito do mouse no catálogo de máquinas que você deseja modificar e selecione Editar Catálogo de Máquinas.
-
Na página NICs:
- Selecione um tipo de NIC
- Selecione ou desmarque as caixas para selecionar NICs e escolha uma rede virtual associada para cada NIC.

Alterar a configuração das VMs
Para alterar a configuração das VMs, incluindo Memória, contagem de CPU e Cores por vCPU, siga estas etapas:
- Na página Catálogos de Máquinas, clique com o botão direito do mouse no catálogo de máquinas que deseja modificar e selecione Editar Catálogo de Máquinas.
-
Na página Máquinas Virtuais, use a seta para cima ou para baixo, ou insira valores diretamente para ajustar a Memória, a contagem de CPU e os Cores por vCPU para as VMs.

Usar PowerShell
Alterar imagem mestre
Os parâmetros necessários são:
-
ProvisioningSchemeName: Nome do esquema de provisionamento a ser editado. -
MasterImage: Caminho literal para a nova imagem mestre.
Execute o seguinte comando. Por exemplo:
Set-ProvSchemeMetadata -Name "ImageManagementPrep_DoImagePreparation" -ProvisioningSchemeName "<ProvisioningSchemeName>" -Value "True"
Publish-ProvMasterVMImage -MasterImageVM "<Literal path to the new master image- template version> -ProvisioningSchemeName "<ProvisioningSchemeName>" -RunAsynchronously
<!--NeedCopy-->
Nota:
Ao atualizar a imagem mestre, apenas o disco do SO é atualizado. As propriedades de hardware permanecem inalteradas. Para atualizar as propriedades de hardware, consulte Adicionar ou alterar o perfil da máquina, Alterar NICs e Alterar NIC e configuração da VM.
Adicionar ou alterar perfil de máquina
Use o comando Set-ProvScheme:
- Para atualizar um catálogo com um novo perfil de máquina, ou
- Para atualizar um catálogo existente que não possui um perfil de máquina para começar a usar o perfil de máquina como fonte de especificação de hardware.
Nota:
Isso não atualiza a especificação de hardware das VMs existentes no catálogo. Apenas as novas VMs adicionadas ao catálogo terão a especificação de hardware do perfil de máquina fornecido.
Para alterar o perfil de máquina ou converter um catálogo existente para começar a usar o perfil de máquina:
Set-ProvScheme -ProvisioningSchemeName <ProvScheme Name> `
-MachineProfile "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
<!--NeedCopy-->
Para alterar o perfil de máquina com especificação de hardware substituída:
Certas configurações podem ser configuradas usando parâmetros de linha de comando específicos. Esses parâmetros de linha de comando, como VMCpuCount e VMMemoryMB, e CPUCores em CustomProperties, têm precedência sobre os valores na versão do modelo de Perfil de Máquina.
$customProperties = @"
<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<StringProperty Name="ClusterId" Value="00062c63-1fb0-58c9-4fc8-5c2573352378" />
<StringProperty Name="CPUCores" Value="2" />
</CustomProperties>
"@
Set-ProvScheme -ProvisioningSchemeName <ProvScheme Name> `
-MachineProfile "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion" `
-CustomProperties $customProperties `
-VMCpuCount 4 `
-VMMemoryMB 4096
<!--NeedCopy-->
Alterar a configuração da NIC e da VM
Os parâmetros necessários são:
-
ProvisioningSchemeName: Nome do esquema de provisionamento a ser editado. -
NetworkMapping: Mapeamento de rede atualizado.
Execute o seguinte comando. Por exemplo:
Set-ProvScheme -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"ClusterId`" Value=`"000xxxx-1fb0-xxxxx-4fc8-5c257335xxxx`" /><Property xsi:type=`"StringProperty`" Name=`"CPUCores`" Value=`"1`" /></CustomProperties>" -NetworkMapping @{"6"="XDHyp:\HostingUnits\<Hosting Unit Name>\Clusters.folder\<Cluster Name>\<Network name>.network"} -ProvisioningSchemeName "<ProvisioningSchemeName>" -VMCpuCount 4
<!--NeedCopy-->