Gerenciar catálogos de máquinas

Observação:

Este artigo descreve como gerenciar catálogos usando comandos do Studio e do PowerShell. Se você criou o catálogo usando o nó Implantação Rápida e continua usando esse nó para gerenciar o catálogo, siga Gerenciar catálogos no Quick Deploy.

Introdução

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

A manutenção do catálogo também pode incluir as tarefas de garantir que cada computador tenha as atualizações mais recentes do sistema operacional, atualizações de software antivírus, atualizações do sistema operacional ou alterações de configuração.

• Os catálogos que contêm máquinas aleatórias agrupadas criadas usando o Machine Creation Services (MCS) mantêm as máquinas atualizando a imagem usada no catálogo e, em seguida, atualizando as máquinas. Esse método permite atualizar um grande número de computadores de usuário com eficiência.
• Para catálogos que contêm máquinas estáticas atribuídas permanentemente, você pode gerenciar a imagem ou o modelo que esses catálogos usam atualmente, mas somente as máquinas adicionadas aos catálogos posteriormente são criadas usando a nova imagem ou modelo.
• Para catálogos do Remote PC Access, você gerencia atualizações para as máquinas dos usuários fora do 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 e serviços de nuvem, consulte Criar e gerenciar conexões e recursos.

Observação:

O MCS não dá 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 a imagem mestre de um catálogo do MCS que contém máquinas persistentes, todas as novas máquinas adicionadas ao catálogo usam a imagem atualizada. As máquinas existentes continuam a usar a imagem mestre original. O processo de atualização de uma imagem é feito da mesma forma para qualquer outro tipo de catálogo. Considere o seguinte:

• Com catálogos de disco permanente, as máquinas pré-existentes não são atualizadas para a nova imagem, mas todas as novas máquinas adicionadas ao catálogo usam a nova imagem.
• Para catálogos de disco não permanente, a imagem do computador será atualizada na próxima vez somente se o computador for reiniciado no Studio ou no PowerShell. Se a máquina for reiniciada a partir do hipervisor fora do Studio, o disco não será redefinido.
• Para catálogos que não persistem, se você quiser imagens diferentes para máquinas diferentes, as imagens deverão 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 Studio
• Usando o PowerShell

Usar o Studio

Esta seção detalha como você pode gerenciar catálogos usando o 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
• Excluir um catálogo
• Gerenciar contas de computador do Active Directory em um catálogo
• Alterar a imagem mestra de um catálogo
• Alterar o nível funcional ou desfazer a alteração
• Clonar um catálogo
• Organize catálogos usando pastas
• Atualizar VDAs
• Gerenciar conjunto de configurações para um catálogo
• Repetir a criação do catálogo
• (Somente VDAs não provisionados pela Citrix) Gerar e gerenciar tokens de registro

Ver detalhes do catálogo

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

Adicionar máquinas a um catálogo

Antes de começar:

• Certifique-se de que o host de virtualização (hipervisor ou provedor de serviços de nuvem) 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ê usar o Studio para criar contas de computador do Active Directory para as máquinas adicionais, deverá ter a permissão de administrador de domínio apropriada.

Dica:

Se a conta Citrix DaaS usada para adicionar máquinas ao catálogo de máquinas tiver permissões restritas do AD, adicione todos os Cloud Connectors que você pretende usar no Faça login em.. tela.

Para adicionar máquinas a um catálogo:

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione um catálogo de máquinas e, em seguida, selecione Adicionar máquinas na barra de ação.
3. No Máquinas Virtuais , selecione o número de máquinas virtuais a serem adicionadas.

4. No Identidades de máquina , defina as configurações da seguinte maneira:

   • Selecione uma identidade na lista.

   • Se aplicável, indique se deseja criar contas ou usar as existentes e o local (domínio) dessas contas.

     Se não houver contas do Active Directory existentes suficientes para o número de VMs que você está adicionando, selecione o domínio e o local em que as contas são criadas.

     Se você usar contas existentes do Active Directory, navegue até as contas ou selecione Importação e especifique um .csv Arquivo contendo nomes de contas. Verifique se há contas suficientes para todas as máquinas que você está adicionando. O Studio gerencia essas contas. Permita que essa interface redefina as senhas de todas as contas ou especifique a senha da conta, que deve ser a mesma para todas as contas.

   • Se esse grupo de identidades for usado por outros catálogos, você não poderá alterá-lo para um grupo diferente usando o Studio. Em vez disso, use o método Set-ProvScheme Cmdlet do PowerShell. Para obter mais informações, consulte o Documentação do SDK do Citrix Virtual Apps and Desktops.

   • Especifique um esquema de nomenclatura de conta, usando marcas de hash para indicar onde os números ou letras sequenciais aparecem. 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.

   • Opcionalmente, você pode especificar com que nome os nomes das contas começam.

     Ao especificar com o que os nomes das contas começam, lembre-se do seguinte cenário: Se os números ou letras iniciais já estiverem em uso, a primeira conta criada será nomeada usando os números ou letras não utilizados mais próximos a partir de então.

     Ver Gerenciar o número de sequência do nome da máquina para personalizar o número de sequência de computadores, que são implantados usando o MCS, por meio de comandos do PowerShell.

5. No Credenciais de domínio , selecione Insira as credenciais e insira as credenciais do usuário com permissões suficientes para criar contas de máquina.

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

Usar arquivos CSV para adicionar máquinas em massa a um catálogo

Você pode adicionar máquinas em massa usando arquivos CSV. O recurso está disponível para todos os catálogos, exceto catálogos provisionados por meio do MCS.

Para adicionar máquinas em massa a um catálogo, conclua as seguintes etapas:

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione um catálogo de máquinas e, em seguida, selecione Adicionar máquinas na barra de ação. O Adicionar máquinas é exibida.
3. Selecionar Adicionar arquivo CSV. A janela Adicionar máquinas em massa é exibida.
4. Selecione Baixar modelo CSV.
5. Preencha o arquivo de modelo.
6. Arraste ou navegue até o arquivo para carregá-lo.
7. Selecionar Validar para executar verificações de validação em sua importação.
8. Selecionar Importação para concluir o processo.

Considerações ao usar arquivos CSV para adicionar máquinas

Observação:

• Para usuários que não são do Active Directory, você deve digitar seus nomes neste formato: <identity provider>:<user name>. Exemplo: AzureAD:nomedeusuário.
• Os nomes de VM diferenciam maiúsculas de minúsculas. Ao inserir caminhos de VM, certifique-se de inserir os nomes de VM corretamente.

Ao editar o arquivo de modelo CSV, lembre-se do seguinte:

• O recurso oferece mais flexibilidade para adicionar máquinas em massa por meio de um arquivo CSV. No arquivo, você pode adicionar apenas máquinas (para uso com atribuições automáticas de usuário) ou adicionar máquinas junto com atribuições de usuário. Digite seus dados no seguinte formato:

  • Para pares de conta de computador e nome de usuário (samName):

  • Domínio\Nome_do_Computador1, Domínio\Nome de Usuário1
  • Domínio\Nome_do_Computador2, Domínio\Nome de Usuário1; Domínio\Nome de usuário2

  • Domínio\Nome_do_Computador3, AzureAD:nome de usuário

  • Somente para contas de máquina:

  • Domínio\Nome_do_Computador1

  • Domínio\Nome_do_Computador2

  • Para pares de VM e nome de usuário:

  • XDHyp:\Conexões\Nome_da_Conexão\RegionName\vm.folder\VMName1.vm,Domínio\Nome_do_Computador1,Domínio\Nome de Usuário1

  • XDHyp:\Conexões\Nome_da_Conexão\RegionName\vm.folder\VMName2.vm,Domínio\Nome_do_Computador2,Domínio\Nome de Usuário2

  • Somente para VMs:

  • XDHyp:\Conexões\Nome_da_Conexão\RegionName\vm.folder\VMName1.vm,Domínio\Nome_do_Computador1

  • XDHyp:\Conexões\Nome_da_Conexão\RegionName\vm.folder\VMName2.vm,Domínio\Nome_do_Computador2

    Por exemplo: XDHyp:\Connections\xpace-scale\East US.region\vm.folder\wsvdaV3-2.vm

    onde

  • escala xpace é o ConnectionName: o nome da conexão que você inseriu em Hospedagem > Adicionar conexões e recursos. Para obter mais informações, consulte Criar uma conexão e recursos.
  • Região Leste dos EUA.region é o RegionName: o nome da região com .região como extensão.
  • wsvdaV3-2.vm é o VMName: o nome da máquina virtual com .Vm como extensão.

• O número máximo de computadores que um arquivo pode conter é 1.000. Para importar mais de 1.000 máquinas, espalhe-as em arquivos diferentes e importe esses arquivos um por um. Recomendamos que você não importe mais de 1.000 máquinas. Caso contrário, a criação do catálogo pode levar muito tempo para ser concluída.

Você também pode exportar máquinas de um catálogo no mesmo Adicionar máquinas página. O CSV exportado de máquinas pode então ser usado como um modelo ao adicionar máquinas em massa. Para exportar máquinas:

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione um catálogo de máquinas e, em seguida, selecione Adicionar máquinas na barra de ação. O Adicionar máquinas é exibida.
3. Selecionar Exportar para arquivo CSV. Um arquivo CSV contendo uma lista das máquinas é baixado.
4. Abra o arquivo CSV para adicionar ou editar máquinas conforme necessário. Para adicionar máquinas em massa usando o arquivo CSV salvo, consulte a seção anterior, Usar arquivos CSV para adicionar máquinas em massa a um catálogo.

Observação:

• Esse recurso não está disponível para acesso remoto ao PC e catálogos provisionados pelo MCS.

• A exportação e importação de máquinas em arquivos CSV só são suportadas entre catálogos do mesmo tipo.

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

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

Observação:

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

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

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

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

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

Solução de problemas

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

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

Se você tiver especificado um caminho diferente para os logs, poderá usar log: [caminho do arquivo de log] para recuperar seus logs.

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

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 são desligadas.

Para excluir máquinas de um catálogo:

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione um catálogo e, em seguida, selecione Ver Máquinas na barra de ação.
3. Selecione uma ou mais máquinas e, em seguida, selecione Excluir na barra de ação.
4. Se você estiver excluindo máquinas persistentes do catálogo, escolha se deseja excluí-las do hipervisor ou do serviço de nuvem também. Se você optar por excluí-los, indique se deseja manter, desabilitar ou excluir suas contas do Active Directory.

Quando você exclui computadores persistentes de um catálogo do Azure Resource Manager, os computadores e os grupos de recursos associados são excluídos do Azure, mesmo que você opte por mantê-los.

Quando você exclui máquinas não persistentes de um catálogo, elas são excluídas automaticamente do hipervisor ou do serviço de nuvem.

Editar um catálogo

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione um catálogo e, em seguida, selecione Editar catálogo de máquinas na barra de ação.
3. No Escopos , altere os escopos.

4. No NIC , execute as seguintes ações:

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

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

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

   Observação:

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

5. No Atualização do VDA , altere ou selecione a versão do VDA para a qual deseja atualizar. Para obter mais informações, consulte Atualização do VDA.

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

   Para catálogos criados usando uma imagem do Azure Resource Manager, as páginas a seguir são visíveis. Lembre-se de que as alterações feitas se aplicam somente às máquinas adicionadas ao catálogo posteriormente. As máquinas existentes permanecem inalteradas.

   • No Máquinas Virtuais , altere o tamanho da máquina e as zonas de disponibilidade em que você deseja criar máquinas.

     Observação:

     • Somente os tamanhos de máquina compatíveis com o catálogo são mostrados.
     • Se necessário, selecione Mostrar apenas tamanhos de máquina usados em outros catálogos de máquinas para filtrar a lista de tamanhos de máquina.

   • On the Machine Profile page, choose whether to use or change a machine profile.

   • (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 for compatível com o tamanho atual da máquina, uma caixa de diálogo de aviso será exibida, informando que alterar a configuração redefine a configuração de tamanho da máquina.   If you choose to continue, a red dot appears next to the **Virtual Machines** menu, prompting you to select a new machine size.
     

   Para obter mais informações sobre as configurações disponíveis nas páginas, consulte Criar um catálogo de computadores usando uma imagem do Azure Resource Manager.

   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.
   • No Unidades organizacionais , adicionar ou remover UOs do Active Directory.
7. No Descrição , altere a descrição do catálogo.
8. Clique Aplicar para aplicar as alterações feitas e clique em Salvar para sair.

Renomear um catálogo

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione um catálogo e, em seguida, selecione Renomear catálogo de máquinas na barra de ação.
3. Digite o novo nome.

Excluir um catálogo

Antes de excluir um catálogo, verifique se:

• Todos os usuários são desconectados e nenhuma sessão desconectada está em execução.
• 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:

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione um catálogo e, em seguida, selecione Excluir catálogo de máquinas na barra de ação.
3. Se o catálogo contiver máquinas persistentes, indique se deseja excluir essas máquinas do hipervisor ou do serviço de nuvem também. Se você optar por fazer isso, escolha se deseja manter, desabilitar ou excluir suas contas de computador do Active Directory.
4. Se necessário, selecione Ocultar o progresso para executar a exclusão em segundo plano.

Observação:

• Quando você exclui um catálogo do Azure Resource Manager, os computadores e grupos de recursos associados são excluídos do Azure, mesmo que você opte por mantê-los.
• Quando você exclui um catálogo que contém máquinas não persistentes, essas máquinas são excluídas do hipervisor ou do serviço de nuvem.
• Quando o hipervisor ou o serviço de nuvem está inacessível durante a exclusão do catálogo, a exclusão do catálogo e da VM falha. Se necessário, você pode optar por excluir os registros da VM somente do banco de dados do site Citrix. Para isso, selecionar o catálogo de máquinas no Catálogos de máquinas e, em seguida, execute a exclusão mostrada no nó Solucionar problemas guia. Lembre-se de que essa ação deixa as VMs intactas no host.

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 computador não utilizadas removendo contas de computador do Active Directory de catálogos de sessão única e de várias sessões. Essas contas podem ser usadas para outras máquinas.
• Adicione contas para que, quando mais computadores forem adicionados ao catálogo, as contas de computador já estejam em vigor. Não use barra (/) no nome de uma UO.

Para gerenciar contas do Active Directory:

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione um catálogo e, em seguida, selecione Gerenciar contas do AD na barra de ação.

3. Escolha se deseja adicionar ou excluir contas de computador. Se você adicionar contas, especifique o que fazer com as senhas da conta: redefina todas elas ou insira uma senha que se aplique a todas as contas.

   Você pode redefinir as senhas se não souber as senhas da conta atual; Você deve ter permissão para executar uma redefinição de senha. Se você inserir uma senha, a senha será alterada nas contas à medida que elas forem importadas. Se você excluir uma conta, escolha se a conta em um Active Directory deve ser mantida, desabilitada ou excluída.

Você também pode indicar se as contas do Active Directory devem ser mantidas, desabilitadas ou excluídas ao remover computadores de um catálogo ou excluir um catálogo.

Alterar a imagem mestra de um catálogo

Recomendamos que você salve cópias ou instantâneos de imagens antes de alterar a imagem mestre de um catálogo. O banco de dados mantém um registro histórico das imagens usadas com cada catálogo de máquinas. Se os usuários encontrarem problemas com a nova imagem implantada em suas áreas de trabalho, você poderá revertê-la para a versão anterior, minimizando o tempo de inatividade do usuário. Não exclua, mova ou renomeie imagens. Caso contrário, você não poderá reverter a imagem mestre.

Importante:

Ao alterar a imagem mestra de um catálogo persistente, considere o seguinte: somente as máquinas adicionadas ao catálogo posteriormente são criadas usando a nova imagem. Não implementamos a nova imagem para máquinas existentes no catálogo.

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

Atualizar ou criar uma imagem

Antes de alterar a imagem mestra de um catálogo, prepare uma nova imagem no hipervisor do host atualizando uma imagem existente ou criando uma.

1. No hipervisor ou no provedor de serviços de nuvem, tire um instantâneo da VM atual e dê um nome significativo ao instantâneo. Esse instantâneo pode ser usado para reverter a imagem mestre.
2. Se necessário, ligue a imagem e faça logon.
3. Instale atualizações ou faça as alterações necessárias na imagem.
4. Se a imagem usar um vDisk pessoal, atualize o inventário.
5. Desligue a VM.
6. Tire um instantâneo da VM e dê a ele um nome significativo que seja reconhecido quando você alterar a imagem mestra.

Observação:

Embora você possa criar um instantâneo usando a interface de gerenciamento, recomendamos que você crie um instantâneo usando o console de gerenciamento do hipervisor e, em seguida, selecione esse instantâneo no Studio. Isso permite que você forneça um nome e uma descrição significativos, em vez de um nome gerado automaticamente. Para imagens de GPU, você pode alterar a imagem somente por meio do console XenServer XenCenter.

Alterar a imagem mestra

Para distribuir uma nova imagem mestre para todas as máquinas em um catálogo:

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione um catálogo e, em seguida, selecione Alterar imagem mestre na barra de ação.

3. No Imagem , selecione o host e a imagem que deseja implantar.

   Dica:

   Para um catálogo criado pelo MCS, você pode anotar sua imagem adicionando uma nota para a imagem. Uma nota pode conter até 500 caracteres. Cada vez que você altera a imagem mestre, uma entrada relacionada à nota é criada 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 anotações da imagem, selecione o catálogo, clique em Propriedades do modelo no painel inferior e clique em Ver histórico de notas.

4. No Estratégia de distribuição , escolha quando as máquinas no catálogo de máquinas são alteradas com a nova imagem: no próximo desligamento ou imediatamente.

   Observação:

   O Estratégia de distribuição não está disponível para VMs persistentes porque a distribuição só é aplicável a VMs não persistentes.

5. Verifique as informações no Resumo e selecione Acabar. Cada máquina é reiniciada automaticamente após ser atualizada.

   Para acompanhar o progresso da atualização, localize o catálogo em Catálogos de máquinas para exibir a barra de progresso embutida e o gráfico de progresso passo a passo. Para um catálogo não persistente, você pode rastrear seus status de atualização de imagem por meio do Atualização de imagem coluna, incluindo Totalmente atualizado, Parcialmente atualizado, Atualização pendentee Preparando imagem.

   Dica:

   Para mostrar o Atualização de imagem , selecione a coluna Colunas a serem exibidas na barra de ações, selecione Catálogo de Máquinas > Status da imageme, em seguida, clique em Salvar.

Se você estiver atualizando um catálogo usando o SDK do PowerShell, poderá especificar um modelo de hipervisor (VMTemplates), como uma alternativa a uma imagem ou a um instantâneo de uma imagem.

Para distribuir uma nova imagem mestra no catálogo de computadores baseado no Azure:

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione um catálogo do Azure e, em seguida, selecione Alterar imagem mestre na barra de ação.
3. No Alterar imagem mestre , selecione uma imagem em Imagem mestre. A folha lista todas as imagens que pertencem à mesma região que as de Recursos.

Estratégia de distribuição

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

Observação:

A estratégia de distribuição só é aplicável a VMs não persistentes.

Considere o seguinte:

• Novas sessões não podem ser iniciadas até que a atualização seja concluída nas máquinas aplicáveis.
• Para máquinas de 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 conectados.
• Para um sistema operacional de várias sessões com computadores filho, as reinicializações não ocorrem automaticamente. Para aplicar a imagem mestra atualizada, reinicie os computadores usando o Studio, o PowerShell ou o Workspace. A reinicialização dos computadores ou dos hipervisores 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 mestra

Depois de implantar uma imagem nova ou atualizada, você pode revertê-la. Isso 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 acontece com a distribuição, a reversão de uma máquina inclui uma reinicialização.

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione o catálogo e, em seguida, selecione Reverter imagem mestre na barra de ação.
3. Especifique quando aplicar a imagem anterior às máquinas, conforme descrito para a operação de implantação.

A reversão é aplicada apenas a máquinas que precisam ser revertidas. Para máquinas que não foram alteradas para a imagem nova ou atualizada (por exemplo, máquinas com usuários que não fizeram logoff), os usuários não recebem mensagens de notificação e não são forçados a fazer logoff.

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

Não é possível reverter em determinados cenários, incluindo os seguintes. (O Reverter imagem mestre não estiver 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.

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. Recomendamos 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 Citrix DaaS. Isso permite que a interface de gerenciamento determine que as máquinas no catálogo precisam ser atualizadas.

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

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione o catálogo. O Detalhes no painel inferior exibe informações de versão.
3. Selecionar Alterar nível funcional. Se a interface de gerenciamento detectar que o catálogo deve alterar o nível funcional, ela exibirá uma mensagem. Siga as instruções. Se uma ou mais máquinas não puderem ser alteradas, uma mensagem explicará o motivo. Para garantir que todas as máquinas funcionem corretamente. Recomendamos que você resolva esses problemas antes de clicar em Mudar.

Após a conclusão da atualização do catálogo, você pode reverter as máquinas para suas versões anteriores do VDA selecionando o catálogo e, em seguida, selecionando Desfazer alteração de nível funcional 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 a Sistema Operacional e Gerenciamento de máquinas. O catálogo clonado herda essas configurações do original.

  Observação:

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

• A clonagem de um catálogo pode levar algum tempo para ser concluída. Se necessário, selecione Ocultar o progresso para executar a clonagem em segundo plano.
• O catálogo clonado herda o nome do original e tem um sufixo Copiar. Você pode alterar o nome. Ver Renomear um catálogo.
• Após a conclusão da clonagem, certifique-se de atribuir o catálogo clonado a um grupo de entrega.
• Você pode criar um catálogo vazio clonando. Durante a clonagem de catálogo, você pode definir o número de máquinas como zero para catálogos provisionados pelo MCS e não adicionar nenhuma máquina para catálogos não provisionados pelo MCS.

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione um catálogo e, em seguida, selecione Clone na barra de ação.
3. No Clonar catálogo de máquinas selecionadas , exiba as configurações do catálogo clonado e defina as configurações conforme aplicável. Selecionar Próximo para prosseguir para a próxima página.
4. No Resumo , visualize um resumo das configurações e selecione Acabar para iniciar a clonagem.
5. Se necessário, selecione Ocultar o progresso para executar a clonagem em segundo plano.

Organize catálogos usando pastas

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

Dica:

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

Funções necessárias

Por padrão, você precisa ter a seguinte função interna para criar e gerenciar pastas de catálogo: Administrador de Nuvem, Administrador Completo ou Administrador de Catálogo de Máquinas. Se necessário, você pode personalizar funções para criar e gerenciar pastas de catálogo. Para obter mais informações, consulte Permissões necessárias.

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 Studio (como o Catálogos de máquinas e o Aplicativos nós) compartilham uma árvore de pastas no back-end. Para evitar conflitos de nome com outros nós ao renomear ou mover pastas, recomendamos que você dê nomes diferentes a pastas de primeiro nível em nós diferentes.

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

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Na hierarquia de pastas, selecione uma pasta e, em seguida, selecione Criar pasta No Ação barra.
3. Insira um nome para a nova pasta e clique em Terminado.

Dica:

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

Mover um catálogo

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

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

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ê só poderá excluir uma pasta se ela e suas subpastas não contiverem catálogos.

Para gerenciar uma pasta, siga estas etapas:

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.

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

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

Permissões necessárias

A tabela a seguir lista as permissões necessárias para executar ações em pastas de catálogo.

Atualizar VDAs

Importante:

• Para garantir uma atualização tranquila, certifique-se de atender aos pré-requisitos e revisar os problemas conhecidos antes de atualizar os VDAs para as versões CR ou LTSR CU. Veja Atualizar VDAs usando o Studio.
• Ao atualizar VDAs LTSR para versões de atualização cumulativa (CU) LTSR, certifique-se de que a versão dos agentes de atualização de VDA em execução nos VDAs seja 7.36.0.7 ou posterior. Para obter mais informações, consulte Atualizar VDAs usando o Studio.
• Você pode alternar entre o CR VDA e o LTSR VDA, desde que mude de uma versão anterior para uma versão posterior. Você não pode mudar de uma versão posterior para uma anterior porque isso é considerado um downgrade. Por exemplo, você não pode fazer downgrade de 2212 CR para 2203 LTSR (qualquer CU), mas pode fazer upgrade de 2112 CR para 2203 LTSR (qualquer CU).
• Você também pode atualizar VDAs usando o PowerShell. Ver Atualizar VDAs usando o PowerShell.

Com o recurso, você pode fazer o seguinte:

• Atualizar VDAs por catálogo
• Editar ou cancelar um upgrade programado do VDA
• Definir as configurações de upgrade do VDA após a criação do catálogo
• Atualizar VDAs por máquina

Observação:

• Quando você programa upgrades de VDA para um catálogo, somente os VDAs no catálogo que têm o VDA Upgrade Agent instalado podem ser atualizados.
• A atualização de um VDA falha quando a máquina está no modo de manutenção ou quando uma sessão está sendo executada na máquina.

Tipos de máquina suportados

Este recurso se aplica aos seguintes tipos de máquinas:

• Máquinas persistentes provisionadas pelo MCS (Ingressado no AD, ingressado no Azure AD e não ingressado no domínio). Você os implanta usando Citrix Machine Creation Services na página Machine Management durante a criação do catálogo.
• Máquinas de acesso remoto ao PC
• Citrix HDX Plus para máquinas Windows 365
• Outras máquinas persistentes provisionadas usando serviços ou tecnologias de provisionamento que não sejam da Citrix. Você adiciona essas máquinas ao DaaS para gerenciamento usando Outro serviço ou tecnologia no Gerenciamento de máquinas durante a criação do catálogo.

Para obter mais informações sobre o Serviços de criação de máquinas Citrix e Outro serviço ou tecnologia opções, consulte Gerenciamento de máquinas.

Observação:

Para máquinas provisionadas pelo MCS, apenas máquinas persistentes estáticas são suportadas. Máquinas aleatórias não são suportadas, mesmo que sejam persistentes.

Atualizar VDAs por catálogo

Observação:

Ao programar atualizações de VDA para um catálogo, certifique-se de que todas as máquinas no catálogo estejam incluídas no escopo de atualização. Portanto, recomendamos fazer backup dessas máquinas antes de iniciar a atualização.

Depois de habilitar a atualização do VDA para um catálogo, você pode atualizar os VDAs no catálogo imediatamente ou programar atualizações para o catálogo. Para fazer isso, siga estas etapas:

1. No Studio, selecione Catálogos de máquinas.

2. Selecione o catálogo e, em seguida, Atualizar VDAs no menu contextual ou na barra de ações. (Clique com o botão direito do mouse para exibir o menu contextual.) A janela VDA Upgrade é exibida.

   

3. Escolha a versão do VDA desejada na lista suspensa em Nova versão para atualizar.

   

   Observação:

   • Você só pode escolher uma versão posterior para atualizar.

   • Não há suporte para a reversão para uma versão anterior.

4. Escolha se deseja atualizar componentes adicionais em sua implantação. Você também pode optar por instalar determinados componentes além da atualização. Se um componente exigir configuração, você deverá clicar no botão Configurar e defina as configurações do componente para continuar. Após a configuração, você pode clicar em Editar para alterar a configuração.

   Importante:

   • Para usar o recurso de componentes adicionais, certifique-se de que o VDA Upgrade Agent seja a versão 7.34 ou posterior, que está incluída no instalador do VDA versão 2206 ou posterior.

   Observação:

   • Se você optar por não atualizar um componente, o componente permanecerá intacto em sua implantação.
   • Para obter uma lista completa de componentes adicionais, consulte Instalar VDAs.

   

5. Clique Próximo.

6. Escolha se deseja ativar qualquer um dos recursos listados. Clique Próximo.

   Observação:

   Por padrão, o Habilitar a limpeza de restauração está marcada. Recomendamos ativar o recurso de restauração. Com o recurso habilitado, um ponto de restauração do sistema é criado antes do início da atualização. O ponto de restauração é excluído após a instalação bem-sucedida do VDA. Para obter mais informações, consulte Restauração em caso de falha na instalação ou atualização.

   

7. Escolha se deseja atualizar os VDAs imediatamente ou em um horário programado.

   • Para atualizar os VDAs imediatamente, selecione Atualize agora e, em seguida, especifique uma duração.

     Uma duração é a quantidade de tempo, em horas, após a qual o VDA Upgrade Service para de iniciar upgrades adicionais. As atualizações em andamento serão executadas até a conclusão. Durante esse período, o DaaS começa a atualizar os VDAs quando eles se tornam qualificados (por exemplo, não há mais sessões ativas).

     Quanto mais VDAs precisarem ser atualizados, maior será essa duração. Recomendamos selecionar um valor grande (por exemplo, 12 horas). Caso contrário, dependendo do número de VDAs, ainda pode haver VDAs que o DaaS não consegue atualizar dentro dessa janela.

   • Para agendar as atualizações, selecione Atualizar mais tarde e, em seguida, especifique quando deseja que as atualizações ocorram. O fuso horário do site, que você definiu em Configurações > Data e hora, aparece para sua informação.

     Você pode agendar as atualizações apenas para os próximos sete dias. As atualizações agendadas se aplicam somente às máquinas que estão atualmente no catálogo. Se você adicionar máquinas ao catálogo posteriormente, mas quiser atualizá-las também, cancele a atualização agendada e recrie uma agenda.

   

8. Selecione o ícone Parar a atualização após o limite de falha (Tech Preview) opção.

   Ilustração do comportamento

   • O limite de falha e o nível de simultaneidade devem ser maiores que zero.

   • O limite de falha e o nível de simultaneidade devem ser menores ou iguais ao número total de máquinas que estão sendo agendadas para atualização

   Limite de falha	Nível de simultaneidade	Comportamento
   Desde que	Não fornecido ou entrada 0	O limite de falha é aplicado e o nível de concucrência é decidido pelo balanceador de carga como antes.
   Não fornecido ou entrada 0	Desde que	O padrão do limite de falha é 10000 (máximo de máquinas por catálogo) e o nível de precisão é usado para envio em lote.
   Não fornecido ou entrada 0	Não fornecido ou entrada 0	O comportamento padrão é aplicável com níveis de simultaneidade atualizados pelo balanceador de carga.

9. Insira o Limite de falha.

   Observação:

   O limite de falha é o número de falhas após as quais o VUS interrompe qualquer instalação de atualização pendente de lotes subsequentes que não são selecionados pelo agente de atualização.

10. Insira o Simultaneidade.

    Observação:

    Atualização simultânea é o número de VMs que podem ser atualizadas simultaneamente em qualquer ponto dentro da janela de atualização.

11. Clique Próximo.

    Observação:

    O limite de falha é incompatível com Ativar restauração ou Ativar restauração e limpeza e pode não funcionar como pretendido.

12. Escolha se deseja selecionar o Citrix forneceu CDN ou Compartilhamento de arquivos local.

    Observação:

    Insira o caminho do arquivo para o instalador vda se você escolher a opção de compartilhamento de arquivos local.

13. Clique Próximo.

14. Revise suas escolhas no Resumo e clique em Acabar para aplicar suas configurações e sair da janela.

Observação:

• O Atualizar VDAs estará disponível somente depois que você habilitar a atualização do VDA para o catálogo. Para habilitar a atualização do VDA, Editar o catálogo.
• Todas as máquinas no catálogo são colocadas no modo de manutenção enquanto as atualizações são implementadas. As atualizações podem levar até 30 minutos para começar e serão executadas somente durante o período de tempo especificado.

No Catálogos de máquinas nó, o nó Atualização do VDA fornece informações de atualização do VDA para o catálogo. As seguintes informações podem aparecer:

Dica:

Para mostrar o Atualização do VDA coluna, selecione Colunas a serem exibidas Na barra de ações, selecione Catálogo de Máquinas > Atualização do VDAe, em seguida, clique em Salvar.

• Disponível: Uma nova versão do VDA está disponível.
• Marcado: A atualização do VDA foi agendada.
• Não configurado: Aparece quando você não ativou a atualização do VDA para o catálogo.
• Atualizado: Os VDAs do catálogo estão atualizados.
• Desconhecido: Não é possível obter as informações necessárias para a atualização do VDA. Existem vários motivos possíveis:
  • O VDA estava em uso durante a janela de atualização.
  • O número de atualizações em andamento atingiu o limite máximo de 500.
  • O Agente de atualização do VDA não respondeu durante a janela de atualização. Certifique-se de que o agente esteja em execução no VDA e possa se comunicar com o Citrix DaaS.
  • Não é possível executar verificações de validação de atualização. Ver Requisito de atualização do VDA.

Você também pode visualizar o status das atualizações do VDA para um catálogo. Para fazer isso, clique no catálogo e marque a opção Estado de atualização do VDA informações sobre o Detalhes guia. As seguintes informações podem aparecer:

• Não agendado: você ativou a atualização do VDA para o catálogo, mas não configurou uma programação de atualização.
• Marcado: Você criou uma programação de atualização para o catálogo. Por exemplo, se você definir o agendamento para começar em 21:00, 14 de dezembro de 2030, as informações aparecem da seguinte forma: Agendado para 14 de dezembro de 2030 21:00 UTC.
• Em andamento: As atualizações do VDA foram iniciadas.
• Cancelado: Você cancelou a atualização agendada.
• Falhou: O catálogo contém uma ou mais máquinas cujas atualizações de VDA não foram bem-sucedidas.
• Bem-sucedido: Todos os VDAs no catálogo foram atualizados com êxito.

Você também pode solucionar problemas de atualização do VDA com ações recomendadas para um catálogo. Para fazer isso, clique no catálogo e vá para o Solucionar problemas guia.

Para detalhar rapidamente os catálogos que têm um estado de atualização específico do VDA, você pode usar filtros. Para obter mais informações, consulte Usar a pesquisa no Studio.

Esteja ciente das seguintes considerações:

• O Atualização do VDA ou Estado de atualização do VDA O filtro está disponível para uso somente com os seguintes filtros: Nome e Catálogo de Máquinas.
• Quando você usa o Atualização do VDA ou o Estado de atualização do VDA filtro Erros e Avisos no canto superior direito ficam indisponíveis.

Editar ou cancelar um upgrade programado do VDA

Depois de agendar as atualizações para um catálogo, talvez você queira editar ou cancelar a atualização agendada. Para fazer isso, siga estas etapas:

1. No Studio, selecione Catálogos de máquinas.
2. Selecione o catálogo e, em seguida, Editar atualização programada do VDA na barra de ação. A janela Edit VDA Upgrade é exibida, mostrando informações sobre a versão do VDA instalada e a versão do VDA para a qual atualizar.

3. Escolha se deseja editar ou cancelar a atualização agendada.

   • Para cancelar a atualização, clique em Cancelar atualização agendada. Lembre-se: Cancelar a atualização agendada não força a interrupção da atualização em andamento.
4. Clique Terminado para sair da janela.

Definir as configurações de upgrade do VDA editando um catálogo

Após a criação do catálogo, você pode definir as configurações de upgrade do VDA editando o catálogo. Antes de começar a editar, considere o seguinte:

• Verifique se todas as máquinas no catálogo estão na mesma faixa de VDA (CR ou LTSR). Caso contrário, certas atualizações do VDA falharão. Por exemplo, se você selecionar LTSR VDA mais recente, as atualizações do CR VDA falharão.

• As atualizações para algumas das máquinas no catálogo podem ter começado. Não é possível modificar atualizações que já estão em andamento. As atualizações em andamento continuam. Aqueles que ainda não iniciaram serão atualizados para a versão especificada.

Atualizar VDAs por máquina

Depois de habilitar a atualização do VDA para um catálogo, você pode atualizar os VDAs do catálogo um por um ou em lotes. Para fazer isso, siga estas etapas:

1. No Studio, selecione Procurar.

2. Selecione uma ou mais máquinas e, em seguida, Atualizar VDA no menu contextual ou na barra de ações. (Clique com o botão direito do mouse para exibir o menu contextual.)

   

   Observação:

   • Pelo Atualizar VDA para estar disponível, certifique-se de ter habilitado o upgrade do VDA para o catálogo em que as máquinas selecionadas residem e que essas máquinas tenham o VDA Upgrade Agent instalado. Para habilitar a atualização do VDA para ele, edite o catálogo.
   • As máquinas serão colocadas no modo de manutenção enquanto as atualizações são lançadas. As atualizações podem levar até 30 minutos para começar.
   • Se sua seleção contiver máquinas para as quais as atualizações do VDA não estão disponíveis ou cujas atualizações estão pendentes (programadas, em andamento ou aguardando atualizações), ignoraremos as atualizações para essas máquinas.

No Procurar , você pode adicionar o nó Atualização do VDA coluna. Para obter informações sobre como adicionar uma coluna personalizada, consulte Personalizar colunas a serem exibidas. A coluna é útil. Ele fornece informações de atualização do VDA para a máquina. As seguintes informações podem aparecer:

• Disponível: Uma nova versão do VDA está disponível.
• Marcado: A atualização do VDA foi agendada.
• Não configurado: Aparece quando você não ativou a atualização do VDA para a máquina.
• Atualizado: O VDA está atualizado.
• Desconhecido: As informações sobre a atualização do VDA ainda não estão disponíveis.

Você também pode visualizar o status da atualização do VDA para uma máquina. Para fazer isso, clique na máquina e marque a opção Estado de atualização do VDA informações sobre o Detalhes guia. As seguintes informações podem aparecer:

• Desconhecido: Não é possível obter as informações necessárias para a atualização do VDA. Existem vários motivos possíveis:
  • O VDA estava em uso durante a janela de atualização.
  • O número de atualizações em andamento atingiu o limite máximo de 500.
  • O Agente de atualização do VDA não respondeu durante a janela de atualização. Certifique-se de que o agente esteja em execução no VDA e possa se comunicar com o Citrix DaaS.
  • Não é possível executar verificações de validação de atualização. Ver Requisito de atualização do VDA.
• Marcado: Você configurou um agendamento de atualização. Por exemplo, se você definir o agendamento para começar em 21:00, 14 de dezembro de 2030, as informações aparecem da seguinte forma: Agendado para 14 de dezembro de 2030 21:00 UTC.
• Aguardando atualização: A máquina é colocada em modo de manutenção, aguardando a atualização. (Certifique-se de que os usuários tenham feito logout de sua sessão para que a atualização possa continuar.)
• Em andamento: A atualização do VDA foi iniciada.
• Falha na atualização: Tentativas de atualizar o VDA falharam.
• Falha na validação: Falha nas tentativas de validar as configurações de atualização do VDA.
• Cancelado: A atualização da máquina foi cancelada.
• Bem-sucedido: O VDA foi atualizado com sucesso.

Você também pode solucionar problemas de atualização do VDA com ações recomendadas para uma máquina. Para fazer isso, clique na máquina e vá para o Solucionar problemas guia.

Para detalhar rapidamente as máquinas que têm um estado de atualização de VDA específico, você pode usar filtros. Para obter mais informações, consulte Usar a pesquisa no Studio. Esteja ciente das seguintes considerações:

• O Atualização do VDA ou Estado de atualização do VDA O filtro está disponível para uso somente com os seguintes filtros: Nome e Catálogo de Máquinas.
• Quando você usa o Atualização do VDA ou o Estado de atualização do VDA filtro Erros e Avisos no canto superior direito ficam indisponíveis.

Gerenciar conjunto de configurações para um catálogo

Antes de começar, certifique-se de ter configurado a implantação do serviço WEM. Para obter mais informações, consulte Introdução ao serviço de Gerenciamento de Ambiente de Trabalho.

Observação:

Por padrão, se você tiver a função Administrador de Nuvem, Administrador de Acesso Total ou Administrador de Catálogo de Máquinas, poderá gerenciar conjuntos de configurações para catálogos. Se necessário, você pode permitir que as funções gerenciem conjuntos de configurações, concedendo-lhes o Gerenciar conjuntos de configurações permissão.

Vincular um catálogo a um conjunto de configurações

Importante:

Se as instâncias de serviço Citrix DaaS e WEM não residirem na mesma região, você não poderá vincular um catálogo a um conjunto de configurações. Nesse caso, migre seu serviço WEM para a mesma região que o Citrix DaaS.

Para vincular um catálogo a um conjunto de configurações, siga estas etapas:

1. No Studio, selecione Catálogos de máquinas.

2. Selecione o catálogo de máquinas e, em seguida, Gerenciar conjunto de configurações na barra de ação. O Gerenciar conjunto de configurações é exibida.

3. Selecione um conjunto de configurações WEM ao qual você deseja vincular o catálogo.

   Observação:

   Se o conjunto de configurações selecionado não contiver configurações relacionadas à configuração básica do WEM, o Aplicar configurações básicas ao conjunto de configurações é exibida. Recomendamos que você selecione a opção para aplicar configurações básicas ao conjunto de configurações.

4. Clique Salvar para salvar sua alteração.

Alternar para um conjunto de configurações diferente

Para alternar para um conjunto de configurações diferente para um catálogo, siga estas etapas:

1. No Studio, selecione Catálogos de máquinas.
2. Selecione o catálogo de máquinas e, em seguida, Gerenciar conjunto de configurações na barra de ação. O Gerenciar conjunto de configurações é exibida.
3. Selecione um conjunto de configurações WEM diferente ao qual você deseja vincular o catálogo.
4. Clique Salvar para salvar sua alteração.

Desvincular um catálogo do conjunto de configurações

Para desvincular um catálogo do conjunto de configurações, siga estas etapas:

1. No Studio, selecione Catálogos de máquinas.
2. Selecione o catálogo de máquinas e, em seguida, Gerenciar conjunto de configurações na barra de ação. O Gerenciar conjunto de configurações é exibida.
3. Clique no ícone X no lado direito do conjunto de configurações selecionado.
4. Clique Salvar para salvar sua alteração.

Repetir a criação do catálogo

Observação:

Esse recurso se aplica somente a catálogos do MCS.

Os catálogos com falha são marcados com um ícone de erro. Para ver os detalhes, acesse o Solucionar problemas de cada catálogo. Antes de tentar novamente a criação do catálogo, lembre-se das seguintes considerações:

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

Para tentar criar um catálogo novamente, faça o seguinte:

1. No Studio, selecione Catálogos de máquinas no painel esquerdo.
2. Selecione o catálogo e vá para o seu Solucionar problemas guia.
3. Clique no hiperlink de repetição para tentar criar novamente o catálogo.
4. No assistente exibido, altere as configurações quando necessário. Se não houver necessidade de fazer alterações, você pode ir para o Resumo página diretamente.
5. Depois de terminar, selecione Acabar para iniciar a criação.

(Somente VDAs não provisionados pela Citrix) Gerar e gerenciar tokens de registro

Depois de decidir adotar o registro baseado em token para máquinas não provisionadas pela Citrix, gere tokens por catálogo de máquina e compartilhe-os com os administradores de instalação do VDA.

Um token de registro apresenta:

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

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

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

5. No Token gerado com sucesso exibida, copie o token e salve-o em um local seguro ou clique em Baixar para baixá-lo para o Downloads pasta.

   Um registro de token aparece na lista de tokens.

   

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

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

Gerenciar tokens

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

• Revogar: revogue o token, mas mantenha-o na lista para fins de registro.
• Excluir: revogue o token e exclua-o da lista.

Observação:

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

Usar o PowerShell

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

• Usar o PowerShell para verificar o status de atualização do VDA e a versão do VDA
• Gerenciar o número de sequência do nome da máquina
• Adicionar descrições a uma imagem
• Redefinir disco do sistema operacional
• Reparar as informações de identidade de contas de computador ativas
• Alterar a configuração de rede de um catálogo de máquinas existente
• Gerenciar versões de um catálogo de máquinas
• Alterar a configuração de cache de um catálogo de máquinas existente
• 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
• Recuperar avisos e erros associados a um catálogo
• Excluir computadores sem acesso ao hipervisor
• Atualizar propriedades de VMs individuais
• Suporte à atualização do VDA por meio do acesso ao compartilhamento de arquivos local

Usar o PowerShell para verificar o status de atualização do VDA e a versão do VDA

Use o Get-VusCatalog PowerShell para verificar o status de atualização do VDA. Suponha que o nome do catálogo seja wuhanTestMC1. Você pode digitar o seguinte no prompt de comando:

• PS C:\> Get-VusCatalog -Name wuhanTestMC1

Neste exemplo, UpgradeState É UpgradeAvailable, o que significa que a atualização do VDA está habilitada para o catálogo. O StateId É UpgradeSuccessful, o que significa que o catálogo foi atualizado com êxito para 2112.0.0.32068 (Versão de atualização).

Use o Get-BrokerMachine PowerShell para obter a versão atual do VDA.

Use o Get-VusAvailableVdaVersion PowerShell para obter a versão mais recente do VDA.

Gerenciar o número de sequência do nome da máquina

Para personalizar o número de sequência de computadores, que são implantados usando o MCS, por meio de comandos do PowerShell, faça o seguinte:

1. Abra o PowerShell como administrador no Delivery Controller.
2. Execute o comando asnp citrix* para carregar os módulos Citrix.

3. Execute o seguinte comando para verificar a contagem inicial do pool de identidades do catálogo:

   Get-AcctIdentityPool -IdentityPoolName xxx

   O IdentityPoolName é o nome do catálogo.

4. Se você quiser definir essa contagem como um valor diferente, execute o seguinte comando e especifique o StartCount como X:

   Set-AcctIdentityPool -IdentityPoolName xxx -StartCount X

5. Adicione as máquinas ao catálogo para que as máquinas sejam criadas com a contagem necessária.

6. Depois de criar as máquinas, execute o seguinte comando para configurá-lo de volta para o valor original Y:

   Set-AcctIdentityPool -IdentityPoolName xxx -StartCount Y

Adicionar descrições a uma imagem

Você pode adicionar descrições informativas sobre alterações relacionadas a atualizações de imagem para catálogos de máquinas. Use 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. Essa funcionalidade é útil para administradores que desejam adicionar rótulos descritivos ao atualizar uma imagem mestre usada por um catálogo, por exemplo, Office 365 instalado. Use os seguintes comandos para adicionar ou exibir descrições de imagens:

• NewProvScheme. Um novo parâmetro, masterImageNote permite adicionar uma nota a uma imagem. Por exemplo:

  C:\PS>New-ProvScheme -ProvisioningSchemeName XenPS -HostingUnitName XenHu -IdentityPoolName idPool1 -MasterImageVM XDHyp:\HostingUnits\XenHU\Base.vm\Base.snapshot -MasterImageNote "Office365 installed"
 

• Publish-ProvMasterVMImage. Use esse parâmetro para publicar a nota. Por exemplo:

C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName MyScheme -MasterImageVM XDHyp:\HostingUnits\HostUnit1\RhoneCC_baseXP.vm\base.snapshot -MasterImageNote "Visual Studio 2019 installed"

• Get-ProvSchemeMasterVMImageHistory. Exibir informações para cada imagem. Por exemplo:

‘C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall

VMImageHistoryUid: 3cba3a75-89cd-4868-989b-27feb378fec5

ProvisioningSchemeUid: 7585f0de-192e-4847-a6d8-22713c3a2f42

ProvisioningSchemeName : MyScheme

MasterImageVM : /Base.vm/base.snapshot

Data : 17/05/2021 09:27:50

MasterImageNote: Office365 instalado’

Redefinir disco do sistema operacional

Usar 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 a ambientes de virtualização AWS, Azure, Google Cloud, SCVMM, VMware e XenServer.

Para executar com êxito o comando do PowerShell, verifique se:

• As VMs de destino estão em um catálogo MCS persistente.
• O catálogo de máquinas do 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á no modo de manutenção.
• As VMs de destino estão desligadas e no modo de manutenção.

Execute as seguintes etapas para redefinir o disco do sistema operacional:

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

3. Executar 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 de 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 Get-ProvVM comando. Isso é menos eficiente porque cada tarefa executará as mesmas verificações redundantes, como verificação de funcionalidade do hipervisor, verificação de conexão para cada VM.

        Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
       

4. É 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 Entrar, nenhuma outra ação será realizada.

   Você pode executar o comando do PowerShell -E se 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 -Força parâmetro:

        Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force
       

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

        Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
       

   • Antes de executar o Reset-ProvVMDiskmudar $ConfirmPreference para ‘Nenhum’:

        PS C:\Windows\system32> $ConfirmPreference='None'
        PS C:\Windows\system32> $ConfirmPreference
        None
        PS C:\Windows\system32> Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
       

   Observação:

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

5. Correr Get-ProvTask para obter o status das tarefas retornadas por Reset-ProvVMDisk comando.

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 é compatível apenas com ambientes de virtualização AWS, Azure, GCP, SCVMM, VMware e XenServer.

Condições

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

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

Redefinir informações de identidade

Para redefinir as informações de identidade:

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

3. Redefina as informações de identidade.

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

        Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
       

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

     • NomedaContaIdentidade: o nome da conta de identidade que deve ser reparada.
     • Nome de usuário privilegiado: conta de usuário que tem permissão de gravação no provedor de identidade (AD ou Azure AD).
     • PrivilegedUserPassword: Senha para PrivilegedUserName.
     • Alvo: Destino para a ação de reparo. Pode ser IdentityInfo para reparar a senha/chave de confiança da conta e UserCertificate para reparar atributos de certificado de usuário de identidades de computador ingressadas no Azure AD híbrido.

   • 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
       

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

     Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force
    

5. Correr Get-ProvVM -ProvisioningSchemeName <name -VMName <name> para verificar a configuração atualizada do disco de identidade. Os atributos do disco de identidade (por exemplo, IdentidadeDiskId) deve ser atualizado. O Identificação de armazenamento e IdentityDiskIndex não deve mudar.

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

Você pode alterar a configuração de rede de um catálogo de máquinas existente para que as novas VMs sejam criadas na nova sub-rede. Use o parâmetro -Mapeamento de rede No Set-ProvScheme para alterar a configuração de rede.

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

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

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

     $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
    

4. Correr Set-ProvScheme -ProvisioningSchemeName "nome" -NetworkMapping $NewNetworkMap.
5. Correr (Get-Provscheme -ProvisioningSchemeName "nome"). Mapas de rede 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 do MCS é atualizado com o 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 comandos do PowerShell. É possível:

• Consulte 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:

• VMCpuCount
• VMMemoryMB
• Propriedades Personalizadas
• Oferta de serviço
• 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
    

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

     Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2
    

• 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 do 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, siga um destes procedimentos:

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

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

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

• WriteBackCacheMemorySize
• WriteBackCacheDiskSize

Atualmente, esse recurso é aplicável a:

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

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áquinas existente. Usar Novo Esquema de Prov Para criar um catálogo de máquinas com UseWriteBackCache Habilitado. Por exemplo:

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

Alterar a configuração do cache

Execute o comando Set-ProvScheme comando. Por exemplo:

  Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128
 

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 de máquinas.
• Essas alterações afetam apenas as novas VMs adicionadas ao catálogo depois que a alteração é feita. As VMs existentes não são afetadas por essas alterações.

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

Você pode usar uma VM, uma especificação de modelo (no caso do Azure) ou um modelo de inicialização (no caso do AWS) ou um modelo VMware (no caso do VMware) 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. Novas VMs adicionadas ao catálogo obtêm valores de propriedade do perfil do computador.

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:

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

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

   • No caso do Azure:

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

   • No caso da AWS:

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

   • No caso da VMware:

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

     Observação:

     Defina o ID da pasta como a propriedade customizada para evitar derivar ID da pasta do modelo VMware.

Recuperar avisos e erros associados a um catálogo

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

Usando comandos do PowerShell, você pode:

• Obter uma lista de erros ou avisos
• Altere o estado de aviso de Novo Para Reconhecido
• Excluir os erros ou avisos

Para executar os comandos do PowerShell:

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

Para obter uma lista de erros e avisos:

Correr Get-ProvOperationEvent comando.

• Sem parâmetros: Obtém todos os erros e avisos
• Com LinkedObjectType e LinkedObjectUid parâmetro: Obtém todos os erros e avisos associados a um esquema de provisionamento específico
• Com Identificação do evento parâmetro: Obtém um erro ou aviso específico que corresponde a esse ID de evento
• Com Filtro parameter: Obtém erros ou avisos por um filtro personalizado

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

Correr Confirm-ProvOperationEvent comando.

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

Para excluir os erros ou avisos:

Correr Remove-ProvOperationEvent comando.

• Com Identificação do evento parameter: remove um erro ou aviso específico que corresponde a essa ID de evento. Você pode obter o Identificação do evento de um erro ou aviso específico como uma saída de Get-ProvOperationEvent comando
• Com LinkedObjectType e LinkedObjectUid parameters: Remove todos os erros e avisos associados a um esquema de provisionamento específico
• Com Todo parâmetro: Remove todos os erros e avisos

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

Excluir computadores sem acesso ao hipervisor

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

Esta opção é ativada em:

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

Limitações

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

Usar o comando PurgeDBOnly

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

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

Observação:

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

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

Try to use -PurgeDBOnly option to clean DDC database.

Use o -PurgeDBOnly na opção Remover-ProvVM Comando do PowerShell para excluir referências de uma VM do banco de dados MCS. Por exemplo,

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

Atualizar propriedades de VMs individuais

Você pode atualizar propriedades de VMs individuais em um catálogo de máquinas MCS persistente usando o comando do PowerShell Set-ProvVM. No entanto, as atualizações não são aplicadas imediatamente. Você deve definir a janela de tempo usando o comando do PowerShell Set-ProvVMUpdateTimeWindow para que as atualizações sejam aplicadas.

Essa implementação ajuda você a gerenciar VMs individuais com eficiência sem atualizar todo o catálogo de máquinas. Atualmente, esse recurso é aplicável somente ao ambiente do Azure.

Atualmente, as propriedades que você pode atualizar são:

• Propriedades Personalizadas
• ServiceOffering
• Perfil da máquina

Usando esse recurso, você pode:

• Atualizar as propriedades de uma VM
• Manter as propriedades atualizadas em uma VM depois que o catálogo de computadores for atualizado
• Reverter as atualizações de configuração aplicadas a uma VM

Antes de atualizar as propriedades de uma VM:

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

3. Verifique a configuração do catálogo de máquinas existente. Por exemplo:

     Get-ProvScheme -ProvisioningSchemeName AzureCatalog
    

4. Verifique a configuração da VM na qual você deseja aplicar as atualizações. Por exemplo:

     Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    

Atualizar propriedades de uma VM

Faça o seguinte para atualizar as propriedades em uma VM:

1. Desative a VM na qual você deseja aplicar as atualizações.

2. Atualize as propriedades da VM. Por exemplo, se você quiser atualizar o tipo de armazenamento (Tipo de armazenamento) da VM, execute o seguinte:

     Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
    

   Você pode atualizar as propriedades de duas VMs em um catálogo de máquinas simultaneamente. Por exemplo:

     Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
    

     Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine2 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
    

   Nota:

   As atualizações não são aplicadas imediatamente.

3. Obtenha a lista de propriedades especificadas para serem atualizadas e a versão de configuração. Por exemplo:

     Get-ProvVMConfiguration -ProvisioningSchemeName AzureCatalog -VMName machine1
    

   Verifique o valor da propriedade de Versão e as propriedades a serem atualizadas (neste caso, Tipo de armazenamento).

4. Verifique a versão de configuração. Por exemplo:

     Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    

   Verifique o valor da propriedade de ProvVMConfigurationVersion. A atualização ainda não foi aplicada. A VM ainda está na configuração antiga.

5. Solicite atualização agendada. Por exemplo:

      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -StartsNow -DurationInMinutes -1
     

   Para obter mais informações sobre atualizações agendadas, consulte Atualizar as máquinas provisionadas para o estado atual do esquema de provisionamento.

   Observação:

   Qualquer atualização pendente do esquema de provisionamento também é aplicada.

6. Reinicie a VM. Por exemplo:

     New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
    

7. Verifique a versão de configuração. Por exemplo:

     Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    

   Verifique o valor da propriedade de ProvVMConfigurationVersion. A atualização agora é aplicada. A VM agora tem a nova configuração.

8. Para aplicar mais atualizações de configuração na VM, desative a VM e repita as etapas.

Manter as propriedades atualizadas em uma VM depois que o catálogo de computadores for atualizado

Faça o seguinte para manter as propriedades atualizadas em uma VM:

1. Desative a VM na qual você deseja aplicar as atualizações.

2. Atualize o catálogo de máquinas. Por exemplo, se você quiser alterar o tamanho da VM (Oferta de serviço) e tipo de depósito (Tipo de armazenamento), execute o seguinte:

     Set-ProvScheme -ProvisioningSchemeName AzureCatalog -ServiceOffering Standard_E4_v3 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
    

3. Obtenha os detalhes de configuração do catálogo de máquinas. Por exemplo:

     Get-ProvScheme -ProvisioningSchemeName AzureCatalog
    

   O ProvisioningSchemeVersion agora é incrementado em um. O tamanho da VM e o tipo de armazenamento também são atualizados.

4. Atualize as propriedades da VM. Por exemplo, forneça um perfil de computador para a VM.

     Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<template-spec>.templatespec\<template-spec-version>.templatespecversion"
    

   Observação:

   A entrada do perfil da máquina tem uma marca e um tamanho de VM diferente (Oferta de serviço) especificado.

5. Obtenha a lista de propriedades que a VM terá depois de mesclar as atualizações de configuração na VM com as atualizações do catálogo de máquinas. Por exemplo:

     Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName AzureCatalog -VMName machine1
    

   Observação:

   Todas as atualizações na VM substituirão as atualizações feitas no catálogo de máquinas.

6. Solicite uma atualização agendada para a VM. Por exemplo:

     Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -VMName machine1 -StartsNow -DurationInMinutes -1
    

7. Reinicie a VM. Por exemplo:

     New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
    

   A VM mantém seu tamanho de VM atualizado como derivado do perfil da máquina. Os valores de marca especificados no perfil da máquina também são aplicados à VM. No entanto, o tipo de armazenamento é derivado do esquema de provisionamento mais recente.

8. Obtenha a versão de configuração da VM. Por exemplo:

     Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    

   O ProvisioningSchemeVersion e ProvVMConfigurationVersion Agora mostra a versão mais recente.

Reverter as atualizações de configuração aplicadas a uma VM

1. Depois de aplicar as atualizações a uma VM, desative a VM.

2. Execute o comando a seguir para remover as atualizações aplicadas na VM. Por exemplo:

     Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName AzureCatalog -VMName machine1
    

3. Solicite uma atualização agendada para a VM. Por exemplo:

     Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -VMName machine1 -StartsNow -DurationInMinutes -1
    

4. Reinicie a VM. Por exemplo:

     New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
    

5. Verifique a versão de configuração da VM. Por exemplo:

     Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    

   O ProvVMConfigurationVersion agora é a versão de configuração do catálogo de máquinas.

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

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

Cmdlets do PowerShell

Dois novos parâmetros opcionais adicionados a New-VusCatalogSchedule e Atualização do New-VusMachineUpgrade cmdlets 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

• VDA Upgrade Agent para a versão 7.40.0.35 ou posterior (usando o instalador do VDA versão 2311 ou posterior)
• SDK do PowerShell remoto de aplicativos e áreas de trabalho virtuais versão 7.40 ou mais recente (lançado em 10 de janeiro de 2024 ou posterior)
• SDK do PowerShell remoto versão 7.42 ou posterior (lançado após 16 de fevereiro de 2024)

Como definir permissões de compartilhamento de arquivos

Os compartilhamentos de rede que contêm pacotes de instalação do 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 ingressado no domínio

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

  A permissão de privilégio mínimo pode ser definida concedendo o Ler acesso a computadores de domínio.

  1. Escolha as pessoas em sua rede com as quais você deseja compartilhar o arquivo.
  2. Clique Configurações avançadas de compartilhamento e ligue Compartilhamento de arquivos e impressoras.

• Permissão de compartilhamento de arquivos não ingressado no domínio

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

  1. Selecione uma pasta compartilhada.
  2. Desative a proteção por senha.
     1. Ir para a pasta Propriedades.
     2. Selecionar Central de Rede e Compartilhamento.
     3. Desativar Compartilhamento protegido por senha.
  3. Clique Compartilhamento avançado para conceder uma permissão de compartilhamento.
     1. Selecionar Permissões.
     2. Conceda um Ler compartilhar permissão para LOGON ANÔNIMO.
  4. Selecione o ícone Guia Segurança Para conceder permissões de pasta
     1. Clique Editar Para adicionar permissões à pasta compartilhada
     2. Selecione a pasta compartilhada para conceder permissões de pasta LOGON ANÔNIMO.
  5. Clique Avançado para ligar Compartilhamento de arquivos e impressoras.
  6. Adicione o nome da pasta compartilhada a 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

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

   Observação:

   Com o Serviço de Atualização Virtual, você pode selecionar entre a faixa Versão Atual ou a faixa LTSR.

   Por exemplo: Se o catálogo de máquinas 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é o Downloads página em Nosso site.
   2. Selecionar Aplicativos e desktops virtuais Citrix como o produto.
   3. Selecionar Citrix Virtual Apps and Desktops 7 2311, todas as edições.
   4. Selecione o instalador do VDA na caixa de diálogo Componentes que estão na ISO do produto, mas também embalados separadamente Expansível.

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

   • Baixe o arquivo Instalador VDA do sistema operacional multissessão Se o tipo de catálogo for Multi sessão
   • Baixe o arquivo Instalador de VDA do sistema operacional de sessão única Se o tipo de catálogo for Sessão única
   • Baixe o arquivo Instalador VDA de serviços principais do sistema operacional de sessão única Se o tipo de catálogo for Acesso remoto ao PC

Observação:

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

Solucionar problemas

• Para máquinas com Estado de energia desconhecido status, consulte CTX131267 para 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.
• Se um Cloud Connector não estiver funcionando corretamente, as operações de provisionamento do MCS (como atualizações de catálogo) demorarão mais do que o normal e o desempenho do console de gerenciamento será reduzido significativamente.

Para onde ir a seguir

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

• Gerenciar um catálogo da AWS
• Gerenciar um catálogo do Google Cloud Platform
• Gerenciar um catálogo do Microsoft Azure
• Gerenciar um catálogo do Microsoft System Center Virtual Machine Manager
• Gerenciar um catálogo VMware
• Gerenciar um catálogo do XenServer