Citrix Virtual Apps and Desktops

Gerenciar catálogos de máquinas

January 24, 2025

Contribuição de:

Nota:

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

Introdução

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

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

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

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

Nota:

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

Sobre instâncias persistentes

Ao atualizar um catálogo MCS criado usando instâncias persistentes ou dedicadas, todas as novas máquinas criadas para o catálogo usam a imagem atualizada. As instâncias preexistentes continuam usando 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 os catálogos de discos permanentes, as máquinas preexistentes não são atualizadas para a nova imagem, mas todas as novas máquinas adicionadas ao catálogo usam a nova imagem.
Para catálogos de discos não permanentes, a imagem da máquina é atualizada na próxima vez em que a máquina for reinicializada.
Com catálogos de máquinas persistentes, a atualização da imagem também atualiza as instâncias do catálogo que a usam.
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

Use 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 esse 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 para um usuário aleatoriamente. Permanente: As máquinas no catálogo são alocadas permanentemente para um usuário.


Tipo de máquina	O tipo de sessão suportado das máquinas no catálogo. Os valores possíveis incluem: Tipo de sistema operacional: sistema operacional multissessão (virtual); Dados do usuário: Descartar. Tipo de sistema operacional: sistema operacional multissessão (virtual); Dados do usuário: No disco local Tipo de sistema operacional: sistema operacional de sessão única (acesso remoto ao PC) Tipo de sistema operacional: sistema operacional de sessão única (virtual); Dados do usuário: descartar Tipo de sistema operacional: sistema operacional 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), serviços manuais e de provisionamento 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 na árvore Machine Catalogs . 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, Preparação

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.
Verifique se você tem 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ê usa o Web Studio para criar contas de computador do Active Directory para as máquinas adicionais, você deve ter a permissão apropriada de administrador de domínio.

Para adicionar máquinas a um catálogo:

Faça login no Web Studio.
Selecione Machine Catalogs no painel esquerdo.
Selecione um catálogo de máquinas e, em seguida, 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 existentes do Active Directory suficientes para o número de VMs que você está adicionando, selecione o domínio e o local em que as contas serão criadas. Especifique um esquema de nomenclatura de contas usando marcas de hash para indicar onde os números ou letras sequenciais aparecem. 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 denominadas PC-Sales-01, PC-Sales-02, PC-Sales-03 e assim por diante.
Se você usa contas existentes do Active Directory, navegue até as contas ou clique em Importar e especifique um arquivo.csv contendo nomes de contas. Verifique se 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 de todas as contas ou especifique a senha da conta, que deve ser a mesma para todas as contas.

As máquinas são criadas como um processo em segundo plano e podem levar muito tempo na criação de 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 poderão mais acessá-la. Portanto, antes de excluir uma máquina, certifique-se de que:

Os dados do usuário são 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 Machine Catalogs no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Exibir máquinas na barra de ação.
Selecione uma ou mais máquinas e, em seguida, 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 foram mantidas, desativadas ou excluídas.

Editar um catálogo

Na página Descrição , altere a descrição do catálogo.
Selecione Machine Catalogs no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Editar catálogo de máquinas na barra de ação.
Na página Scopes , 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 páginas a seguir estão visíveis. Lembre-se de que as alterações feitas se aplicam somente às máquinas adicionadas posteriormente ao catálogo. As máquinas existentes permanecem inalteradas.
- Na página Virtual Machines , altere o tamanho da máquina e as zonas de disponibilidade em que você deseja criar máquinas.
  Nota:
  - Somente os tamanhos de máquina que o catálogo suporta são mostrados.
  - Se necessário, selecione Mostrar somente 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).
Nota:

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 Virtual Machines , 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 do Remote PC Access, as seguintes páginas estão visíveis:
- On the Power Management page, change the power management settings and select a power management connection.
- Na página Organizational Units , 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 Machine Catalogs no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Renomear catálogo de máquinas na barra de ação.
Insira o novo nome.

Mover um catálogo para uma zona diferente

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

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

Faça login no Web Studio.
Selecione Machine Catalogs no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Move na barra de ação.
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 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 do 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 Machine Catalogs no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Excluir catálogo de máquinas na barra de ação.
Indique se as máquinas no catálogo foram excluídas. Se você optar por excluir as máquinas, indique se as contas de computador do Active Directory para essas máquinas foram mantidas, desativadas 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:

Libere contas de máquina não utilizadas removendo contas de computador do Active Directory dos catálogos de sistemas operacionais de sessão única e sistemas operacionais de várias sessões. 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 em vigor. Não use uma barra (/) em um nome de OU.

Para gerenciar contas do Active Directory:

Faça login no Web Studio.
Selecione Machine Catalogs no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Gerenciar contas do AD na barra de ação.
Escolha se deseja adicionar ou excluir contas de computador. Se você adicionar contas, especifique o que fazer com as senhas da conta: redefina-as todas ou insira uma senha que se aplique a todas as contas.

Você pode redefinir as senhas se não souber as senhas atuais da conta; você deve ter permissão para realizar 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 retidas, desativadas 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 mestras antes de atualizar as máquinas no catálogo. O banco de dados mantém um registro histórico das imagens mestras usadas em cada catálogo de máquinas. Reverta ou reverta máquinas em um catálogo para usar a versão anterior da imagem mestre. Execute essa 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 mestras. Você não pode reverter um catálogo para usá-los.

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

Atualizar ou criar uma imagem mestre

Antes de atualizar o catálogo da máquina, 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. Esse instantâneo pode ser usado para reverter (reverter) 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 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 mestras de GPU, você pode alterar a imagem mestre somente por meio do console XenServer.

Alterar a imagem mestre

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

Faça login no Web Studio.
Selecione Machine Catalogs no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Alterar imagem mestre na barra de ação.
Na página Image , 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 à imagem. Uma nota pode conter até 500 caracteres. Sempre que você altera a imagem mestre, uma entrada relacionada à nota é criada se 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 Rollout Strategy , 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 Rollout Strategy não está disponível para VMs persistentes porque a implantação só é aplicável a VMs não persistentes.
Verifique as informações na página Summary e clique em Finish. Cada máquina é reiniciada automaticamente após a atualização.

Para acompanhar o progresso da atualização, localize o catálogo em Machine Catalogs para ver a barra de progresso embutida e o gráfico de progresso passo a passo.

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

Estratégia de lançamento:

A atualização de imagens no próximo desligamento afetará imediatamente qualquer máquina que não esteja em uso no momento, ou seja, máquinas que não tenham uma sessão de usuário ativa. Um sistema que está 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 sistema operacional 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 sistema operacional multissessão com máquinas secundárias, as reinicializações não ocorrem automaticamente. Para aplicar a imagem mestre atualizada, reinicie as máquinas usando o Studio, o PowerShell ou o 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 tomadas em um determinado catálogo; as configurações avançadas variam de acordo com o 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 em funcionamento. Quaisquer novos recursos que exijam a imagem mais recente não estão mais disponíveis. Assim como na implantação, a reversão de uma máquina inclui uma reinicialização.

Faça login no Web Studio.
Selecione Machine Catalogs no painel esquerdo.
Selecione o catálogo e, em seguida, selecione Roll Back Master Image 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 implantação.

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

Para acompanhar o progresso da reversão, localize o catálogo em Machine Catalogs para ver 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áquinas:

Inicie as máquinas atualizadas para que elas se registrem no Controller. Esse processo permite que o Web Studio determine se as máquinas no catálogo precisam ser atualizadas.

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

Faça login no Web Studio.
Selecione Machine Catalogs no painel esquerdo.
Selecione o catálogo. A guia Details no painel inferior exibe informações sobre a 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 explica o porquê. 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 continuar.

Depois que a alteração do catálogo for concluída, você poderá reverter as máquinas para suas versões anteriores do VDA selecionando o catálogo e selecionando Undo Functional Level Change na barra de ação.

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 machine management. 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.

Entre no Web Studio e selecione Machine Catalogs no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Clone na barra de ação.
Na janela Clone Selected Machine Catalog , visualize as configurações do catálogo clonado e defina-as conforme aplicável. Selecione Próximo para prosseguir para a próxima página.
Na página Summary , veja um resumo das configurações e selecione Finish 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, primeiro planeje como organizar seus catálogos. Considere o seguinte:

Você pode aninhar pastas com 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 os nós Machine Catalogs e Applications ) compartilham uma árvore de pastas no backend. Para evitar conflitos de nomes com outros nós ao renomear ou mover pastas, recomendamos que você dê nomes diferentes às pastas de primeiro nível em nós diferentes.

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

Selecione Machine Catalogs no painel esquerdo.
Na hierarquia de pastas, selecione uma pasta e, em seguida, selecione Criar pasta na barra Action .
Insira um nome para a nova pasta e clique em Concluído.

Dica:

Se você criar uma pasta em um local não desejado, 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 Machine Catalogs no painel esquerdo.
Visualize os catálogos por pasta. Você também pode ativar Exibir todos os acima da hierarquia de pastas para visualizar todos os catálogos ao mesmo tempo.
Clique com o botão direito do mouse em um catálogo e selecione Move Machine Catalog.
Selecione a pasta para a qual você deseja mover o catálogo e clique em Concluído.

Dica:

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

Gerenciar pastas de catálogos

Você pode excluir, renomear e mover pastas do 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 Machine Catalogs 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 Move Folder.
Siga as instruções na tela para concluir as etapas restantes.

Use o PowerShell

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

Recupere 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 os comandos do PowerShell, você pode:

Obtenha uma lista de erros ou avisos
Altere 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 da Citrix.

Para obter uma lista de erros e avisos:

Execute o comando Get-ProOperationEvent .

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 esse ID de evento
Com o parâmetro Filter : Obtém erros ou avisos por filtro personalizado

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

Execute o comando Confirm-ProOperationEvent .

Com o parâmetro EventID : define o estado de um erro ou aviso específico que corresponde a esse ID de evento. Você pode obter o EventID de um erro ou aviso específico como saída do comando Get-ProOperationEvent
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-ProOperationEvent .

Com o parâmetro EventID : remove um erro ou aviso específico que corresponde a esse ID de evento. Você pode obter o EventID de um erro ou aviso específico como saída do comando Get-ProOperationEvent
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 às atualizações de imagens para catálogos de máquinas. Use esse 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 comandos a seguir para adicionar ou visualizar descrições de imagens:

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

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

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

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

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

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

Para acompanhar o progresso da reversão, localize o catálogo em Machine Catalogs para ver a barra de progresso em linha e o gráfico de progresso passo a passo.

Você não pode reverter em determinados cenários, incluindo os seguintes. (A opção Roll Back Master Image 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 do catálogo estão funcionando.

Redefinir 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áquinas criado pelo MCS. Atualmente, esse recurso é aplicável ao AWS, Azure, XenServer e Google Cloud. Ambientes de virtualização SCVMM e VMware.

Para executar com êxito o comando do PowerShell, 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 que o esquema de provisionamento tem entradas corretas.
O hipervisor não está no 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 da 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 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 e verificação de conexão para cada VM.
```
   Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
 
```
É exibido um prompt de confirmação que lista as VMs a serem redefinidas junto com uma mensagem de aviso de que é uma operação irrecuperável. Se você não fornecer uma resposta e pressionar Enter, nenhuma ação adicional será realizada.

Nota:

Não tire 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 ela executaria e sair sem executar a ação.

Você também pode ignorar o aviso 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.

Nota:

Esse recurso é suportado no 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 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. Em seguida, você pode gerenciar as várias versões do catálogo de máquinas usando os 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 de máquinas
Exclua manualmente uma versão se ela não for usada por uma VM desse catálogo de máquinas
Altere 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:

Contagem de CPUs do VMC
Memória VM MB
Propriedades personalizadas
Oferta de serviços
Perfil da máquina
Mapeamento de rede
Grupo de segurança

Execute os comandos a seguir (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 em todos os catálogos. Por exemplo, nesse caso, no máximo 15 versões serão mantidas 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 as versões mais antigas estiverem sendo usadas por qualquer uma das VMs no catálogo de máquinas. Nesse caso, faça o seguinte:

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 VMs e possam ser excluídas.

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

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

Nota:

Um catálogo de máquinas existente baseado em perfil de máquina não pode ser alterado para um catálogo de máquinas que não seja 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 PowerShell .

Execute o comando Set-provScheme para aplicar os valores das propriedades do perfil da máquina às novas VMs adicionadas ao catálogo da máquina. Por exemplo:

No caso do Azure:

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

No caso da AWS:

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

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

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

Nota:

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

Condições

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

Desligue e defina a VM para o 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 da Citrix.
Redefina as informações de identidade.
- Para redefinir somente 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.
  - Alvo: Alvo para a ação de reparo. Pode ser o IdentityInfo para reparar a senha/chave de confiança da conta e o UserCertificate para reparar os atributos do certificado do usuário das identidades de máquinas unidas do 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 ignorar a solicitação 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 o IdentityDiskIndex não devem ser alterados.

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

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

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

Atualmente, esse recurso é 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).

Ative 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 ativado. 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-->

Nota:

O valor de writebackCacheDiskSize deve ser maior que zero porque é necessário pelo menos 1 GB de armazenamento em disco 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 as novas VMs adicionadas ao catálogo após a alteração ser feita. As VMs existentes não são afetadas por essas mudanças.

Suporte de atualização de VDA por meio de acesso ao compartilhamento de arquivos local

Especifique a localização do instalador do VDA por meio dos cmdlets do PowerShell, o que reduz seu esforço de fornecer regras de rede para permitir que cada VDA busque o novo instalador de 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 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

VUS Agent Installer que vem com o VDA 2311
Agente de upgrade do VDA para a versão 7.40.0.35 ou posterior (usando o instalador do VDA versão 2311 ou posterior)
Aplicativos e desktops virtuais Remote PowerShell SDK 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 contendo pacotes do instalador de VDA devem ter acesso de leitura para o serviço VDA Upgrade Agent, que é executado como Sistema Local (NT AUTHORITY\ SYSTEM principal).

Permissão de compartilhamento de arquivos associados a um domínio

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

A permissão de privilégio mínimo pode ser definida concedendo ao Read o acesso aos computadores do domínio.
1. Escolha as pessoas da 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 arquivos não vinculados ao domínio

Quando a máquina VDA não está associada ao domínio, a conta Local System (o VUA é executado como Sistema Local) usa ANONYMOUS LOGON ao acessar compartilhamentos de rede.
1. Selecione uma pasta compartilhada.
2. Desative 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 compartilhamento Read para ANONYMOUS LOGON.
4. Selecione a guia Security Tab 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 ANONYMOUS LOGON.
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 de VDA a partir 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 faixa Current Release ou a faixa LTSR.

Por exemplo: Se o catálogo da máquina estiver definido como Versão atual 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 produto.
3. Selecione Citrix Virtual Apps and Desktops 7 2311, todas as edições.
4. Selecione o instalador de VDA entre os componentes que estão na ISO do produto, mas também são embalados separadamente expansíveis.
Selecione o instalador de VDA relevante com base no tipo de catálogo.
- Baixe o instalador VDA com sistema operacional multissessão ** se o tipo de catálogo for **multissessão
- Baixe o instalador VDA de OS de sessão única se o tipo de catálogo for sessão única
- Baixe o instalador VDA Single-session OS Core Services se o tipo de catálogo for Remote PC Access

Nota:

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

Solucionar problemas

Para máquinas com o 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

January 24, 2025

Contribuição de:

January 24, 2025

Contribuição de:

Neste artigo

Introdução
Gerenciar catálogos de máquinas
Use 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
Organize catálogos usando pastas
Use o PowerShell
Recupere avisos e erros associados a um catálogo
Adicionar descrições a uma imagem
Redefinir 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áquinas não baseado em perfil de máquina em catálogo de máquinas baseado em perfil de máquina
Reparar as informações de identidade das contas de computador ativas
Alterar a configuração do cache em um catálogo de máquinas existente
Suporte de atualização de VDA por meio de acesso ao compartilhamento de arquivos local
Solucionar problemas
Para onde ir a seguir

Isso foi útil?