Citrix Virtual Apps and Desktops

Gerenciar catálogos de máquinas

May 7, 2025

Contribuição de:

Observação:

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 abrange 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 contas de computador do Active Directory de um catálogo.

Manter catálogos também pode incluir garantir 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 contendo máquinas aleatórias agrupadas criadas usando os Serviços de Criação de Máquina (MCS) mantêm máquinas atualizando a imagem mestre usada no catálogo e, em seguida, atualizando as máquinas. Este 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 a PC, você gerencia atualizações nas máquinas dos usuários fora do Web Studio. Execute esta 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.

Observação:

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. 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 discos 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 discos não persistentes, a imagem da máquina será atualizada na próxima vez que a máquina for reinicializada.
Com catálogos de máquina 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áquina de duas maneiras:

Usando o Web Studio
Usando o PowerShell

Use o Web Studio

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

Ver detalhes do catálogo

Use a função de pesquisa para localizar um catálogo de máquina 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 aba 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 pelas máquinas no catálogo. Os valores possíveis incluem Tipo de SO: SO multissessão (virtual); Dados do usuário: Descartar. Tipo de SO: SO multissessão (virtual); Dados do usuário: No disco local Tipo de SO: SO de sessão única (acesso remoto ao 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áquina (máquina MCS), serviços de provisionamento manual e Citrix.
Contagem alocada	O número de máquinas no catálogo atribuídas a um grupo de entrega.
Pasta	A localização do catálogo dentro da á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 do VDA	Estado de 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 somente 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 suficientes não utilizadas. Se você estiver usando contas existentes, o número de máquinas que você pode adicionar será limitado pelo número de contas disponíveis.
Se você usar o Web Studio para criar contas de computador do Active Directory para máquinas adicionais, será necessário ter a permissão apropriada de administrador de domínio.

Para adicionar máquinas a um catálogo:

Entre no Web Studio.
Selecione Catálogos de máquinas no painel esquerdo.
Selecione um catálogo de máquinas e então selecione Adicionar máquinas na barra de ação.
Selecione o número de máquinas virtuais a serem adicionadas.
Se não houver contas do Active Directory suficientes para o número de VMs que você está adicionando, selecione o domínio e o local onde as contas serão criadas. Especifique um esquema de nomenclatura de conta, usando marcas de hash para indicar onde números ou letras sequenciais aparecem. Não use barra (/) no nome de uma UO. 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 chamadas PC-Sales-01, PC-Sales-02, PC-Sales-03 e assim por diante.
Se você usar contas existentes do Active Directory, 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 pode 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

Após excluir uma máquina de um catálogo de máquinas, os usuários não poderão 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:

Entre no Web Studio.
Selecione Catálogos de máquinas no painel esquerdo.
Selecione um catálogo e então selecione Exibir Máquinas na barra de ação.
Selecione uma ou mais máquinas e então selecione Excluir na barra de ação.

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 serã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 então selecione Editar Catálogo de Máquina na barra de ação.
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 ficam visíveis. Tenha em mente que as alterações feitas se aplicam somente à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.
  Observação:
  - Somente os tamanhos de máquina suportados pelo catálogo são mostrados.
  - Se necessário, selecione Mostrar apenas tamanhos de máquinas usados em outros catálogos de máquinas para filtrar a lista de tamanhos de máquinas.
- On the Machine Profile page, choose whether to use or change a machine profile.
- (Visible only when the catalog is configured with a dedicated group host) On the Dedicated host group page, choose whether to change a host group.
- On the Storage and License Types page, choose whether to change the storage type, license type, and Azure Computer Gallery settings (available only when Place prepared image in Azure Gallery is in use).
Observação:

Se a configuração recém-selecionada não suportar o tamanho atual da máquina, uma caixa de diálogo de aviso será exibida, 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.
- On the License Type page, choose whether to change the Windows license or Linux license setting.
Para catálogos de acesso remoto a PC, as seguintes páginas são visíveis:
- On the Power Management page, change the power management settings and select a power management connection.
- Na página Unidades Organizacionais , adicione ou remova UOs do Active Directory.
Clique em Aplicar para aplicar as alterações feitas e clique em Salvar para sair.

Renomear um catálogo

Entre no Web Studio.
Selecione Catálogos de máquinas no painel esquerdo.
Selecione um catálogo e então selecione Renomear Catálogo de Máquina na barra de ação.
Digite 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 do hipervisor que contém as VMs nesse catálogo afeta o desempenho.

Entre no Web Studio.
Selecione Catálogos de máquinas no painel esquerdo.
Selecione um catálogo e então selecione Mover na barra de ação.
Selecione a zona para onde você deseja mover o catálogo.

Excluir um catálogo

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

Todos os usuários são desconectados e você não executa nenhuma sessão desconectada.
O modo de manutenção é 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:

Entre no Web Studio.
Selecione Catálogos de máquinas no painel esquerdo.
Selecione um catálogo e então selecione Excluir catálogo de máquina na barra de ação.
Indique se as máquinas no catálogo serão excluídas. Se você optar por excluir as máquinas, indique se as contas de computador do Active Directory para essas máquinas serão mantidas, 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áquina, você pode:

Libere contas de máquinas não utilizadas removendo contas de computadores do Active Directory de catálogos de sistemas operacionais de sessão única e multissessão. Essas contas podem então ser usadas para outras máquinas.
Adicione contas para que, quando mais máquinas forem adicionadas ao catálogo, as contas de computador já estejam definidas. Não use barra (/) no nome de uma UO.

Para gerenciar contas do Active Directory:

Entre no Web Studio.
Selecione Catálogos de máquinas no painel esquerdo.
Selecione um catálogo e depois selecione Gerenciar contas do 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 caso não saiba as senhas atuais da conta; você precisa ter permissão para executar uma redefinição de senha. Ao inserir uma senha, a senha é alterada nas contas à medida que elas são importadas. Ao excluir uma conta, escolha se a conta no Active Directory será mantida, desativada ou excluída.

Indique se as contas do Active Directory são mantidas, 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 das imagens principais antes de atualizar as máquinas no catálogo. O banco de dados mantém um registro histórico das imagens mestras usadas com cada catálogo de máquina. Reverta ou reverta 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 as imagens mestres. Você não pode reverter um catálogo para usá-los.

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

Atualizar ou criar uma imagem mestre

Antes de atualizar o catálogo da máquina, atualize uma imagem mestre existente ou crie uma no seu hipervisor do host.

No seu hipervisor, tire um instantâneo da VM atual e dê a ele um nome significativo. Este instantâneo pode ser usado para reverter (rollback) máquinas no catálogo, se necessário.
Se necessário, ligue a imagem mestre e faça login.
Instale atualizações ou faça as alterações necessárias na imagem mestre.
Desligue a VM.
Tire um snapshot 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 snapshot, 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 da GPU, você pode alterar a imagem mestre somente por meio do console do XenServer.

Alterar a imagem mestre

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

Entre no Web Studio.
Selecione Catálogos de máquinas no painel esquerdo.
Selecione um catálogo e então selecione Alterar imagem mestre na barra de ação.
Na página Imagem , selecione o host e a imagem que você deseja lançar. > 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, independentemente de você adicionar 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.
Na página Estratégia de implementação , escolha quando as máquinas no catálogo de máquinas serão atualizadas com a nova imagem mestre: no próximo desligamento ou imediatamente. > Nota: > > A página Estratégia de implementação não está disponível para VMs persistentes porque a implementação só é aplicável a VMs não persistentes.
Verifique as informações na página Resumo e 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 a um instantâneo de uma imagem.

Estratégia de implementação:

Atualizar imagens no próximo desligamento afetará imediatamente todas as máquinas que não estiverem em uso no momento, ou seja, máquinas que não tenham 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 com SO de sessão única, as máquinas são atualizadas imediatamente quando não estão em uso ou quando os usuários não estão conectados.
Para um sistema operacional multissessã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. Reiniciar a partir das máquinas ou do hipervisor não aplica a atualização.

Dica:

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

Reverter a imagem mestre

Depois de lançar 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. Quando você reverte, as máquinas no catálogo são revertidas para a última imagem de trabalho. Quaisquer novos recursos que exijam a imagem mais recente não estão mais disponíveis. Assim como na implementação, reverter uma máquina inclui uma reinicialização.

Entre no Web Studio.
Selecione Catálogos de máquinas no painel esquerdo.
Selecione o catálogo e então selecione Reverter imagem mestre na barra de ação.
Especifique quando aplicar a imagem mestre anterior às máquinas, conforme descrito na seção anterior para a operação de implementação.

A reversão é aplicada somente às máquinas que precisam ser revertidas. Máquinas que não são atualizadas com a imagem mestra 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.

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

Altere o nível funcional do 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áquina:

Inicie as máquinas atualizadas para que elas sejam registradas no Controlador. Este processo permite que o Web Studio determine que as máquinas no catálogo precisam ser atualizadas.

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

Entre no Web Studio.
Selecione Catálogos de máquinas no painel esquerdo.
Selecione o catálogo. A aba 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 ser atualizado, 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 da máquina . 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 um sufixo Cópia. Você pode alterar o nome. Veja Renomear um catálogo.
Após a conclusão da clonagem, certifique-se de atribuir o catálogo clonado a um grupo de entrega.

Entre no Web Studio e selecione Catálogos de Máquinas no painel esquerdo.
Selecione um catálogo e então selecione Clonar na barra de ação.
Na janela Clonar catálogo de máquina selecionado , visualize as configurações do catálogo clonado e defina as configurações conforme aplicável. Selecione Próximo 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.

Organize catálogos usando pastas

Você pode criar pastas para organizar catálogos e 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 primeiro 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, Aplicativose 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 nós diferentes.

Se você criar uma pasta usando o cmdlet New-BrokerAdminFolder SDK e quiser que ela apareça no nó Machine Catalogs , 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 então selecione Criar Pasta na barra Ação .
Digite um nome para a nova pasta e clique em Concluído.

Dica:

Se você criar uma pasta em um local não pretendido, 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.
Ver 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.
Clique com o botão direito do mouse em um catálogo e selecione Mover catálogo de máquina.
Selecione a pasta para a qual deseja mover o catálogo e clique em Concluído.

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 os passos 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 Ação 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 históricos e avisos para entender problemas com seu catálogo de máquina MCS e corrigi-los.

Usando comandos do PowerShell, você pode:

Obtenha uma lista de erros ou avisos
Alterar o estado de aviso de Novo para Reconhecido
Exclua os erros ou avisos

Para executar os comandos do PowerShell:

Abra uma janela do PowerShell.
Execute asnp citrix* para carregar os módulos PowerShell específicos do 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 Filtro : 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 Todos : Define o estado de todos os erros e avisos como Reconhecidos

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 parâmetro Todos : 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 imagens 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 imagens:

Para adicionar uma nota ao criar um catálogo de máquina 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áquina, 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.

Não é possível 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 sistema operacional.
O instantâneo usado para criar o catálogo foi corrompido.
As alterações do usuário nas máquinas no catálogo não persistem.
As máquinas no catálogo estão em execução.

Redefinir o disco do sistema operacional

Use o comando do PowerShell Reset-ProvVMDisk para redefinir o disco do sistema operacional de uma VM persistente em um catálogo de máquina criado pelo MCS. Atualmente, esse recurso é aplicável ao AWS, Azure, XenServer e Google Cloud. SCVMM e ambientes de virtualização VMware.

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

As VMs de destino estão em um catálogo MCS persistente.
O catálogo da máquina 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 sistema operacional:

Abra uma janela do PowerShell.
Execute asnp citrix* para carregar os módulos PowerShell específicos do Citrix.
Execute o comando do PowerShell Reset-ProvVMDisk de qualquer 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 por 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 e verificação de conexão para cada VM.
```
   Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
 
```
Um prompt de confirmação é exibido 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 outra ação será realizada.

Observação:

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

Você pode executar o comando do PowerShell -WhatIf para imprimir a ação que ele executaria 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 de 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.

Observação:

Este recurso é compatível com o Citrix Virtual Apps and Desktops 2203 LTSR CU3 e versões posteriores.

Para alterar a configuração de rede de 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 chegar ao 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 "nome" -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áquina 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:

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

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

Contagem VMCpu
VMMemoryMB
Propriedades personalizadas
Oferta de serviço
Perfil da Máquina
Mapeamento de rede
Grupo de Segurança

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

Para ver os detalhes de configuração das várias versões de um catálogo de máquina:
```
   Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog
 
```

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

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

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

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

Para usar qualquer versão anterior para atualizar o catálogo da máquina:

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

Para excluir manualmente uma versão se ela não for usada por uma VM do catálogo daquela máquina:
```
   Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3
 
```
Para definir o número máximo de versões a serem retidas pelo catálogo da máquina (o padrão é 99). Esta 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 qualquer uma das VMs no catálogo de máquinas. Nesse caso, faça um dos seguintes:

Aumentar o limite do número máximo de versões a serem retidas pelo catálogo da máquina.
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áquina não baseado em perfil de máquina em um catálogo de máquina baseado em perfil de máquina

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

Observação:

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áquina persistente ou não persistente com VMs e sem um perfil de máquina.
Abra a janela 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 tenham 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.

Observação:

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

Condições

Certifique-se do seguinte para redefinir com sucesso o disco de identidade:

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

Redefinir disco de identidade

Para redefinir o disco de identidade:

Abra a janela PowerShell .
Execute asnp citrix* para carregar os módulos PowerShell específicos do Citrix.
Redefinir 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 utilizados no comando são os seguintes:
  - 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.
  - Alvo: Alvo da ação de reparo. Pode ser IdentityInfo para reparar senha de conta/chave de confiança e UserCertificate para reparar atributos de certificado de usuário de identidades de máquina associadas ao Hybrid AzureAD.
- Para redefinir todas as configurações 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 pular 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 do disco de identidade atualizada. Os atributos do disco de identidade (por exemplo, IdentityDiskId) devem ser atualizados. O StorageId e o IdentityDiskIndex não devem ser alterados.

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

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

Tamanho da memória do WriteBackCache
Tamanho do disco do cache de gravação

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 do 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áquina existente. Use New-ProvScheme para criar um catálogo de máquina 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 do cache

Execute o comando Set-ProvScheme. Por exemplo:

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

Observação:

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 da máquina.

Essas alterações afetam somente novas VMs adicionadas ao catálogo após a alteração ser feita. As VMs existentes não são afetadas por essas alterações.

Suporte de atualização do VDA via acesso ao compartilhamento de arquivos local

Especifique o local do instalador do VDA por meio de cmdlets do PowerShell, o que reduz o esforço de fornecer regras de rede para permitir que cada VDA 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 que você use instaladores de um compartilhamento de arquivos local

VdaWorkstationPackageUri - para especificar o caminho UNC para o instalador VDA do sistema operacional da estação de trabalho
VdaServerPackageUri - para especificar o caminho UNC para o instalador VDA do sistema operacional 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)
Virtual Apps and Desktops Remote PowerShell SDK versão 7.40 ou mais recente (lançado em 10 de janeiro de 2024 ou posteriormente)

Como definir permissões de compartilhamento de arquivos

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

Permissão de compartilhamento de arquivos associados ao domínio

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

A permissão de privilégio mínimo pode ser definida concedendo ao acesso de Leitura aos Computadores do Domínio.
1. Escolha as pessoas na sua rede com quem você deseja compartilhar o arquivo.
2. Clique em Configurações avançadas de compartilhamento e ative Compartilhamento de arquivos e impressoras.
Permissão de compartilhamento de arquivo não associado ao domínio

Quando a máquina VDA não está associada a um domínio, a conta Sistema Local (o VUA é executado como Sistema Local) usa LOGON ANÔNIMO ao acessar compartilhamentos de rede.
1. Selecione uma pasta compartilhada.
2. Desabilite a proteção por senha.
  1. Vá para a pasta Propriedades.
  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 Leitura compartilhamento 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 para LOGON ANÔNIMO.
5. Clique em Avançado para ativar Compartilhamento de arquivos e impressoras.
6. Adicione o nome da pasta compartilhada em Política de Segurança de Acesso à Rede.
Observação:

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.

Observação:

Com o Virtual Upgrade Service, você pode selecionar entre o controle de versão atual ou o controle LTSR.

Por exemplo: Se o catálogo da máquina estiver definido como Versão atual, que é 2311, e a versão do VDA for 2305, você deverá 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 VDA entre os Componentes que estão no ISO do produto, mas também são empacotados separadamente expansíveis.
Selecione o instalador VDA relevante com base no tipo de catálogo.
- Baixe o instalador Multi-session OS VDA se o tipo de catálogo for multi-sessão
- Baixe o instalador Single-session OS VDA se o tipo de catálogo for single-session
- Baixe o instalador Single-session OS Core Services VDA se o tipo de catálogo for Remote PC Access

Observação:

A versão do instalador de compartilhamento de arquivos deve exatamente corresponder à versão mais recente do instalador 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 mostram continuamente um estado de energia desconhecido, consulte Como corrigir VMs que mostram continuamente um estado de energia desconhecido.

Para onde ir a seguir

Para obter informações sobre como gerenciar catálogos específicos de serviços em nuvem, 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

May 7, 2025

Contribuição de:

May 7, 2025

Contribuição de:

Neste artigo

Introdução
Gerenciar catálogos de máquinas
Use o Web Studio
Ver 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
Organize catálogos usando pastas
Usar o PowerShell
Recuperar avisos e erros associados a um catálogo
Adicionar descrições a uma imagem
Redefinir o disco do sistema operacional
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áquina não baseado em perfil de máquina em um catálogo de máquina 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áquina existente
Suporte de atualização do VDA via acesso ao compartilhamento de arquivos local
Solução de problemas
Para onde ir a seguir

Isso foi útil?