Gerenciar um catálogo do Google Cloud Platform

Last published : Nov 13, 2026
(/pt-br/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-manage.html) descreve os assistentes que gerenciam um catálogo de máquinas. As informações a seguir cobrem detalhes específicos para ambientes de nuvem do Google.
Observação:
Antes de gerenciar um catálogo do Google Cloud Platform, você precisa concluir a criação de um catálogo do Google Cloud Platform. Consulte (/pt-br/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-create/create-machine-catalog-gcp.html).
Related information
Gerenciar catálogos de máquinas

Gerenciar catálogo de máquinas

Para adicionar máquinas a um catálogo, atualizar máquinas e reverter uma atualização, consulte (/pt-br/citrix-virtual-apps-desktops/2507-ltsr/install-configure/machine-catalogs-manage.html).

Gerenciamento de energia

O Citrix DaaS™ permite o gerenciamento de energia de máquinas do Google Cloud. Use o nó Pesquisar no painel esquerdo para localizar a máquina que você deseja gerenciar. As seguintes ações de energia estão disponíveis:
  • Excluir
  • Iniciar
  • Reiniciar
  • Reinicialização Forçada
  • Desligar
  • Desligamento Forçado
  • Adicionar ao Grupo de Entrega
  • Gerenciar Tags
  • Ativar Modo de Manutenção
Você também pode gerenciar a energia de máquinas do Google Cloud usando o Autoscale. Para fazer isso, adicione as máquinas do Google Cloud a um Grupo de Entrega e, em seguida, habilite o Autoscale para esse Grupo de Entrega. Para obter mais informações sobre o Autoscale, consulte (/pt-br/citrix-daas/manage-deployment/autoscale.html).

Atualizar máquinas provisionadas usando PowerShell

O comando Set-ProvScheme altera o esquema de provisionamento. No entanto, ele não afeta as máquinas existentes. Usando o comando PowerShell Set-ProvVMUpdateTimeWindow, agora você pode aplicar o esquema de provisionamento atual a uma máquina ou conjunto de máquinas existente, persistente ou não persistente. Atualmente, no GCP, a atualização de propriedade suportada por esse recurso é o perfil da 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
Para atualizar as VMs existentes:
  1. Verifique a configuração das máquinas existentes. Por exemplo,
    Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
  2. Atualize o esquema de provisionamento. Por exemplo,
    `Set-ProvScheme –ProvisioningSchemeName "my-catalog" –MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofileinstance.vm"
  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
    Você também pode encontrar máquinas com uma versão específica. Por exemplo,
    Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion
  4. Atualizar máquinas existentes.
    • Para atualizar todas as máquinas existentes:
      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
    • Para atualizar uma lista de máquinas específicas:
      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
    • Para atualizar máquinas com base na saída de Get-ProvVM:
      Get-ProvVM -ProvisioningSchemeName "my-catalog" | Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
  5. Encontre máquinas com uma atualização agendada. Por exemplo,
    Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
  6. Reinicie as máquinas. No próximo ligar, as alterações de propriedade são aplicadas às máquinas existentes. Você pode verificar o status atualizado usando o seguinte comando:
    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion

Alterar propriedades personalizadas relacionadas ao disco de um catálogo existente

Você pode alterar as seguintes propriedades personalizadas relacionadas ao disco de um catálogo existente e de VMs existentes do catálogo:
  • PersistOSDisk
  • PersistWBC
  • StorageType
  • IdentityDiskStorageType
  • WbcDiskStorageType
Observação:
  • A propriedade StorageType é para o disco do SO
  • A propriedade PersistOsDisk pode ser definida apenas para catálogos não persistentes com cache de write-back habilitado
Essa implementação ajuda você a selecionar diferentes tipos de armazenamento para diferentes discos mesmo após a criação de um catálogo e, assim, equilibrar os preços associados aos diferentes tipos de armazenamento.
Para fazer isso, use os comandos do PowerShell Set-ProvScheme e Set-ProvVMUpdateTimeWindow:
  1. Abra uma janela do PowerShell.
  2. Execute asnp citrix*.
  3. Execute Get-ProvVM -VMName <VM name> para obter as propriedades personalizadas.
  4. Altere a string de propriedades personalizadas:
    1. Copie as propriedades personalizadas para um Bloco de Notas e altere as propriedades personalizadas.
    2. Na janela do PowerShell, cole as propriedades personalizadas modificadas do Bloco de Notas e atribua uma variável às propriedades personalizadas modificadas. Por exemplo:
      $cp =  '<CustomProperties xmlns=http://schemas.citrix.com/2014/xd/machinecreation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <Property xsi:type="StringProperty" Name="CatalogZones" Value="" />
      <Property xsi:type="StringProperty" Name="PersistWBC" Value="true" />
      <Property xsi:type="StringProperty" Name="PersistOSDisk" Value="true" />
      <Property xsi:type="StringProperty" Name="WBCDiskStorageType" Value="pd-standard" />
      <Property xsi:type="StringProperty" Name="StorageType" Value="pd-standard" />
      </CustomProperties>'
  5. Atualize o catálogo existente. Por exemplo:
    Set-ProvScheme -ProvisioningSchemeName <yourCatalogName> -CustomProperties $cp
  6. Atualize as VMs existentes. Por exemplo:
    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
  7. Reinicie as VMs. No próximo ligar, as alterações de propriedade personalizadas são aplicadas às VMs existentes.

Proteger contra exclusão acidental de máquina

O Citrix DaaS permite proteger os recursos do MCS no Google Cloud para evitar exclusão acidental. Configure a VM provisionada definindo o sinalizador deletionProtection como TRUE.
Por padrão, as VMs provisionadas através do MCS ou do plug-in do Google Cloud são criadas com o InstanceProtection ativado. A implementação é aplicável a catálogos persistentes e não persistentes. Os catálogos não persistentes são atualizados quando as instâncias são recriadas a partir do modelo. Para máquinas persistentes existentes, você pode definir o sinalizador no console do Google Cloud. Para obter mais informações sobre como definir o sinalizador, consulte o site de documentação do Google. Novas máquinas adicionadas a catálogos persistentes são criadas com deletionProtection ativado.
Se você tentar excluir uma instância de VM para a qual você definiu o sinalizador deletionProtection, a solicitação falhará. No entanto, se você tiver a permissão compute.instances.setDeletionProtection ou for atribuído à função IAM de Administrador de Computação, você pode redefinir o sinalizador para permitir que o recurso seja excluído.

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
Disco de ID "RecursoCitrix": "interno"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Imagem "RecursoCitrix": "interno"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Disco do SO "RecursoCitrix": "interno"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
PrepVM "RecursoCitrix": "interno"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Instantâneo publicado "RecursoCitrix": "interno"
Bucket de armazenamento "RecursoCitrix": "interno"
Modelo "RecursoCitrix": "interno"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
VM no catálogo "RecursoCitrix": "interno"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx". O plug-in também adiciona este rótulo para VMs provisionadas pelo MCS: "citrix-provisioning-scheme-id": "provSchemeId". Você pode usar este rótulo para filtrar por catálogo no console do GCP.
Disco WBC "RecursoCitrix": "interno"
CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Observação:
Uma VM não está visível no inventário do Citrix se uma tag CitrixResource for adicionada para identificá-la como um recurso criado pelo MCS. Você pode remover ou renomear a tag para torná-la visível.

Mais informações