Citrix Virtual Apps and Desktops

Gerenciar catálogos de máquinas

January 23, 2026

Contribuição de:

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

É possível 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. Isso inclui 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 atualizar com eficiência um grande número de máquinas de usuário.
Para catálogos que contêm máquinas estáticas, atribuídas permanentemente, e para catálogos de máquinas de Acesso Remoto a 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 de 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 pré-existentes 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 pré-existentes 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:

Usando o Web Studio
Usando o PowerShell

Usar o Web Studio

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

Exibir detalhes do catálogo

Use a função de pesquisa para localizar um catálogo de máquinas específico. Consulte Pesquisar instâncias para obter instruções.
Nos resultados da pesquisa, selecione um catálogo conforme necessário.
Consulte a tabela a seguir para obter descrições das colunas do catálogo.
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 a 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: Serviços de criação de máquinas (máquina MCS), Manual e Serviços de provisionamento Citrix™.
Contagem Alocada	O número de máquinas no catálogo atribuídas a um grupo de entrega.
Pasta	O local do catálogo na árvore Catálogos de Máquinas. Ele 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 VDA	Status da Atualização do 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

Adicionar máquinas a um catálogo

Antes de começar:

Certifique-se de que o host de virtualização 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:

Faça login no Web Studio.
Selecione Catálogos de Máquinas no painel esquerdo.
Selecione um catálogo de máquinas e, em seguida, selecione Adicionar máquinas na barra de ações.
Selecione o número de máquinas virtuais a serem adicionadas.
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-Sales-## (com 0-9 selecionado) resulta em contas de computador nomeadas PC-Sales-01, PC-Sales-02, PC-Sales-03 e assim por diante.
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 há 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 para 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.

Excluir máquinas de um catálogo

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:

Faça login no Web Studio.
Selecione Catálogos de Máquinas no painel esquerdo.
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.

Editar um catálogo

Na página Descrição, altere a descrição do catálogo.
Selecione Catálogos de Máquinas no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Editar Catálogo de Máquinas na barra de ações.
Na página Escopos, altere os escopos.
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 feitas se aplicam apenas às máquinas que você adicionar 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:
  - Somente os tamanhos de máquina suportados pelo catálogo são exibidos.
  - 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 atual da máquina, 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 da licença do Windows ou da licença do Linux.
Para catálogos de Acesso Remoto a 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.
Clique em Aplicar para aplicar as alterações feitas e clique em Salvar para sair.

Renomear um catálogo

Faça login no Web Studio.
Selecione Catálogos de Máquinas no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Renomear Catálogo de Máquinas na barra de ações.
Insira o novo nome.

Mover um catálogo para uma zona diferente

Se sua implantação tiver mais de uma zona, você pode 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.

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

Excluir um 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:

Faça login no Web Studio.
Selecione Catálogos de Máquinas no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Excluir Catálogo de Máquinas na barra de ações.
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.

Gerenciar contas de computador do Active Directory em um catálogo

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:

Faça login no Web Studio.
Selecione Catálogos de Máquinas no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Gerenciar contas AD na barra de ações.
Escolha se deseja adicionar ou excluir contas de computador. Se você adicionar contas, especifique o que fazer com as senhas das contas: redefina todas elas ou insira 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 quando você remove máquinas de um catálogo ou exclui um catálogo.

Atualizar 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. Reverta 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.

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.
Se necessário, ligue a imagem mestre e faça login.
Instale as atualizações ou faça as alterações necessárias na imagem mestre.
Desligue a VM.
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. Esse 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ê pode alterar a imagem mestre apenas 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:

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

Dica:

Para um catálogo criado pelo 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 ou não. 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 Visualizar histórico de notas.
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.
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.

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 atualmente, 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. Esse 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, reverter uma máquina inclui uma reinicialização.

Faça login no Web Studio.
Selecione Catálogos de Máquinas no painel esquerdo.
Selecione o catálogo e, em seguida, selecione Reverter Imagem Mestre na barra de ações.
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 imagem mestre nova ou atualizada 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 para um catálogo de máquinas:

Inicie as máquinas atualizadas para que elas se registrem no Controller. Esse 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:

Faça login no Web Studio.
Selecione Catálogos de Máquinas no painel esquerdo.
Selecione o catálogo. A guia Detalhes no painel inferior exibe informações da versão.
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.

Clonar um catálogo

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

Você não pode alterar as configurações associadas ao sistema operacional e ao gerenciamento de máquinas. O catálogo clonado herda essas configurações do original.
A clonagem de um catálogo pode levar algum tempo para ser concluída. 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.

Faça login no Web Studio e, em seguida, selecione Catálogos de Máquinas no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Clonar na barra de ações.
Na janela Clonar Catálogo de Máquinas Selecionado, visualize as configurações para o catálogo clonado e configure as configurações conforme aplicável. Selecione Avançar para prosseguir para a próxima página.
Na página Resumo, visualize um resumo das configurações e selecione Concluir para iniciar a clonagem.
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.

Criar uma pasta de catálogo

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 sob o 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
 
```

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

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

Dica:

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

Mover um catálogo

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

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

Dica:

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

Gerenciar pastas de catálogo

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

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

Para gerenciar uma pasta, siga as etapas abaixo:

Selecione Catálogos de Máquinas no painel esquerdo.
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.
Siga as instruções na tela para concluir as etapas restantes.

Usar o PowerShell

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

Recuperar avisos e erros associados a um catálogo

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 PowerShell, você pode:

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

Para executar os comandos PowerShell:

Abra uma janela do PowerShell.
Execute asnp citrix* para carregar os módulos 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 o parâmetro 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 uma 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 uma 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.

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
 
```

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 pelo 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:

Abra uma janela do PowerShell.
Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.
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
 
```
- 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
 
```
- Especifique uma única VM pelo nome:
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
 
```
- 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
 
```
Um prompt de confirmação aparece listando as VMs a serem redefinidas, juntamente 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 será tomada.

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
 
```
- Forneça o parâmetro -Confirm:$false:
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
 
```
- 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
 
```
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:

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

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

$NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
<!--NeedCopy-->

Execute Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap.
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 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
 
```
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
 
```

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
 
```
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 pelo MCS.
```
 Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15
 
```

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 açõ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 para 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) ou modelo de inicialização (no caso da AWS) como entrada de perfil de máquina para converter um catálogo de máquinas não baseado em perfil de máquina para um catálogo de máquinas baseado em perfil de máquina. 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:

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

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-->

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. Esta implementação é aplicável a catálogos de máquinas MCS persistentes e não persistentes.

Nota:

Atualmente, o recurso é suportado apenas para ambientes de virtualização Azure e VMware.

Condições

Certifique-se do 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:

Abra a janela do PowerShell.
Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.
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
 
```
  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: Destino para a ação de reparo. Pode ser IdentityInfo para reparar a senha da conta/chave de confiança, e UserCertificate para reparar os atributos do 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
 
```
```
 Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
 
```
- Para recriar completamente o disco de identidade:
```
 Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate
 
```
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

```
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 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:

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

Habilitar 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 do 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 no 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 o VDA 2311
Agente de Atualização do VDA para a versão 7.40.0.35 ou posterior (usando o instalador do 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 do 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 ingressado no domínio

Quando a máquina VDA é ingressada no 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 do 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 Compartilhamento de Arquivos e Impressoras.
Permissão de compartilhamento de arquivos não ingressado no domínio

Quando a máquina VDA não é ingressada no 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 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 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 do VDA de um compartilhamento de arquivos local

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

Nota:

Com o Virtual Upgrade Service, você pode selecionar entre a trilha Current Release ou a trilha LTSR.

Por exemplo: Se o catálogo de máquinas estiver definido como Current Release, 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 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 expansão Componentes que estão no ISO do produto, mas também empacotados separadamente.`
Selecione o instalador do VDA relevante com base no tipo de catálogo.
- Baixe o instalador do VDA do SO multi-sessão se o tipo de catálogo for multi-sessão
- Baixe o instalador do VDA do SO de sessão única se o tipo de catálogo for sessão única
- Baixe o instalador do VDA de Serviços Principais do SO de sessão única se o tipo de catálogo for Acesso Remoto a PC

Nota:

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

Solução de problemas

Para máquinas com status “Estado de Energia Desconhecido”, consulte CTX131267 para obter orientação.
Para corrigir VMs que exibem continuamente um estado de energia desconhecido, consulte Como corrigir VMs que exibem continuamente um estado de energia desconhecido.

Onde ir em seguida

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

A versão oficial deste conteúdo está em inglês. Parte do conteúdo da documentação da Cloud Software Group é traduzida automaticamente para sua conveniência. A Cloud Software Group não tem controle sobre o conteúdo traduzido automaticamente, que pode conter erros, imprecisões ou linguagem inadequada. Nenhuma garantia de qualquer tipo, expressa ou implícita, é fornecida quanto à precisão, confiabilidade, adequação ou correção de quaisquer traduções feitas do original em inglês para qualquer outro idioma, ou quanto à conformidade do seu produto ou serviço Cloud Software Group com qualquer conteúdo traduzido automaticamente, e nenhuma garantia fornecida sob o contrato de licença de usuário final aplicável ou os termos de serviço, ou qualquer outro contrato com a Cloud Software Group, de que o produto ou serviço esteja em conformidade com qualquer documentação será aplicável na medida em que essa documentação tenha sido traduzida automaticamente. A Cloud Software Group não se responsabiliza por quaisquer danos ou problemas que possam surgir em decorrência do uso de conteúdo traduzido automaticamente.

Isso foi útil?

Gerenciar catálogos de máquinas

January 23, 2026

Contribuição de:

January 23, 2026

Contribuição de:

Neste artigo

Introdução
Gerenciar catálogos de máquinas
Usar o Web Studio
Exibir detalhes do catálogo
Adicionar máquinas a um catálogo
Excluir máquinas de um catálogo
Editar um catálogo
Renomear um catálogo
Mover um catálogo para uma zona diferente
Excluir um catálogo
Gerenciar contas de computador do Active Directory em um catálogo
Atualizar um catálogo
Alterar o nível funcional ou desfazer a alteração
Clonar um catálogo
Organizar catálogos usando pastas
Usar o PowerShell
Recuperar avisos e erros associados a um catálogo
Adicionar descrições a uma imagem
Redefinir disco do SO
Alterar a configuração de rede para um esquema de provisionamento existente
Gerenciar versões de um catálogo de máquinas
Converter um catálogo de máquinas não baseado em perfil de máquina para um catálogo de máquinas baseado em perfil de máquina
Reparar as informações de identidade de contas de computador ativas
Alterar a configuração de cache em um catálogo de máquinas existente
Suporte à atualização do VDA via acesso a compartilhamento de arquivos local
Solução de problemas
Onde ir em seguida

Isso foi útil?