Documentação de produtos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Gerenciar catálogos de máquinas

November 8, 2024
Contribuição de: 
C C

Observação:

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 para hospedar hipervisores, consulte Conexões e recursos.

Observação:

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:

  1. Use a função de pesquisa para localizar um catálogo de máquinas específico. Consulte 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 esse catálogo.
Coluna Descrição
Catálogo de máquinas

O nome e o tipo de alocação do catálogo. Os tipos de alocação incluem:
  • Aleatório: as máquinas no catálogo são alocadas para um usuário aleatoriamente.
  • Permanente: As máquinas no catálogo são alocadas permanentemente para um usuário.
    		•
    Tipo de máquina




    		O tipo de sessão suportado das máquinas no catálogo. Os valores possíveis incluem:
  • Tipo de sistema operacional: sistema operacional multissessão (virtual); Dados do usuário: Descartar.
  • Tipo de sistema operacional: sistema operacional multissessão (virtual); Dados do usuário: No disco local
  • Tipo de sistema operacional: sistema operacional de sessão única (acesso remoto ao PC)
  • Tipo de sistema operacional: sistema operacional de sessão única (virtual); Dados do usuário: descartar
  • Tipo de sistema operacional: sistema operacional de sessão única (virtual); Dados do usuário: No disco local
    		•
    Contagem de máquinas A contagem de máquinas no catálogo e o método de provisionamento. Os métodos de provisionamento possíveis incluem: serviços de criação de máquinas (máquina MCS), serviços manuais e de provisionamento Citrix.
    Contagem alocada O número de máquinas no catálogo atribuídas a um grupo de entrega.
    Pasta A localização do catálogo na árvore Machine Catalogs . Ele exibe o nome da pasta em que o catálogo está (incluindo a barra invertida final) ou - se o catálogo estiver no nível raiz.
    Atualização do VDA Estado de atualização do VDA. Os valores possíveis incluem: Não configurado, agendado, disponível e atualizado.
    Status da imagem O status de atualização da imagem do catálogo. Aplicável somente a catálogos de máquinas não persistentes. Os valores possíveis incluem: Totalmente atualizado, Parcialmente atualizado, Atualizações pendentes, Preparação

    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 Adicionar máquinas na barra de ação.
    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 denominadas 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 Exibir máquinas na barra de ação.
    4. Selecione uma ou mais máquinas e, em seguida, selecione Excluir na barra de ação.

    Escolha se deseja excluir as máquinas que estão sendo removidas. Se você optar por excluir as máquinas, indique se as contas do Active Directory 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 Editar catálogo de máquinas na barra de ação.
    4. Na página Scopes , altere os escopos.

    5. Você pode ver outras páginas dependendo do tipo de catálogo.

      Para catálogos criados usando uma imagem do Azure Resource Manager, as seguintes páginas estão visíveis. Lembre-se de que as alterações feitas se aplicam 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 em que você deseja criar máquinas.

        Observação:

        • Somente os tamanhos de máquina que o catálogo suporta são mostrados.
        • Se necessário, selecione Mostrar somente tamanhos de máquinas usados em outros catálogos de máquinas para filtrar a lista de tamanhos de máquinas.

      • Na página Perfil da máquina, escolha se deseja usar ou alterar um perfil de máquina.

      • (Visível somente quando o catálogo estiver configurado com um host de grupo dedicado) Na página Grupo de hosts dedicados, escolha se deseja alterar um grupo de hosts.

      • Na página Tipos de armazenamento e licença, escolha se deseja alterar o tipo de armazenamento, o tipo de licença e as configurações da Galeria de Computadores do Azure (disponível somente quando Colocar imagem preparada na Galeria do Azure estiver em uso).

      Observação:

      Se a configuração recém-selecionada não suportar o tamanho atual da máquina, uma caixa de diálogo de aviso será exibida, informando que a alteração da configuração redefine a configuração do tamanho da máquina. Se você optar por continuar, um ponto vermelho aparecerá ao lado do menu Virtual Machines , solicitando que você selecione um novo tamanho de máquina.

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

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

      • Na página Gerenciamento de energia, altere as configurações de gerenciamento de energia e selecione uma conexão de gerenciamento de energia.
      • Na página Organizational Units, adicione ou remova unidades organizacionais do Active Directory.
    6. Clique em Aplicar para aplicar as alterações feitas e clique em Salvar 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 Renomear catálogo de máquinas na barra de ação.
    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ção.
    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 estão desconectados e você não executa nenhuma sessão desconectada.
    • 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 Excluir catálogo de máquinas na barra de ação.
    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 Gerenciar contas do AD na barra de ação.

    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 mestras de GPU, você pode alterar a imagem mestre somente por meio do console XenServer.

    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 Alterar imagem mestre na barra de ação.
    4. Na página Image , selecione o host e a imagem que você deseja lançar. > Dica: > > Para um catálogo criado pelo MCS, você pode anotar sua imagem adicionando uma nota 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 visualizar o histórico de notas da imagem, selecione o catálogo, clique em Propriedades do modelo no painel inferior e, em seguida, clique em Exibir histórico de notas.
    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. > Observação: > > A página Estratégia de implementação não está disponível para VMs persistentes porque a implementação só é aplicável a VMs não persistentes.
    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 progresso da atualização, localize o catálogo em Machine Catalogs para ver a barra de progresso embutida e o gráfico de progresso passo a passo.

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

    Estratégia de implantação:

    A atualização de imagens no próximo desligamento afetará imediatamente qualquer máquina que não esteja em uso no momento, ou seja, máquinas que não tenham uma sessão de usuário ativa. Um sistema que está em uso recebe a atualização quando a sessão ativa atual termina. Considere o seguinte:

    • Novas sessões não podem ser iniciadas até que a atualização seja concluída nas máquinas aplicáveis.
    • 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.

    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ção.
    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 ver a barra de progresso em linha e o gráfico de progresso passo a passo.

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

    Altere o nível funcional do catálogo de máquinas depois de atualizar os VDAs nas máquinas para uma versão mais recente. A Citrix recomenda atualizar todos os VDAs para a versão mais recente para permitir o acesso a todos os recursos 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 Alterar nível funcional. 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 os problemas da máquina antes de clicar em Alterar para continuar.

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

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

    • Você não pode alterar as configurações associadas ao sistema operacional e machine management. O catálogo clonado herda essas configurações do original.
    • A clonagem de um catálogo pode levar algum tempo para ser concluída. Se necessário, selecione Ocultar progresso para executar a clonagem em segundo plano.
    • O catálogo clonado herda o nome do original e tem o sufixo Copy. Você pode 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ção.
    3. Na janela Clone Selected Machine Catalog , visualize as configurações do catálogo clonado e defina-as conforme aplicável. Selecione Next para prosseguir para a próxima página.
    4. Na página Summary , veja um resumo das configurações e selecione Finish para iniciar a clonagem.
    5. Se necessário, selecione Ocultar progresso para executar a clonagem em segundo plano.

    Organize catálogos usando pastas

    Você pode criar pastas para organizar catálogos 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 Criar pasta na barra Action .
    3. Insira um nome para a nova pasta e clique em Concluído.

    Dica:

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

    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 Exibir todos os acima da hierarquia de pastas para visualizar todos os catálogos ao mesmo tempo.
    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 você deseja mover o catálogo e clique em Concluído.

    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 as etapas abaixo:

    1. Selecione Machine Catalogs no painel esquerdo.

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

      • Para renomear a pasta, selecione Renomear pasta.
      • Para excluir a pasta, selecione Excluir pasta.
      • Para mover a pasta, selecione Move Folder.
    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
    • 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 do PowerShell específicos à Citrix.

    Para obter uma lista de erros e avisos:

    Execute o comando Get-ProOperationEvent .

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

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

    Execute o comando Confirm-ProOperationEvent .

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

    Para excluir os erros ou avisos:

    Execute o comando Remove-ProOperationEvent .

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

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

    Adicionar descrições a uma imagem

    Você pode adicionar descrições informativas sobre alterações relacionadas 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 "Nota"
 <!--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 "Nota"
 <!--NeedCopy-->

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

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

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

    Você não pode reverter em determinados cenários, incluindo os seguintes. (A opção Roll Back Master Image não está visível).

    • Você não tem permissão para reverter.
    • O catálogo não foi criado usando o MCS.
    • O catálogo foi criado usando uma imagem do disco do sistema operacional.
    • O instantâneo usado para criar o catálogo foi corrompido.
    • As alterações do usuário nas máquinas no catálogo não persistem.
    • As máquinas do catálogo estão funcionando.

    Redefinir disco do sistema operacional

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

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

    • As VMs de destino estão em um catálogo MCS persistente.
    • O catálogo de máquinas MCS está funcionando corretamente.
    • Isso implica que o esquema de provisionamento e o host existem, e que o esquema de provisionamento tem entradas corretas.
    • O hipervisor não está no modo de manutenção.
    • As VMs de destino estão desligadas e em modo de manutenção.

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

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

    3. Execute o comando do PowerShell Reset-ProvVMDisk de qualquer uma das seguintes maneiras:

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

         Redefinir-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS
 <!--NeedCopy-->

      • Especifique a lista de VMs como uma saída do comando Get-ProvVM e execute a redefinição em cada VM:

         (Get-ProvVM -ProvisioningSchemeName "xxx") | Redefinir-ProvVMDisk "abc" -OS
 <!--NeedCopy-->

      • Especifique uma única VM pelo nome:

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

         Obter-ProvVM -ProvisioningSchemeName "xxx" | Redefinir-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
 <!--NeedCopy-->

    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 Enter, nenhuma ação adicional será realizada.

      Observação:

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

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

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

      • Forneça o parâmetro -Force :

         Redefinir-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force
 <!--NeedCopy-->

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

         Redefinir-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirmar:$false
 <!--NeedCopy-->

      • Antes de executar o Reset-ProvVMDisk, altere $ConfirmPreference para None:

         PS C:\Windows\system32> $ConfirmPreference='Nenhum'
 PS C:\Windows\system32> $ConfirmPreference
 Nenhum
 PS C:\Windows\system32> Redefinir-ProvVMDisk -NomeDoEsquemaDeProvisionamento "xxx" -NomeDaVM "abc" -SO
 <!--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.

    Observação:

    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 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\MinhasRedes\Nrede 0.rede"}
<!--NeedCopy-->
    4. Execute Set-ProvScheme -ProvisioningSchemeName “name” -NetworkMapping $NewNetworkMap.
    5. Execute (Get-Provscheme -ProvisioningSchemeName “name”) .networkMaps para verificar a nova configuração de rede para o esquema de provisionamento existente.

    Gerenciar versões de um catálogo de máquinas

    Quando um catálogo de máquinas MCS é atualizado com o comando Set-provScheme , a configuração atual é salva como uma versão. Em seguida, você pode gerenciar as várias versões do catálogo de máquinas usando os comandos do PowerShell. Você pode:

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

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

    • Contagem de CPUs do VMC
    • Memória VM MB
    • Propriedades personalizadas
    • ServiceOffering
    • MachineProfile
    • 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
 <!--NeedCopy-->

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

       Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Versão 2
 <!--NeedCopy-->

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

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

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

       Set-Prov Scheme - Nome do esquema de aprovisionamento Azure Catalog - Versão 2
 <!--NeedCopy-->

    • Para excluir manualmente uma versão se ela não for usada por uma VM do catálogo dessa máquina:

       Remove-provSchemeVersion - Nome do esquema de aprovisionamento Azure Catalog - Versão 3
 <!--NeedCopy-->

    • Para definir o número máximo de versões a serem retidas pelo catálogo da máquina (o padrão é 99). Esta configuração é aplicada em todos os catálogos. Por exemplo, neste caso, um máximo de 15 versões serão retidas para todos os catálogos provisionados pelo MCS.

       Set-provServiceConfigurationData - Nome “maxProvSchemeVersions” - Valor 15
 <!--NeedCopy-->

    Se o número de versões atingir o número máximo de versões, uma nova versão não poderá ser criada se versões mais antigas estiverem em uso por qualquer uma das VMs no catálogo de máquinas. Nesse caso, faça um dos seguintes:

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

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

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

    Observação:

    Um catálogo de máquinas baseado em perfil de máquina existente não pode ser alterado para um catálogo de máquinas baseado em perfil de máquina não.

    Para fazer isso:

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

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

      • No caso do Azure:

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

      • No caso da AWS:

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

    Reparar as informações de identidade 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 somente a senha da máquina e as chaves confiáveis ou redefinir todas as configurações do disco de identidade. A implementação é aplicável a catálogos de máquinas MCS persistentes e não persistentes.

    Observação:

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

    Condições

    Garanta o seguinte para redefinir com sucesso o disco de identidade:

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

    Redefinir disco de identidade

    Para redefinir o disco de identidade:

    1. Abra a janela do 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:

        
 Reparar-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 <!--NeedCopy-->

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

        • IdentityAccountName: O nome da conta de identidade que deve ser reparada.
        • PrivilegedUserName: conta de usuário que tem permissão de gravação no provedor de identidade (AD ou AzureAD).
        • PrivilegedUserPassword: Senha para PrivilegedUserName.
        • Target: Alvo para a ação de reparo. Pode ser IdentityInfo, para reparar a senha/chave confiável da conta, e UserCertificate, para reparar os atributos do certificado do usuário das identidades de máquinas ingressadas no Hybrid AzureAD.

      • Para redefinir todas as configurações do disco de identidade, execute os seguintes comandos na seguinte ordem:

        
 Reparar-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 <!--NeedCopy-->

        
 Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identidade
 <!--NeedCopy-->

      • Para recriar completamente o disco de identidade:

        
 Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate
 <!--NeedCopy-->

    4. Digite y para confirmar a ação. Você também pode pular o prompt de confirmação usando o parâmetro -Force. Por exemplo:

      Reset-provvmDisk - Nome do esquema de aprovisionamento <name> -Nome da VM <name> -Identidade -Força
<!--NeedCopy-->
    5. Execute Get-ProvVM -ProvisioningSchemeName <name -VMName <name> para verificar a configuração do disco de identidade atualizada. Os atributos do disco de identidade (por exemplo, IdentityDiskId) devem ser atualizados. O StorageId e o IdentityDiskIndex não devem mudar.

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

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

    • WriteBackCacheMemorySize
    • WriteBackCacheDiskSize

    Este recurso é atualmente aplicável a:

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

    Requisitos

    Os requisitos para modificar a configuração de cache são:

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

    • Habilite o parâmetro UseWriteBackCache para o catálogo de máquinas existente. Use New-ProvScheme para criar um catálogo de máquina com UseWriteBackCache habilitado. Por exemplo:

       Novo-ProvScheme -NomeDoEsquemaDeProvisionamento $CatalogName -UidDaUnidadeDeHospedagem $HostingUnitUid `
 -UidDoPoolDeIdentidade $acctPool.UidDoPoolDeIdentidade -CleanOnBoot` -VMDaImagemMestra $MasterImage `
 -OfertaDeServiço $ServiceOffering` -MapaDeRede $NetworkMap `
 -GrupoDeSegurança $SecurityGroup` -UseWriteBackCache -WriteBackCacheDiskTamanho 8
 <!--NeedCopy-->

    Altere a configuração do cache

    Execute o comando Set-ProvScheme. Por exemplo:

    Set-ProvScheme -NomeDoEsquemaDeProvisionamento $provScheme.NomeDoEsquemaDeProvisionamento -WriteBackCacheDisk32 -TamanhoDaMemóriaDoCacheDeWriteBack128 
<!--NeedCopy-->

    Observação:

    • O valor de writebackCacheDiskSize deve ser maior que zero porque é necessário pelo menos 1 GB de armazenamento em disco cache.
    • O valor de WritebackCacheMemorySize deve ser menor que o tamanho da memória do catálogo da máquina.
    • Essas alterações só afetam as novas VMs adicionadas ao catálogo depois que a alteração foi feita. As VMs existentes não são afetadas por essas mudanças.

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

    Especifique a localização do instalador do VDA por meio dos cmdlets do PowerShell, o que reduz seu esforço de fornecer regras de rede para permitir que cada VDA busque o novo instalador de VDA no Citrix Managed Azure CDN.

    Cmdlets PowerShell

    Dois novos parâmetros opcionais adicionados aos cmdlets New-VUSCatalogSchedule e New-VUSMachineUpgrade que permitem usar instaladores de um compartilhamento de arquivos local

    • VDAWorkstationPackageURI - para especificar o caminho UNC para o instalador VDA do sistema operacional da estação de trabalho
    • vdaServerPackageURI - para especificar o caminho UNC para o instalador VDA do sistema operacional do servidor

    Pré-requisitos

    • VUS Agent Installer que vem com o VDA 2311
    • Agente de upgrade do VDA para a versão 7.40.0.35 ou posterior (usando o instalador do VDA versão 2311 ou posterior)
    • Aplicativos e desktops virtuais Remote PowerShell SDK versão 7.40 ou mais recente (lançado em 10 de janeiro de 2024 ou posterior)

    Como definir permissões de compartilhamento de arquivos

    Os compartilhamentos de rede contendo pacotes do instalador de VDA devem ter acesso de leitura para o serviço VDA Upgrade Agent, que é executado como Sistema Local (NT AUTHORITY\ SYSTEM principal).

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

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

      A permissão de privilégio mínimo pode ser definida concedendo ao Read o acesso aos computadores do domínio.

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

    • Permissão de compartilhamento de arquivos não vinculados ao domínio

      Quando a máquina VDA não está associada ao domínio, a conta Local System (o VUA é executado como Sistema Local) usa ANONYMOUS LOGON ao acessar compartilhamentos de rede.

      1. Selecione uma pasta compartilhada.
      2. Desative a proteção por senha.
        1. Vá para a pasta Propriedades.
        2. Selecione Central de Rede e Compartilhamento.
        3. Desative Compartilhamento protegido por senha.
      3. Clique em Compartilhamento Avançado para conceder uma permissão de compartilhamento.
        1. Selecione Permissões.
        2. Conceda uma permissão de compartilhamento Read para ANONYMOUS LOGON.
      4. Selecione a guia Security Tab para conceder permissões de pasta
        1. Clique em Editar para adicionar permissões à pasta compartilhada
        2. Selecione a pasta compartilhada para conceder permissões de pasta para ANONYMOUS LOGON.
      5. Clique em Avançado para ativar Compartilhamento de arquivos e impressoras.
      6. Adicione o nome da pasta compartilhada à Política de Segurança de Acesso à Rede.

      Observação:

      Reinicie sua máquina para que a alteração entre em vigor imediatamente.

    Atualizações de VDA a partir de um compartilhamento de arquivos local

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

      Observação:

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

      Por exemplo: Se o catálogo da máquina estiver definido como Versão atual 2311 e a versão do VDA for 2305, você deverá atualizar o VDA para a versão 2311.

      1. Navegue até a página Downloads em , nosso site.
      2. Selecione Citrix Virtual Apps and Desktops como produto.
      3. Selecione Citrix Virtual Apps and Desktops 7 2311, todas as edições.
      4. Selecione o instalador de VDA entre os componentes que estão na ISO do produto, mas também são embalados separadamente expansíveis.

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

      • Baixe o instalador VDA com sistema operacional multissessão ** se o tipo de catálogo for **multissessão
      • Baixe o instalador VDA de OS de sessão única se o tipo de catálogo for sessão única
      • Baixe o instalador VDA Single-session OS Core Services se o tipo de catálogo for Remote PC Access

    Observação:

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

    Solucionar problemas

    O que fazer a seguir

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

    Gerenciar catálogos de máquinas
    November 8, 2024
    Contribuição de: 
    C C
    November 8, 2024
    Contribuição de: 
    C C

    Neste artigo

    Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
    © 1999- Cloud Software Group, Inc. All rights reserved.