Citrix DaaS™

Gerenciar catálogos de máquinas

May 4, 2026

Contribuição de:

C C

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ó de Implantação Rápida e continuar usando esse nó para gerenciar o catálogo, siga Gerenciar catálogos na Implantação Rápida.

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 que você atualize um grande número de máquinas de usuários de forma eficiente.
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 somente as máquinas que você adicionar aos catálogos posteriormente serão criadas usando a nova imagem ou modelo.
Para catálogos de Acesso Remoto a PCs, 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 para qualquer outro tipo de catálogo. Considere o seguinte:

Com catálogos de disco persistente, as máquinas preexistentes não são atualizadas para a nova imagem, mas todas as novas máquinas adicionadas ao catálogo usam a nova imagem.
Para catálogos de disco não persistente, a imagem da máquina é atualizada na próxima vez somente se a máquina for reiniciada dentro do Studio ou do 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
Usando o PowerShell
Usar o Studio
Esta seção detalha como você pode gerenciar catálogos usando o Studio:
Exibir detalhes do catálogo
Adicionar máquinas a um catálogo
Excluir máquinas de um catálogo
Editar um catálogo
Renomear um catálogo
Excluir um catálogo
Gerenciar contas de computador do Active Directory em um catálogo
Alterar a imagem mestre de um catálogo
Converter catálogos provisionados por MCS de imagens mestre para imagens preparadas.
Alterar o nível funcional ou desfazer a alteração
Clonar um catálogo
- Organizar catálogos usando pastas
- Atualizar VDAs
- Gerenciar configurações de otimização de experiência para um catálogo
- Tentar novamente a criação do catálogo
- (Somente VDAs não provisionados pela Citrix®) Gerar e gerenciar tokens de registro

Exibir detalhes do catálogo

Use a função de pesquisa para localizar um catálogo de máquinas específico. Consulte Pesquisar instâncias para obter instruções.
Nos resultados da pesquisa, selecione um catálogo conforme necessário.

Consulte a tabela a seguir para obter descrições das colunas do catálogo.

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 compatível das máquinas no catálogo. Os valores possíveis incluem • Tipo de SO: SO multissessão (Virtual); Dados do usuário: Descartar. • Tipo de SO: SO multissessão (Virtual); Dados do usuário: No disco local • Tipo de SO: SO de sessão única (Acesso Remoto a PCs) • 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 na á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 da atualização de 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 somente a catálogos de máquinas não persistentes. Os valores possíveis incluem: Totalmente atualizado, Parcialmente atualizado, Atualizações pendentes, Preparando

Clique em uma guia no painel de detalhes inferior para obter mais informações sobre um catálogo selecionado.

Guia Descrição

|——|——–|

Detalhes

Resume as principais configurações do catálogo de máquinas, como tipo de máquina, método de provisionamento, conta de serviço, SO e versão do VDA, permitindo que você visualize e gerencie seus recursos rapidamente.

Propriedades do Modelo	Disponível somente para catálogos provisionados por MCS. Exibe informações detalhadas de provisionamento para o catálogo selecionado, incluindo • Propriedades do Modelo de Máquina • Detalhes Específicos do Hipervisor • Propriedades do Perfil da Máquina




Máquinas	Exibe uma lista paginada de nomes de máquinas no catálogo selecionado.
Grupos de Entrega	Disponível para catálogos de Acesso Remoto a PCs. Exibe os grupos de entrega associados ao catálogo selecionado. Ele exibe o nome do grupo de entrega e a associação do catálogo.

Tags	Não disponível em ambientes multilocatário.

^^ ^^ Exibe o nome da tag e a descrição das tags atribuídas ao catálogo de máquinas selecionado.

Gerenciamento do Ambiente de Trabalho	Visível somente quando o serviço WEM é provisionado e acessível. Exibe as configurações de otimização do sistema de Gerenciamento do Ambiente de Trabalho.

Insights de Custo	Aplicável somente a catálogos Azure MCS, isso exibe

^^ ^^ • Custo total incorrido nos últimos 30 dias.
^^ ^^ • Uma comparação entre o custo total atual de 30 dias e o período anterior de 30 dias.

^^	^^ O acesso requer a permissão Citrix Gerenciamento de Custos > Gerenciar > Ler custo (padrão para Administradores de Nuvem) para exibir a guia, e a permissão Azure `Microsoft.CostManagement/query/read` para exibir os detalhes de custo.
Solução de Problemas	Exibe erros ou avisos do catálogo com ações recomendadas.

Adicionar máquinas a um catálogo

Antes de começar:

-  Certifique-se de que o host de virtualização (hipervisor ou provedor de serviços de nuvem) tenha processadores, memória e armazenamento suficientes para acomodar as máquinas adicionais.
-  Certifique-se de que você tem contas de computador do Active Directory não utilizadas suficientes. Se você estiver usando contas existentes, o número de máquinas que você pode adicionar é limitado pelo número de contas disponíveis.
-  Se você usar o Studio para criar contas de computador do Active Directory para as máquinas adicionais, você deve ter a 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 restritas do AD, adicione todos os Cloud Connectors que você pretende usar na tela “Fazer logon em…“.

Para adicionar máquinas a um catálogo:

No Studio, selecione “Catálogos de Máquinas” no painel esquerdo.
Selecione um catálogo de máquinas e, em seguida, selecione “Adicionar máquinas” na barra de ações.
Na página “Máquinas Virtuais”, selecione o número de máquinas virtuais a serem adicionadas.
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 as existentes, e o local (domínio) para essas contas.
- Se houver contas do Active Directory existentes insuficientes 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 nomes de contas. Certifique-se de que há contas suficientes para todas as máquinas que você está adicionando. O Studio gerencia essas contas. Permita que essa interface redefina as senhas de todas as contas, ou especifique a senha da conta, que deve ser a mesma para todas as contas.
- Se este 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 PowerShell Set-ProvScheme. 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 números ou letras sequenciais aparecem. Por exemplo, um esquema de nomenclatura de PC-Sales-## (com 0-9 selecionado) resulta em contas de computador nomeadas PC-Sales-01, PC-Sales-02, PC-Sales-03 e assim por diante.
- Opcionalmente, você pode especificar com o que os nomes das contas devem começar.
  
  Ao especificar com o que os nomes das contas devem começar, 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 a seguir.
  
  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 o MCS, por meio de comandos do PowerShell.
- 1. 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.

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

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

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

No Studio, selecione “Catálogos de Máquinas” no painel esquerdo.
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.
Selecione “Adicionar Arquivo CSV”. A janela “Adicionar Máquinas em Massa” é exibida.
Selecione “Baixar Modelo CSV”.
Preencha o arquivo de modelo.
Arraste ou procure o arquivo para carregá-lo.
Selecione “Validar” para realizar verificações de validação em sua importação.
Selecione “Importar” para concluir o processo.

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

Nota:

Para usuários que não são do Active Directory, você deve digitar seus nomes neste formato: <provedor de identidade>:<nome de usuário>. Exemplo: AzureAD:username.

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 o seguinte em mente:

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

No Studio, selecione “Catálogos de Máquinas” no painel esquerdo.
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.
Selecione “Exportar para arquivo CSV”. Um arquivo CSV contendo uma lista das máquinas é baixado.
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.

Nota:

Este recurso não está disponível para catálogos de Acesso Remoto para PC 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 WebSocket VDA

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

Nota:

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:

Faça login no VDA.
Localize a ferramenta EnrollMachine.exe, em C:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Tool.
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:

| Nome do Parâmetro | Obrigatório | Descrição | Exemplo | |–|–|–|–|

-  | `-websocket_token_stdin` | Sim | Lê o token de registro. | `.\EnrollMachine.exe -websocket_token_stdin` | | `-websocket_token_string` | Sim | 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]` | Sim | Lê o token de registro do caminho fornecido. | `.\EnrollMachine.exe -websocket_token_file:C:\token\test2.txt` | | `log:[log-file-path]` | Não | Exibe os logs da ferramenta de registro. | `.\EnrollMachine.exe log:[C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt]` |
-  | `-help` | Não | Exibe 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 login 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	Sucesso	O VDA foi adicionado com sucesso ao catálogo de máquinas.

-1 ArgumentoInválido O parâmetro de entrada no token de registro é inválido.
-2 AgenteBrokerNãoEncontrado O serviço de agente broker não foi encontrado.
-3 TokenInválido O token inserido é inválido.

-4	DeclaraçõesObrigatóriasDoTokenAusentes	As declarações obrigatórias para o token estão ausentes, por exemplo, CustomerId ou URIs de Registro.
-5	ErroInterno	Ocorreu um erro geral.
-6	TempoEsgotado	A tarefa excedeu o tempo limite.
-7	FalhaAoDeterminarStatusDeIngressoADDaMáquina	O serviço que retorna o status de ingresso da máquina no AD falhou.
-8	FalhaNaMáquinaADAoEncontrarSid	O serviço que retorna o Sid da máquina AD falhou.
-9	FalhaNaSolicitaçãoDeRegistro	A solicitação falhou devido a um erro HTTP.
-10	RespostaDeRegistroComCamposObrigatóriosAusentes	A resposta da ferramenta de registro está sem o parâmetro `VirtualSiteId`.
-11	PermissãoInsuficiente	Você não tem a permissão necessária para executar a tarefa.
-12	FalhaAoDeterminarStatusDeIngressoAadDaMáquina	O serviço que verifica o status de ingresso da máquina no AD gera um erro.
-13	FalhaNaMáquinaAadAoEncontrarDeviceId	O parâmetro adicional `AAD device id` adicionado pelo sistema está vazio.
-14	DeviceIdAadInválido	O parâmetro adicional `AAD device id` adicionado pelo sistema não é um GUID válido.
-15	EndereçoMacInválido	Endereço MAC inválido.
-16	FalhaAoObterNomeDoHostDoComputadorParaVdaInstanceName	Falha ao obter o nome do host do computador para definir o parâmetro adicional `VdaInstanceName`.

-17

FalhaAoAbrirChaveDeRegistroDoAgenteDeDesktopVirtual

Falha ao abrir a chave de registro do VDA para gravar a lista de Delivery Controllers.

-18 Falha: o token atingiu a contagem máxima Falha: o token atingiu a contagem máxima.

Excluir máquinas de um catálogo

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

Os dados do usuário 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:

No Studio, selecione Catálogos de Máquinas no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Exibir Máquinas na barra de ações.
Selecione uma ou mais máquinas e, em seguida, selecione Excluir na barra de ações.
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.

Editar um catálogo

No Studio, selecione Catálogos de Máquinas no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Editar Catálogo de Máquinas na barra de ações.
Na página Escopos, altere os escopos.
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.
Apenas 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.
Nota:
- 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 de máquina.
- Este recurso não é compatível com hipervisores IBM Cloud.
- Este recurso é compatível apenas com o Nutanix Prism Element em hipervisores Nutanix.
Na página Atualização do VDA, altere ou selecione a versão do VDA para a qual deseja atualizar. Para obter mais informações, consulte Atualização do VDA.
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.
  Nota:
  - Apenas os tamanhos de máquina compatíveis com o catálogo são exibidos.
  - 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.
  - Para catálogos do Azure, se ZRS for a redundância de armazenamento na página Tipos de Armazenamento e Licença, você receberá um aviso sugerindo que limpe a seleção de zona e deixe o Azure gerenciar as zonas de disponibilidade da VM.
- Na página Perfil da Máquina, escolha se deseja usar ou alterar um perfil de máquina.
  
  Nota:
  
  Para catálogos do Azure, ao modificar um perfil de máquina que inclui zonas de disponibilidade e escolher ZRS para redundância de armazenamento, um aviso sugere que você limpe a seleção de zona.
- (Somente quando o catálogo está 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 redundância de armazenamento (para catálogo do Azure), tipo de armazenamento, tipo de licença e configurações da Galeria de Computadores do Azure (disponível apenas quando Colocar imagem preparada na Galeria do Azure está em uso).
  
  Nota:
  
  Se a configuração recém-selecionada não for compatível com o tamanho de máquina atual, uma caixa de diálogo de aviso será exibida, informando que a alteração da configuração redefine a configuração de tamanho de 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 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 Unidades Organizacionais, adicione ou remova OUs do Active Directory.
1. Na página Descrição, altere a descrição do catálogo.
1. Clique em “Aplicar” para aplicar as alterações feitas e clique em “Salvar” para sair.
Renomear um catálogo

No Studio, selecione Catálogos de Máquinas no painel esquerdo.
Selecione um catálogo e, em seguida, selecione Renomear Catálogo de Máquinas na barra de ações.

1. Insira o novo nome.

Excluir um catálogo

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

Todos os usuários estejam desconectados e nenhuma sessão desconectada esteja em execução.
O modo de manutenção esteja 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 estejam desligadas.
O catálogo não esteja 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.
-  1.  Selecione um catálogo e, em seguida, selecione **Excluir Catálogo de Máquinas** na barra de ações.
-  1.  Se o catálogo contiver máquinas persistentes, indique se deseja excluir essas máquinas do hipervisor ou serviço de nuvem também. Se optar por fazer isso, escolha se deseja reter, desabilitar ou excluir suas contas de computador do Active Directory.

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 banco de dados do seu 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 esta ação deixa as VMs intactas no host.

Gerenciar contas de computador do Active Directory em um catálogo

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

Liberar contas de máquina não utilizadas removendo contas de computador do Active Directory de catálogos de sessão única e multi-sessão. 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 lugar. Não use uma barra (/) em um nome de OU.
Para gerenciar contas do Active Directory:

No Studio, selecione Catálogos de Máquinas no painel esquerdo.
Selecione um catálogo e, em seguida, selecione “Gerenciar contas AD” na barra de ações.
Escolha se deseja adicionar ou excluir contas de computador. Se você adicionar contas, especifique o que fazer com as senhas das contas: redefina todas elas ou insira 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 realizar 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.

Alterar a imagem mestre de um catálogo

Recomendamos que você salve cópias ou instantâneos de imagens antes de alterar a imagem mestre de um catálogo. O banco de dados mantém um registro histórico das imagens usadas com cada catálogo de máquinas. Se os usuários encontrarem problemas com a nova imagem 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 de 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.

Após uma máquina ser 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:

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”.
Na página “Imagem”, selecione uma imagem preparada.
Na página “Estratégia de implementação”, selecione quando você deseja atualizar este catálogo com a imagem preparada selecionada.
Na página “Resumo”, verifique os detalhes e clique em “Concluir”.
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 hipervisor host, atualizando uma imagem existente ou criando uma.

Em seu hipervisor ou provedor de serviços de nuvem, tire um instantâneo da VM atual e dê um nome significativo ao instantâneo. Este instantâneo pode ser usado para reverter a imagem mestre.
Se necessário, ligue a imagem e faça logon.
Instale atualizações ou faça quaisquer alterações necessárias na imagem.
Se a imagem usar um vDisk Pessoal, atualize o inventário.
Desligue a VM.
Tire um instantâneo da VM e dê um nome significativo ao instantâneo 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 XenServer XenCenter®.

Alterar a imagem mestre

Para implementar uma nova imagem mestre em todas as máquinas de um catálogo:

No Studio, selecione Catálogos de Máquinas no painel esquerdo.
Selecione um catálogo e, em seguida, selecione “Alterar Imagem Mestre” na barra de ações.
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, independentemente de você adicionar uma nota. Se você atualizar um catálogo sem adicionar uma nota, a entrada aparecerá como nula (-). Para visualizar o histórico de notas da imagem, selecione o catálogo, clique em “Propriedades do Modelo” no painel inferior e, em seguida, clique em “Visualizar histórico de notas”.

Na página “Estratégia de Implementação”, escolha quando as máquinas no catálogo de máquinas serã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.

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 os status de atualização da imagem por meio da coluna Atualização da Imagem, incluindo Totalmente atualizado, Parcialmente atualizado, Atualização pendente e Preparando imagem.

Dica:

Para exibir a coluna Atualização da 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 alternativa a uma imagem ou a um instantâneo de uma imagem.

Para implantar uma nova imagem mestre no catálogo de máquinas baseado no Azure:

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

Selecione um catálogo do Azure e, em seguida, selecione Alterar Imagem Mestre na barra de ações.
Na página Alterar Imagem Mestre, selecione uma imagem em Imagem mestre. O painel lista todas as imagens que pertencem à mesma região dos Recursos.

Estratégia de implantação

-  A alteração da imagem no próximo desligamento afetará imediatamente todas as máquinas que não estão em uso no momento, 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.

-  > **Nota:** > > A estratégia de implantaçã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 multissessão com máquinas filhas, as reinicializações não ocorrem automaticamente. Para aplicar a imagem mestre atualizada, reinicie as máquinas usando o Studio, o PowerShell ou o Workspace. A reinicialização 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 implantar 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 implantação, a reversão de uma máquina inclui uma reinicialização.
1. No Studio, selecione Catálogos de Máquinas no painel esquerdo.
1. Selecione o catálogo e, em seguida, selecione Reverter Imagem Mestre na barra de ações.
  - 1. Especifique quando aplicar a imagem anterior às máquinas, conforme descrito para a operação de implantaçã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 determinados 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 do catálogo não persistem.
- As máquinas no catálogo estão em execução.

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

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

Antes de alterar o nível funcional de um catálogo de máquinas:

    -  Inicie as máquinas atualizadas para que elas se registrem no Citrix DaaS. Isso permite que a interface de gerenciamento determine que as máquinas no catálogo precisam ser atualizadas.

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

No Studio, selecione Catálogos de Máquinas no painel esquerdo. - 1. Selecione o catálogo. A guia Detalhes no painel inferior exibe as informações da versão.
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.

Clonar um catálogo

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

    -  Você não pode alterar as configurações associadas ao [sistema operacional](/pt-br/citrix-daas/install-configure/machine-catalogs-create.html#operating-system) e ao [gerenciamento de máquinas](/pt-br/citrix-daas/install-configure/machine-catalogs-create.html#machine-management). O catálogo clonado herda essas configurações do original.

> **Nota:**
>
    -  > Se você selecionar um catálogo do Azure para clonar e selecionar uma Imagem Mestre, o painel listará todas as imagens que pertencem à mesma região dos Recursos.

-  A clonagem de um catálogo pode levar algum tempo para ser concluída. Se necessário, selecione **Ocultar progresso** para executar a clonagem em segundo plano.
-  O catálogo clonado herda o nome do original e tem o sufixo `Copy`. Você pode alterar o nome. Consulte [Renomear um catálogo](/pt-br/citrix-daas/install-configure/machine-catalogs-manage.html#rename-a-catalog).

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.

No Studio, selecione Catálogos de Máquinas no painel esquerdo.
- 1. Selecione um catálogo e, em seguida, selecione Clonar na barra de ações.
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.
Na página Resumo, visualize um resumo das configurações e selecione “Concluir” para iniciar a clonagem.
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.

Criar uma pasta de catálogo

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

 
```

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

No Studio, selecione Catálogos de Máquinas no painel esquerdo.
Na hierarquia de pastas, selecione uma pasta e, em seguida, selecione Criar Pasta na barra Ação.
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.

Mover um catálogo

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

No Studio, selecione Catálogos de Máquinas no painel esquerdo.
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.
Clique com o botão direito do mouse em um catálogo e, em seguida, selecione Mover Catálogo de Máquinas.
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.

Gerenciar pastas de catálogo

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

No Studio, selecione Catálogos de Máquinas no painel esquerdo.
Na hierarquia de pastas, selecione uma pasta e, em seguida, selecione uma ação na barra Ação, conforme necessário:
- Para renomear a pasta, selecione Renomear Pasta.
- Para excluir a pasta, selecione Excluir Pasta.
- Para mover a pasta, selecione Mover Pasta.
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 realizar 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.

Gerenciar configurações de otimização de experiência para um catálogo

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

Permissões necessárias

Por padrão, a criação e o gerenciamento de conjuntos de configuração para catálogos de máquinas exigem a função de Administrador Completo do WEM, juntamente com uma das seguintes funções:
Administrador de Acesso Total
Administrador de Nuvem
Administrador de Catálogo de Máquinas
Para permitir que outras funções gerenciem conjuntos de configuração, atribua a elas a permissão Gerenciar conjuntos de configuração e a função de Administrador Completo do WEM.
Editar as configurações de otimização de experiência
Selecione uma opção de Otimização de Experiência para aplicar ao catálogo:
Aplicar configurações padrão: Selecione esta opção para aplicar as configurações de otimização padrão, incluindo proteção automática contra picos de CPU e otimização inteligente de CPU.
Aplicar configurações personalizadas: Insira um nome para criar um conjunto de configurações e, em seguida, personalize as configurações de otimização de acordo com seus requisitos. Alternativamente, você pode selecionar um conjunto de configurações existente.
Tentar novamente a criação do catálogo

Nota:

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 “Solucionar problemas” de cada catálogo. Antes de tentar novamente a criação do catálogo, considere o seguinte:

Verifique primeiro as informações de solução de problemas 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:

No Studio, selecione “Catálogos de Máquinas” no painel esquerdo.
Selecione o catálogo e, em seguida, vá para a guia “Solucionar problemas”.
- 1. Clique no hiperlink de repetição para tentar novamente a criação do catálogo.
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”.
Depois de terminar, selecione “Concluir” para iniciar a criação.

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

Nota:

Para executar esta tarefa, você deve ter a função de Administrador da Nuvem.
Depois de decidir adotar o registro baseado em token para máquinas não provisionadas por Citrix, gere tokens por catálogo de máquina e, em seguida, compartilhe-os com os administradores de instalação de 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:

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”.
Clique com o botão direito do mouse no catálogo e selecione “Gerenciar Tokens de Registro”.
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 o 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).
Clique em “Gerar”.
Na janela “Token gerado com sucesso” que aparece, copie o token e salve-o em um local seguro, ou clique em “Baixar” para fazer o download para a pasta “Downloads”.

Um registro de token aparece na lista de tokens.
Compartilhe o token com os administradores de instalação de 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.

Nota:

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

Usar PowerShell

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

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

Abra o PowerShell como administrador no Delivery Controller.
Execute o comando asnp citrix* para carregar os módulos Citrix.
Execute o seguinte comando para verificar a contagem inicial do pool de identidades do catálogo:

Get-AcctIdentityPool -IdentityPoolName xxx
O IdentityPoolName é o nome do catálogo.

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

Adicione as máquinas ao catálogo para que as máquinas sejam criadas com a contagem necessária.
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 este 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. Exiba 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 pelo 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 estejam em um catálogo MCS persistente.
O catálogo de máquinas MCS esteja funcionando corretamente. Isso implica que o esquema de provisionamento e o host existem, e o esquema de provisionamento tem entradas corretas.
O Hypervisor não esteja em modo de manutenção.
As VMs de destino estejam desligadas e em modo de manutenção.

Execute as seguintes etapas para redefinir o disco do SO:

Abra uma janela do PowerShell.
Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.
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

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

(Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS

 ```
```
Especifique uma única VM pelo nome:
```
```

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

 ```
```
Crie tarefas de redefinição separadas para cada uma das VMs retornadas pelo comando Get-ProvVM. Isso é menos eficiente porque cada tarefa executará as mesmas verificações redundantes, como verificação de capacidade do hypervisor, verificação de conexão para cada VM.
```
```

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

 ```
```
Um prompt de confirmação aparece listando as VMs a serem redefinidas, juntamente 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á tomada.

Você pode executar o comando PowerShell -WhatIf para imprimir a ação que ele executaria e sair sem realizar 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

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

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

 ```
```
Antes de executar o Reset-ProvVMDisk, altere $ConfirmPreference para ‘None’:
```
```

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

 ```
```
Observação:

Não retire as VMs do modo de manutenção nem as ligue até a conclusão do processo de redefinição.
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 apresentam problemas relacionados à identidade. Você pode optar por redefinir apenas a senha da máquina e as chaves de confiança, ou redefinir toda a configuração do disco de identidade. Esta implementação é aplicável a catálogos de máquinas MCS persistentes e não persistentes.

Observação:

Atualmente, o recurso é compatível apenas com ambientes de virtualização AWS, Azure, GCP, SCVMM, VMware e XenServer.

Condições

Certifique-se do seguinte para redefinir o disco de identidade com 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 as informações de identidade:

Abra a janela do PowerShell.
Execute asnp citrix* para carregar os módulos PowerShell específicos do Citrix.
Redefina as informações de identidade.
- Para redefinir apenas a senha da máquina e as chaves de confiança, execute o seguinte comando:
```
 Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo

 
```
  A descrição dos parâmetros usados no comando é a seguinte:
  - 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 Microsoft Entra ID).
  - PrivilegedUserPassword: Senha para PrivilegedUserName.
  - Target: Destino para a ação de reparo. Pode ser IdentityInfo para reparar a senha/chave de confiança da conta, e UserCertificate para reparar os atributos de certificado de usuário de identidades de máquina híbridas do Microsoft Entra.
- 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

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

 
```
Para recriar completamente o disco de identidade:
```
```

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

 ```
```
Observação:
- Se a máquina estiver em uma versão VDA 2511 (Atualização 1) ou posterior e tiver a chave de registro definida para habilitar um MachineGuid exclusivo (HKLM:\Software\Citrix\MachineIdentityServiceAgent\EnableUniqueMachineGuid), ela continuará usando o mesmo MachineGuid de antes, independentemente da configuração -Recreate.
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 -ProvisioningSchemeName <name> -VMName <name> -Identity -Force


```
Execute Get-ProvVM -ProvisioningSchemeName <name -VMName <name> para verificar a configuração atualizada do disco de identidade. Os atributos do disco de identidade (por exemplo, IdentityDiskId) devem ser atualizados. O StorageId e o IdentityDiskIndex não devem ser alterados.

Alterar a configuração 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:

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

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

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

<!--NeedCopy-->

Execute Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap.
Execute (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps para verificar a nova configuração de rede para o esquema de provisionamento existente.

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

Quando um catálogo de máquinas MCS é atualizado com o comando Set-ProvScheme, a configuração atual é salva como uma versão. 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

 
```
Para ver os detalhes de configuração de uma versão específica de um catálogo de máquinas:
```
 Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2

 
```
Para ver o número total de versões associadas a um catálogo de máquinas:
```
 (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count

 
```
Para usar qualquer versão anterior para atualizar o catálogo de máquinas:
```
 Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2

 
```
Para excluir manualmente uma versão se ela não for usada por uma VM desse catálogo de máquinas:
```
 Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3

 
```
Para definir o número máximo de versões a serem retidas pelo catálogo de máquinas (o padrão é 99). Essa configuração é aplicada a todos os catálogos. Por exemplo, neste caso, um máximo de 15 versões será retido para todos os catálogos provisionados por MCS.
```
 Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15

 
```

Se o número de versões atingir o número máximo de versões, uma nova versão não poderá ser criada se versões mais antigas estiverem em uso por alguma das VMs no catálogo de máquinas. Nesse caso, faça uma das seguintes açõ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 o 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).

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 de 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, pois é 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. 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 de máquina.

Observação:

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

Para fazer isso:

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

Execute o comando Set-ProvScheme para aplicar os valores de propriedade do perfil de 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 do VMware.

Recuperar avisos e erros associados a um catálogo

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

Usando comandos do PowerShell, você pode:

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

Para executar os comandos do PowerShell:

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

Para obter uma lista de erros e avisos:

Execute o comando Get-ProvOperationEvent.

Sem parâmetros: 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 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 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 Citrix PowerShell SDK.

Excluir máquinas sem acesso ao hipervisor

Ao excluir uma VM ou um esquema de provisionamento, o MCS precisa remover as 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 por meio do hipervisor. Use a opção PurgeDBOnly no PowerShell Remove-ProvVM para excluir objetos de recurso de VM, como VM, disco base, imagem no ACG e assim por diante, do banco de dados, mesmo quando não há acesso ao hipervisor.

Esta opção está habilitada em:

todos os hipervisores compatíveis
VMs persistentes e não persistentes

Limitações

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

Usar o comando PurgeDBOnly

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

A conexão do host está em modo de manutenção
Credenciais inválidas
Falha na autenticação
Operação não autorizada
O hypervisor 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 hypervisor 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.

Esta implementação ajuda você a gerenciar VMs individuais de forma eficiente 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:

Atualizar as propriedades de uma VM
Manter as propriedades atualizadas em uma VM após a atualização do catálogo de máquinas
Reverter as atualizações de configuração aplicadas a uma VM

Antes de atualizar as propriedades de uma VM:

Abra uma janela do PowerShell.
Execute asnp citrix* para carregar os módulos PowerShell específicos do Citrix.
Verifique a configuração do catálogo de máquinas existente. Por exemplo:
```
Get-ProvScheme -ProvisioningSchemeName <catalog name>


```
Verifique a configuração da VM na qual você deseja aplicar as atualizações. Por exemplo:
```
Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1


```

Atualizar propriedades de uma VM

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

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

Atualize as propriedades da VM. Por exemplo, se você quiser atualizar a propriedade personalizada de tipo de armazenamento (StorageType) da VM, execute o seguinte:

Set-ProvVM -ProvisioningSchemeName <catalog name> -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 <catalog name> -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."

<!--NeedCopy-->

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

<!--NeedCopy-->

Observação:

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

Obtenha a lista de propriedades que devem ser atualizadas e a versão da configuração. Por exemplo:
```
Get-ProvVMConfiguration -ProvisioningSchemeName <catalog name> -VMName machine1


```
Verifique o valor da propriedade Version e as propriedades a serem atualizadas (neste caso, StorageType).
Verifique a versão da configuração. Por exemplo:
```
Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1


```
Verifique o valor da propriedade ProvVMConfigurationVersion. A atualização ainda não foi aplicada. A VM ainda está na configuração antiga.
Solicite a atualização agendada. Por exemplo:
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -StartsNow -DurationInMinutes -1

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

Reinicie a VM. Por exemplo:

New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn

<!--NeedCopy-->

Verifique a versão da configuração. Por exemplo:
```
Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1


```
Verifique o valor da propriedade de ProvVMConfigurationVersion. A atualização foi aplicada. A VM agora tem a nova configuração.
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:

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

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 <catalog name> -ServiceOffering Standard_E4_v3 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."

<!--NeedCopy-->

Obtenha os detalhes de configuração do catálogo de máquinas. Por exemplo:
```
Get-ProvScheme -ProvisioningSchemeName <catalog name>


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

Atualize as propriedades da VM. Por exemplo, forneça um perfil de máquina para a VM.

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

<!--NeedCopy-->

Observação:

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

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 <catalog name> -VMName machine1


```
Observação:

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

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

Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -VMName machine1 -StartsNow -DurationInMinutes -1

<!--NeedCopy-->

Reinicie a VM. Por exemplo:
```
New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn


```
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.
Obtenha a versão da configuração da VM. Por exemplo:
```
Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1


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

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

Após aplicar as atualizações a uma VM, desligue a VM.

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

Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName <catalog name> -VMName machine1

<!--NeedCopy-->

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

Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -VMName machine1 -StartsNow -DurationInMinutes -1

<!--NeedCopy-->

Reinicie a VM. Por exemplo:

New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn

<!--NeedCopy-->

Verifique a versão da configuração da VM. Por exemplo:
```
Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1


```
O valor de 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 do 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 provisionados não MCS.
Para VMs não persistentes: Disco do SO, Disco de Identidade e disco de cache de write-back (WBC).

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

Ele deve estar no mesmo cluster do armazenamento antigo.
O host no qual a VM está sendo executada deve ter acesso a ambos os datastores antigo e novo.

Migrar o armazenamento em disco

Para migrar o armazenamento em disco:

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 estiver configurado, então o WBC (se usado) deve ser compatível com o armazenamento de destino do SO.
- Se o armazenamento de destino do SO não estiver configurado, então o WBC (se usado) deve ser compatível com o armazenamento atual do SO.
Desligue as VMs e ative o Modo de Manutenção.

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 informações de armazenamento do SO. Por exemplo:

 $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
 $result
 $result.ProvResourceInStorage | Format-List -Property *

 <!--NeedCopy-->

Execute TemporaryStorageInfo para informações de armazenamento do WBC. Por exemplo:

```

$result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
$result
$result.TemporaryStorageInfo | Format-List -Property *

<!--NeedCopy--> ```

Migre o disco do SO, disco de Identidade e disco do WBC (aplicável a VMs não persistentes) para o armazenamento de destino usando o comando PowerShell Move-ProvVMDisk.
Observação:
- 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


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


```
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 ao migrar, então nenhum dos discos é 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 oferece suporte à movimentação do disco se ele tiver o snapshot.

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

Você pode converter um catálogo de máquinas provisionado pelo MCS existente em um catálogo de máquinas de imagem preparada usando o comando PowerShell Set-ProvSchemeImage. No entanto, não é possível reverter para o catálogo herdado 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 um catálogo de máquinas de imagem preparada

Para migrar, faça o seguinte:

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:
- Azure:
  - Studio
  - PowerShell
- VMware:
  - Studio
  - PowerShell

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

Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid

<!--NeedCopy-->

Execute o comando Get-ProvImageVersionSpec para obter o nome da definição da imagem, o UID da especificação da versão da imagem. Por exemplo:

Get-ProvImageVersionSpec -ImageDifinitionName <name> -Filter {IsPrepared -eq $true} | select ImageDefinitionName ImageVersionSpecUId

<!--NeedCopy-->

Execute o comando Set-ProvSchemeImage para migrar um catálogo de máquinas provisionado pelo MCS existente para um catálogo de máquinas de imagem preparada. Por exemplo:
```
Set-ProvSchemeImage -ProvisioningSchemeName [ProvisioningSchemeName] -ImageVersionSpecUid [ImageVersionSpecUid]


```

Execute o comando Get-ProvScheme para verificar se o catálogo foi migrado. Por exemplo:

Get-ProvScheme -ProvisioningSchemeName <name> | 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 exibem continuamente um estado de energia desconhecido, consulte Como corrigir VMs que exibem continuamente um estado de energia desconhecido.
Se um Cloud Connector não estiver funcionando corretamente, as operações de provisionamento do MCS (como atualizações de catálogo) 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 hipervisor específicos, consulte:

A versão oficial deste conteúdo está em inglês. Parte do conteúdo da documentação da Cloud Software Group é traduzida automaticamente para sua conveniência. A Cloud Software Group não tem controle sobre o conteúdo traduzido automaticamente, que pode conter erros, imprecisões ou linguagem inadequada. Nenhuma garantia de qualquer tipo, expressa ou implícita, é fornecida quanto à precisão, confiabilidade, adequação ou correção de quaisquer traduções feitas do original em inglês para qualquer outro idioma, ou quanto à conformidade do seu produto ou serviço Cloud Software Group com qualquer conteúdo traduzido automaticamente, e nenhuma garantia fornecida sob o contrato de licença de usuário final aplicável ou os termos de serviço, ou qualquer outro contrato com a Cloud Software Group, de que o produto ou serviço esteja em conformidade com qualquer documentação será aplicável na medida em que essa documentação tenha sido traduzida automaticamente. A Cloud Software Group não se responsabiliza por quaisquer danos ou problemas que possam surgir em decorrência do uso de conteúdo traduzido automaticamente.

Isso foi útil?

Gerenciar catálogos de máquinas

May 4, 2026

Contribuição de:

C C

May 4, 2026

Contribuição de:

C C

Neste artigo

Introdução
Sobre instâncias persistentes
Gerenciar Catálogos de Máquinas
Usar o Studio
Exibir detalhes do catálogo
Adicionar máquinas a um catálogo
Excluir máquinas de um catálogo
Editar um catálogo
Renomear um catálogo
Excluir um catálogo
Gerenciar contas de computador do Active Directory em um catálogo
Alterar a imagem mestre de um catálogo
Converter catálogos provisionados por MCS de imagens mestre para imagens preparadas
Alterar o nível funcional ou desfazer a alteração
Clonar um catálogo
Organizar catálogos usando pastas
Atualizar VDAs
Gerenciar configurações de otimização de experiência para um catálogo
Tentar novamente a criação do catálogo
(Somente VDAs não provisionados por Citrix) Gerar e gerenciar tokens de registro
Usar PowerShell
Gerenciar o número de sequência do nome da máquina
Adicionar descrições a uma imagem
Redefinir disco do SO
Reparar as informações de identidade de contas de computador ativas
Alterar a configuração de rede para um catálogo de máquinas existente
Gerenciar versões de um catálogo de máquinas
Alterar a configuração de cache de um catálogo de máquinas existente
Converter um catálogo de máquinas não baseado em perfil de máquina para um catálogo de máquinas baseado em perfil de máquina
Recuperar avisos e erros associados a um catálogo
Excluir máquinas sem acesso ao hipervisor
Atualizar propriedades de VMs individuais
Migração de armazenamento de VMs
Migrar catálogos provisionados pelo MCS existentes para o catálogo de máquinas de imagem preparada
Solução de problemas
Onde ir em seguida

Isso foi útil?

Gerenciar catálogos de máquinas

Introdução

Sobre instâncias persistentes