Citrix Virtual Apps and Desktops

Gerenciar catálogos de máquinas

Nota:

Você pode gerenciar a implantação do seu Citrix Virtual Apps and Desktops usando dois consoles de gerenciamento: Web Studio (baseado na Web) e Citrix Studio (baseado no 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 a partir de um catálogo de máquinas, renomear, alterar a descrição ou gerenciar contas de computador do Active Directory de um catálogo.

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

  • Catálogos contendo máquinas em pool aleatórias criadas usando o Machine Creation Services (MCS) fazem a manutenção das máquinas atualizando a imagem mestre usada no catálogo e, depois, atualizando as máquinas. Esse método permite que você atualize eficientemente um grande número de máquinas de usuário.
  • Para catálogos contendo máquinas estáticas e permanentemente atribuídas e para catálogos de máquinas de Remote PC Access, as atualizações de máquinas de usuários são realizadas fora do Web Studio. Usando ferramentas de distribuição de software de terceiros, execute a tarefa individualmente ou coletivamente.

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

Nota:

O MCS não suporta o Windows 10 IoT Core e 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, as novas máquinas criadas para o catálogo usam a imagem atualizada. As instâncias pré-existentes continuam a usar a instância original. O processo de atualização de uma imagem é feito da mesma maneira para todos os outros tipos de catálogo. Considere o seguinte:

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

Gerenciar catálogos de máquinas

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

Usar o Web Studio

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

Antes de começar:

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

Para adicionar máquinas a um catálogo:

  1. Faça login no Web Studio.
  2. Selecione Machine Catalogs no painel esquerdo.
  3. Selecione um catálogo de máquinas e, em seguida, selecione Add Machines na barra de ações.
  4. Selecione o número de máquinas virtuais a serem adicionadas.
  5. 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 onde as contas são criadas. Especifique um esquema de nomenclatura de conta usando marcas de hash para indicar onde os números ou letras sequenciais aparecem. Não use barra (/) no nome de uma unidade organizacional. 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 com os nomes PC-Sales-01, PC-Sales-02, PC-Sales-03 e assim por diante.
  6. Se você usar contas existentes do Active Directory, navegue até as contas ou clique em Import e especifique o arquivo .csv que contém o nome das 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, podendo levar bastante tempo quando muitas máquinas são criadas. A criação da máquina continua mesmo se você fechar o Web Studio.

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

  • Foi feito backup dos dados do usuário ou os dados não são mais necessários.
  • Todos os usuários fizeram logoff. Ativar o modo de manutenção impede que sejam estabelecidas novas conexões a uma máquina.
  • As máquinas estão desligadas.

Para excluir máquinas de um catálogo:

  1. Faça login no Web Studio.
  2. Selecione Machine Catalogs no painel esquerdo.
  3. Selecione um catálogo e, em seguida, selecione View Machines na barra de ações.
  4. Selecione uma ou mais máquinas e, em seguida, selecione Delete na barra de ações.

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

  1. Na página Description, altere a descrição do catálogo.
  2. Selecione Machine Catalogs no painel esquerdo.
  3. Selecione um catálogo e, em seguida, selecione Edit Machine Catalog na barra de ações.
  4. Na página Scopes, altere os escopos.
  5. Você pode ver páginas adicionais dependendo do tipo de catálogo.

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

    • Na página Virtual Machines, altere o tamanho da máquina e as zonas de disponibilidade nas quais você deseja criar máquinas.

      Nota:

      • Somente os tamanhos de máquina que o catálogo suporta são mostrados.
      • Se necessário, selecione Show only machine sizes used in other machine catalogs para filtrar a lista de tamanhos de máquina.
    • Na página Machine Profile, escolha se deseja usar ou alterar um perfil de máquina.

    • Na página License Type, escolha se deseja alterar a configuração da licença do Windows ou da licença do Linux.

    Para catálogos de acesso remoto a PC, as seguintes páginas estão visíveis:

    • Na página Power Management, altere as configurações de gerenciamento de energia e selecione uma conexão de gerenciamento de energia.
    • Na página Organizational Units, adicione ou remova unidades organizacionais do Active Directory.
  6. Clique em Apply para aplicar as alterações feitas e clique em Save para sair.
  1. Faça login no Web Studio.
  2. Selecione Machine Catalogs no painel esquerdo.
  3. Selecione um catálogo e, em seguida, selecione Rename Machine Catalog na barra de ações.
  4. Digite o novo nome.

Mover um catálogo para uma zona diferente

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

Mover um catálogo para uma zona que não seja a do hipervisor que contém as VMs no catálogo afeta o desempenho.

  1. Faça login no Web Studio.
  2. Selecione Machine Catalogs no painel esquerdo.
  3. Selecione um catálogo e, em seguida, selecione Move na barra de ações.
  4. Selecione a zona para onde deseja mover o catálogo.

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

  • Todos os usuários fizeram logoff e não há sessões desconectadas em execução.
  • O modo de manutenção está ativado para todas as máquinas do catálogo, de modo que novas conexões não possam ser estabelecidas.
  • 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. Faça login no Web Studio.
  2. Selecione Machine Catalogs no painel esquerdo.
  3. Selecione um catálogo e, em seguida, selecione Delete Machine Catalog na barra de ações.
  4. Indique se as máquinas no catálogo devem ser excluídas. Se você optar por excluir as máquinas, indique se as contas de computador do Active Directory dessas máquinas serão mantidas, desativadas ou excluídas.

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

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

Para gerenciar contas do Active Directory:

  1. Faça login no Web Studio.
  2. Selecione Machine Catalogs no painel esquerdo.
  3. Selecione um catálogo e, em seguida, selecione Manage AD accounts na barra de ações.
  4. Escolha se deseja adicionar ou excluir contas de computador. Se você adicionar contas, especifique o que fazer com as senhas das contas: redefinir todas elas ou inserir uma senha que se aplique a todas as contas.

    Você pode redefinir as senhas se não souber as senhas da conta atual, mas deve ter permissão para executar uma redefinição de senha. Ao inserir uma senha, a senha é alterada nas contas à medida que elas são importadas. Ao excluir uma conta, escolha se a conta no Active Directory deve ser mantida, desativada ou excluída.

Indique se as contas do Active Directory serão mantidas, desativadas ou excluídas quando você remover máquinas de um catálogo ou excluir um catálogo.

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

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

Atualizar ou criar uma imagem mestre

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

  1. No hipervisor, tire um instantâneo da VM atual e dê um nome significativo ao instantâneo. Esse instantâneo pode ser usado para reverter máquinas no catálogo, se necessário.
  2. Se necessário, ligue a imagem mestre e faça logon.
  3. Instale atualizações ou faça as alterações necessárias na imagem mestre.
  4. Desligue a VM.
  5. Tire um instantâneo da VM. Dê a ele um nome significativo que seja facilmente 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 o instantâneo no Web Studio. Esse processo permite que você forneça um nome e uma descrição significativos em vez de um nome gerado automaticamente. Para imagens mestre de GPU, você pode alterar a imagem mestre somente por meio do console Citrix Hypervisor.

Alterar a imagem mestre

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

  1. Faça login no Web Studio.
  2. Selecione Machine Catalogs no painel esquerdo.
  3. Selecione um catálogo e, em seguida, selecione Change Master Image na barra de ações.
  4. Na página Master Image, selecione o host e a imagem que você deseja implantar.

    Dica:

    Para um catálogo criado pelo MCS, você pode anotar sua imagem adicionando uma nota para a imagem. Uma nota pode conter até 500 caracteres. Cada vez que você altera a imagem mestre, é criada uma entrada relacionada à nota se você adicionar uma nota. Se você atualizar um catálogo sem adicionar uma nota, a entrada aparecerá como null (-). Para exibir o histórico de notas da imagem, selecione o catálogo, clique em Template Properties no painel inferior e, em seguida, clique em View note history.

  5. 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ó se aplica a VMs não persistentes.

  6. Verifique as informações na página Summary e clique em Finish. Cada máquina reinicializa automaticamente depois de ser atualizada.

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

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

Estratégia de implantação:

A atualização da imagem no próximo desligamento afetará imediatamente todas as máquinas que não estejam em uso no momento, ou seja, 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. Considere o seguinte:

  • Novas sessões não podem ser iniciadas até que a atualização seja concluída nas máquinas aplicáveis.
  • No caso de máquinas de SO de sessão única, as máquinas são imediatamente atualizadas quando não estão em uso ou quando os usuários não estão conectados.
  • No caso de um SO de sessão única com máquinas secundárias, as reinicializações não ocorrem automaticamente. Elas devem ser desligadas e reinicializadas manualmente.

Dica:

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

Se você quiser ativar o agendamento de reinicialização única usando o PowerShell, consulte Ativar agendamento de reinicialização única.

Reverter a imagem mestre

Depois de implantar uma imagem mestre atualizada ou nova, você pode revertê-la. Esse processo pode ser necessário se ocorrerem problemas com as máquinas recentemente atualizadas. Quando você faz a reversão, as máquinas no catálogo voltam para a última imagem funcional. Os novos recursos que exigem a imagem mais recente não estarão mais disponíveis. Tal como acontece com a implantação, a reversão de uma máquina inclui uma reinicialização.

  1. Faça login no Web Studio.
  2. Selecione Machine Catalogs no painel esquerdo.
  3. Selecione o catálogo e, em seguida, selecione Roll Back Master Image na barra de ações.
  4. Especifique quando aplicar às máquinas a imagem mestre anterior, conforme descrito na seção anterior sobre a operação de implantação.

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

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

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

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

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:

  1. Faça login no Web Studio.
  2. Selecione Machine Catalogs no painel esquerdo.
  3. Selecione o catálogo. A guia Details no painel inferior exibe informações da versão
  4. Selecione Change Functional Level. Se o Web Studio detectar que o catálogo precisa de atualização, ele exibe uma mensagem. Siga as instruções. Se uma ou mais máquinas não puderem ser atualizadas, uma mensagem explica o motivo. Para garantir que todas as máquinas funcionem corretamente, a Citrix recomenda que você resolva o problema com as máquinas antes de clicar em Change para prosseguir.

Após a conclusão da alteração do catálogo, você pode reverter as máquinas para suas versões anteriores do VDA selecionando o catálogo e escolhendo Undo Functional Level Change na barra de ações.

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

  • Não é possível alterar as configurações associadas ao sistema operacional e gerenciamento da máquina. O catálogo clonado herda essas configurações do original.
  • A clonagem de um catálogo pode levar algum tempo para ser concluída. Se necessário, selecione Hide progress para executar a clonagem em segundo plano.
  • O catálogo clonado herda o nome do original e tem um sufixo Copy. Você pode mudar o nome. Consulte Renomear um catálogo.
  • Após a conclusão da clonagem, atribua o catálogo clonado a um grupo de entrega.
  1. Entre no Web Studio e selecione Machine Catalogs no painel esquerdo.
  2. Selecione um catálogo e, em seguida, selecione Clone na barra de ações.
  3. Na janela Clone Selected Machine Catalog, exiba as configurações do catálogo clonado e defina as configurações conforme aplicável. Selecione Next para prosseguir para a próxima página.
  4. Na página Summary, exiba um resumo das configurações e selecione Finish para iniciar a clonagem.
  5. Se necessário, selecione Hide progress para executar a clonagem em segundo plano.

Organizar catálogos usando pastas

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

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 nome com outros nós ao renomear ou mover pastas, recomendamos que você atribua nomes diferentes às pastas de primeiro nível nos diferentes nós.

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

  1. Selecione Machine Catalogs no painel esquerdo.
  2. Na hierarquia de pastas, selecione uma pasta e, em seguida, selecione Create Folder na barra Action.
  3. Insira um nome para a nova pasta e clique em Done.

Dica:

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

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

  1. Selecione Machine Catalogs no painel esquerdo.
  2. Exiba os catálogos por pasta. Você também pode ativar View all acima da hierarquia de pastas para exibir todos os catálogos de uma vez só.
  3. Clique com o botão direito do mouse em um catálogo e selecione Move Machine Catalog.
  4. Selecione a pasta para a qual deseja mover o catálogo e clique em Done.

Dica:

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

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. Selecione Machine Catalogs no painel esquerdo.
  2. Na hierarquia de pastas, selecione uma pasta e, em seguida, selecione uma ação na barra Action, conforme necessário:

    • Para renomear a pasta, selecione Rename Folder.
    • Para excluir a pasta, selecione Delete Folder.
    • Para mover a pasta, selecione Move Folder.
  3. Siga as instruções na tela para concluir as etapas restantes.

Usar o PowerShell

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

Você pode receber 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:

  • Obter uma lista de erros ou avisos
  • Alterar o estado do aviso de New para Acknowledged
  • Excluir os erros ou avisos

Para executar os comandos do PowerShell:

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

Para obter uma lista de erros e avisos:

Execute o comando Get-ProvOperationEvent.

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

Para alterar o estado de erros ou avisos de New para Acknowledged:

Execute o comando Confirm-ProvOperationEvent.

  • 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 a saída EventId de um erro ou aviso específico como uma saída do comando Get-ProvOperationEvent
  • Com os parâmetros LinkedObjectType e LinkedObjectUid: define o estado de todos os erros e avisos associados a um esquema de provisionamento específico
  • Com o parâmetro All: define o estado de todos os erros e avisos como Acknowledged.

Para excluir os erros ou avisos:

Execute o comando Remove-ProvOperationEvent.

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

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

Ativar agendamento de reinicialização única

Se você quiser ativar o agendamento de reinicialização única usando o PowerShell, use os seguintes comandos BrokerCatalogRebootSchedule do PowerShell para criar, modificar e excluir um agendamento de reinicialização:

  • Get-BrokerCatalogRebootSchedule
  • New-BrokerCatalogRebootSchedule
  • Set-BrokerCatalogRebootSchedule
  • Remove-BrokerCatalogRebootSchedule
  • Rename-BrokerCatalogRebootSchedule

Por exemplo,

  • Para criar um agendamento de reinicialização das VMs no catálogo chamado BankTellers para começar em 3 de fevereiro de 2022, entre 2h e 4h.

     C:\PS> New-BrokerCatalogRebootSchedule -Name BankTellers -CatalogName BankTellers  -StartDate "2022-02-03" -StartTime "02:00" -Enabled $true -RebootDuration 120
     <!--NeedCopy-->
    
  • Para criar um agendamento de reinicialização das VMs no catálogo com o UID 17 para começar em 3 de fevereiro de 2022, entre 1h e 5h. Dez minutos antes da reinicialização, cada VM é configurada para exibir uma caixa de mensagem com o título WARNING: Reboot pending e a mensagem Save your work em cada sessão do usuário.

     C:\PS> New-BrokerCatalogRebootSchedule -Name 'Update reboot' -CatalogUid 17 -StartDate "2022-02-03" -StartTime "01:00" -Enabled $true -RebootDuration 240 -WarningTitle "WARNING: Reboot pending" -WarningMessage "Save your work" -WarningDuration 10
     <!--NeedCopy-->
    
  • Para renomear o agendamento de reinicialização do catálogo chamado Old Name para New Name.

    C:\PS> Rename-BrokerCatalogRebootSchedule -Name "Old Name" -NewName "New Name"
    <!--NeedCopy-->
    
  • Para exibir todos os agendamentos de reinicialização do catálogo com o UID 1 e renomear o agendamento de reinicialização do catálogo com o UID 1 para New name.

    C:\PS> Get-BrokerCatalogRebootSchedule -Uid 1 | Rename-BrokerCatalogRebootSchedule -NewName "New Name" -PassThru
    <!--NeedCopy-->
    
  • Para definir o agendamento de reinicialização do catálogo chamado Accounting para exibir uma mensagem com o título WARNING: Reboot pending e a mensagem Save your work dez minutos antes da reinicialização de cada VM. A mensagem aparece em todas as sessões do usuário nessa VM.

    ``` C:\PS> Set-BrokerCatalogRebootSchedule -Name Accounting -WarningMessage “Save your work” -WarningDuration 10 -WarningTitle “WARNING: Reboot pending”

  • Para exibir todos os agendamentos de reinicialização que estão desativados e habilitar todos os agendamentos de reinicialização desativados.

     C:\PS> Get-BrokerCatalogRebootSchedule -Enabled $false | Set-BrokerCatalogRebootSchedule -Enabled $true
     <!--NeedCopy-->
    
  • Para definir o agendamento de reinicialização do catálogo com o UID 17 para exibir a mensagem Rebooting in %m% minutes quinze, dez e cinco minutos antes da reinicialização de cada VM.

     C:\PS> Set-BrokerCatalogRebootSchedule 17 -WarningMessage "Rebooting in %m% minutes." -WarningDuration 15 -WarningRepeatInterval 5
     <!--NeedCopy-->
    
  • Para configurar o fuso horário do catálogo chamado MyCatalog.

     C:\PS> Set-BrokerCatalog -Name "MyCatalog" -TimeZone <TimeZone>
     <!--NeedCopy-->
    

Adicionar descrições a uma imagem

Você pode adicionar descrições informativas sobre alterações relacionadas a atualizações de imagens para catálogos de máquinas. Use 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 seguintes comandos para adicionar ou exibir 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 visualizar 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 fica 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 de SO.
  • O instantâneo usado para criar o catálogo tornou-se corrompido.
  • As alterações do usuário nas máquinas no catálogo não persistem.
  • As máquinas no catálogo estão sendo executadas.

Redefinir disco do sistema operacional

Use o comando 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 Azure, Citrix Hypervisor e Google Cloud. Ambientes de virtualização SCVMM e VMware.

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

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

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

  1. Abra uma janela do PowerShell.
  2. Execute asnp citrix* para carregar os módulos do PowerShell específicos à Citrix.
  3. Execute o comando Reset-ProvVMDisk do PowerShell de qualquer uma das seguintes formas:

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

       Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS
       <!--NeedCopy-->
      
    • Especifique a lista de VMs como saída do comando Get-ProvVM e execute a redefinição em cada VM:

       (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS
       <!--NeedCopy-->
      
    • Especifique uma única VM pelo nome:

       Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
       <!--NeedCopy-->
      
    • Crie tarefas de redefinição separadas para cada uma das VMs retornadas pelo comando Get-ProvVM. Isso é menos eficiente porque cada tarefa executará as mesmas verificações redundantes, como a verificação da capacidade do hipervisor e verificação de conexão para cada VM.

       Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
       <!--NeedCopy-->
      
  4. É exibido um prompt de confirmação que lista as VMs a serem redefinidas juntamente com uma mensagem de aviso de que essa é uma operação irrecuperável. Se você não fornecer uma resposta e pressionar Enter, nenhuma ação é executada.

    Nota:

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

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

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

    • Forneça o parâmetro -Force:

       Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force
       <!--NeedCopy-->
      
    • Forneça o parâmetro -Confirm:$false:

       Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
       <!--NeedCopy-->
      
    • Antes de executar o Reset-ProvVMDisk, mude $ConfirmPreference para None:

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

Alterar a configuração de rede de 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 é compatível com o Citrix Virtual Apps and Desktops 2203 LTSR CU3 e versões posteriores.

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

  1. Na janela do PowerShell, execute o comando asnp citrix* para carregar os módulos do PowerShell.
  2. Execute (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps para chegar ao caminho de rede que deseja alterar.
  3. Atribua uma variável à nova configuração de rede. Por exemplo:

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

Solucionar problemas

O que fazer a seguir

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