Documentação de produtos
Citrix DaaS™
Ver PDF

Gerenciar um catálogo VMware

September 15, 2025
Contribuição de: 
C 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 VMs provisionadas para o estado atual do esquema de provisionamento

O comando Set-ProvScheme altera o esquema de provisionamento. No entanto, ele não afeta as VMs existentes. Usando o comando PowerShell Set-ProvVMUpdateTimeWindow, você pode aplicar o esquema de provisionamento atual a uma VM existente persistente ou não persistente, ou a um conjunto de VMs. Este recurso é aplicável a catálogos de máquinas baseados em perfil de máquina e não baseados em perfil de máquina.

Você pode atualizar o seguinte:

  • VMCpuCount: Propriedade do esquema de provisionamento
  • VMMemoryMB: Propriedade do esquema de provisionamento
  • ID da Pasta: Propriedade personalizada
  • Mapeamento de sub-rede: Propriedade do esquema de provisionamento
  • Versão de hardware da VM: Somente para catálogo de máquinas baseado em perfil de máquina
  • Perfil de máquina: Somente para catálogo de máquinas baseado em perfil de máquina

Você pode atualizar:

  • Uma única VM
  • Uma lista de VMs específicas ou todas as VMs existentes associadas a um ID de esquema de provisionamento
  • Uma lista de VMs específicas ou todas as VMs existentes associadas a um nome de esquema de provisionamento (nome do catálogo de máquinas)

Antes de atualizar as VMs existentes

  1. Verifique a configuração das VMs existentes. Por exemplo:

    Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
<!--NeedCopy-->

  2. Atualize o esquema de provisionamento. Por exemplo:

    $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="FOLDER_ID"/></CustomProperties>
$memoryMb=<DOUBLE THE "UPDATE" MACHINE PROFILE>
Set-ProvScheme -ProvisioningSchemeName my-catalog -VMCpuCount 4 -VmMemoryMb $memoryMb -CustomProperties $customerProperties -NetworkMapping @{"1" = "<A_NETWORK_PATH_FROM_THE_HOSTING_UNIT>"} -MachineProfile "<PATH_TO_UPDATE_MACHINE_PROFILE>"
<!--NeedCopy-->

  3. Verifique se a propriedade atual da VM corresponde ao esquema de provisionamento atual e se há alguma ação de atualização pendente na VM. Por exemplo:

    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
<!--NeedCopy-->

    Você também pode encontrar VMs com uma versão específica. Por exemplo:

    Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion
<!--NeedCopy-->

Solicitar atualizações para VMs existentes para aplicar na próxima reinicialização

  1. Execute os seguintes comandos para atualizar as VMs existentes e fazer com que as atualizações sejam aplicadas na próxima reinicialização.

    • Para atualizar todas as VMs existentes. Por exemplo:

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

    • Para atualizar uma lista de VMs específicas. Por exemplo:

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

    • Para atualizar VMs com base na saída de Get-ProvVM. Por exemplo:

      Get-ProvVM -ProvisioningSchemeName "my-catalog" | Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

    Nota:

    • O StartsNow indica que o horário de início agendado é o horário atual.
    • O DurationInMinutes com um número negativo (por exemplo, –1) indica que não há limite superior para a janela de tempo do agendamento.

  2. Encontre VMs com uma atualização agendada. Por exemplo:

    Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
<!--NeedCopy-->

  3. Reinicie as VMs. Na próxima inicialização, as alterações de propriedade são aplicadas às VMs existentes. Você pode verificar o status atualizado usando o seguinte comando. Por exemplo:

    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
<!--NeedCopy-->

Cancelar a atualização da configuração

Você também pode cancelar uma atualização de configuração de uma única VM, várias VMs ou um catálogo inteiro. Para cancelar uma atualização de configuração:

  1. Execute Clear-ProvVMUpdateTimeWindow. Por exemplo:

    • Para cancelar a atualização de configuração agendada para uma única VM:

       Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
 <!--NeedCopy-->

    • Para cancelar a atualização de configuração agendada para várias VMs:

       Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
 <!--NeedCopy-->

      Nota:

      As VMs devem ser do mesmo catálogo.

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 nas 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 usando comandos PowerShell

Use o comando PowerShell Get-HypConfigurationDataForItem para encontrar o ID da pasta de uma pasta existente em um Hypervisor VMware.

Crie uma conexão de hospedagem e um grupo de recursos para um Hypervisor VMware. Em seguida, execute as seguintes etapas para encontrar o ID da pasta de uma pasta nesse hypervisor.

  1. Determine o caminho XDHyp para a raiz da árvore de pastas da VM. Por exemplo:

    XDHyp:\Connections\VMwareConn\Datacenter.datacenter
<!--NeedCopy-->

  2. Use Get-HypConfigurationDataForItem para recuperar a estrutura da árvore. Por exemplo:

    Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
<!--NeedCopy-->

  3. Execute o seguinte comando para identificar o ID da pasta a partir da saída XML. Neste exemplo, procure o ID da pasta de ExampleFolder na saída XML.

    $result = Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
$result.VmPlacementFolder
<!--NeedCopy-->

    Saída XML:

    <?xml version="1.0" encoding="utf-16"?>
<CtxVmPlacementFolder xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Name>vm</Name>
<Id>group-v4</Id>
<SubFolder>
<CtxVmPlacementFolder>
  <Name>vCLS</Name>
  <Id>group-v75</Id>
  <SubFolder />
</CtxVmPlacementFolder>
<CtxVmPlacementFolder>
  <Name>MyOtherFolder</Name>
  <Id>group-v1110</Id>
  <SubFolder />
</CtxVmPlacementFolder>
<CtxVmPlacementFolder>
  <Name>ExampleFolder</Name>
  <Id>group-v4658</Id>
  <SubFolder />
</CtxVmPlacementFolder>
</SubFolder>
</CtxVmPlacementFolder>
<!--NeedCopy-->

Encontrar o ID da pasta no vSphere

Acesse o MOB em qualquer sistema de servidor ESXi ou vCenter para encontrar o ID da pasta das VMs.

O Managed Object Browser (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.

Identificar recursos criados pelo MCS

A seguir estão as tags que o MCS adiciona aos recursos na plataforma VMware. As tags na tabela são representadas como “chave”:”valor”.

Nome do recurso Tag
VM de Preparação “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
September 15, 2025
Contribuição de: 
C C
September 15, 2025
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.