Gerenciar um catálogo do Google Cloud Platform

Last published : Nov 03, 2026
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 nuvem do Google.
Nota:
Antes de gerenciar um catálogo do Google Cloud Platform, você precisa terminar de criar um catálogo do Google Cloud Platform. Consulte Criar um catálogo do Google Cloud Platform.
Related information
Gerenciar catálogos de máquinas
Para adicionar máquinas a um catálogo, siga estas etapas:
  1. No Studio, selecione Catálogos de Máquinas no painel esquerdo.
  2. Selecione o catálogo de máquinas ao qual você deseja adicionar máquinas.
  3. Selecione Adicionar Máquinas na barra de ações.
  4. Na página Máquinas Virtuais, especifique o número de máquinas que você deseja adicionar e, em seguida, selecione Avançar.
  5. Na página Identidades da Máquina, selecione uma conta do Active Directory e, em seguida, selecione Avançar.
  6. Na página Credenciais de Domínio, selecione Inserir credenciais, digite o nome de usuário e a senha, selecione Salvar e, em seguida, selecione Avançar.
  7. Na página Resumo, confirme as informações e, em seguida, selecione Concluir.

Atualizar máquinas

Este recurso pode ser útil em casos em que você deseja atualizar sua imagem mestre ou o nível funcional mínimo.
Para atualizar máquinas, siga estas etapas:
  1. No Studio, selecione Catálogos de Máquinas no painel esquerdo.
  2. Selecione o catálogo de máquinas que contém as máquinas que você deseja atualizar.
  3. Selecione Alterar Imagem Mestra na barra de ações.
  4. Na página Imagem, selecione uma VM e o nível funcional mínimo para o catálogo e, em seguida, selecione Avançar.
  5. Na página Estratégia de Implantação, especifique quando você deseja atualizar as máquinas e, em seguida, selecione Avançar.
  6. Na página Resumo, confirme as informações e, em seguida, selecione Concluir.

Reverter uma atualização de máquina

Para reverter uma atualização de máquina, siga estas etapas:
Importante:
Não renomeie, exclua ou mova imagens mestras. Caso contrário, você não poderá reverter a atualização.
  1. No Studio, selecione Catálogos de Máquinas no painel esquerdo.
  2. Selecione o catálogo de máquinas onde você deseja reverter a atualização da máquina.
  3. Selecione Reverter Imagem Mestra na barra de ações.
  4. Na página Visão Geral, confirme as informações e, em seguida, selecione Avançar.
  5. Na página Estratégia de Implantação, configure a estratégia de implantação e selecione Avançar.
  6. Na página Resumo, confirme as informações e selecione Concluir.

Gerenciamento de energia

O Citrix DaaS™ permite gerenciar a energia das máquinas do Google Cloud. Use o nó Pesquisar no painel de navegação para localizar a máquina que você deseja gerenciar a energia. As seguintes ações de energia estão disponíveis:
  • Excluir
  • Iniciar
  • Reiniciar
  • Forçar Reinício
  • Desligar
  • Forçar Desligamento
  • Adicionar ao Grupo de Entrega
  • Gerenciar Tags
  • Ativar Modo de Manutenção
Você também pode gerenciar a energia das 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, ative o Autoscale para esse Grupo de Entrega. Para obter mais informações sobre o Autoscale, consulte Autoscale.

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 persistentes ou não persistentes existentes. Atualmente, no GCP, as atualizações de propriedade suportadas por esse recurso são Perfil da máquina, Oferta de serviço e Configurações de catálogo personalizadas.
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,
    • Atualizando o perfil da máquina
      `Set-ProvScheme –ProvisioningSchemeName "my-catalog" –MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofileinstance.vm"
    • Atualizando a oferta de serviço
      Set-ProvScheme -ProvisioningSchemeName "my-catalog" -ServiceOffering “XDHyp:\HostingUnits\<hosting-unit>\serviceoffering.folder\<service-offering>.serviceoffering"
  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. Atualize as 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
    Nota:
    • StartsNow indica que a hora de início agendada é a hora atual.
    • DurationInMinutes com um número negativo (por exemplo, –1) indica que não há limite superior na janela de tempo do agendamento.
  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
Nota:
  • 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 ativado.
Esta 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, equilibra 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. Na próxima inicialização, 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 por meio do plug-in MCS ou 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 na plataforma GCP. As tags na tabela são representadas como "chave":"valor".
Nome do recurso Tag
Disco de ID "CitrixResource": "interno"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Imagem "CitrixResource": "interno"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Disco do SO "CitrixResource": "interno"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
VM de preparação "CitrixResource": "interno"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Instantâneo publicado "CitrixResource": "interno"
Bucket de armazenamento "CitrixResource": "interno"
Modelo "CitrixResource": "interno"
"CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
VM no catálogo "CitrixResource": "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 "CitrixResource": "interno"
CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Nota:
Uma VM não fica 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