Documentação de produtos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Gerenciar catálogos de máquinas

January 23, 2026
Contribuição de: 
C

Nota:

Você pode gerenciar sua implantação do Citrix Virtual Apps and Desktops™ usando dois consoles de gerenciamento: Web Studio (baseado na web) e Citrix Studio (baseado no Windows). Este artigo aborda apenas o Web Studio. Para obter informações sobre o Citrix Studio, consulte o artigo equivalente no Citrix Virtual Apps and Desktops 7 2212 ou anterior.

Introdução

Você pode adicionar ou remover máquinas de um catálogo de máquinas, renomear, alterar a descrição ou gerenciar as contas de computador do Active Directory de um catálogo.

A manutenção de catálogos também pode incluir a garantia de que cada máquina tenha as atualizações mais recentes do sistema operacional. Incluindo atualizações de antivírus, atualizações do sistema operacional ou alterações de configuração.

  • Catálogos que contêm máquinas aleatórias agrupadas criadas usando o Machine Creation Services™ (MCS) mantêm as máquinas atualizando a imagem mestre usada no catálogo e, em seguida, atualizando as máquinas. Esse método permite que você atualize com eficiência um grande número de máquinas de usuários.
  • Para catálogos que contêm máquinas estáticas, atribuídas permanentemente, e para catálogos de máquinas de Acesso Remoto para PC, você gerencia as atualizações das máquinas dos usuários fora do Web Studio. Execute essa tarefa individualmente ou coletivamente usando ferramentas de distribuição de software de terceiros.

Para obter informações sobre como criar e gerenciar conexões com hipervisores host, consulte Conexões e recursos.

Nota:

O MCS não oferece suporte ao Windows 10 IoT Core e ao Windows 10 IoT Enterprise. Consulte o site da Microsoft para obter mais informações.

Sobre instâncias persistentes

Ao atualizar um catálogo MCS criado usando instâncias persistentes ou dedicadas, todas as novas máquinas criadas para o catálogo usam a imagem atualizada. As instâncias preexistentes continuam a usar a instância original. O processo de atualização de uma imagem é feito da mesma forma para qualquer outro tipo de catálogo. Considere o seguinte:

  • Com catálogos de disco persistentes, as máquinas preexistentes não são atualizadas para a nova imagem, mas todas as novas máquinas adicionadas ao catálogo usam a nova imagem.
  • Para catálogos de disco não persistentes, a imagem da máquina é atualizada na próxima vez que a máquina for redefinida.
  • Com catálogos de máquinas persistentes, a atualização da imagem também atualiza as instâncias do catálogo que a utilizam.
  • Para catálogos que não persistem, se você quiser imagens diferentes para máquinas diferentes, as imagens devem residir em catálogos separados.

Gerenciar catálogos de máquinas

Você pode gerenciar um catálogo de máquinas de duas maneiras:

Usar o Web Studio

Esta seção detalha como você pode gerenciar catálogos usando o Web Studio:

  1. Use a função de pesquisa para localizar um catálogo de máquinas específico. Consulte Pesquisar instâncias para obter instruções.
  2. Nos resultados da pesquisa, selecione um catálogo conforme necessário.
  3. Consulte a tabela a seguir para obter descrições das colunas do catálogo.
  4. Clique em uma guia no painel de detalhes inferior para obter mais informações sobre este catálogo.
Coluna Descrição
Catálogo de Máquinas

O nome e o tipo de alocação do catálogo. Os tipos de alocação incluem
  • Aleatório: As máquinas no catálogo são alocadas a um usuário aleatoriamente.
  • Permanente: As máquinas no catálogo são alocadas a um usuário permanentemente.
    		•
    Tipo de Máquina




    		O tipo de sessão suportado das máquinas no catálogo. Os valores possíveis incluem
  • Tipo de SO: SO multi-sessão (Virtual); Dados do usuário: Descartar.
  • Tipo de SO: SO multi-sessão (Virtual); Dados do usuário: No disco local
  • Tipo de SO: SO de sessão única (Acesso Remoto para PC)
  • Tipo de SO: SO de sessão única (Virtual); Dados do usuário: Descartar
  • Tipo de SO: SO de sessão única (Virtual); Dados do usuário: No disco local
    		•
    Contagem de Máquinas A contagem de máquinas no catálogo e o método de provisionamento. Os métodos de provisionamento possíveis incluem: Machine Creation Services (máquina MCS), Manual e Citrix Provisioning™ Services.
    Contagem Alocada O número de máquinas no catálogo atribuídas a um grupo de entrega.
    Pasta O local do catálogo dentro da árvore Catálogos de Máquinas. Exibe o nome da pasta em que o catálogo está (incluindo a barra invertida final) ou - se o catálogo estiver no nível raiz.
    Atualização de VDA Estado de atualização de VDA. Os valores possíveis incluem: Não configurado, Agendado, Disponível e Atualizado.
    Status da Imagem O status de atualização da imagem do catálogo. Aplicável apenas a catálogos de máquinas não persistentes. Os valores possíveis incluem: Totalmente atualizado, Parcialmente atualizado, Atualizações pendentes, Preparando

    Antes de começar:

    • Certifique-se de que o hipervisor host tenha processadores, memória e armazenamento suficientes para acomodar as máquinas adicionais.
    • Certifique-se de ter contas de computador do Active Directory não utilizadas suficientes. Se você estiver usando contas existentes, o número de máquinas que você pode adicionar é limitado pelo número de contas disponíveis.
    • Se você usar o Web Studio para criar contas de computador do Active Directory para as máquinas adicionais, você deve ter a permissão de administrador de domínio apropriada.

    Para adicionar máquinas a um catálogo:

    1. Faça login no Web Studio.
    2. Selecione Catálogos de Máquinas no painel esquerdo.
    3. Selecione um catálogo de máquinas e, em seguida, selecione Adicionar máquinas na barra de ações.
    4. Selecione o número de máquinas virtuais a serem adicionadas.
    5. Se houver contas do Active Directory existentes insuficientes para o número de VMs que você está adicionando, selecione o domínio e o local onde as contas são criadas. Especifique um esquema de nomenclatura de conta, usando sinais de hash para indicar onde aparecem números ou letras sequenciais. Não use uma barra (/) em um nome de OU. Um nome não pode começar com um número. Por exemplo, um esquema de nomenclatura de PC-Vendas-## (com 0-9 selecionado) resulta em contas de computador nomeadas PC-Vendas-01, PC-Vendas-02, PC-Vendas-03 e assim por diante.
    6. Se você usar contas do Active Directory existentes, navegue até as contas ou clique em Importar e especifique um arquivo .csv contendo nomes de contas. Certifique-se de que haja contas suficientes para todas as máquinas que você está adicionando. O Web Studio gerencia essas contas. Permita que o Web Studio redefina as senhas de todas as contas ou especifique a senha da conta, que deve ser a mesma para todas as contas.

    As máquinas são criadas como um processo em segundo plano e podem levar muito tempo ao criar muitas máquinas. A criação da máquina continua mesmo se você fechar o Web Studio.

    Depois de excluir uma máquina de um catálogo de máquinas, os usuários não podem mais acessá-la, portanto, antes de excluir uma máquina, certifique-se de que:

    • Os dados do usuário foram copiados ou não são mais necessários.
    • Todos os usuários estão desconectados. Ativar o modo de manutenção impede que novas conexões sejam feitas a uma máquina.
    • As máquinas estão desligadas.

    Para excluir máquinas de um catálogo:

    1. Faça login no Web Studio.
    2. Selecione Catálogos de Máquinas no painel esquerdo.
    3. Selecione um catálogo e, em seguida, selecione Exibir Máquinas na barra de ações.
    4. Selecione uma ou mais máquinas e, em seguida, selecione Excluir na barra de ações.

    Escolha se deseja excluir as máquinas que estão sendo removidas. Se você optar por excluir as máquinas, indique se as contas do Active Directory para essas máquinas são mantidas, desabilitadas ou excluídas.

    1. Na página Descrição, altere a descrição do catálogo.
    2. Selecione Catálogos de Máquinas no painel esquerdo.
    3. Selecione um catálogo e, em seguida, selecione Editar Catálogo de Máquinas na barra de ações.
    4. Na página Escopos, altere os escopos.

    5. Na página NIC, execute as seguintes ações:

      • Para alterar o mapeamento de sub-rede de uma NIC, selecione uma rede no campo Rede Associada.
      • Para adicionar um mapeamento de sub-rede, selecione Adicionar NIC, selecione uma rede no campo Rede Associada e clique em Salvar.

      Apenas as sub-redes presentes no host associado ao catálogo aparecem no campo Rede Associada.

      Você só pode adicionar NIC a catálogos de máquinas do Azure sem perfis de máquina.

      Nota:

      • Para catálogos de máquinas AWS, você não pode mapear a mesma sub-rede para mais de uma NIC.
      • Para catálogos de máquinas com perfis de máquina, o número de NICs no catálogo deve ser igual ao número de NICs no perfil da máquina.
      • Este recurso não é suportado para hipervisores IBM Cloud.
      • Este recurso é suportado apenas para Nutanix Prism Element no caso de hipervisores Nutanix.

    6. Você pode ver outras páginas dependendo do tipo de catálogo.

      Para catálogos criados usando uma imagem do Azure Resource Manager, as seguintes páginas estão visíveis. Lembre-se de que as alterações que você faz se aplicam apenas às máquinas que você adiciona ao catálogo posteriormente. As máquinas existentes permanecem inalteradas.

      • Na página Máquinas Virtuais, altere o tamanho da máquina e as zonas de disponibilidade onde você deseja criar máquinas.

        Nota:

        • Apenas os tamanhos de máquina que o catálogo suporta são mostrados.
        • Se necessário, selecione Mostrar apenas tamanhos de máquina usados em outros catálogos de máquinas para filtrar a lista de tamanhos de máquina.

      • Na página Perfil da Máquina, escolha se deseja usar ou alterar um perfil de máquina.

      • (Visível apenas quando o catálogo está configurado com um host de grupo dedicado) Na página Grupo de host dedicado, escolha se deseja alterar um grupo de host.

      • Na página Tipos de Armazenamento e Licença, escolha se deseja alterar o tipo de armazenamento, o tipo de licença e as configurações da Galeria de Computadores do Azure (disponível apenas quando Colocar imagem preparada na Galeria do Azure está em uso).

      Nota:

      Se a configuração recém-selecionada não suportar o tamanho da máquina atual, uma caixa de diálogo de aviso aparecerá, informando que a alteração da configuração redefine a configuração do tamanho da máquina. Se você optar por continuar, um ponto vermelho aparecerá ao lado do menu Máquinas Virtuais, solicitando que você selecione um novo tamanho de máquina.

      • Na página Tipo de Licença, escolha se deseja alterar a configuração de licença do Windows ou Linux.

      Para catálogos de Acesso Remoto para PC, as seguintes páginas estão visíveis:

      • Na página Gerenciamento de Energia, altere as configurações de gerenciamento de energia e selecione uma conexão de gerenciamento de energia.
      • Na página Unidades Organizacionais, adicione ou remova OUs do Active Directory.
    7. Clique em Aplicar para aplicar as alterações feitas e clique em Salvar para sair.
    1. Faça login no Web Studio.
    2. Selecione Catálogos de Máquinas no painel esquerdo.
    3. Selecione um catálogo e, em seguida, selecione Renomear Catálogo de Máquinas na barra de ações.
    4. Insira o novo nome.

    Mover um catálogo para uma zona diferente

    Se sua implantação tiver mais de uma zona, você poderá mover um catálogo de uma zona para outra.

    Mover um catálogo para uma zona diferente, que não seja o hipervisor que contém as VMs nesse catálogo, afeta o desempenho.

    1. Faça login no Web Studio.
    2. Selecione Catálogos de Máquinas no painel esquerdo.
    3. Selecione um catálogo e, em seguida, selecione Mover na barra de ações.
    4. Selecione a zona para a qual você deseja mover o catálogo.

    Antes de excluir um catálogo, certifique-se de que:

    • Todos os usuários estão desconectados e você não está executando nenhuma sessão desconectada.
    • O modo de manutenção está ativado para todas as máquinas no catálogo para que novas conexões não possam ser feitas.
    • Todas as máquinas no catálogo estão desligadas.
    • O catálogo não está associado a um grupo de entrega. Em outras palavras, o grupo de entrega não contém máquinas do catálogo.

    Para excluir um catálogo:

    1. Faça login no Web Studio.
    2. Selecione Catálogos de Máquinas no painel esquerdo.
    3. Selecione um catálogo e, em seguida, selecione Excluir Catálogo de Máquinas na barra de ações.
    4. Indique se as máquinas no catálogo são excluídas. Se você optar por excluir as máquinas, indique se as contas de computador do Active Directory para essas máquinas são retidas, desabilitadas ou excluídas.

    Converter catálogos MCS legados no Azure em catálogos baseados em perfil de máquina

    Para converter um catálogo de máquinas não baseado em perfil de máquina em um catálogo de máquinas baseado em perfil de máquina, conclua as seguintes etapas:

    1. Na página Catálogos de Máquinas, clique com o botão direito do mouse no nome do Catálogo de Máquinas que você deseja converter e, em seguida, selecione Editar Catálogo de Máquinas.
    2. Na página Editar Catálogo de Máquinas > Perfil da Máquina, selecione a caixa de seleção Usar um perfil de máquina (obrigatório para o Azure Active Directory).
    3. Clique em Selecionar um perfil de máquina.
    4. Na página Selecionar um perfil de máquina, selecione uma máquina virtual ou modelo de inicialização para usar como perfil de máquina.
    5. Se algumas configurações atuais diferirem das novas configurações de perfil de máquina, selecione a opção necessária para as configurações que você deseja usar e clique em Continuar.
    6. Clique em Aplicar.

    Nota:

    Atualmente, este recurso é suportado apenas para Azure, AWS e VMware.

    Para gerenciar contas do Active Directory em um catálogo de máquinas, você pode:

    • Liberar contas de máquina não utilizadas removendo contas de computador do Active Directory de catálogos de SO de sessão única e SO de multi-sessão. Essas contas podem então ser usadas para outras máquinas.
    • Adicionar contas para que, quando mais máquinas forem adicionadas ao catálogo, as contas de computador já estejam no lugar. Não use uma barra (/) em um nome de OU.

    Para gerenciar contas do Active Directory:

    1. Faça login no Web Studio.
    2. Selecione Catálogos de Máquinas no painel esquerdo.
    3. Selecione um catálogo e, em seguida, selecione Gerenciar contas AD na barra de ações.

    4. Escolha se deseja adicionar ou excluir contas de computador. Se você adicionar contas, especifique o que fazer com as senhas das contas: redefini-las todas ou inserir uma senha que se aplique a todas as contas.

      Você pode redefinir senhas se não souber as senhas atuais das contas; você deve ter permissão para realizar uma redefinição de senha. Ao inserir uma senha, a senha é alterada nas contas à medida que são importadas. Ao excluir uma conta, escolha se a conta no Active Directory é mantida, desabilitada ou excluída.

    Indique se as contas do Active Directory são retidas, desabilitadas ou excluídas ao remover máquinas de um catálogo ou excluir um catálogo.

    Recomendamos que você salve cópias ou instantâneos de imagens mestre antes de atualizar as máquinas no catálogo. O banco de dados mantém um registro histórico das imagens mestre usadas com cada catálogo de máquinas. Reverter as máquinas em um catálogo para usar a versão anterior da imagem mestre. Execute esta tarefa se os usuários encontrarem problemas com as atualizações que você implantou em seus desktops. Isso minimiza o tempo de inatividade do usuário. Não exclua, mova ou renomeie imagens mestre. Você não pode reverter um catálogo para usá-las.

    Depois que uma máquina é atualizada, ela reinicia automaticamente.

    Atualizar ou criar uma imagem mestre

    Antes de atualizar o catálogo de máquinas, atualize uma imagem mestre existente ou crie uma em seu hipervisor host.

    1. Em seu hipervisor, tire um instantâneo da VM atual e dê ao instantâneo um nome significativo. Este instantâneo pode ser usado para reverter (restaurar) máquinas no catálogo, se necessário.
    2. Se necessário, ligue a imagem mestre e faça login.
    3. Instale atualizações ou faça as alterações necessárias na imagem mestre.
    4. Desligue a VM.
    5. Tire um instantâneo da VM. Dê a ele um nome significativo que seja reconhecido quando o catálogo for atualizado no Web Studio. Embora o Web Studio possa criar um instantâneo, a Citrix recomenda que você o crie usando o console de gerenciamento do hipervisor. Em seguida, selecione esse instantâneo no Web Studio. Este processo permite que você forneça um nome e uma descrição significativos, em vez de um nome gerado automaticamente. Para imagens mestre de GPU, você só pode alterar a imagem mestre através do console do XenServer®.

    Alterar a imagem mestre

    Para preparar e implantar a atualização em todas as máquinas em um catálogo:

    1. Faça login no Web Studio.
    2. Selecione Catálogos de Máquinas no painel esquerdo.
    3. Selecione um catálogo e, em seguida, selecione Alterar Imagem Mestre na barra de ações.
    4. Na página Imagem, selecione o host e a imagem que você deseja implantar.

      Dica:

      Para um catálogo criado por MCS, você pode anotar sua imagem adicionando uma nota para a imagem. Uma nota pode conter até 500 caracteres. Cada vez que você altera a imagem mestre, uma entrada relacionada à nota é criada, quer você adicione uma nota. Se você atualizar um catálogo sem adicionar uma nota, a entrada aparecerá como nula (-). Para visualizar o histórico de notas da imagem, selecione o catálogo, clique em Propriedades do Modelo no painel inferior e, em seguida, clique em Exibir histórico de notas.

    5. Na página Estratégia de Implantação, escolha quando as máquinas no catálogo de máquinas são atualizadas com a nova imagem mestre: no próximo desligamento ou imediatamente.

      Nota:

      A página Estratégia de Implantação não está disponível para VMs persistentes porque a implantação é aplicável apenas a VMs não persistentes.

    6. Verifique as informações na página Resumo e, em seguida, clique em Concluir. Cada máquina reinicia automaticamente após ser atualizada.

    Para acompanhar o progresso da atualização, localize o catálogo em Catálogos de Máquinas para visualizar a barra de progresso em linha e o gráfico de progresso passo a passo.

    Ao atualizar um catálogo usando o PowerShell SDK diretamente, em vez do Web Studio, especifique um modelo de hipervisor (VMTemplates). Use isso como uma alternativa a uma imagem ou um instantâneo de uma imagem.

    Para implantar uma nova imagem mestre em um catálogo de máquinas baseado no Azure:

    1. No Web Studio, selecione Catálogos de Máquinas no painel esquerdo.
    2. Selecione um catálogo do Azure e, em seguida, selecione Alterar Imagem Mestre na barra de ações.
    3. Na página Alterar Imagem Mestre, selecione uma imagem em Imagem mestre. O painel lista todas as imagens que pertencem à mesma região que as dos Recursos.

    Estratégia de implantação:

    A atualização de imagens no próximo desligamento afetará imediatamente todas as máquinas que não estão em uso no momento, ou seja, máquinas que não têm uma sessão de usuário ativa. Um sistema em uso recebe a atualização quando a sessão ativa atual termina. Considere o seguinte:

    • Novas sessões não podem ser iniciadas até que a atualização seja concluída nas máquinas aplicáveis.
    • Para máquinas de SO de sessão única, as máquinas são atualizadas imediatamente quando a máquina não está em uso ou quando os usuários não estão logados.
    • Para um SO multi-sessão com máquinas filhas, as reinicializações não ocorrem automaticamente. Para aplicar a imagem mestre atualizada, reinicie as máquinas usando o Studio, PowerShell ou Workspace. A reinicialização das máquinas ou do hipervisor não aplica a atualização.

    Dica:

    Limite o número de máquinas sendo reinicializadas usando as configurações avançadas para uma conexão de host. Use essas configurações para modificar as ações tomadas para um determinado catálogo; as configurações avançadas variam dependendo do hipervisor.

    Reverter a imagem mestre

    Depois de implantar uma imagem mestre atualizada ou nova, você pode revertê-la. Este processo pode ser necessário se ocorrerem problemas com as máquinas recém-atualizadas. Ao reverter, as máquinas no catálogo são revertidas para a última imagem funcional. Quaisquer novos recursos que exijam a imagem mais recente não estarão mais disponíveis. Assim como na implantação, a reversão de uma máquina inclui uma reinicialização.

    1. Faça login no Web Studio.
    2. Selecione Catálogos de Máquinas no painel esquerdo.
    3. Selecione o catálogo e, em seguida, selecione Reverter Imagem Mestre na barra de ações.
    4. Especifique quando aplicar a imagem mestre anterior às máquinas, conforme descrito na seção anterior para a operação de implantação.

    A reversão é aplicada apenas às máquinas que precisam ser revertidas. As máquinas que não são atualizadas com a nova ou atualizada imagem mestre não recebem mensagens de notificação e não são forçadas a fazer logoff.

    Para acompanhar o progresso da reversão, localize o catálogo em Catálogos de Máquinas para visualizar a barra de progresso em linha e o gráfico de progresso passo a passo.

    Você não pode reverter em certos cenários, incluindo os seguintes. (A opção Reverter Imagem Mestre não está visível).

    • Você não tem permissão para reverter.
    • O catálogo não foi criado usando o MCS.
    • O catálogo foi criado usando uma imagem do disco do SO.
    • O instantâneo usado para criar o catálogo foi corrompido.
    • As alterações do usuário nas máquinas do catálogo não persistem.
    • As máquinas no catálogo estão em execução.

    Alterar o nível funcional ou desfazer a alteração

    Altere o nível funcional para o catálogo de máquinas depois de atualizar os VDAs nas máquinas para uma versão mais recente. A Citrix recomenda atualizar todos os VDAs para a versão mais recente para permitir o acesso a todos os recursos mais recentes.

    Antes de alterar o nível funcional de um catálogo de máquinas:

    • Inicie as máquinas atualizadas para que elas se registrem no Controller. Este processo permite que o Web Studio determine que as máquinas no catálogo precisam de atualização.

    Para alterar o nível funcional de um catálogo:

    1. Faça login no Web Studio.
    2. Selecione Catálogos de Máquinas no painel esquerdo.
    3. Selecione o catálogo. A guia Detalhes no painel inferior exibe informações da versão.
    4. Selecione Alterar Nível Funcional. Se o Web Studio detectar que o catálogo precisa de atualização, ele exibirá uma mensagem. Siga as instruções. Se uma ou mais máquinas não puderem ser atualizadas, uma mensagem explicará o motivo. Para garantir que todas as máquinas funcionem corretamente, a Citrix recomenda que você resolva os problemas da máquina antes de clicar em Alterar para prosseguir.

    Após a conclusão da alteração do catálogo, você pode reverter as máquinas para suas versões VDA anteriores selecionando o catálogo e, em seguida, selecionando Desfazer Alteração de Nível Funcional na barra de ações.

    Antes de clonar um catálogo, esteja ciente das seguintes considerações:

    Nota:

    Se você selecionar um catálogo do Azure para clonar e selecionar uma Imagem Mestre, o painel listará todas as imagens que pertencem à mesma região que as dos Recursos.

    • Clonar um catálogo pode levar algum tempo para ser concluído. Se necessário, selecione Ocultar progresso para executar a clonagem em segundo plano.
    • O catálogo clonado herda o nome do original e tem o sufixo Copy. Você pode alterar o nome. Consulte Renomear um catálogo.
    • Após a conclusão da clonagem, certifique-se de atribuir o catálogo clonado a um grupo de entrega.
    1. Faça login no Web Studio e, em seguida, selecione Catálogos de Máquinas no painel esquerdo.
    2. Selecione um catálogo e, em seguida, selecione Clonar na barra de ações.
    3. Na janela Clonar Catálogo de Máquinas Selecionado, visualize as configurações do catálogo clonado e configure as configurações conforme aplicável. Selecione Avançar para prosseguir para a próxima página.
    4. Na página Resumo, visualize um resumo das configurações e selecione Concluir para iniciar a clonagem.
    5. Se necessário, selecione Ocultar progresso para executar a clonagem em segundo plano.

    Organizar catálogos usando pastas

    Você pode criar pastas para organizar catálogos para facilitar o acesso. Por exemplo, você pode organizar catálogos por tipo de imagem ou por estrutura organizacional.

    Dica:

    Você pode definir sua exibição padrão preferida (exibição de pasta ou lista) para o nó Catálogos de Máquinas clicando no ícone Pasta no canto superior direito da barra de ações.

    Antes de começar, planeje como organizar seus catálogos. Considere o seguinte:

    • Você pode aninhar pastas em até cinco níveis de profundidade (excluindo a pasta raiz padrão).
    • Uma pasta de catálogo pode conter catálogos e subpastas.

    • Todos os nós no Web Studio (como Catálogos de Máquinas, Grupos de Entrega, Aplicativos e Grupos de Aplicativos) compartilham a mesma árvore de pastas no back-end. Para evitar conflitos de nomes ao renomear ou mover pastas, use nomes exclusivos para pastas de primeiro nível em diferentes nós.

      Se você criar uma pasta usando o cmdlet SDK New-BrokerAdminFolder e quiser que ela apareça no nó Catálogos de Máquinas, você deve adicionar os metadados ContainsMachineCatalogs usando o cmdlet Set-BrokerAdminFolderMetadata.

      Exemplo:

       Set-BrokerAdminFolderMetadata -AdminFolderId {adminFolderUid} -Name ContainsMachineCatalogs -Value true
 <!--NeedCopy-->

    Para criar uma pasta de catálogo, siga estas etapas:

    1. Selecione Catálogos de Máquinas no painel esquerdo.
    2. Na hierarquia de pastas, selecione uma pasta e, em seguida, selecione Criar Pasta na barra de Ações.
    3. Insira um nome para a nova pasta e, em seguida, clique em Concluído.

    Dica:

    Se você criar uma pasta em um local não intencional, poderá arrastá-la para o local correto.

    Você pode mover um catálogo entre pastas. As etapas detalhadas são as seguintes:

    1. Selecione Catálogos de Máquinas no painel esquerdo.
    2. Visualize os catálogos por pasta. Você também pode ativar Ver tudo acima da hierarquia de pastas para visualizar todos os catálogos de uma vez.
    3. Clique com o botão direito do mouse em um catálogo e, em seguida, selecione Mover Catálogo de Máquinas.
    4. Selecione a pasta para a qual você deseja mover o catálogo e, em seguida, clique em Concluído.

    Dica:

    Você pode arrastar um catálogo para uma pasta.

    Você pode excluir, renomear e mover pastas de catálogo.

    Você só pode excluir uma pasta se ela e suas subpastas não contiverem catálogos.

    Para gerenciar uma pasta, siga as etapas abaixo:

    1. Selecione Catálogos de Máquinas no painel esquerdo.

    2. Na hierarquia de pastas, selecione uma pasta e, em seguida, selecione uma ação na barra de Ações conforme necessário:

      • Para renomear a pasta, selecione Renomear Pasta.
      • Para excluir a pasta, selecione Excluir Pasta.
      • Para mover a pasta, selecione Mover Pasta.
    3. Siga as instruções na tela para concluir as etapas restantes.

    Atualizar VDAs

    Você pode usar a interface do Studio para atualizar VDAs com facilidade. Para obter mais informações e orientações passo a passo, consulte a documentação do Citrix VDA Upgrade Service.

    Nota:

    Este recurso se aplica apenas a catálogos MCS.

    Catálogos com falha são marcados com um ícone de erro. Para ver os detalhes, vá para a guia Solução de problemas de cada catálogo. Antes de tentar novamente a criação do catálogo, esteja ciente das seguintes considerações:

    • Verifique as informações de solução de problemas primeiro e resolva os problemas. As informações descrevem os problemas encontrados e fornecem recomendações para resolvê-los.
    • Você não pode alterar as configurações associadas ao Sistema operacional e ao gerenciamento de máquinas. O catálogo herda essas configurações do original.
    • A criação pode levar algum tempo para ser concluída. Se necessário, selecione Ocultar progresso para executar a criação em segundo plano.

    Para tentar novamente a criação de um catálogo, faça o seguinte:

    1. No Web Studio, selecione Catálogos de Máquinas no painel esquerdo.
    2. Selecione o catálogo e, em seguida, vá para a guia Solução de problemas.
    3. Clique no hiperlink de repetição para tentar novamente a criação do catálogo.
    4. No assistente que aparece, altere as configurações onde for necessário. Se não houver necessidade de fazer alterações, você pode ir diretamente para a página Resumo.
    5. Após terminar, selecione Concluir para iniciar a criação.

    Registrar VDAs não provisionados por MCS usando tokens

    Agora você pode gerar e gerenciar tokens de registro para VDAs não provisionados por MCS. Essa implementação permite o registro de VDA via WebSocket sem provisionar os VDAs com MCS. Esse recurso também suporta Linux Virtual Delivery Agent, Citrix Virtual Delivery Agent para macOS e VDAs não associados a domínio com Citrix Virtual Apps and Desktops.

    Antes de começar

    1. Configure seu site. Para obter mais informações, consulte Criar um site.
    2. Instale certificados TLS nos Delivery Controllers. Para obter mais informações, consulte Instalar certificados de servidor TLS nos Controllers.
    3. Instale a CA raiz e a CA intermediária no VDA para confiar no Delivery Controller.

    4. Habilite a conexão WebSocket no Delivery Controller. Execute o seguinte comando em cada Delivery Controller presente em seu site:

      New-ItemProperty "HKLM:\SOFTWARE\Citrix\DesktopServer\WorkerProxy" -Name "WebSocket_Enabled" -PropertyType "DWord" -Value 1 -Force
<!--NeedCopy-->

      Nota:

      Certifique-se de reiniciar os Delivery Controllers após habilitar o WebSocket.

    Gerar tokens de registro

    Depois de decidir habilitar o registro baseado em token para máquinas não provisionadas pela Citrix, você deve primeiro gerar tokens por catálogo de máquinas e, em seguida, compartilhá-los com os administradores de instalação do VDA.

    Um token de registro apresenta:

    • Intervalo de registro: 1 a 5000 máquinas VDA
    • Período de validade: até 14 dias

    Para gerar um token para um catálogo usando o Web Studio, siga estas etapas:

    1. Em Web Studio > Catálogos de Máquinas, localize um catálogo não provisionado por MCS, que tenha Método de provisionamento: Manual exibido na coluna Contagem de Máquinas.
    2. Clique com o botão direito do mouse no catálogo e, em seguida, selecione Gerenciar Tokens de Registro.
    3. Na página Gerar token de registro que aparece, forneça as seguintes informações do token:
      • Digite um nome para o token.
      • Insira seu período de validade. O período não deve ser superior a 14 dias. O token é válido apenas pelo período especificado.
      • (Opcional) Selecione uma conexão de host para gerenciamento de energia de VDAs registrados com o token. As opções incluem todas as conexões de host na zona deste catálogo.
      • Insira os limites de uso do token (entre 1 e 5000).
    4. Clique em Gerar.

    5. Na janela Token gerado com sucesso que aparece, copie o token e salve-o em um local seguro, ou clique em Download para baixá-lo para a pasta Downloads.

      Um registro de token aparece na lista de tokens.

      Geração de token

    6. Compartilhe o token com os administradores de instalação do VDA.

      Para obter mais informações sobre como instalar o VDA e um token em máquinas, consulte Instalar VDAs.

    Gerenciar tokens

    Você tem duas opções para revogar um token e torná-lo indisponível para registro de VDA:

    • Revogar: Revoga o token, mas o mantém na lista para fins de registro.
    • Excluir: Revoga o token e o exclui da lista.

    Nota:

    Tokens expirados são excluídos automaticamente em 14 dias.

    Registrar máquinas em catálogos usando a ferramenta de registro de VDA WebSocket

    A ferramenta de registro de VDA WebSocket facilita o registro baseado em token para máquinas VDA. Essa ferramenta ajuda você a converter uma conexão em uma conexão WebSocket adicionando o VDA ao catálogo de máquinas usando o token de registro.

    Nota:

    Esta ferramenta foi projetada para registrar máquinas VDA que não foram registradas em nenhum catálogo de máquinas.

    Siga as instruções para executar a ferramenta de registro:

    1. Faça login no VDA.
    2. Localize a ferramenta EnrollMachine.exe, em C:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Tool.
    3. Execute a ferramenta com os parâmetros de entrada apropriados. Por exemplo, EnrollMachine.exe -websocket_token_string:xxxxxxxxx

    A tabela a seguir descreve os parâmetros de entrada da ferramenta de registro:

    Nome do Parâmetro Obrigatório Descrição Exemplo
    -websocket_token_stdin Sim

    		Lê o token de registro. .\EnrollMachine.exe -websocket_token_stdin
    -websocket_token_string Lê o token de registro diretamente do parâmetro da linha de comando. .\EnrollMachine.exe -websocket_token_string:<token>
    -websocket_token_file:[token-file-path] Lê o token de registro do caminho fornecido. .\EnrollMachine.exe -websocket_token_file:C:\token\test2.txt
    log:[log-file-path] Não Mostra os logs da ferramenta de registro. .\EnrollMachine.exe log:[C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt]
    -help Não Mostra um breve texto de ajuda. .\EnrollMachine.exe -help

    Após o registro bem-sucedido, você receberá uma mensagem de sucesso na ferramenta e nos logs. Certifique-se de fazer login no Web Studio para verificar se a máquina VDA foi adicionada ao catálogo e se o status da máquina está registrado.

    Solução de problemas

    Por padrão, você pode encontrar os logs da ferramenta de registro em:

    C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt

    Se você especificou um caminho diferente para os logs, pode usar log:[log-file-path] para recuperar seus logs.

    A tabela a seguir lista os códigos retornados pela ferramenta de registro:

    Código String Descrição
    0 Success O VDA foi adicionado com sucesso ao catálogo de máquinas.
    -1 InvalidArgument O parâmetro de entrada no token de registro é inválido.
    -2 BrokerAgentNotFound O serviço do agente do broker não foi encontrado.
    -3 TokenInvalid O token inserido é inválido.
    -4 TokenMissingRequiredClaims As reivindicações necessárias para o token estão faltando, por exemplo, CustomerId ou URIs de registro.
    -5 InternalError Ocorreu um erro geral.
    -6 TimedOut A tarefa expirou.
    -7 FailedToDetermineMachineADJoinedStatus O serviço que retorna o status de associação da máquina ao AD falhou.
    -8 ADMachineFailedToFindSid O serviço que retorna o Sid da máquina AD falhou.
    -9 EnrollRequestFailed A solicitação falhou devido a um erro HTTP.
    -10 EnrollResponseMissingRequiredFields A resposta da ferramenta de registro está faltando o parâmetro VirtualSiteId.
    -11 InsufficientPermission Você não tem a permissão necessária para executar a tarefa.
    -12 FailedToDetermineMachineAadJoinedStatus O serviço que verifica o status de associação da máquina ao AD lança um erro.
    -13 AadMachineFailedToFindDeviceId O parâmetro adicional AAD device id adicionado pelo sistema está vazio.
    -14 AadDeviceIdNotValid O parâmetro adicional AAD device id adicionado pelo sistema não é um guid válido.
    -15 NoValidMacAddress Endereço MAC inválido.
    -16 FailedToGetComputerHostNameForVdaInstanceName Falha ao obter o nome do host do computador para definir o parâmetro adicional VdaInstanceName.
    -17 VirtualDesktopAgentRegistryKeyFailedToOpen Falha ao abrir a chave do registro VDA para gravar a lista de Delivery Controllers.
    -18 Failed Token reached the max count Falha: o token atingiu a contagem máxima.

    Usar o PowerShell

    Esta seção detalha como você pode gerenciar catálogos usando o PowerShell:

    Você pode obter erros e avisos históricos para entender os problemas com seu catálogo de máquinas MCS e corrigi-los.

    Usando comandos do PowerShell, você pode:

    • Obter uma lista de erros ou avisos
    • Alterar o estado de aviso de Novo para Reconhecido
    • Excluir os erros ou avisos

    Para executar os comandos do PowerShell:

    1. Abra uma janela do PowerShell.
    2. Execute asnp citrix* para carregar os módulos do PowerShell específicos da Citrix.

    Para obter uma lista de erros e avisos:

    Execute o comando Get-ProvOperationEvent.

    • Sem parâmetros: Obtém todos os erros e avisos
    • Com os parâmetros LinkedObjectType e LinkedObjectUid: Obtém todos os erros e avisos associados a um esquema de provisionamento específico
    • Com o parâmetro EventId: Obtém um erro ou aviso específico que corresponde a este ID de evento
    • Com o parâmetro Filter: Obtém erros ou avisos por filtro personalizado

    Para alterar o estado de erros ou avisos de Novo para Reconhecido:

    Execute o comando Confirm-ProvOperationEvent.

    • Com o parâmetro EventId: Define o estado de um erro ou aviso específico que corresponde a este ID de evento. Você pode obter o EventId de um erro ou aviso específico como saída do comando Get-ProvOperationEvent
    • Com os parâmetros LinkedObjectType e LinkedObjectUid: Define o estado de todos os erros e avisos associados a um esquema de provisionamento específico
    • Com o parâmetro All: Define o estado de todos os erros e avisos como Reconhecido

    Para excluir os erros ou avisos:

    Execute o comando Remove-ProvOperationEvent.

    • Com o parâmetro EventId: Remove um erro ou aviso específico que corresponde a este ID de evento. Você pode obter o EventId de um erro ou aviso específico como saída do comando Get-ProvOperationEvent
    • Com os parâmetros LinkedObjectType e LinkedObjectUid: Remove todos os erros e avisos associados a um esquema de provisionamento específico
    • Com o parâmetro All: Remove todos os erros e avisos

    Para obter mais informações, consulte Citrix PowerShell SDK.

    Excluir máquinas sem acesso ao hipervisor

    Ao excluir uma VM ou um esquema de provisionamento, o MCS precisa remover tags da VM e, às vezes, também do disco base, para que os recursos incluídos nas opções de exclusão não sejam mais rastreados ou identificados pelo MCS. No entanto, alguns desses recursos são acessíveis apenas através do hipervisor. Use a opção PurgeDBOnly no PowerShell Remove-ProvVM para excluir objetos de recurso de VM, como VM, disco base, imagem em ACG e assim por diante, do banco de dados, mesmo quando não há acesso ao hipervisor.

    Esta opção está habilitada em:

    • todos os hipervisores suportados
    • VMs persistentes e não persistentes

    Limitações

    Você não pode usar os comandos -PurgeDBOnly e -ForgetVM ao mesmo tempo.

    Usar o comando PurgeDBOnly

    Ao executar o comando PowerShell Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -ForgetVM, a operação de exclusão pode falhar nos seguintes cenários:

    • A conexão do host está em modo de manutenção
    • Credenciais inválidas
    • Falha de autenticação
    • Operação não autorizada
    • O hipervisor está inacessível

    Nota:

    Remove-provVM -ForgetVM tem como alvo apenas VMs persistentes. Se uma das VMs na lista não for persistente, a operação falhará.

    Quando a operação falha porque o hipervisor está inacessível, o seguinte prompt aparece:

    Try to use -PurgeDBOnly option to clean DDC database.

    Use a opção -PurgeDBOnly no comando PowerShell Remove-ProvVM para excluir referências de uma VM do banco de dados MCS. Por exemplo,

    Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -PurgeDBOnly

    Adicionar descrições a uma imagem

    Você pode adicionar descrições informativas sobre alterações relacionadas a atualizações de imagem para catálogos de máquinas. Use este recurso para adicionar uma descrição ao criar um catálogo ou ao atualizar uma imagem mestre existente para um catálogo. Você também pode exibir informações para cada imagem mestre no catálogo. Use os seguintes comandos para adicionar ou visualizar descrições de imagem:

    • Para adicionar uma nota ao criar um catálogo de máquinas com uma imagem mestre, use o parâmetro MasterImageNote no comando NewProvScheme. Por exemplo:

       C:\PS>New-ProvScheme -ProvisioningSchemeName <name> -HostingUnitName <name> -IdentityPoolName <name> -MasterImageVM
 XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\Base.snapshot -MasterImageNote "Note"
 <!--NeedCopy-->

    • Para atualizar a imagem mestre associada a um catálogo de máquinas, use o parâmetro MasterImageNote no comando Publish-ProvMasterVMImage. Por exemplo:

       C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName <name> -MasterImageVM XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\base.snapshot -MasterImageNote "Note"
 <!--NeedCopy-->

    • Para exibir as informações de cada imagem, use o comando Get-ProvSchemeMasterVMImageHistory. Por exemplo:

       C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall
 <!--NeedCopy-->

    Para acompanhar o progresso da reversão, localize o catálogo em Catálogos de Máquinas para visualizar a barra de progresso em linha e o gráfico de progresso passo a passo.

    Você não pode reverter em certos cenários, incluindo os seguintes. (A opção Reverter Imagem Mestre não está visível).

    • Você não tem permissão para reverter.
    • O catálogo não foi criado usando o MCS.
    • O catálogo foi criado usando uma imagem do disco do SO.
    • O instantâneo usado para criar o catálogo foi corrompido.
    • As alterações do usuário nas máquinas do catálogo não persistem.
    • As máquinas no catálogo estão em execução.

    Redefinir disco do SO

    Use o comando PowerShell Reset-ProvVMDisk para redefinir o disco do SO de uma VM persistente em um catálogo de máquinas criado por MCS. Atualmente, este recurso é aplicável a ambientes de virtualização AWS, Azure, XenServer, Google Cloud, SCVMM e VMware.

    Para executar o comando PowerShell com sucesso, certifique-se de que:

    • As VMs de destino estão em um catálogo MCS persistente.
    • O catálogo de máquinas MCS está funcionando corretamente.
    • Isso implica que o esquema de provisionamento e o host existem, e o esquema de provisionamento tem entradas corretas.
    • O hipervisor não está em modo de manutenção.
    • As VMs de destino estão desligadas e em modo de manutenção.

    Execute as seguintes etapas para redefinir o disco do SO:

    1. Abra uma janela do PowerShell.
    2. Execute asnp citrix* para carregar os módulos do PowerShell específicos da Citrix.

    3. Execute o comando PowerShell Reset-ProvVMDisk de uma das seguintes maneiras:

      • Especifique a lista de VMs como uma lista separada por vírgulas e execute a redefinição em cada VM:

         Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS
 <!--NeedCopy-->

      • Especifique a lista de VMs como uma saída do comando Get-ProvVM e execute a redefinição em cada VM:

         (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS
 <!--NeedCopy-->

      • Especifique uma única VM por nome:

         Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
 <!--NeedCopy-->

      • Crie tarefas de redefinição separadas para cada uma das VMs retornadas pelo comando Get-ProvVM. Isso é menos eficiente porque cada tarefa executará as mesmas verificações redundantes, como verificação de capacidade do hipervisor, verificação de conexão para cada VM.

         Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
 <!--NeedCopy-->

    4. Um prompt de confirmação aparece listando as VMs a serem redefinidas junto com uma mensagem de aviso de que é uma operação irrecuperável. Se você não fornecer uma resposta e pressionar Enter, nenhuma ação adicional ocorrerá.

      Nota:

      Não tire as VMs do modo de manutenção nem as ligue até a conclusão do processo de redefinição.

      Você pode executar o comando PowerShell -WhatIf para imprimir a ação que ele tomaria e sair sem executar a ação.

      Você também pode ignorar o prompt de confirmação usando um dos seguintes métodos:

      • Forneça o parâmetro -Force:

         Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force
 <!--NeedCopy-->

      • Forneça o parâmetro -Confirm:$false:

         Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
 <!--NeedCopy-->

      • Antes de executar o Reset-ProvVMDisk, altere $ConfirmPreference para None:

         PS C:\Windows\system32> $ConfirmPreference='None'
 PS C:\Windows\system32> $ConfirmPreference
 None
 PS C:\Windows\system32> Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
 <!--NeedCopy-->
    5. Execute Get-ProvTask para obter o status das tarefas retornadas pelo comando Reset-ProvVMDisk.

    Alterar a configuração de rede para um esquema de provisionamento existente

    Você pode alterar a configuração de rede para um esquema de provisionamento existente para que as novas VMs sejam criadas na nova sub-rede. Use o parâmetro -NetworkMapping no comando Set-ProvScheme para alterar a configuração de rede.

    Nota:

    Este recurso é suportado no Citrix Virtual Apps and Desktops 2203 LTSR CU3 e versões posteriores.

    Para alterar a configuração de rede para um esquema de provisionamento existente, faça o seguinte:

    1. Na janela do PowerShell, execute o comando asnp citrix* para carregar os módulos do PowerShell.
    2. Execute (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps para obter o caminho de rede que você deseja alterar.

    3. Atribua uma variável à nova configuração de rede. Por exemplo:

      $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
<!--NeedCopy-->
    4. Execute Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap.
    5. Execute (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps para verificar a nova configuração de rede para o esquema de provisionamento existente.

    Gerenciar versões de um catálogo de máquinas

    Quando um catálogo de máquinas MCS é atualizado com o comando Set-ProvScheme, a configuração atual é salva como uma versão. Você pode então gerenciar as várias versões do catálogo de máquinas usando comandos do PowerShell. Você pode:

    • Ver a lista de versões de um catálogo de máquinas
    • Usar qualquer versão anterior para atualizar o catálogo de máquinas
    • Excluir manualmente uma versão se ela não for usada por uma VM desse catálogo de máquinas
    • Alterar o número máximo de versões a serem retidas pelo catálogo de máquinas (o padrão é 99)

    Uma versão inclui as seguintes informações de um catálogo de máquinas:

    • VMCpuCount
    • VMMemoryMB
    • CustomProperties
    • ServiceOffering
    • MachineProfile
    • NetworkMapping
    • SecurityGroup

    Execute os seguintes comandos (fornecidos como exemplos) para gerenciar as várias versões de um catálogo de máquinas.

    • Para ver os detalhes de configuração das várias versões de um catálogo de máquinas:

       Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog
 <!--NeedCopy-->

    • Para ver os detalhes de configuração de uma versão específica de um catálogo de máquinas:

       Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2
 <!--NeedCopy-->

    • Para ver o número total de versões associadas a um catálogo de máquinas:

       (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count
 <!--NeedCopy-->

    • Para usar qualquer versão anterior para atualizar o catálogo de máquinas:

       Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2
 <!--NeedCopy-->

    • Para excluir manualmente uma versão se ela não for usada por uma VM desse catálogo de máquinas:

       Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3
 <!--NeedCopy-->

    • Para definir o número máximo de versões a serem retidas pelo catálogo de máquinas (o padrão é 99). Essa configuração é aplicada a todos os catálogos. Por exemplo, neste caso, um máximo de 15 versões serão retidas para todos os catálogos provisionados por MCS.

       Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15
 <!--NeedCopy-->

    Se o número de versões atingir o número máximo de versões, uma nova versão não poderá ser criada se versões mais antigas estiverem em uso por alguma das VMs no catálogo de máquinas. Nesse caso, faça uma das seguintes opções:

    • Aumente o limite do número máximo de versões a serem retidas pelo catálogo de máquinas.
    • Atualize algumas VMs que estão em versões mais antigas para que essas versões mais antigas não sejam mais referenciadas por nenhuma VM e possam ser excluídas.

    Converter um catálogo de máquinas não baseado em perfil de máquina em um catálogo de máquinas baseado em perfil de máquina

    Você pode usar uma VM, especificação de modelo (no caso do Azure), modelo de inicialização (no caso da AWS) ou modelo VMware (no caso do VMware) como entrada de perfil de máquina para converter um catálogo de máquinas não baseado em perfil de máquina em um catálogo de máquinas baseado em perfil de máquina. As novas VMs adicionadas ao catálogo assumem os valores de propriedade do perfil da máquina, a menos que sejam substituídos por uma propriedade personalizada explícita.

    Nota:

    Um catálogo de máquinas baseado em perfil de máquina existente não pode ser alterado para um catálogo de máquinas não baseado em perfil de máquina.

    Para fazer isso:

    1. Crie um catálogo de máquinas persistente ou não persistente com VMs e sem um perfil de máquina.
    2. Abra a janela do PowerShell.

    3. Execute o comando Set-ProvScheme para aplicar os valores de propriedade do perfil da máquina às novas VMs adicionadas ao catálogo de máquinas. Por exemplo:

      • No caso do Azure:

         Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits\<HostingUnitName>\machineprofile.folder\<ResourceGroupName>\<TemplateSpecName>\<VersionName>
 <!--NeedCopy-->

      • No caso da AWS:

         Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\<launch-template>.launchtemplate\<launch-template-version>.launchtemplateversion"
 <!--NeedCopy-->

      • No caso do VMware:

          Set-ProvScheme -ProvisioningSchemeName "my-prov-scheme" -MachineProfile "XDHyp:\HostingUnits\my-hosting-unit\my-template.template"
 <!--NeedCopy-->

        Nota:

        Defina o FolderID como a propriedade personalizada para evitar derivar o FolderID do modelo VMware.

    Reparar as informações de identidade de contas de computador ativas

    Você pode redefinir as informações de identidade de contas de computador ativas que apresentam problemas relacionados à identidade. Você pode optar por redefinir apenas a senha da máquina e as chaves de confiança, ou redefinir toda a configuração do disco de identidade. Essa implementação é aplicável a catálogos de máquinas MCS persistentes e não persistentes.

    Nota:

    Atualmente, o recurso é suportado para ambientes de virtualização AWS, GCP, Azure, SCVMM, XenServer e VMware.

    Condições

    Garanta o seguinte para redefinir o disco de identidade com sucesso:

    • Desligue e defina a VM para o modo de manutenção
    • Não inclua o parâmetro -OS no comando PowerShell

    Redefinir disco de identidade

    Para redefinir o disco de identidade:

    1. Abra a janela do PowerShell.
    2. Execute asnp citrix* para carregar os módulos do PowerShell específicos da Citrix.

    3. Redefina as informações de identidade.

      • Para redefinir apenas a senha da máquina e as chaves de confiança, execute o seguinte comando:

         Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 <!--NeedCopy-->

        A descrição dos parâmetros usados no comando é a seguinte:

        • IdentityAccountName: O nome da conta de identidade que deve ser reparada.
        • PrivilegedUserName: Conta de usuário que tem permissão de gravação no provedor de identidade (AD ou AzureAD).
        • PrivilegedUserPassword: Senha para PrivilegedUserName.
        • Target: Alvo para a ação de reparo. Pode ser IdentityInfo para reparar a senha da conta/chave de confiança, e UserCertificate para reparar atributos de certificado de usuário de identidades de máquina unidas ao Hybrid AzureAD.

      • Para redefinir toda a configuração do disco de identidade, execute os seguintes comandos na seguinte ordem:

         Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 <!--NeedCopy-->

         Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
 <!--NeedCopy-->

      • Para recriar completamente o disco de identidade:

         Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate
 <!--NeedCopy-->

    4. Digite y para confirmar a ação. Você também pode ignorar o prompt de confirmação usando o parâmetro -Force. Por exemplo:

      Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force
<!--NeedCopy-->
    5. Execute Get-ProvVM -ProvisioningSchemeName <name -VMName <name> para verificar a configuração atualizada do disco de identidade. Os atributos do disco de identidade (por exemplo, IdentityDiskId) devem ser atualizados. O StorageId e o IdentityDiskIndex não devem mudar.

    Alterar a configuração de cache em um catálogo de máquinas existente

    Após criar um catálogo não persistente com MCSIO habilitado, você pode usar o comando Set-ProvScheme para modificar os seguintes parâmetros:

    • WriteBackCacheMemorySize
    • WriteBackCacheDiskSize

    Este recurso é atualmente aplicável a:

    • Ambientes GCP e Microsoft Azure, e
    • um catálogo não persistente com MCSIO habilitado

    Requisitos

    Os requisitos para modificar a configuração de cache são:

    • Atualize para a versão mais recente do VDA (2308 ou posterior).

    • Habilite o parâmetro UseWriteBackCache para o catálogo de máquinas existente. Use New-ProvScheme para criar um catálogo de máquinas com UseWriteBackCache habilitado. Por exemplo:

       New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
 -IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot `
 -MasterImageVM $MasterImage `
 -ServiceOffering $ServiceOffering `
 -NetworkMap $NetworkMap `
 -SecurityGroup $SecurityGroup `
 -UseWriteBackCache -WriteBackCacheDiskSize 8
 <!--NeedCopy-->

    Alterar a configuração de cache

    Execute o comando Set-ProvScheme. Por exemplo:

    Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128
<!--NeedCopy-->

    Nota:

    • O valor de WriteBackCacheDiskSize deve ser maior que zero porque é necessário pelo menos 1 GB de armazenamento em disco de cache.
    • O valor de WriteBackCacheMemorySize deve ser menor que o tamanho da memória do catálogo de máquinas.
    • Essas alterações afetam apenas as novas VMs adicionadas ao catálogo após a alteração. As VMs existentes não são afetadas por essas alterações.

    Suporte à atualização de VDA via acesso a compartilhamento de arquivos local

    Especifique o local do instalador do VDA por meio de cmdlets do PowerShell, o que reduz seu esforço de fornecer regras de rede para permitir que cada VDA vá e busque o novo instalador do VDA do Citrix Managed Azure CDN.

    Cmdlets do PowerShell

    Dois novos parâmetros opcionais adicionados aos cmdlets New-VusCatalogSchedule e New-VusMachineUpgrade que permitem usar instaladores de um compartilhamento de arquivos local

    • VdaWorkstationPackageUri - para especificar o caminho UNC para o instalador do VDA do SO da estação de trabalho
    • VdaServerPackageUri - para especificar o caminho UNC para o instalador do VDA do SO do servidor

    Pré-requisitos

    • Instalador do Agente VUS que vem com VDA 2311
    • Agente de Atualização VDA para a versão 7.40.0.35 ou posterior (usando o instalador VDA versão 2311 ou posterior)
    • SDK do PowerShell Remoto do Virtual Apps and Desktops versão 7.40 ou mais recente (lançado em 10 de janeiro de 2024 ou posterior)

    Como definir permissões de compartilhamento de arquivos

    Os compartilhamentos de rede que contêm pacotes de instaladores VDA devem ter acesso de leitura para o serviço VDA Upgrade Agent, que é executado como Sistema Local (principal NT AUTHORITY\SYSTEM).

    • Permissão de compartilhamento de arquivos associado a domínio

      Quando a máquina VDA está associada a um domínio, a conta Sistema Local (VUA é executado como Sistema Local) usa credenciais de computador ao acessar compartilhamentos de rede.

      A permissão de menor privilégio pode ser definida concedendo acesso de Leitura aos Computadores de Domínio.

      1. Escolha as pessoas em sua rede com quem você deseja compartilhar o arquivo.
      2. Clique em Configurações de Compartilhamento Avançadas e ative o Compartilhamento de Arquivos e Impressoras.

    • Permissão de compartilhamento de arquivos não associado a domínio

      Quando a máquina VDA não está associada a um domínio, a conta Sistema Local (VUA é executado como Sistema Local) usa LOGON ANÔNIMO ao acessar compartilhamentos de rede.

      1. Selecione uma pasta compartilhada.
      2. Desative a proteção por senha.
        1. Vá para Propriedades da Pasta.
        2. Selecione Central de Rede e Compartilhamento.
        3. Desative o Compartilhamento Protegido por Senha.
      3. Clique em Compartilhamento Avançado para conceder uma permissão de compartilhamento.
        1. Selecione Permissões.
        2. Conceda uma permissão de compartilhamento de Leitura para LOGON ANÔNIMO.
      4. Selecione a Guia Segurança para conceder permissões de pasta
        1. Clique em Editar para adicionar permissões à pasta compartilhada
        2. Selecione a pasta compartilhada para conceder permissões de pasta a LOGON ANÔNIMO.
      5. Clique em Avançado para ativar o Compartilhamento de Arquivos e Impressoras.
      6. Adicione o nome da pasta compartilhada à Política de Segurança de Acesso à Rede.

      Nota:

      Reinicie sua máquina para que a alteração entre em vigor imediatamente.

    Atualizações de VDA de um compartilhamento de arquivos local

    1. Baixe o instalador do VDA e coloque-o no arquivo compartilhado.

      Nota:

      Com o Virtual Upgrade Service, você pode selecionar entre a trilha de Lançamento Atual ou a trilha LTSR.

      Por exemplo: Se o catálogo de máquinas estiver definido como Lançamento Atual, que é 2311, e a versão do VDA for 2305, você deve atualizar o VDA para a versão 2311.

      1. Navegue até a página de Downloads em nosso site.
      2. Selecione Citrix Virtual Apps and Desktops como o produto.
      3. Selecione Citrix Virtual Apps and Desktops 7 2311, Todas as Edições.
      4. Selecione o instalador do VDA na seção expansível Componentes que estão no ISO do produto, mas também empacotados separadamente.

    2. Selecione o instalador VDA relevante com base no tipo de catálogo.

      • Baixe o instalador VDA do SO multi-sessão se o tipo de catálogo for multi-sessão
      • Baixe o instalador VDA do SO de sessão única se o tipo de catálogo for sessão única
      • Baixe o instalador VDA de Serviços Principais do SO de sessão única se o tipo de catálogo for Acesso Remoto para PC

    Nota:

    A versão do instalador do compartilhamento de arquivos deve corresponder exatamente à versão da versão mais recente do instalador publicada pelo VUS na nuvem.

    Migração de armazenamento de VMs

    Você pode mover o armazenamento em disco de VMs existentes de um armazenamento antigo para um novo armazenamento em ambientes VMware e XenServer. Durante a migração, o MCS mantém os recursos da VM, como gerenciamento de energia, redefinição do disco do SO e assim por diante. Você também pode adicionar novas VMs ao catálogo de máquinas usando o novo armazenamento em disco. Para fazer isso, use o comando PowerShell Move-ProvVMDisk.

    Você pode migrar VMs persistentes de clone completo e VMs não persistentes.

    • Para VMs persistentes de Clone Completo: Disco do SO, Disco de Identidade e discos não provisionados por MCS.
    • Para VMs não persistentes: Disco do SO, Disco de Identidade e disco de Cache de Write-back (WBC).

    O novo armazenamento deve satisfazer as seguintes condições:

    • Deve estar dentro do mesmo cluster do armazenamento antigo.
    • O host no qual a VM está sendo executada deve ter acesso aos armazenamentos de dados antigo e novo.

    Migrar o armazenamento em disco

    Para migrar o armazenamento em disco:

    1. Adicione um armazenamento de destino a uma unidade de hospedagem existente. Você pode executar o comando PowerShell Add-Hyphostingunitstorage para adicionar o armazenamento de destino:

      Se você não deseja adicionar novas VMs ao armazenamento antigo, altere o armazenamento antigo para Substituído. Você pode fazer isso usando o Studio ou comandos do PowerShell. Para o Studio, consulte Editar armazenamento. Alternativamente, execute Set-Hyphostingunitstorage e defina Superseded como true para desabilitar a criação de novas VMs no armazenamento antigo.

      Nota:

      Para VMs não persistentes:

      • Se o WBC for usado, configure o armazenamento de destino do WBC na unidade de hospedagem.
      • Se o armazenamento de destino do SO estiver configurado, o WBC (se usado) deve ser compatível com o armazenamento de destino do SO.
      • Se o armazenamento de destino do SO não estiver configurado, o WBC (se usado) deve ser compatível com o armazenamento atual do SO.
    2. Desligue as VMs e ative o Modo de Manutenção.

    3. Obtenha as informações sobre o esquema de provisionamento, unidade de hospedagem, armazenamento em disco do SO e armazenamento em disco do WBC.

      • Execute ProvResourceInStorage para obter informações de armazenamento do SO. Por exemplo:

         $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
 $result
 $result.ProvResourceInStorage | Format-List -Property *
 <!--NeedCopy-->

      • Execute TemporaryStorageInfo para obter informações de armazenamento do WBC. Por exemplo:

         $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
 $result
 $result.TemporaryStorageInfo | Format-List -Property *
 <!--NeedCopy-->

    4. Migre o disco do SO, o disco de Identidade e o disco WBC (aplicável a VMs não persistentes) para o armazenamento de destino usando o comando PowerShell Move-ProvVMDisk.

      Nota:

      • Sempre forneça os discos do SO e de Identidade nos parâmetros DiskType e DestinationStorageId.
      • O DestinationStorageId para o disco do SO e o disco de Identidade deve ser o mesmo.

      Exemplo:

      VMs persistentes:

      (Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myFullCloneProvScheme" -VMName "machine01" -DiskType OS,Identity -DestinationStorageId datastore1,datastore1
<!--NeedCopy-->

      Importante:

      Para VM persistente, todos os discos são movidos. Você não pode selecionar quais discos mover.

      VMs não persistentes:

      (Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myCleanOnBootProvScheme" -VMName "machine01" -DiskType OS,Identity,WBC -DestinationStorageId None,None,datastore1
<!--NeedCopy-->

      Importante:

      • Se você não deseja migrar um disco específico, defina o valor como None para o parâmetro DestinationStorageId.
      • Se a VM tiver disco WBC, adicione o disco WBC no parâmetro DiskType e adicione as informações necessárias no parâmetro DestinationStorageId.

    Migrar catálogos provisionados por MCS existentes para catálogos de máquinas de imagem preparada

    Você pode converter um catálogo de máquinas provisionado por MCS existente em um catálogo de máquinas de imagem preparada usando um comando PowerShell Set-ProvSchemeImage. No entanto, você não pode reverter para o catálogo legado após a migração. Atualmente, este recurso é aplicável a ambientes de virtualização Azure e VMware.

    Limitações

    Considere as seguintes limitações:

    • Se o catálogo MCS usar um disco de dados persistente, o catálogo não poderá ser migrado para usar uma imagem preparada.
    • Se o catálogo MCS usar discos não gerenciados, o catálogo não poderá ser migrado para usar uma imagem preparada.

    Migrar para o catálogo de máquinas de imagem preparada

    Para migrar, faça o seguinte:

    1. Crie uma definição de imagem e versões de imagem usando comandos do Studio ou PowerShell. Consulte as etapas para criar definições de imagem e versões de imagem em:

    2. Execute o comando Get-ProvScheme para obter o UID do esquema de provisionamento. Por exemplo:

      Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid
<!--NeedCopy-->

    3. Execute o comando Get-ProvImageVersionSpec para obter o nome da definição de imagem, UID da especificação da versão da imagem. Por exemplo:

      Get-ProvImageVersionSpec -ImageDifinitionName <name> -Filter {IsPrepared -eq $true} | select ImageDefinitionName ImageVersionSpecUId
<!--NeedCopy-->

    4. Execute o comando Set-ProvSchemeImage para migrar um catálogo de máquinas provisionado por MCS existente para um catálogo de máquinas de imagem preparada. Por exemplo:

      Set-ProvSchemeImage -ProvisioningSchemeName [ProvisioningSchemeName] -ImageVersionSpecUid [ImageVersionSpecUid]
<!--NeedCopy-->

    5. Execute o comando Get-ProvScheme para verificar se o catálogo foi migrado. Por exemplo:

      Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid, ImageVersionSpecUId
<!--NeedCopy-->

    Solução de problemas

    Onde ir em seguida

    Para obter informações sobre como gerenciar catálogos de serviços de nuvem específicos, consulte:

    Gerenciar catálogos de máquinas
    January 23, 2026
    Contribuição de: 
    C
    January 23, 2026
    Contribuição de: 
    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.