Citrix DaaS™

Gerenciar catálogos de máquinas

Observação:

Este artigo descreve como gerenciar catálogos usando o Studio e comandos do PowerShell. Se você criou o catálogo usando o nó Quick Deploy e continua a usar 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 máquina 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.

  • 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 máquinas de usuário com eficiência.
  • Para catálogos que contêm máquinas estáticas e permanentemente atribuídas, você pode gerenciar a imagem ou o modelo que esses catálogos usam atualmente, mas apenas as máquinas que você adicionar aos catálogos posteriormente serão criadas usando a nova imagem ou modelo.
  • Para catálogos do Remote PC Access, você gerencia as atualizações das máquinas dos usuários fora do Studio. Execute essa tarefa individualmente ou coletivamente usando ferramentas de distribuição de software de terceiros.

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

Observação:

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

Sobre instâncias persistentes

Ao atualizar a imagem mestre para um catálogo 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 que para qualquer outro tipo de catálogo. Considere o seguinte:

  • Com catálogos de disco persistentes, as máquinas pré-existentes não são atualizadas para a nova imagem, mas todas as novas máquinas adicionadas ao catálogo usam a nova imagem.
  • Para catálogos de disco não persistentes, a imagem da máquina é atualizada na próxima vez somente se a máquina for reiniciada dentro do Studio ou PowerShell. Se a máquina for reiniciada 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 devem residir em catálogos separados.

Gerenciar Catálogos de Máquinas

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

Usando o Studio

Esta seção detalha como você pode gerenciar catálogos usando o 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 este catálogo.
Coluna Descrição
Catálogo de Máquinas

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




    O tipo de sessão suportado das máquinas no catálogo. Os valores possíveis incluem:
  • Tipo de SO: SO de várias sessões (Virtual); Dados do usuário: Descartar.
  • Tipo de SO: SO de várias sessões (Virtual); Dados do usuário: No disco local
  • Tipo de SO: SO de sessão única (Remote PC Access)
  • Tipo de SO: SO de sessão única (Virtual); Dados do usuário: Descartar
  • Tipo de SO: SO de sessão única (Virtual); Dados do usuário: No disco local
  • Contagem de Máquinas A contagem de máquinas no catálogo e o método de provisionamento. Os métodos de provisionamento possíveis incluem: Machine Creation Services (máquina MCS), Manual e Citrix Provisioning™ Services.
    Contagem Alocada O número de máquinas no catálogo atribuídas a um grupo de entrega.
    Pasta O local do catálogo dentro da árvore Catálogos de Máquinas. Ele exibe o nome da pasta em que o catálogo está (incluindo a barra invertida final), ou - se o catálogo estiver no nível raiz.
    Atualização de 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 da atualização da imagem do catálogo. Aplicável apenas a catálogos de máquinas não persistentes. Os valores possíveis incluem: Totalmente atualizado, Parcialmente atualizado, Atualizações pendentes, Preparando

    Antes de começar:

    • Certifique-se de que o host de virtualização (hipervisor ou provedor de serviços em nuvem) tenha processadores, memória e armazenamento suficientes para acomodar as máquinas adicionais.
    • Certifique-se de ter 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, você deve ter permissão de administrador de domínio apropriada.

    Dica:

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

    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ções.
    3. Na página Máquinas Virtuais, selecione o número de máquinas virtuais a serem adicionadas.
    4. Na página Identidades da Máquina, configure as definições da seguinte forma:

      • Selecione uma identidade na lista.

      • Se aplicável, indique se deseja criar contas ou usar contas existentes, e o local (domínio) para essas 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 onde as contas são criadas.

        Se você usar contas do Active Directory existentes, navegue até as contas ou selecione Importar e especifique um arquivo .csv contendo os nomes das contas. Certifique-se de que haja 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 pool de identidades for usado por outros catálogos, você não poderá alterá-lo para um pool diferente usando o Studio. Em vez disso, use o cmdlet Set-ProvScheme do PowerShell. Para obter mais informações, consulte a Documentação do SDK do Citrix Virtual Apps and Desktops.

      • Especifique um esquema de nomenclatura de conta, usando sinais de cerquilha para indicar onde os números ou letras sequenciais aparecem. Por exemplo, um esquema de nomenclatura de PC-Vendas-## (com 0-9 selecionado) resulta em contas de computador nomeadas PC-Vendas-01, PC-Vendas-02, PC-Vendas-03 e assim por diante.

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

        Ao especificar com o que os nomes das contas começam, esteja ciente 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.

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

    5. Na página Credenciais de Domínio, selecione Inserir credenciais e insira as credenciais de 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.

    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ções. A janela Adicionar Máquinas é exibida.
    3. Selecione 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. Selecione Validar para executar verificações de validação em sua importação.
    8. Selecione Importar para concluir o processo.

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

    Observação:

    • Para usuários não-Active Directory, você deve digitar seus nomes neste formato: <provedor_de_identidade>:<nome_de_usuário>. Exemplo: AzureAD:nome_de_usuário.
    • Os nomes das VMs diferenciam maiúsculas de minúsculas. Ao inserir caminhos de VM, certifique-se de inserir os nomes das VMs corretamente.

    Ao editar o arquivo de modelo CSV, tenha em mente o 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 máquina e nome de usuário (samName):

      • Domain\ComputerName1, Domain\Username1
      • Domain\ComputerName2, Domain\Username1;Domain\Username2
      • Domain\ComputerName3, AzureAD:username

      • Somente para contas de máquina:

      • Domain\ComputerName1
      • Domain\ComputerName2

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

      • XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName1.vm,Domain\ComputerName1,Domain\Username1
      • XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName2.vm,Domain\ComputerName2,Domain\Username2

      • Somente para VMs:

      • XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName1.vm,Domain\ComputerName1
      • XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName2.vm,Domain\ComputerName2

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

        onde,

      • xpace-scale é 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.
      • East US.region é o RegionName: O nome da região com .region 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 máquinas que um arquivo pode conter é 1.000. Para importar mais de 1.000 máquinas, distribua-as em arquivos diferentes e, em seguida, importe esses arquivos um por um. Recomendamos que você importe no máximo 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 na mesma página Adicionar Máquinas. 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ções. A janela Adicionar Máquinas é exibida.
    3. Selecione 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:

    • Este recurso não está disponível para catálogos do Remote PC Access e provisionados por MCS.

    • A exportação e importação de máquinas em arquivos CSV é suportada apenas entre catálogos do mesmo tipo.

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

    A ferramenta de registro de VDA WebSocket 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:

    Esta 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 logon no VDA.
    2. Localize a ferramenta EnrollMachine.exe, em C:\Program Files\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:

    Parâmetro Obrigatório Descrição Exemplo
    -websocket_token_stdin Sim

    Lê o token de registro. .\EnrollMachine.exe -websocket_token_stdin
    -websocket_token_string Lê o token de registro diretamente do parâmetro da linha de comando. .\EnrollMachine.exe -websocket_token_string:<token>
    -websocket_token_file:[token-file-path] Lê o token de registro do caminho fornecido. .\EnrollMachine.exe -websocket_token_file:C:\token\test2.txt
    log:[log-file-path] Não Mostra os logs da ferramenta de registro. .\EnrollMachine.exe log:[C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt]
    -help Não Mostra um breve texto de ajuda. .\EnrollMachine.exe -help

    Após o registro bem-sucedido, você receberá uma mensagem de sucesso na ferramenta e nos logs. Certifique-se de fazer logon 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 registro em:

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

    Se você especificou um caminho diferente para os logs, pode usar log:[log-file-path] para recuperar seus logs.

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

    Código String Descrição
    0 Success O VDA foi adicionado com sucesso ao catálogo de máquinas.
    -1 InvalidArgument O parâmetro de entrada no token de registro é inválido.
    -2 BrokerAgentNotFound O serviço do agente do broker não foi encontrado.
    -3 TokenInvalid O token inserido é inválido.
    -4 TokenMissingRequiredClaims As declarações necessárias para o token estão faltando, por exemplo, CustomerId ou URIs de registro.
    -5 InternalError Ocorreu um erro geral.
    -6 TimedOut A tarefa expirou.
    -7 FailedToDetermineMachineADJoinedStatus O serviço que retorna o status de junção de AD da máquina falhou.
    -8 ADMachineFailedToFindSid O serviço que retorna o Sid da máquina AD falhou.
    -9 EnrollRequestFailed A solicitação falhou devido a um erro HTTP.
    -10 EnrollResponseMissingRequiredFields A resposta da ferramenta de registro está faltando o parâmetro VirtualSiteId.
    -11 InsufficientPermission Você não tem a permissão necessária para executar a tarefa.
    -12 FailedToDetermineMachineAadJoinedStatus O serviço que verifica o status de junção de AD da máquina gera um erro.
    -13 AadMachineFailedToFindDeviceId O parâmetro adicional AAD device id adicionado pelo sistema está vazio.
    -14 AadDeviceIdNotValid O parâmetro adicional AAD device id adicionado pelo sistema não é um GUID válido.
    -15 NoValidMacAddress Endereço MAC inválido.
    -16 FailedToGetComputerHostNameForVdaInstanceName Falha ao obter o nome do host do computador para definir o parâmetro adicional VdaInstanceName.
    -17 VirtualDesktopAgentRegistryKeyFailedToOpen Falha ao abrir a chave de registro do VDA para gravar a lista de Delivery Controllers.
    -18 Failed Token reached the max count O token falhou e atingiu a contagem máxima.

    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:

    • Os dados do usuário foram copiados ou não são mais necessários.
    • Todos os usuários estão desconectados. Ativar o modo de manutenção impede que novas conexões sejam feitas a uma máquina.
    • As máquinas estão desligadas.

    Para excluir máquinas de um catálogo:

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

    Ao excluir máquinas persistentes de um catálogo do Azure Resource Manager, as máquinas e os grupos de recursos associados são excluídos do Azure, mesmo que você opte por retê-los.

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

    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ções.
    3. Na página Escopos, altere os escopos.
    4. Na página NIC, execute as seguintes ações:

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

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

      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 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.
      • Este recurso não é suportado para hipervisores IBM Cloud.
      • Este recurso é suportado apenas para Nutanix Prism Element em hipervisores Nutanix.
    5. Na página Atualização de VDA, altere ou selecione a versão do VDA para a qual deseja atualizar. Para obter mais informações, consulte Atualização de 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 seguintes páginas estão visíveis. Lembre-se de que as alterações feitas se aplicam apenas às máquinas que você adicionar ao catálogo posteriormente. As máquinas existentes permanecem inalteradas.

      • Na página Máquinas Virtuais, altere o tamanho da máquina e as zonas de disponibilidade onde você deseja criar máquinas.

        Observação:

        • Somente os tamanhos de máquina que o catálogo suporta 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.
      • Na página Perfil da Máquina, escolha se deseja usar ou alterar um perfil de máquina.

      • (Somente quando o catálogo é configurado com um grupo de host dedicado) Na página Grupo de host dedicado, escolha se deseja alterar um grupo de host.

      • 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 apenas quando Colocar imagem preparada na Galeria do Azure está 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 de tamanho da máquina. Se você optar por continuar, um ponto vermelho aparecerá ao lado do menu Máquinas Virtuais, solicitando que você selecione um novo tamanho de máquina.

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

      Para catálogos do Remote PC Access, 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 Unidades Organizacionais, adicione ou remova OUs do Active Directory.
    7. Na página Descrição, altere a descrição do catálogo.
    8. Clique em Aplicar para aplicar as alterações feitas e clique em Salvar para sair.
    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ções.
    3. Insira o novo nome.

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

    • Todos os usuários estão desconectados e nenhuma sessão desconectada está em execução.
    • O modo de manutenção está ativado para todas as máquinas no catálogo para que novas conexões não possam ser feitas.
    • Todas as máquinas no catálogo estão desligadas.
    • O catálogo não está associado a um grupo de entrega. Em outras palavras, o grupo de entrega não contém máquinas do catálogo.

    Para excluir um catálogo:

    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ções.
    3. Se o catálogo contiver máquinas persistentes, indique se deseja excluir essas máquinas também do hipervisor ou serviço de nuvem. Se você optar por fazê-lo, escolha se deseja reter, desabilitar ou excluir suas contas de computador do Active Directory.
    4. Se necessário, selecione Ocultar progresso para executar a exclusão em segundo plano.

    Observação:

    • Ao excluir um catálogo do Azure Resource Manager, as máquinas e os grupos de recursos associados são excluídos do Azure, mesmo que você opte por retê-los.
    • Ao excluir um catálogo que contém máquinas não persistentes, essas máquinas são excluídas do hipervisor ou serviço de nuvem.
    • Quando o hipervisor ou 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 apenas do seu banco de dados do site Citrix. Para fazer isso, selecione o catálogo de máquinas no nó Catálogos de Máquinas e, em seguida, execute a exclusão mostrada na guia Solução de problemas. Lembre-se de que essa ação deixa as VMs intactas no host.

    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 de catálogos de sessão única e de várias sessões. Essas contas podem entã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 no local. Não use uma barra (/) em um nome de OU.

    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 AD na barra de ações.
    3. Escolha se deseja adicionar ou excluir contas de computador. Se você adicionar contas, especifique o que fazer com as senhas das contas: redefini-las todas ou inserir uma senha que se aplique a todas as contas.

      Você pode redefinir senhas se não souber as senhas atuais das contas; 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 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 retidas, desabilitadas ou excluídas ao remover máquinas de um catálogo ou excluir 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 que você implantou em seus desktops, você poderá reverter 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 mestre para um catálogo persistente, considere o seguinte: apenas as máquinas que você adicionar ao catálogo posteriormente serã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.

    Converter catálogos provisionados por MCS de imagens mestre para imagens preparadas

    Para converter um catálogo provisionado por MCS de uma imagem mestre para uma imagem preparada, siga estas etapas:

    1. Clique em Catálogos de Máquinas no painel esquerdo e selecione um catálogo de máquinas que você deseja converter. Clique com o botão direito do mouse e selecione Converter para Imagem Preparada.
    2. Na página Imagem, selecione uma imagem preparada.
    3. Na página Estratégia de implementação, selecione quando você deseja atualizar este catálogo com a imagem preparada selecionada.
    4. Na página Resumo, verifique os detalhes e clique em Concluir.
    5. Verifique os detalhes do catálogo de máquinas convertido em Propriedades do Modelo.

    Atualmente, este recurso está disponível apenas para ambientes de virtualização Azure e VMware.

    Atualizar ou criar uma imagem

    Antes de alterar a imagem mestre de um catálogo, prepare uma nova imagem em seu host hipervisor, atualizando uma imagem existente ou criando uma.

    1. Em seu hipervisor ou provedor de serviços em nuvem, tire um instantâneo da VM atual e dê ao instantâneo um nome significativo. Este 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ê ao instantâneo um nome significativo que seja reconhecido ao alterar a imagem mestre.

    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 apenas através do console XenCenter® do XenServer.

    Alterar a imagem mestre

    Para implementar 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ções.
    3. Na página Imagem, selecione o host e a imagem que você deseja implementar.

      Dica:

      Para um catálogo criado por 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, quer você adicione uma nota ou não. Se você atualizar um catálogo sem adicionar uma nota, a entrada aparecerá como nula (-). Para visualizar o histórico de notas da imagem, selecione o catálogo, clique em Propriedades do Modelo no painel inferior e, em seguida, clique em Exibir histórico de notas.

    4. Na página Estratégia de implementaçã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:

      A página Estratégia de implementação não está disponível para VMs persistentes porque a implementação é aplicável apenas a VMs não persistentes.

    5. Verifique as informações na página Resumo e, em seguida, selecione Concluir. 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 visualizar a barra de progresso em linha e o gráfico de progresso passo a passo. Para um catálogo não persistente, você pode acompanhar seus status de atualização de imagem através da coluna Atualização de Imagem, incluindo Totalmente atualizado, Parcialmente atualizado, Atualização pendente e Preparando imagem.

      Dica:

      Para mostrar a coluna Atualização de Imagem, selecione o ícone Colunas a Exibir na barra de ações, selecione Catálogo de Máquinas > Status da Imagem e, 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 um instantâneo de uma imagem.

    Para implementar uma nova imagem mestre para o catálogo de máquinas 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ções.
    3. Na página Alterar Imagem Mestre, selecione uma imagem em Imagem Mestre. A lâmina lista todas as imagens que pertencem à mesma região que as dos Recursos.

    Estratégia de implementação

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

    Observação:

    A estratégia de implementação é aplicável apenas 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 SO de várias sessões com máquinas filhas, as reinicializações não ocorrem automaticamente. Para aplicar a imagem mestre atualizada, reinicie as máquinas usando o Studio, PowerShell ou Workspace. Reiniciar das máquinas ou dos hipervisores não aplica a atualização.

    Dica:

    Limite o número de máquinas sendo reinicializadas usando as configurações avançadas para 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 implementar uma imagem atualizada ou nova, você pode revertê-la. Isso pode ser necessário se ocorrerem problemas com as máquinas recém-atualizadas. Ao reverter, as máquinas no catálogo são revertidas para a última imagem funcional. Quaisquer novos recursos que exijam a imagem mais recente não estarão mais disponíveis. Assim como na implementação, reverter 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ções.
    3. Especifique quando aplicar a imagem anterior às máquinas, conforme descrito para a operação de implementação.

    A reversão é aplicada apenas às 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 visualizar a barra de progresso em linha e o gráfico de progresso passo a passo.

    Você não pode reverter em certos cenários, incluindo os seguintes. (A opção Reverter Imagem Mestre não está visível).

    • Você não tem permissão para reverter.
    • O catálogo não foi criado usando o MCS.
    • O catálogo foi criado usando uma imagem do disco do SO.
    • 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 de atualização.

    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. A guia Detalhes no painel inferior exibe informações de versão.
    3. Selecione 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 Alterar.

    Após a conclusão da atualização do catálogo, você pode reverter as máquinas para suas versões VDA anteriores selecionando o catálogo e, em seguida, selecionando Desfazer Alteração de Nível Funcional na barra de ações.

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

    • Você não pode alterar as configurações associadas ao sistema operacional e ao gerenciamento 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 lâmina listará todas as imagens que pertencem à mesma região que as dos Recursos.

    • Clonar um catálogo pode levar algum tempo para ser concluído. Se necessário, selecione Ocultar progresso para executar a clonagem em segundo plano.
    • O catálogo clonado herda o nome do original e tem um sufixo Cópia. Você pode alterar o nome. Consulte Renomear um catálogo.
    • Após a conclusão da clonagem, certifique-se de atribuir o catálogo clonado a um grupo de entrega.
    • Você pode criar um catálogo vazio por clonagem. Durante a clonagem do catálogo, você pode definir o número de máquinas como zero para catálogos provisionados por MCS e não adicionar máquinas para catálogos não provisionados por MCS.
    1. No Studio, selecione Catálogos de Máquinas no painel esquerdo.
    2. Selecione um catálogo e, em seguida, selecione Clonar na barra de ações.
    3. Na janela Clonar Catálogo de Máquinas Selecionado, visualize as configurações do catálogo clonado e configure as configurações conforme aplicável. Selecione Avançar para prosseguir para a próxima página.
    4. Na página Resumo, visualize um resumo das configurações e selecione Concluir para iniciar a clonagem.
    5. Se necessário, selecione Ocultar progresso 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 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 ícone Pasta no canto superior direito da barra de ações.

    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.

    Antes de começar, planeje como organizar seus catálogos. Considere o seguinte:

    • Você pode aninhar pastas em até cinco níveis de profundidade (excluindo a pasta raiz padrão).
    • Uma pasta de catálogo pode conter catálogos e subpastas.
    • Todos os nós no Studio (como Catálogos de Máquinas, Grupos de Entrega, Aplicativos e Grupos de Aplicativos) compartilham a mesma árvore de pastas no back-end. Para evitar conflitos de nome ao renomear ou mover pastas, use nomes exclusivos para pastas de primeiro nível em diferentes nós.

      Se você criar uma pasta usando o cmdlet SDK New-BrokerAdminFolder e quiser que ela apareça no nó Catálogos de Máquinas, você deve adicionar os metadados ContainsMachineCatalogs usando o cmdlet Set-BrokerAdminFolderMetadata.

      Exemplo:

       Set-BrokerAdminFolderMetadata -AdminFolderId {adminFolderUid} -Name ContainsMachineCatalogs -Value true
       <!--NeedCopy-->
      

    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 na barra de Ações.
    3. Insira um nome para a nova pasta e, em seguida, clique em Concluído.

    Dica:

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

    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 os catálogos por pasta. Você também pode ativar Exibir 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, em seguida, selecione Mover Catálogo de Máquinas.
    4. Selecione a pasta para a qual você deseja mover o catálogo e, em seguida, 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ê pode excluir uma pasta somente 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 barra de Ações 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.

    Ação Permissões necessárias
    Criar pastas de catálogo Criar Pasta de Catálogo de Máquinas
    Excluir pastas de catálogo Remover Pasta de Catálogo de Máquinas
    Mover pastas de catálogo Mover Pasta de Catálogo de Máquinas
    Renomear pastas de catálogo Editar Pasta de Catálogo de Máquinas
    Mover catálogos para pastas Editar Pasta de Catálogo de Máquinas e Editar Propriedades do Catálogo de Máquinas

    Atualizar VDAs

    Você pode usar a interface do Studio para atualizar VDAs com facilidade. Para obter mais informações e orientações passo a passo, consulte a documentação do Serviço de Atualização de VDA da Citrix.

    Antes de começar, certifique-se de ter configurado sua implantação do serviço WEM. Para obter mais informações, consulte Introdução ao serviço Workspace Environment Management.

    Observação:

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

    Vincular um catálogo a um conjunto de configuração

    Importante:

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

    Para vincular um catálogo a um conjunto de configuração, 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ção na barra de ações. A janela Gerenciar conjunto de configuração é exibida.

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

      Observação:

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

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

    Mudar para um conjunto de configuração diferente

    Para mudar para um conjunto de configuração 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ção na barra de ações. A janela Gerenciar conjunto de configuração é exibida.
    3. Selecione um conjunto de configuração WEM diferente ao qual você deseja vincular o catálogo.
    4. Clique em Salvar para salvar sua alteração.

    Desvincular um catálogo do conjunto de configuração

    Para desvincular um catálogo do conjunto de configuração, 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ção na barra de ações. A janela Gerenciar conjunto de configuração é exibida.
    3. Clique no ícone X no lado direito do conjunto de configuração selecionado.
    4. Clique em Salvar para salvar sua alteração.

    Observação:

    Este recurso se aplica apenas a catálogos MCS.

    Catálogos com falha são marcados com um ícone de erro. Para ver os detalhes, vá para a guia Solução de problemas de cada catálogo. Antes de tentar novamente a criação do catálogo, esteja ciente 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 ao Sistema operacional e ao 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 progresso para executar a criação em segundo plano.

    Para tentar novamente a criação de um catálogo, faça o seguinte:

    1. No Studio, selecione Catálogos de Máquinas no painel esquerdo.
    2. Selecione o catálogo e, em seguida, vá para a guia Solução de problemas.
    3. Clique no hiperlink de repetição para tentar novamente a criação do catálogo.
    4. No assistente que aparece, altere as configurações onde for necessário. Se não houver necessidade de fazer alterações, você pode ir diretamente para a página Resumo.
    5. Após terminar, selecione Concluir para iniciar a criação.

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

    Observação:

    Para executar esta tarefa, você deve ter a função de Administrador de Nuvem.

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

    Um token de registro apresenta:

    • Intervalo de registro: 1 a 5000 máquinas 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 por MCS, que tenha Método de provisionamento: Manual exibido na coluna Contagem de Máquinas.
    2. Clique com o botão direito do mouse no catálogo e, em seguida, selecione Gerenciar Tokens de Registro.
    3. Na página Gerar token de registro que aparece, forneça as seguintes informações do token:
      • Digite um nome para o token.
      • Insira seu período de validade. O período não deve ser superior a 14 dias. O token é válido apenas para o período especificado.
      • (Opcional) Selecione uma conexão de host para gerenciamento de energia de VDAs registrados 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 5000).
    4. Clique em Gerar.
    5. Na janela Token gerado com sucesso que aparece, copie o token e salve-o em um local seguro, ou clique em Baixar para baixá-lo para a pasta Downloads.

      Um registro de token aparece na lista de tokens.

      Geração de token

    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 máquinas, consulte Instalar VDAs.

    Gerenciar tokens

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

    • Revogar: Revoga o token, mas o mantém na lista para fins de registro.
    • Excluir: Revoga o token e o exclui da lista.

    Observação:

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

    Usar PowerShell

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

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

    Para personalizar o número de sequência das máquinas, que são implantadas usando 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 para o pool de identidades do catálogo:

      Get-AcctIdentityPool -IdentityPoolName xxx

      O IdentityPoolName é o nome do catálogo.

    4. Se você quiser definir essa contagem para 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. Após criar as máquinas, execute o seguinte comando para redefini-lo 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 visualizar descrições de imagem:

    • 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"
    <!--NeedCopy-->
    
    • Publish-ProvMasterVMImage. Use este 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. Exibe 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

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

    MasterImageNote : Office365 installed`

    Redefinir disco do SO

    Use o comando PowerShell Reset-ProvVMDisk para redefinir o disco do SO de uma VM persistente em um catálogo de máquinas criado por MCS. Atualmente, este recurso é aplicável a ambientes de virtualização AWS, Azure, Google Cloud, SCVMM, VMware e XenServer®.

    Para executar o comando PowerShell com sucesso, 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 o esquema de provisionamento tem entradas corretas.
    • O hipervisor não está em modo de manutenção.
    • As VMs de destino estão desligadas e em modo de manutenção.

    Execute as seguintes etapas para redefinir o disco do SO:

    1. Abra uma janela do PowerShell.
    2. Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.
    3. Execute o comando PowerShell Reset-ProvVMDisk de 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
         <!--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") | Reset-ProvVMDisk "abc" -OS
         <!--NeedCopy-->
        
      • Especifique uma única VM por 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 verificação de capacidade do hipervisor, verificação de conexão para cada VM.

         Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
         <!--NeedCopy-->
        
    4. Um prompt de confirmação aparece listando 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 outra ação ocorrerá.

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

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

      • Forneça o parâmetro -Force:

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

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

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

      Observação:

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

    5. Execute Get-ProvTask para obter o status das tarefas retornadas pelo comando Reset-ProvVMDisk.

    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 têm 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. Essa 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 AWS, Azure, GCP, SCVMM, VMware e XenServer.

    Condições

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

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

    Redefinir informações de identidade

    Para redefinir informações de identidade:

    1. Abra a janela do PowerShell.
    2. Execute asnp citrix* para carregar os módulos PowerShell específicos da 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
         <!--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 Azure AD).
        • PrivilegedUserPassword: Senha para PrivilegedUserName.
        • Target: Destino para a ação de reparo. Pode ser IdentityInfo para reparar senha de conta/chave de confiança, e UserCertificate para reparar atributos de certificado de usuário de identidades de máquina unidas ao Azure AD Híbrido.
      • Para redefinir toda a configuração do disco de identidade, execute os seguintes comandos na seguinte ordem:

         Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
         <!--NeedCopy-->
        
         Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
         <!--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 ignorar o prompt de confirmação usando o parâmetro -Force. Por exemplo:

      Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force
      <!--NeedCopy-->
      
    5. Execute Get-ProvVM -ProvisioningSchemeName <name -VMName <name> para verificar a configuração atualizada do disco de identidade. Os atributos do disco de identidade (por exemplo, IdentityDiskId) devem ser atualizados. O StorageId e IdentityDiskIndex não devem mudar.

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

    Você pode alterar a configuração de rede para um catálogo de máquinas 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.

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

    1. Na janela do PowerShell, execute o comando asnp citrix* para carregar os módulos PowerShell.
    2. Execute (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps para chegar ao 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"}
      <!--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. Você pode então gerenciar as várias versões do catálogo de máquinas usando comandos PowerShell. Você pode:

    • Ver a lista de versões de um catálogo de máquinas.
    • Usar qualquer versão anterior para atualizar o catálogo de máquinas.
    • Excluir manualmente uma versão se ela não for usada por uma VM desse catálogo de máquinas.
    • Alterar 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
    • CustomProperties
    • ServiceOffering
    • MachineProfile
    • NetworkMapping
    • SecurityGroup

    Execute os seguintes comandos (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 -Version 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-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2
       <!--NeedCopy-->
      
    • Para excluir manualmente uma versão se ela não for usada por uma VM desse catálogo de máquinas:

       Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3
       <!--NeedCopy-->
      
    • 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 a todos os catálogos. Por exemplo, neste caso, um máximo de 15 versões serão retidas para todos os catálogos provisionados por MCS.

       Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 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 alguma das VMs no catálogo de máquinas. Nesse caso, faça uma das seguintes opções:

    • 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

    Após 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 do cache são:

    • Atualizar para a versão mais recente do VDA (2308 ou posterior).
    • Habilitar o parâmetro UseWriteBackCache para o catálogo de máquinas existente. Use New-ProvScheme para criar um catálogo de máquinas com UseWriteBackCache habilitado. Por exemplo:

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

    Alterar a configuração do cache

    Execute o comando Set-ProvScheme. Por exemplo:

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

    Observação:

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

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

    Você pode usar uma VM, especificação de modelo (no caso do Azure) ou modelo de inicialização (no caso da AWS), ou modelo VMware (no caso do VMware) como entrada de perfil de máquina para converter um catálogo de máquinas não baseado em perfil de máquina para um catálogo de máquinas baseado em perfil de máquina. Novas VMs adicionadas ao catálogo assumem os valores de propriedade do perfil da máquina.

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

         Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits\<HostingUnitName>\machineprofile.folder\<ResourceGroupName>\<TemplateSpecName>\<VersionName>
         <!--NeedCopy-->
        
      • No caso da AWS:

         Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\<launch-template>.launchtemplate\<launch-template-version>.launchtemplateversion"
         <!--NeedCopy-->
        
      • No caso do VMware:

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

        Observação:

        Defina o FolderID como a propriedade personalizada para evitar derivar o FolderID do modelo VMware.

    Você pode obter erros e avisos históricos para entender os problemas com seu catálogo de máquinas MCS e corrigir esses problemas.

    Usando comandos PowerShell, você pode:

    • Obter uma lista de erros ou avisos
    • Alterar o estado de aviso de Novo para Reconhecido
    • Excluir os erros ou avisos

    Para executar os comandos PowerShell:

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

    Para obter uma lista de erros e avisos:

    Execute o comando Get-ProvOperationEvent.

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

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

    Execute o comando Confirm-ProvOperationEvent.

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

    Para excluir os erros ou avisos:

    Execute o comando Remove-ProvOperationEvent.

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

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

    Excluir máquinas 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ão acessíveis apenas através do hipervisor. Use a opção PurgeDBOnly no PowerShell Remove-ProvVM para excluir objetos de recurso de VM, como VM, disco base, imagem em ACG e assim por diante, do banco de dados, mesmo quando não há acesso ao hipervisor.

    Esta opção está habilitada 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 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á em modo de manutenção
    • Credenciais inválidas
    • Falha na autenticação
    • Operação não autorizada
    • O hipervisor está inacessível

    Observação:

    Remove-provVM -ForgetVM tem como alvo 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 aparece:

    Tente usar a opção -PurgeDBOnly para limpar o banco de dados DDC.

    Use a opção -PurgeDBOnly no comando PowerShell Remove-ProvVM 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 as propriedades de VMs individuais em um catálogo de máquinas MCS persistente usando o comando PowerShell Set-ProvVM. No entanto, as atualizações não são aplicadas imediatamente. Você deve definir a janela de tempo usando o comando 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, este recurso é aplicável a ambientes Azure e VMware.

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

    • CustomProperties
    • ServiceOffering (Não aplicável ao VMware)
    • MachineProfile
    • CpuCount
    • Memory

    Usando este recurso, você pode:

    Antes de atualizar as propriedades de uma VM:

    1. Abra uma janela do PowerShell.
    2. Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.
    3. Verifique a configuração do catálogo de máquinas existente. Por exemplo:

      Get-ProvScheme -ProvisioningSchemeName <nome_do_catalogo>
      <!--NeedCopy-->
      
    4. Verifique a configuração da VM na qual você deseja aplicar as atualizações. Por exemplo:

      Get-ProvVM -ProvisioningSchemeName <nome_do_catalogo> -VMName machine1
      <!--NeedCopy-->
      

    Atualizar propriedades de uma VM

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

    1. Desligue a VM na qual você deseja aplicar as atualizações.
    2. Atualize as propriedades da VM. Por exemplo, se você quiser atualizar a propriedade personalizada do tipo de armazenamento (StorageType) da VM, execute o seguinte:

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

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

      Set-ProvVM -ProvisioningSchemeName <nome_do_catalogo> -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
      <!--NeedCopy-->
      
      Set-ProvVM -ProvisioningSchemeName <nome_do_catalogo> -VMName machine2 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
      <!--NeedCopy-->
      

      Observação:

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

    3. Obtenha a lista de propriedades que devem ser atualizadas e a versão da configuração. Por exemplo:

      Get-ProvVMConfiguration -ProvisioningSchemeName <nome_do_catalogo> -VMName machine1
      <!--NeedCopy-->
      

      Verifique o valor da propriedade de Version e as propriedades a serem atualizadas (neste caso, StorageType).

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

      Get-ProvVM -ProvisioningSchemeName <nome_do_catalogo> -VMName machine1
      <!--NeedCopy-->
      

      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 a atualização agendada. Por exemplo:

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <nome_do_catalogo> -StartsNow -DurationInMinutes -1
       <!--NeedCopy-->
      

      Para obter mais informações sobre atualizações agendadas, consulte Atualizar 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
      <!--NeedCopy-->
      
    7. Verifique a versão da configuração. Por exemplo:

      Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
      <!--NeedCopy-->
      

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

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

    Reter as propriedades atualizadas em uma VM após a atualização do catálogo de máquinas

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

    1. Desligue 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 (ServiceOffering) e o tipo de armazenamento (StorageType), execute o seguinte:

      Set-ProvScheme -ProvisioningSchemeName <nome_do_catalogo> -ServiceOffering Standard_E4_v3 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
      <!--NeedCopy-->
      
    3. Obtenha os detalhes de configuração do catálogo de máquinas. Por exemplo:

      Get-ProvScheme -ProvisioningSchemeName <nome_do_catalogo>
      <!--NeedCopy-->
      

      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 máquina para a VM.

      Set-ProvVM -ProvisioningSchemeName <nome_do_catalogo> -VMName machine1 -MachineProfile "XDHyp:\HostingUnits\<unidade_de_hospedagem>\machineprofile.folder\<grupo_de_recursos>.resourcegroup\<especificacao_de_modelo>.templatespec\<versao_especificacao_de_modelo>.templatespecversion"
      <!--NeedCopy-->
      

      Observação:

      A entrada do perfil da máquina tem uma tag e um tamanho de VM diferente (ServiceOffering) especificados.

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

      Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName <nome_do_catalogo> -VMName machine1
      <!--NeedCopy-->
      

      Observação:

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

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

      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <nome_do_catalogo> -VMName machine1 -StartsNow -DurationInMinutes -1
      <!--NeedCopy-->
      
    7. Reinicie a VM. Por exemplo:

      New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
      <!--NeedCopy-->
      

      A VM mantém seu tamanho de VM atualizado conforme derivado do perfil da máquina. Os valores de tag conforme 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 da configuração da VM. Por exemplo:

      Get-ProvVM -ProvisioningSchemeName <nome_do_catalogo> -VMName machine1
      <!--NeedCopy-->
      

      O ProvisioningSchemeVersion e ProvVMConfigurationVersion agora mostram a versão mais recente.

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

    1. Após aplicar as atualizações a uma VM, desligue a VM.
    2. Execute o seguinte comando para remover as atualizações aplicadas na VM. Por exemplo:

      Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName <nome_do_catalogo> -VMName machine1
      <!--NeedCopy-->
      
    3. Solicite a atualização agendada para a VM. Por exemplo:

      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <nome_do_catalogo> -VMName machine1 -StartsNow -DurationInMinutes -1
      <!--NeedCopy-->
      
    4. Reinicie a VM. Por exemplo:

      New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
      <!--NeedCopy-->
      
    5. Verifique a versão da configuração da VM. Por exemplo:

      Get-ProvVM -ProvisioningSchemeName <nome_do_catalogo> -VMName machine1
      <!--NeedCopy-->
      

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

    Migração de armazenamento de VMs

    Você pode mover o armazenamento em disco de VMs existentes de um armazenamento antigo para um novo armazenamento em ambientes VMware e XenServer. Durante a migração, o MCS mantém os recursos da VM, como gerenciamento de energia, redefinição de disco do SO e assim por diante. Você também pode adicionar novas VMs ao catálogo de máquinas usando o novo armazenamento em disco. Para fazer isso, use o comando PowerShell Move-ProvVMDisk.

    Você pode migrar VMs persistentes de clone completo e VMs não persistentes.

    • Para VMs persistentes de Clone Completo: Disco do SO, Disco de Identidade e discos não provisionados por MCS.
    • Para VMs não persistentes: Disco do SO, Disco de Identidade e disco de Cache de Gravação (WBC).

    O novo armazenamento deve satisfazer as seguintes condições:

    • Deve estar dentro do mesmo cluster do armazenamento antigo.
    • O host no qual a VM está sendo executada deve ter acesso aos armazenamentos de dados antigo e novo.

    Migrar o armazenamento em disco

    Para migrar o armazenamento em disco:

    1. Adicione um armazenamento de destino a uma unidade de hospedagem existente. Você pode executar o comando PowerShell Add-Hyphostingunitstorage para adicionar o armazenamento de destino:

      Se você não quiser adicionar novas VMs ao armazenamento antigo, altere o armazenamento antigo para Substituído. Você pode fazer isso usando o Studio ou comandos PowerShell. Para o Studio, consulte Editar armazenamento. Alternativamente, execute Set-Hyphostingunitstorage e defina Superseded como true para desabilitar a criação de novas VMs no armazenamento antigo.

      Observação:

      Para VMs não persistentes:

      • Se o WBC for usado, configure o armazenamento de destino do WBC na unidade de hospedagem.
      • Se o armazenamento de destino do SO for configurado, o WBC (se usado) deve ser compatível com o armazenamento de destino do SO.
      • Se o armazenamento de destino do SO não for configurado, o WBC (se usado) deve ser compatível com o armazenamento atual do SO.
    2. Desligue as VMs e ative o Modo de Manutenção.
    3. Obtenha as informações sobre o esquema de provisionamento, unidade de hospedagem, armazenamento em disco do SO e armazenamento em disco do WBC.

      • Execute ProvResourceInStorage para obter informações de armazenamento do SO. Por exemplo:

         $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
         $result
         $result.ProvResourceInStorage | Format-List -Property *
         <!--NeedCopy-->
        
      • Execute TemporaryStorageInfo para obter informações de armazenamento do WBC. Por exemplo:

         $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
         $result
         $result.TemporaryStorageInfo | Format-List -Property *
         <!--NeedCopy-->
        
    4. Migre o disco do SO, o disco de Identidade e o disco WBC (aplicável a VMs não persistentes) para o armazenamento de destino usando o comando PowerShell Move-ProvVMDisk.

      Importante:

      • Sempre forneça os discos do SO e de Identidade nos parâmetros DiskType e DestinationStorageId.
      • O DestinationStorageId para o disco do SO e o disco de Identidade deve ser o mesmo.

      Exemplo:

      VMs persistentes:

      (Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myFullCloneProvScheme" -VMName "machine01" -DiskType OS,Identity -DestinationStorageId datastore1,datastore1
      <!--NeedCopy-->
      

      Importante:

      Para VM persistente, todos os discos são movidos. Você não pode selecionar quais discos mover.

      VMs não persistentes:

      (Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myCleanOnBootProvScheme" -VMName "machine01" -DiskType OS,Identity,WBC -DestinationStorageId None,None,datastore1
      <!--NeedCopy-->
      

      Importante:

      • Se você não quiser migrar um disco específico, defina o valor como None para o parâmetro DestinationStorageId.
      • Se a VM tiver disco WBC, adicione o disco WBC no parâmetro DiskType e adicione as informações necessárias no parâmetro DestinationStorageId.

    Solução de problemas

    Se um dos discos falhar na migração, nenhum dos discos será migrado para o armazenamento de destino. Você pode obter o relatório de falha usando o seguinte comando:

    (Get-ProvTask -TaskID xxxxxxxxx).DiskMoveFailedVirtualMachines
    <!--NeedCopy-->
    

    Considerações importantes para a migração de VMs não persistentes no VMware

    • Se você tentar mover o disco do SO e de Identidade para um novo armazenamento, os arquivos específicos da VM também serão movidos para o novo armazenamento.
    • O VMware não suporta a movimentação do disco se ele tiver o instantâneo.

    Migrar catálogos provisionados por MCS existentes para catálogo de máquinas de imagem preparada

    Você pode converter um catálogo de máquinas provisionado por MCS existente em um catálogo de máquinas de imagem preparada usando um comando PowerShell Set-ProvSchemeImage. No entanto, você não pode reverter para o catálogo legado após a migração. Atualmente, este recurso é aplicável a ambientes de virtualização Azure e VMware.

    Limitações

    Considere as seguintes limitações:

    • Se o catálogo MCS usar um disco de dados persistente, o catálogo não poderá ser migrado para usar uma imagem preparada.
    • Se o catálogo MCS usar discos não gerenciados, o catálogo não poderá ser migrado para usar uma imagem preparada.

    Migrar para catálogo de máquinas de imagem preparada

    Para migrar, faça o seguinte:

    1. Crie uma definição de imagem e versões de imagem usando o Studio ou comandos PowerShell. Consulte as etapas para criar definições de imagem e versões de imagem em:

    2. Execute o comando Get-ProvScheme para obter o UID do esquema de provisionamento. Por exemplo:

      Get-ProvScheme -ProvisioningSchemeName <nome> | select ProvisioningSchemeName, ProvisioningSchemeUid
      <!--NeedCopy-->
      
    3. Execute o comando Get-ProvImageVersionSpec para obter o nome da definição de imagem, o UID da especificação da versão da imagem. Por exemplo:

      Get-ProvImageVersionSpec -ImageDifinitionName <nome> -Filter {IsPrepared -eq $true} | select ImageDefinitionName ImageVersionSpecUId
      <!--NeedCopy-->
      
    4. Execute o comando Set-ProvSchemeImage para migrar um catálogo de máquinas provisionado por MCS existente para um catálogo de máquinas de imagem preparada. Por exemplo:

      Set-ProvSchemeImage -ProvisioningSchemeName [ProvisioningSchemeName] -ImageVersionSpecUid [ImageVersionSpecUid]
      <!--NeedCopy-->
      
    5. Execute o comando Get-ProvScheme para verificar se o catálogo foi migrado. Por exemplo:

      Get-ProvScheme -ProvisioningSchemeName <nome> | select ProvisioningSchemeName, ProvisioningSchemeUid, ImageVersionSpecUid
      <!--NeedCopy-->
      

    Solução de problemas

    • Para máquinas com status Power State Unknown, consulte CTX131267 para obter orientação.
    • Para corrigir VMs que mostram continuamente um estado de energia desconhecido, consulte Como corrigir VMs que mostram continuamente um estado de energia desconhecido.
    • Se um Cloud Connector não estiver operando corretamente, as operações de provisionamento do MCS (como atualizações de catálogo) demoram mais do que o normal e o desempenho do console de gerenciamento degrada significativamente.

    Onde ir em seguida

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

    Gerenciar catálogos de máquinas

    Neste artigo