Criar catálogos de máquinas

May 31, 2026

Contribuição de:

Importante:

A partir do Citrix Virtual Apps and Desktops™ 7 2006, se sua implantação atual usar alguma das seguintes tecnologias, você poderá atualizar sua implantação para a versão atual somente após remover os itens de Fim de Vida (EOL) que usam essas tecnologias.

vDisks Pessoais (PvDs)

AppDisks™

Tipos de host de nuvem pública: Citrix CloudPlatform, Microsoft Azure Classic

Para obter detalhes, consulte Remover PVD, AppDisks e hosts não suportados.

Nota:

Você pode gerenciar sua implantação do Citrix Virtual Apps and Desktops usando dois consoles de gerenciamento: Web Studio (baseado na web) e Citrix Studio (baseado em Windows). Este artigo aborda apenas o Web Studio. Para obter informações sobre o Citrix Studio, consulte o artigo equivalente no Citrix Virtual Apps and Desktops 7 2212 ou anterior.

Se você deseja usar conexões de host de nuvem pública para sua implantação, você precisa da Licença de Direitos Híbridos para concluir sua nova instalação ou atualização para a versão atual.

Quando o instalador detecta uma ou mais das tecnologias não suportadas ou conexões de host sem a Licença de Direitos Híbridos, a atualização pausa ou para. Uma mensagem explicativa aparece. Os logs do instalador contêm detalhes. Para obter mais informações, consulte Atualizar uma implantação.

Introdução

Coleções de máquinas físicas ou virtuais são gerenciadas como uma única entidade chamada catálogo de máquinas. Todas as máquinas em um catálogo têm o mesmo tipo de sistema operacional: SO multi-sessão ou SO de sessão única, e máquinas Windows ou Linux.

O Web Studio o guia para criar o primeiro catálogo de máquinas depois de criar o site. Depois de criar o primeiro catálogo, o Web Studio o guia para criar o primeiro grupo de entrega. Mais tarde, você pode alterar o catálogo que criou e criar mais catálogos.

Dica:

A atualização de uma implantação existente habilita o recurso de otimização de armazenamento do Machine Creation Services (MCS) (MCS I/O), nenhuma configuração adicional é necessária. A atualização do Virtual Delivery Agent (VDA) e do Delivery Controller lida com a atualização do MCS I/O.

Visão geral

Ao criar um catálogo de VMs, você especifica como provisionar essas VMs. Você pode usar o Machine Creation Services™ (MCS). Ou, você pode usar suas próprias ferramentas para fornecer máquinas.

Considere:

O MCS oferece suporte a um único disco de sistema da imagem da máquina virtual. Ele ignora o restante dos discos de dados anexados a essa imagem.
Se você usar o MCS para provisionar VMs, você fornecerá uma imagem mestre (ou um instantâneo de uma imagem) para criar VMs idênticas no catálogo. Antes de criar o catálogo, você primeiro usa as ferramentas para criar e configurar a imagem mestre. Esse processo inclui a instalação de um Virtual Delivery Agent (VDA) na imagem. Em seguida, você cria o catálogo de máquinas no Web Studio. Você seleciona essa imagem (ou instantâneo), especifica o número de VMs a serem criadas no catálogo e configura informações adicionais.
Se suas máquinas já estiverem disponíveis, você ainda deverá criar um ou mais catálogos de máquinas para elas.
Se você estiver criando um catálogo usando o PowerShell SDK diretamente, poderá especificar um modelo de hipervisor (VMTemplates), em vez de uma imagem ou um instantâneo.
O uso de um modelo para provisionar um catálogo é considerado um recurso experimental. Ao usar esse método, a preparação da máquina virtual pode falhar. Como resultado, o catálogo não pode ser publicado usando o modelo.

Ao usar o MCS ou o Citrix Provisioning™ para criar o primeiro catálogo, você usa a conexão de host que configurou ao criar o site. Mais tarde (depois de criar seu primeiro catálogo e grupo de entrega), você pode alterar informações sobre essa conexão ou criar mais conexões.

Depois de concluir o assistente de criação de catálogo, os testes são executados automaticamente para garantir que ele esteja configurado corretamente. Quando os testes forem concluídos, você poderá visualizar um relatório de teste. Execute os testes a qualquer momento no Web Studio.

Nota:

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.

Para obter detalhes técnicos sobre as ferramentas do Citrix Provisioning, consulte Gerenciamento de Imagens do Citrix Virtual Apps and Desktops.

Verificação de licença RDS

Atualmente, o Web Studio não verifica as licenças RDS da Microsoft válidas ao criar um catálogo de máquinas que contém máquinas de SO multi-sessão do Windows. Para visualizar o status da licença RDS da Microsoft para uma máquina de SO multi-sessão do Windows, vá para o Citrix Director. Visualize o status da licença RDS da Microsoft no painel Detalhes da Máquina. Este painel está na página Detalhes da Máquina e Detalhes do Usuário. Para obter mais informações, consulte Integridade da licença RDS da Microsoft.

Registro de VDA

Um VDA deve ser registrado com um Delivery Controller™ ao iniciar sessões intermediadas. VDAs não registrados podem resultar na subutilização de recursos que, de outra forma, estariam disponíveis. Existem várias razões pelas quais um VDA pode não estar registrado, muitas das quais um administrador pode solucionar. O Web Studio fornece informações de solução de problemas no assistente de criação de catálogo e depois que você adiciona máquinas de um catálogo a um grupo de entrega.

Depois de adicionar máquinas existentes usando o assistente, a lista de nomes de contas de computador indica se cada máquina é adequada para ser adicionada ao catálogo. Passe o mouse sobre o ícone ao lado de cada máquina para exibir uma mensagem informativa sobre ela.

Se a mensagem identificar uma máquina problemática, remova-a ou adicione-a. Por exemplo, se uma mensagem indicar que as informações podem não ser obtidas sobre uma máquina, adicione a máquina mesmo assim.

Para obter mais informações, consulte:

CTX136668 para orientação sobre solução de problemas de registro de VDA
Versões de VDA e níveis funcionais
Métodos de registro de VDA

Resumo da criação de catálogo MCS

Aqui está uma breve visão geral das ações padrão do MCS depois que você fornece informações no assistente de criação de catálogo.

Se você selecionou uma imagem mestre (em vez de um instantâneo), o MCS cria um instantâneo.
O MCS cria uma cópia completa do instantâneo e a coloca em cada local de armazenamento definido na conexão do host.
O MCS adiciona as máquinas ao Active Directory, o que cria identidades exclusivas.
O MCS cria o número de VMs especificado no assistente, com dois discos definidos para cada VM. Além dos dois discos por VM, um mestre também é armazenado no mesmo local de armazenamento. Se você tiver vários locais de armazenamento definidos, cada um receberá os seguintes tipos de disco:
- A cópia completa do snapshot que é somente leitura e compartilhada entre as VMs recém-criadas.
- Um disco de identidade exclusivo de 16 MB que confere a cada VM uma identidade única. Cada VM recebe um disco de identidade.
- Um disco de diferença exclusivo para armazenar gravações feitas na VM. Este disco é provisionado de forma fina (se suportado pelo armazenamento do host) e aumenta para o tamanho máximo da imagem mestre, se necessário. Cada VM recebe um disco de diferença. O disco de diferença mantém as alterações feitas durante as sessões. É permanente para desktops dedicados. Para desktops agrupados, ele é excluído e um novo é criado após cada reinício via controlador de entrega.

Alternativamente, ao criar VMs para entregar desktops estáticos, você pode especificar (na página Máquinas do assistente de criação de catálogo) clones de VM espessos (cópia completa). Clones completos não exigem a retenção da imagem mestre em cada armazenamento de dados. Cada VM tem seu próprio arquivo.

Considerações de armazenamento do MCS

Existem muitos fatores ao decidir sobre soluções de armazenamento, configurações e capacidades para o MCS. As informações a seguir fornecem considerações adequadas para a capacidade de armazenamento:

Considerações de capacidade:

Discos

Os discos Delta ou de Diferença (Diff) consomem a maior quantidade de espaço na maioria das implantações do MCS para cada VM. Cada VM criada pelo MCS recebe no mínimo 2 discos na criação.
- Disco0 = Disco de Diferença: contém o SO quando copiado da Imagem Base Mestra.
- Disco1 = Disco de Identidade: 16 MB - contém dados do Active Directory para cada VM.
À medida que o produto evolui, pode ser necessário adicionar mais discos para satisfazer certos casos de uso e consumo de recursos. Por exemplo:
- Otimização de Armazenamento do MCS cria um disco estilo cache de gravação para cada VM. Em ambientes de virtualização XenServer, VMware e SCVMM, o MCS coloca o disco de cache de gravação (WBC) no mesmo local de armazenamento do disco do SO se você configurar a lista de armazenamento de SO disponível da mesma forma que a lista de armazenamento temporário disponível ao criar uma conexão de host.
- O MCS adicionou a capacidade de usar clones completos em oposição ao cenário de disco Delta descrito na seção anterior.
Recursos do hipervisor também podem entrar na equação. Por exemplo:
- XenServer IntelliCache cria um Disco de Leitura no armazenamento local para cada XenServer. Esta opção economiza IOPS em relação à imagem mestre que pode ser mantida no local de armazenamento compartilhado.
Sobrecarga do hipervisor

Diferentes hipervisores usam arquivos específicos que criam sobrecarga para VMs. Os hipervisores também usam armazenamento para gerenciamento e operações gerais de registro. Calcule o espaço para incluir a sobrecarga para:
- Arquivos de log
- Arquivos específicos do hipervisor. Por exemplo:
  - O VMware adiciona mais arquivos à pasta armazenamento de VM. Consulte Melhores Práticas do VMware.
  - Calcule os requisitos totais de tamanho da sua máquina virtual. Considere uma máquina virtual contendo 20 GB para o disco virtual, 16 GB para o arquivo de troca e 100 MB para arquivos de log, consumindo um total de 36,1 GB.
- Snapshots para XenServer; Snapshots para VMware.
Sobrecarga de processo

A criação de um catálogo, a adição de uma máquina e a atualização de um catálogo têm implicações de armazenamento exclusivas. Por exemplo:
- Criação inicial do catálogo exige que uma cópia do disco base seja copiada para cada local de armazenamento.
- Adicionar uma máquina a um catálogo não exige a cópia do disco base para cada local de armazenamento. A criação do catálogo varia de acordo com os recursos selecionados.
- Atualizar o catálogo para criar um disco base extra em cada local de armazenamento. As atualizações do catálogo também experimentam um pico temporário de armazenamento onde cada VM no catálogo tem 2 discos Diff por um certo período de tempo.

Mais considerações:

Dimensionamento da RAM: Afeta o tamanho de certos arquivos e discos do hipervisor, incluindo discos de otimização de E/S, cache de gravação e arquivos de snapshot.
Provisionamento Fino / Espesso: O armazenamento NFS é preferido devido aos recursos de provisionamento fino.

Otimização de armazenamento do Machine Creation Services (MCS)

O recurso de otimização de armazenamento do Machine Creation Services (MCS) também é conhecido como MCS I/O. Este recurso está disponível apenas no Azure, GCP, XenServer, VMware, AWS e SCVMM.

O contêiner de cache de gravação é baseado em arquivo, a mesma funcionalidade encontrada no Citrix Provisioning. Por exemplo, o nome do arquivo de cache de gravação do Citrix Provisioning é D:\vdiskdif.vhdx e o nome do arquivo de cache de gravação do MCS I/O é D:\mcsdif.vhdx.
Obtenha melhorias de diagnóstico incluindo suporte para um arquivo de despejo de memória do Windows gravado no disco de cache de gravação.
O MCS I/O mantém a tecnologia de cache na RAM com estouro para o disco rígido para fornecer a solução de cache de gravação de várias camadas mais otimizada. Essa funcionalidade permite que um administrador equilibre o custo em cada camada, RAM e disco, e o desempenho para atender à expectativa de carga de trabalho desejada.

A atualização do método de cache de gravação de baseado em disco para baseado em arquivo requer as seguintes alterações:

O MCS I/O não oferece mais suporte a cache somente RAM. Especifique um tamanho de disco no Web Studio durante a criação do catálogo de máquinas.
O disco de cache de gravação da VM é criado e formatado automaticamente ao inicializar uma VM pela primeira vez. Assim que a VM estiver ativa, o arquivo de cache de gravação mcsdif.vhdx é gravado no volume formatado MCSWCDisk.
O arquivo de paginação é redirecionado para este volume formatado, MCSWCDisk. Como resultado, este tamanho de disco considera a quantidade total de espaço em disco. Ele inclui o delta entre o tamanho do disco e a carga de trabalho gerada, mais o tamanho do arquivo de paginação. Isso geralmente está associado ao tamanho da RAM da VM.

Habilitando atualizações de otimização de armazenamento do MCS

Para habilitar a funcionalidade de otimização de armazenamento do MCS I/O, atualize o Delivery Controller e o VDA para a versão mais recente do Citrix Virtual Apps and Desktops.

Nota:

Se você atualizar uma implantação existente que tenha o MCS I/O habilitado, nenhuma configuração adicional será necessária. A atualização do VDA e do Delivery Controller lida com a atualização do MCS I/O.

Ao habilitar a atualização de otimização de armazenamento do MCS, considere o seguinte:

Ao criar um catálogo de máquinas, o administrador pode configurar a RAM e o tamanho do disco.

Configuração do catálogo de máquinas(/pt-br/citrix-virtual-apps-desktops/2503/media/mcsio-disable.png)
A atualização de um catálogo de máquinas existente para um novo snapshot de VM contendo um VDA configurado para a versão 1903 resulta no seguinte comportamento: o novo snapshot continua a usar a configuração de E/S do MCS do catálogo existente para RAM e tamanho do disco. O disco bruto existente é formatado.

Importante:

A otimização de armazenamento do MCS mudou com o Citrix Virtual Apps and Desktops versão 1903. Esta versão oferece suporte à tecnologia de cache de gravação baseada em arquivo, proporcionando melhor desempenho e estabilidade. A nova funcionalidade fornecida pelo MCS I/O pode exigir um requisito de armazenamento de cache de gravação maior em comparação com as versões anteriores do Citrix Virtual Apps and Desktops. A Citrix recomenda que você reavalie o tamanho do disco para garantir que ele tenha espaço em disco suficiente para o fluxo de trabalho alocado e um tamanho de arquivo de paginação extra. O tamanho do arquivo de paginação geralmente está relacionado à quantidade de RAM do sistema. Se o tamanho do disco do catálogo existente for insuficiente, crie um catálogo de máquinas e aloque um disco de cache de gravação maior.

Atribuir uma letra de unidade específica ao disco de cache de gravação de retorno de E/S do MCS

Você pode atribuir uma letra de unidade específica ao disco de cache de gravação de retorno de E/S do MCS. Essa implementação ajuda a evitar conflitos entre a letra da unidade de quaisquer aplicativos que você usa e a letra da unidade do disco de cache de gravação de retorno de E/S do MCS. Para atribuir uma letra de unidade ao disco de cache de gravação de retorno de E/S do MCS, você pode usar comandos do PowerShell. Os hipervisores suportados são Azure, GCP, VMware, SCVMM e XenServer.

Nota:

Este recurso requer a versão 2305 ou posterior do VDA.

Limitações

Aplicável apenas ao sistema operacional Windows
Letra de unidade aplicável para disco de cache de gravação de retorno: E a Z
Não aplicável quando o disco temporário do Azure é usado como disco de cache de gravação de retorno
Aplicável apenas ao criar um novo catálogo de máquinas

Atribuir uma letra de unidade ao disco de cache de gravação de retorno

Para atribuir uma letra de unidade a um disco de cache de write-back:

Abra a janela do PowerShell.
Execute asnp citrix*.
Crie um pool de identidades, se ainda não tiver sido criado.

Crie um esquema de provisionamento usando o comando New-ProvScheme com a propriedade WriteBackCacheDriveLetter. Por exemplo:

New-ProvScheme -CleanOnBoot `
-HostingUnitName "<name>" `
-IdentityPoolName $schemeName `
-ProvisioningSchemeName $schemeName `
-InitialBatchSizeHint 1 `
-UseWriteBackCache -WriteBackCacheDiskSize 127 -WriteBackCacheMemorySize 256 -WriteBackCacheDriveLetter E `
-MasterImageVM "XDHyp:\HostingUnits\<name>\image.folder\abcd-resources.resourcegroup\MCSIOMasterVm_OsDisk_1_d3e2d6352xxxxxxxxx2130aa145ec77.manageddisk" `
-NetworkMapping @{"0"="XDHyp:\\HostingUnits\\name\\virtualprivatecloud.folder\\East US.region\\virtualprivatecloud.folder\\abcd-resources.resourcegroup\\abcd-resources-vnet.virtualprivatecloud\\default.network"} `
-ServiceOffering "XDHyp:\\HostingUnits\\<name>\\serviceoffering.folder\\Standard_D2s_v5.serviceoffering" `
-CustomProperties '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
<Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS"/>
<Property xsi:type="StringProperty" Name="PersistWBC" Value="false" />
<Property xsi:type="StringProperty" Name="PersistOsDisk" Value="false" />
<Property xsi:type="StringProperty" Name="PersistVm" Value="false" />
<Property xsi:type="StringProperty" Name="WBCDiskStorageType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="UseTempDiskForWBC" Value="false" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="abcd-group1" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
<Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
</CustomProperties>'
<!--NeedCopy-->

Conclua a criação do catálogo. Para obter informações, consulte https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/creating-a-catalog/.

Prepare uma imagem mestre

Para obter informações sobre como criar hosts de conexão, consulte Conexões e recursos.

A imagem mestre contém o sistema operacional, aplicativos não virtualizados, VDA e outros softwares.

É bom saber:

Uma imagem mestre também pode ser conhecida como imagem de clone, imagem dourada, VM base ou imagem base. Os fornecedores de host usam termos diferentes.
Certifique-se de que o host tenha processadores, memória e armazenamento suficientes para acomodar o número de máquinas criadas.
Configure a quantidade correta de espaço em disco rígido necessária para desktops e aplicativos. Esse valor não pode ser alterado posteriormente ou no catálogo de máquinas.
Os catálogos de máquinas do Acesso Remoto para PC não usam imagens mestre.

Instale e configure o seguinte software na imagem mestre:

Ferramentas de integração para seu hipervisor (como Citrix VM Tools, Hyper-V Integration Services ou VMware tools). Se você omitir esta etapa, os aplicativos e desktops podem não funcionar corretamente.
Um VDA. A Citrix recomenda instalar a versão mais recente para permitir o acesso aos recursos mais novos. A falha na instalação de um VDA na imagem mestre faz com que a criação do catálogo falhe.
Ferramentas de terceiros conforme necessário, como software antivírus ou agentes de distribuição eletrônica de software. Configure os serviços com configurações apropriadas para os usuários e o tipo de máquina (como recursos de atualização).
Aplicativos de terceiros que você não está virtualizando. A Citrix recomenda virtualizar aplicativos. A virtualização reduz custos, eliminando a necessidade de atualizar a imagem mestre após adicionar ou reconfigurar um aplicativo. Além disso, menos aplicativos instalados reduzem o tamanho dos discos rígidos da imagem mestre, o que economiza custos de armazenamento.
Clientes App-V com as configurações recomendadas, se você planeja publicar aplicativos App-V. O cliente App-V está disponível na Microsoft.
Ao usar o MCS, se você localizar o Microsoft Windows, instale as localidades e os pacotes de idiomas. Durante o provisionamento, quando um snapshot é criado, as VMs provisionadas usam as localidades e os pacotes de idiomas instalados.

Importante:

Se você estiver usando o MCS, não execute o Sysprep em imagens mestre.

Para preparar uma imagem mestre:

Usando a ferramenta de gerenciamento do seu hipervisor, crie uma imagem mestre e, em seguida, instale o sistema operacional, além de todos os service packs e atualizações. Especifique o número de vCPUs. Você também pode especificar o valor da vCPU se criar o catálogo de máquinas usando o PowerShell. Você não pode especificar o número de vCPUs ao criar um catálogo usando o Web Studio. Configure a quantidade de espaço em disco rígido necessária para desktops e aplicativos. Esse valor não pode ser alterado posteriormente ou no catálogo.
Certifique-se de que o disco rígido esteja anexado no local do dispositivo 0. A maioria dos modelos de imagem mestre padrão configura este local por padrão, mas alguns modelos personalizados podem não fazê-lo.
Instale e configure o software listado acima na imagem mestre.
Se você não estiver usando o MCS, junte a imagem mestre ao domínio onde os aplicativos e desktops são membros. Certifique-se de que a imagem mestre esteja disponível no host onde as máquinas são criadas. Se você estiver usando o MCS, não é necessário juntar a imagem mestre a um domínio. As máquinas provisionadas são unidas ao domínio especificado no assistente de criação de catálogo.
A Citrix recomenda que você crie e nomeie um snapshot da sua imagem mestre. Se você especificar uma imagem mestre em vez de um snapshot ao criar um catálogo, o Web Studio criará um snapshot. Você não poderá nomeá-lo.

Ativação de licenciamento por volume

O MCS oferece suporte à ativação de licenciamento por volume para automatizar e gerenciar a ativação de sistemas operacionais Windows e Microsoft Office. Os três modelos que o MCS oferece suporte para ativação de licenciamento por volume são:

Serviço de Gerenciamento de Chaves (KMS)
Ativação baseada no Active Directory (ADBA)
Chave de Ativação Múltipla (MAK)

Você pode alterar a configuração de ativação após criar o catálogo de máquinas.

Serviço de Gerenciamento de Chaves (KMS)

O KMS é um serviço leve que não requer um sistema dedicado e pode ser facilmente co-hospedado em um sistema que fornece outros serviços. Essa funcionalidade é suportada em todas as versões do Windows suportadas pelo Citrix. Durante a preparação da imagem, o MCS realiza o rearm do KMS do Microsoft Windows e do Microsoft Office. Você pode pular o rearm executando o comando Set-Provserviceconfigurationdata. Para obter mais informações sobre a ativação do KMS, consulte Ativar usando o Serviço de Gerenciamento de Chaves.

Nota:

Todos os catálogos de máquinas criados após a execução do comando Set-Provserviceconfigurationdata têm a mesma configuração fornecida no comando.

Ativação baseada no Active Directory (ADBA)

O ADBA permite ativar máquinas por meio de suas conexões de domínio. As máquinas são ativadas imediatamente quando ingressam no domínio. Essas máquinas permanecem ativadas enquanto permanecerem unidas ao domínio e em contato com ele. Essa funcionalidade é suportada em todas as versões do Windows suportadas pelo Citrix. Para obter mais informações sobre a ativação baseada no Active Directory, consulte Ativar usando ativação baseada no Active Directory.

Chave de Ativação Múltipla (MAK)

MAK é uma forma de ativar o volume e autenticar o sistema Windows com a ajuda do servidor Microsoft. Você deve comprar a chave MAK da Microsoft, que é atribuída com um número fixo de contagens de ativação. Cada vez que um sistema Windows é ativado, a contagem de ativação é reduzida. Existem duas maneiras de ativar o sistema:

Ativação Online: Se o sistema Windows que você deseja ativar tiver acesso à internet, o sistema ativa automaticamente o Windows ao instalar a chave do produto. Esse processo reduz a contagem de ativação em 1 para a MAK correspondente.
Ativação Offline: Se o sistema Windows não conseguir se conectar à internet para fazer a ativação online, o MCS obtém um ID de confirmação e um ID de instalação do servidor Microsoft para ativar o sistema Windows. Essa forma de ativação é útil para catálogos de máquinas não persistentes.

Nota:

O MCS não oferece suporte à ativação do Microsoft Office usando MAK.

A versão mínima do VDA necessária é 2303.

Requisitos de chave

O Delivery Controller deve ter acesso à internet.
Crie um novo catálogo se a nova imagem a ser atualizada tiver uma chave MAK diferente da original.
Instale a chave MAK na imagem mestre. Consulte Implantar Ativação MAK para as etapas de instalação da chave MAK em um sistema Windows.
Se você não estiver usando a preparação de imagem:
1. Adicione o valor DWORD do registro Manual em Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\SoftwareProtectionPlatform\Activation.
2. Defina o valor como 1.

Contagens de Ativação

Para visualizar o número de ativações restantes para a chave MAK ou para verificar se uma VM está consumindo duas ou mais ativações, use a Ferramenta de Gerenciamento de Ativação de Volume (VAMT). Consulte Instalar VAMT.

Ative o sistema Windows usando MAK

Para ativar o sistema Windows usando MAK:

Instale a chave do produto na imagem mestre. Esta etapa consome uma contagem de ativação.
Criar um catálogo de máquinas MCS.
Se você não estiver usando a preparação de imagem:
1. Adicione o valor DWORD do registro Manual em Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\SoftwareProtectionPlatform\Activation.
2. Defina o valor como 1.
Este método desabilita a opção de ativação online.
Adicione VMs ao catálogo de máquinas.
Ligue as VMs.
Dependendo se é ativação online ou offline, o sistema Windows é ativado.
- Se a ativação for online, o sistema Windows será ativado após a instalação da chave do produto.
- Se a ativação for offline, o MCS se comunica com as VMs provisionadas para obter o status de ativação do sistema Windows. O MCS então recupera um ID de confirmação e um ID instalado do servidor Microsoft. Esses IDs são usados para ativar o sistema Windows.

Solução de problemas

Se a VM provisionada não for ativada com a chave MAK instalada, execute o comando Get-ProvVM ou Get-ProvScheme em uma janela do PowerShell.

O comando Get-ProvScheme: Consulte o parâmetro WindowsActivationType associado ao catálogo de máquinas MCS da imagem mestre mais recente.
O comando Get-ProvVM. Consulte os parâmetros WindowsActivationType, WindowsActivationStatus, WindowsActivationStatusErrorCode e WindowsActivationStatusError.

Você pode verificar o erro e as etapas para resolver o problema.

Criar um catálogo de máquinas usando o Web Studio

Antes de criar um catálogo:

Revise esta seção para saber mais sobre as escolhas que você faz e as informações que você fornece.
Certifique-se de ter criado uma conexão com o hipervisor, serviço de nuvem e outros recursos que hospedam suas máquinas.
Se você criou uma imagem mestre para provisionar máquinas, certifique-se de ter instalado um VDA nessa imagem.

Para iniciar o assistente de criação de catálogo:

Se este for o primeiro catálogo a ser criado, você será guiado para a seleção correta (como “Configurar as máquinas e criar catálogos de máquinas para executar aplicativos e desktops”). O assistente de criação de catálogo é aberto.
Se você já criou um catálogo e deseja criar outro, siga estas etapas:
1. Faça login no Web Studio, selecione Catálogos de Máquinas no painel esquerdo e, em seguida, selecione Criar Catálogo de Máquinas na barra de ações.
2. Para organizar catálogos usando pastas, crie pastas sob a pasta padrão Catálogos de Máquinas. Para obter mais informações, consulte Criar uma pasta de catálogo.
3. Selecione a pasta onde você deseja criar o catálogo e, em seguida, clique em Criar Catálogo de Máquinas. O assistente de criação de catálogo é aberto.

O assistente o guiará pelos seguintes itens. As páginas do assistente que você vê diferem, dependendo das seleções que você faz.

Sistema operacional

Cada catálogo contém máquinas de apenas um tipo. Selecione um.

SO multissessão: Um catálogo de SO multissessão fornece desktops compartilhados hospedados. As máquinas podem estar executando versões compatíveis dos sistemas operacionais Windows ou Linux, mas o catálogo não pode conter ambos. (Consulte a documentação do Linux VDA para obter detalhes sobre esse SO.)
Sistema operacional de sessão única: Um catálogo de sistema operacional de sessão única fornece desktops VDI que você pode atribuir a vários usuários diferentes.
Acesso Remoto a PC: Um catálogo de Acesso Remoto a PC fornece aos usuários acesso remoto às suas máquinas de desktop físicas do escritório. O Acesso Remoto a PC não requer uma VPN para fornecer segurança.

Gerenciamento de máquinas

Esta página não aparece ao criar catálogos de Acesso Remoto a PC.

A página Gerenciamento de Máquinas indica como as máquinas são gerenciadas e quais ferramentas você usa para implantar máquinas.

Escolha se as máquinas no catálogo são gerenciadas em termos de energia através do Web Studio.

As máquinas são gerenciadas em termos de energia através do Web Studio, por exemplo, VMs ou PCs blade. Esta opção está disponível apenas se você já configurou uma conexão com um host.
As máquinas não são gerenciadas em termos de energia através do Web Studio, por exemplo, máquinas físicas.

Se você indicou que as máquinas são gerenciadas em termos de energia através do Web Studio, escolha qual ferramenta usar para criar VMs.

Tecnologia Citrix Provisioning
- Citrix Machine Creation Services (MCS) Cria um catálogo de VMs provisionadas e com imagem usando MCS. O MCS copia imagens clonadas de uma imagem mestre para essas VMs.
- Citrix Provisioning Services (PVS) Cria um catálogo de VMs provisionadas usando MCS e com imagem usando PVS. Essas VMs servem como dispositivos de destino PVS e o servidor PVS pode transmitir uma única imagem de disco compartilhada para elas.
  Nota:
  - Esta opção está disponível apenas para sites PVS registrados no Citrix Cloud™ e está atualmente limitada a recursos do Azure.
  - Ao criar um catálogo do Citrix Provisioning, na página Dispositivo de Destino, você pode ver que no menu suspenso para selecionar a farm e o site para as máquinas a serem provisionadas, há farms e sites listados que não existem mais. Como solução alternativa, você pode executar o comando PowerShell Unregister-HypPvsSite para remover as farms e os sites do banco de dados. Para obter informações sobre o comando PowerShell, consulte Unregister-HypPvsSite.
Outro serviço ou tecnologia Uma ferramenta que gerencia máquinas já existentes no data center. A Citrix recomenda que você use o Microsoft System Center Configuration Manager ou outro aplicativo de terceiros para garantir que as máquinas no catálogo sejam consistentes.

Tipos de desktop (experiência de desktop)

Nota:

As opções na página Experiência de Desktop variam de acordo com o tipo de máquina que você seleciona na página Tipo de Máquina.

Para máquinas com SO de várias sessões, os usuários recebem um desktop aleatório cada vez que fazem logon. Selecione uma das seguintes opções:
- Sim, salve as alterações no disco local da máquina que hospeda os desktops virtuais. (Persistente)
- Não, descarte todas as alterações e limpe os desktops virtuais quando o usuário fizer logoff. (Não persistente)
Nota:

Para máquinas persistentes de várias sessões, as alterações que os usuários fazem nos desktops serão salvas e acessíveis a todos os usuários autorizados.
Para máquinas com SO de sessão única, você obtém as seguintes opções na página Experiência de Desktop:
- Quero que os usuários se conectem a um novo desktop (aleatório) cada vez que fizerem logon.
- Quero que os usuários se conectem ao mesmo desktop (estático) cada vez que fizerem logon.
  
  Para desktops estáticos, você pode decidir se as alterações feitas pelos usuários serão salvas ou descartadas após o logoff.

Se você selecionar Salvar alterações no disco local da máquina que hospeda os desktops virtuais: Persistente, as opções de cópia rápida ou cópia completa estão disponíveis para o modo de cópia da máquina virtual na página Máquinas Virtuais.

Se você selecionar Descartar todas as alterações e limpar os desktops virtuais quando o usuário fizer logoff: Não persistente, você não pode configurar o modo de cópia da máquina virtual na página Máquinas Virtuais.

Imagem e perfil da máquina

Esta página aparece somente quando você está usando o MCS para criar VMs.

Selecione um tipo de imagem para o catálogo de máquinas e, em seguida, selecione uma imagem. Dois tipos de imagem estão disponíveis:
- Imagem mestre. Uma imagem que ainda não passou pelo processo de preparação de imagem. O processo de preparação de imagem é iniciado automaticamente quando a criação do catálogo começa.
  Nota:
  - Ao usar o MCS, não execute o Sysprep em imagens mestre.
  - Se você especificar uma imagem mestre em vez de um instantâneo, o Web Studio criará um instantâneo, mas você não poderá nomeá-lo.
- Imagem preparada. Uma imagem que passou pelo processo de preparação de imagem e pode ser usada diretamente para a criação de VM. Optar por imagens preparadas em vez de imagens mestre durante a criação do catálogo garante uma criação de catálogo de máquinas mais rápida e confiável, juntamente com um gerenciamento simplificado do ciclo de vida da imagem.
  Nota:
  - As VMs criadas usando imagens preparadas não suportam hibernação.
  - Atualmente, a criação de catálogos usando imagens preparadas está disponível apenas em ambientes Azure e VMware.
Para obter mais informações sobre como criar imagens preparadas, consulte Gerenciamento de imagens (visualização).

Ao selecionar uma imagem, você pode adicionar uma nota para a imagem selecionada, se necessário.

Para habilitar o uso dos recursos mais recentes do produto, certifique-se de que a imagem mestre tenha a versão mais recente do VDA instalada. Não altere a seleção mínima padrão do VDA. No entanto, se você precisar usar uma versão anterior do VDA, consulte Versões do VDA e níveis funcionais.

Uma mensagem de erro aparece se você selecionar um instantâneo ou VM que não seja compatível com a tecnologia de gerenciamento de máquina selecionada anteriormente no assistente.
Para usar uma VM existente como perfil de máquina, selecione Usar um perfil de máquina e, em seguida, selecione a VM.

Nota:

Atualmente, o uso de perfis de máquina é restrito a VMs do Azure, AWS, GCP e VMware.

Para implantações VMware, ao criar um catálogo de máquinas usando um perfil de máquina, você deve especificar a pasta onde deseja manter as máquinas virtuais.

Para fornecer o local da pasta da máquina virtual, no assistente de criação de catálogo, vá para a página Máquinas Virtuais e vá para a seção Selecionar uma pasta para colocar as máquinas e selecione o local da pasta da máquina virtual. Se não for especificado, o sistema considera a pasta do perfil de máquina selecionado como o local padrão.
Para implantações AWS, você pode selecionar um modelo de inicialização como perfil de máquina.
Selecione o nível funcional mínimo para o catálogo. Para habilitar o uso dos recursos mais recentes do produto, certifique-se de que a imagem mestre tenha a versão mais recente do VDA instalada.

Máquinas

Esta página não aparece quando você está criando catálogos de Acesso Remoto a PCs.

O título desta página depende do que você selecionou na página Gerenciamento de Máquinas: Máquinas, Máquinas Virtuais ou VMs e usuários.

Ao usar o MCS:

Especifique quantas máquinas virtuais criar. Digite 0 (zero) se não quiser criar nenhuma. Mais tarde, você pode criar VMs para um catálogo vazio executando Adicionar máquinas.
Escolha a quantidade de memória (em MB) que cada VM terá.
Cada VM criada tem um disco rígido. Seu tamanho é definido na imagem mestre. Você não pode alterar o tamanho do disco rígido no catálogo.
Se sua implantação contiver mais de uma zona, você poderá selecionar uma zona para o catálogo.
Se você estiver criando VMs de desktop estáticas, selecione um modo de cópia de máquina virtual. Consulte Modo de cópia de máquina virtual.
Se você estiver criando VMs de desktop aleatórias que não usam vDisks, poderá configurar um cache para ser usado para dados temporários em cada máquina. Consulte Configurar cache para dados temporários.

Ao usar outras ferramentas:

Adicione (ou importe uma lista de) nomes de contas de máquina do Active Directory. Você pode alterar o nome da conta do Active Directory para uma VM depois de adicioná-la/importá-la. Se você especificou máquinas estáticas na página Experiência da Área de Trabalho, pode, opcionalmente, especificar o nome de usuário do Active Directory para cada VM que adicionar.

Depois de adicionar ou importar nomes, você pode usar o botão Remover para excluir nomes da lista, enquanto ainda estiver nesta página.

Ao usar outras ferramentas (mas não o MCS):

Um ícone e uma dica de ferramenta para cada máquina adicionada (ou importada) ajudam a identificar máquinas que podem não ser elegíveis para adicionar ao catálogo ou que não conseguem se registrar em um Delivery Controller. Para obter detalhes, consulte Versões do VDA e níveis funcionais.

Adicionar SIDs ao criar máquinas virtuais

Agora você pode adicionar o parâmetro ADAccountSid para identificar exclusivamente as máquinas ao criar novas máquinas virtuais.

Para fazer isso:

Crie um catálogo com o tipo de identidade compatível.

Adicione máquinas ao catálogo usando NewProvVM. Por exemplo:

New-ProvVM  -ProvisioningSchemeName "name"  -ADAccountSid @("SID ")  -RunAsynchronously
<!--NeedCopy-->

No entanto, você não pode provisionar uma máquina com:

Uma conta AD que não está no pool de identidade do catálogo
Uma conta AD que não está em estado disponível

Modo de cópia da máquina virtual

O modo de cópia que você especifica na página Máquinas determina se o MCS cria clones finos (cópia rápida) ou espessos (cópia completa) a partir da imagem mestre. (Padrão = clones finos)

Use clones de cópia rápida para um uso de armazenamento mais eficiente e criação de máquinas mais rápida.
Use clones de cópia completa para melhor recuperação de dados e suporte à migração, com IOPS potencialmente reduzidos após a criação das máquinas.

Nota:

A abordagem de Clone de Cópia Completa está disponível apenas para provisionamento de VMs persistentes em SOs de sessão única ou múltipla.

Versões de VDA e níveis funcionais

O nível funcional de um catálogo controla quais recursos do produto estão disponíveis para as máquinas no catálogo. O uso de recursos introduzidos em novas versões do produto requer um novo VDA. No entanto, as máquinas nesse catálogo com uma versão anterior do VDA não podem se registrar.

Um menu próximo à parte inferior da página Máquinas (ou Dispositivos) permite selecionar o nível mínimo de VDA. Isso define o nível funcional mínimo do catálogo. Por padrão, o nível funcional mais atual é selecionado para implantações locais. Se você seguir a recomendação da Citrix de sempre instalar e atualizar VDAs e componentes principais para a versão mais recente, não precisará alterar essa seleção. No entanto, se você precisar continuar usando versões mais antigas do VDA, selecione o valor correto.

Uma versão do Citrix Virtual Apps and Desktops pode não incluir uma nova versão do VDA, ou o novo VDA pode não impactar o nível funcional. Nesses casos, o nível funcional pode indicar uma versão do VDA anterior aos componentes instalados ou atualizados. O artigo Novidades de cada versão indica qualquer alteração no nível funcional padrão.

O nível funcional selecionado afeta a lista de máquinas acima dele. Na lista, uma dica de ferramenta ao lado de cada entrada indica se o VDA da máquina é compatível com o catálogo nesse nível funcional.

Mensagens são exibidas na página se o VDA em cada máquina não atender ou exceder o nível funcional mínimo selecionado. Você pode continuar com o assistente. É provável que essas máquinas não consigam se registrar em um Controller posteriormente. Alternativamente, você pode:

Remover as máquinas que contêm VDAs mais antigos da lista, atualizar seus VDAs e, em seguida, adicioná-las de volta ao catálogo.
Escolher um nível funcional inferior que impeça o acesso aos recursos mais recentes do produto.

Uma mensagem também é exibida se uma máquina não foi adicionada ao catálogo porque é do tipo de máquina errado. Exemplos incluem tentar adicionar um servidor a um catálogo de SO de sessão única, ou adicionar uma máquina de SO de sessão única originalmente criada para alocação aleatória a um catálogo de máquinas estáticas.

Importante:

Na versão 1811, um nível funcional extra foi adicionado: 1811 (ou mais recente). Esse nível é destinado ao uso com futuros recursos do Citrix Virtual Apps and Desktops. A seleção 7.9 (ou mais recente) permanece o padrão. Esse padrão é válido para todas as implantações agora.

Se você selecionar 1811 (ou mais recente), quaisquer versões anteriores de VDA nesse catálogo não poderão se registrar em um Controller. No entanto, se o catálogo contiver apenas VDAs na versão 1811 ou versões posteriores suportadas, todos eles serão elegíveis para registro. Isso inclui catálogos que contêm VDAs configurados para versões posteriores do Citrix Virtual Apps and Desktops, incluindo a versão 1903 e outras versões 19XX anteriores à versão atual.

Configurar cache para dados temporários

Ao usar o MCS para gerenciar máquinas aleatórias não persistentes em um catálogo, você pode habilitar o Write-Back Cache para as máquinas para melhorar o desempenho de E/S.

O Write-back Cache é conhecido como MCSIO. Para obter mais informações, consulte este artigo do blog.

Pré-requisitos

Para habilitar o write-back cache, o catálogo deve atender aos seguintes requisitos:

Usa uma conexão que especifica o armazenamento para dados temporários. Para obter mais informações, consulte Conexões e recursos.
Os VDAs devem ser no mínimo da versão 7.9 e instalados com um driver MCSIO atual.

Nota:

A instalação deste driver é uma opção ao instalar ou atualizar um VDA. Por padrão, esse driver não é instalado.
Para habilitar a atribuição de letra de unidade para caches de disco, as VMs devem atender aos seguintes requisitos adicionais:
- Sistema Operacional: Windows
- Versão do VDA: 2305 ou posterior

Considerações

Os caches de write-back vêm em cache de Memória e cache de Disco. Por padrão, seus valores padrão diferem de acordo com o tipo de conexão. Geralmente, os valores padrão são suficientes para a maioria dos casos; no entanto, considere o espaço necessário para:
- Arquivos de dados temporários criados pelo próprio Windows, incluindo o arquivo de paginação do Windows.
- Dados do perfil do usuário.
- Dados do ShareFile que são sincronizados com as sessões dos usuários.
- Dados que podem ser criados ou copiados por um usuário da sessão ou por quaisquer aplicativos que os usuários possam instalar dentro da sessão.
A configuração do cache de write-back com um cache de disco e sem cache de memória foi removida. Para habilitar um cache para dados temporários, recomendamos selecionar Tamanho do cache de disco (GB) e Memória alocada para cache (MB) e especificar um tamanho maior que 0 para o cache de memória. Os dados temporários são inicialmente gravados no cache de memória. Quando o cache de memória atinge seu limite configurado, os dados mais antigos são movidos para o disco de cache de dados temporários.
O cache de memória faz parte da quantidade total de memória em cada máquina. Portanto, se você habilitar a caixa de seleção Tamanho do cache de memória (MB) (recomendado), considere aumentar a quantidade total de memória em cada máquina.
Se você mantiver a caixa de seleção Tamanho do cache de memória (MB) (recomendado) desmarcada, os dados temporários serão gravados diretamente no cache de disco, usando uma quantidade mínima de memória.
Alterar o Tamanho do cache de disco (GB) de seu valor padrão pode afetar o desempenho. O tamanho deve corresponder aos requisitos do usuário e à carga colocada na máquina.

Importante:

Se o cache de disco ficar sem espaço, a sessão do usuário se tornará inutilizável.
Se você desmarcar a caixa de seleção Tamanho do cache de disco, nenhum disco de cache será criado. Neste caso, especifique um valor de Memória alocada para cache que seja grande o suficiente para armazenar todos os dados temporários. Isso é viável apenas se grandes quantidades de RAM estiverem disponíveis para alocação a cada VM.
Se você desmarcar ambas as caixas de seleção, os dados temporários não serão armazenados em cache. Eles serão gravados no disco de diferença (localizado no armazenamento do SO) para cada VM. (Esta é a ação de provisionamento em versões anteriores a 7.9.)
Não ative o cache se você pretende usar este catálogo para criar AppDisks.
Você não pode alterar os valores de cache em um catálogo de máquinas depois que ele é criado.

NIC (NICs)

Esta página não aparece ao criar catálogos de Acesso Remoto para PC.

Se você planeja usar várias NICs, associe uma rede virtual a cada placa. Por exemplo, você pode atribuir uma placa para acessar uma rede segura específica e outra placa para acessar uma rede mais comumente usada. Você também pode adicionar ou remover NICs desta página.

Contas de máquina

Esta página aparece apenas ao criar catálogos de Acesso Remoto para PC.

Na página Contas de Máquina, especifique as contas de máquina do Active Directory ou Unidades Organizacionais (OUs) a serem adicionadas que correspondem a usuários ou grupos de usuários. Não use uma barra (/) em um nome de OU.

Ao adicionar OUs, você pode fazer o seguinte se o domínio não for exibido na lista:

Pesquisar por ele usando uma correspondência exata.
Navegar por todos os domínios para encontrá-lo.

Você pode escolher uma conexão de gerenciamento de energia configurada anteriormente ou optar por não usar o gerenciamento de energia. Se você deseja usar o gerenciamento de energia, mas uma conexão adequada ainda não foi configurada, você pode criar essa conexão mais tarde e, em seguida, editar o catálogo de máquinas para atualizar as configurações de gerenciamento de energia.

Identidades de máquina

Esta página aparece apenas ao usar o MCS para criar VMs.

Cada máquina no catálogo deve ter uma identidade única. Esta página permite configurar identidades para máquinas no catálogo. As máquinas são unidas à identidade depois de serem provisionadas. Você não pode alterar o tipo de identidade depois de criar o catálogo.

Um fluxo de trabalho geral para configurar as definições nesta página é o seguinte:

Selecione uma identidade na lista.
Indique se deseja criar contas ou usar as existentes, e o local (domínio) para essas contas.

Você pode selecionar uma das seguintes opções:

Active Directory local. Máquinas de propriedade de uma organização e conectadas com uma conta do Active Directory que pertence a essa organização. Elas existem no local.
Unido ao Azure Active Directory Híbrido. Máquinas de propriedade de uma organização e conectadas com uma conta do Active Directory Domain Services que pertence a essa organização. Elas existem na nuvem e no local. Para obter informações sobre os requisitos, limitações e considerações, consulte Unido ao Azure Active Directory Híbrido.
Nota:
- Antes de usar a união híbrida do Azure Active Directory, certifique-se de que seu ambiente Azure atenda aos pré-requisitos. Consulte Configurar a união híbrida do Microsoft Entra.
- Esta opção exige que a imagem mestre atenda ao pré-requisito do sistema operacional. Para obter mais informações, consulte Dispositivos unidos ao Microsoft Entra híbrido.
Não unido ao domínio. Máquinas não unidas a nenhum domínio. Para obter informações sobre os requisitos e limitações, consulte Não unido ao domínio.

Importante:

Se você selecionar Active Directory local ou Unido ao Azure Active Directory Híbrido como tipo de identidade, cada máquina no catálogo deve ter uma conta de computador do Active Directory correspondente.

O tipo de identidade Não unido ao domínio requer a versão 2311 ou posterior do VDA como nível funcional mínimo para o catálogo. Para torná-lo disponível, atualize o nível funcional mínimo.

Se você criar contas, deverá ter permissão para criar contas de computador na UO onde as máquinas residem. Cada máquina no catálogo deve ter um nome exclusivo. Especifique o esquema de nomenclatura de contas para as máquinas que você deseja criar. Para obter mais informações, consulte Esquema de nomenclatura de contas de máquina.

Nota:

Certifique-se de que os nomes das UOs não usem barras (/).

Se você usar contas existentes, navegue até as contas ou clique em Importar e especifique um arquivo .csv contendo nomes de contas. O conteúdo do arquivo importado deve usar o formato:

[ADComputerAccount] ADcomputeraccountname.domain

Certifique-se de que haja contas suficientes para todas as máquinas que você está adicionando. A interface do Web Studio gerencia essas contas. Portanto, 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.

Para catálogos que contêm máquinas físicas ou existentes, selecione ou importe contas existentes e atribua cada máquina a uma conta de computador do Active Directory e a uma conta de usuário.

Esquema de nomenclatura de conta de máquina

Cada máquina em um catálogo deve ter um nome exclusivo. Você deve especificar um esquema de nomenclatura de conta de máquina ao criar um catálogo. Use curingas (sinais de hash) como espaços reservados para números ou letras sequenciais que aparecem no nome.

Ao especificar um esquema de nomenclatura, esteja ciente das seguintes regras:

O esquema de nomenclatura deve conter pelo menos um curinga. Você deve colocar todos os curingas juntos.
O nome completo, incluindo curingas, deve conter no mínimo 2 e no máximo 15 caracteres. Deve incluir pelo menos um caractere não numérico e um caractere # (curinga).
O nome não deve incluir espaços ou qualquer um dos seguintes caracteres: ,~!@'$%^&.()}{\/*?"<>|=+[];:_"..
O nome não pode terminar com um hífen (-).

Além disso, deixe espaço suficiente para crescimento ao especificar o esquema de nomenclatura. Considere este exemplo: Se você criar 1.000 contas de máquina com o esquema “veryverylong#”, o último nome de conta criado (veryverylong1000) contém 16 caracteres. Portanto, o esquema de nomenclatura resulta em um ou mais nomes de máquina que excedem o máximo de 15 caracteres.

Você pode indicar se os valores sequenciais são números (0-9) ou letras (A-Z):

0-9. Se selecionado, os curingas especificados se resolvem em números sequenciais.

Nota:

Se houver apenas um curinga (#), os nomes das contas começam com 1. Se houver dois, os nomes das contas começam com 01. Se houver três, os nomes das contas começam com 001, e assim por diante.
A-Z. Se selecionado, os curingas especificados resultam em letras sequenciais.

Por exemplo, um esquema de nomenclatura de PC-Sales-## (com 0-9 selecionado) resulta em contas 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 começam.

Se você selecionar 0-9, as contas são nomeadas sequencialmente, começando com os números especificados. Insira um ou mais dígitos, dependendo de quantos curingas você usa no campo anterior. Por exemplo, se você usar dois curingas, insira dois dígitos ou mais.
Se você selecionar A-Z, as contas são nomeadas sequencialmente, começando com as letras especificadas. Insira uma ou mais letras, dependendo de quantos curingas você usa no campo anterior. Por exemplo, se você usar dois curingas, insira duas letras ou mais.

Credenciais de domínio

Insira as credenciais de um administrador que tem permissão para realizar operações de conta. As etapas detalhadas são as seguintes:

Clique em Inserir credenciais. A página Segurança do Windows é exibida.
No campo Nome de usuário, insira o SamName, nome de usuário ou SID de usuário do administrador:
- Se você inserir um SamName, o campo Domínio é preenchido automaticamente.
- Se você inserir um nome de usuário ou SID, você pode limitar a pesquisa de usuário a um domínio específico inserindo o nome de domínio ou SID no campo Domínio.
Clique em Verificar nome para verificar se o nome de usuário é válido ou exclusivo.
No campo Senha, insira a senha de domínio do administrador.
Clique em Concluído.

Nota:

Se o tipo de identidade selecionado em Identidades da Máquina for Hybrid Azure Active Directory joined, as credenciais inseridas devem ter recebido a permissão Write userCertificate.

Resumo, nome e descrição

Na página Resumo, revise as configurações especificadas. Insira um nome e uma descrição para o catálogo. Essas informações aparecem no Web Studio.

Quando terminar, clique em Concluir para iniciar a criação do catálogo. Quando terminar, selecione Concluir para iniciar a criação do catálogo.

Em Catálogos de Máquinas, o novo catálogo aparece com uma barra de progresso embutida.

Para visualizar os detalhes do progresso da criação:

Passe o mouse sobre o catálogo de máquinas.
Na dica de ferramenta que aparece, clique em Exibir detalhes.

Um gráfico de progresso passo a passo aparece onde você pode ver o seguinte:
- Histórico de etapas
- Progresso e tempo de execução da etapa atual
- Etapas restantes

Sincronização de tempo do MCS

A sincronização de tempo é determinada pela imagem mestre e pelo tipo de catálogo unido à identidade da máquina. Você obtém o seguinte método de sincronização de tempo de acordo com a imagem mestre e o catálogo:

Imagem mestre	Catálogo	Método de sincronização de tempo resultante
NDJ	AD ou Azure AD Híbrido	Por padrão, NT5DS. Você pode desabilitar o MCS de alterar a configuração de sincronização de tempo usando as configurações de registro na imagem mestre
NDJ	NDJ ou Azure AD	Mesmo que a configuração de sincronização de tempo original
AD ou Azure AD Híbrido	AD ou Azure AD Híbrido	Mesmo que a configuração de sincronização de tempo original
Azure AD	Azure AD	O mesmo que a configuração original de sincronização de tempo

Nota:

A sincronização de tempo original é controlada pela seguinte configuração de registro e não pode ser alterada:

Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W32Time\Config

Valor: MaxAllowedPhaseOffset, MaxNegPhaseCorrection e MaxPosPhaseCorrection

Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W32Time\Parameters

Valor: Type

Para desabilitar o MCS de alterar a configuração de sincronização de tempo, defina o valor da seguinte configuração de registro na imagem mestre:

Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix
Nome: TimeSyncMethodKeep
Tipo: DWORD
0 (Ou, valor TimeSyncMethodKeep não configurado): Não mantém a configuração original de sincronização de tempo.
1: Mantém a configuração original de sincronização de tempo e os valores dos parâmetros padrão.

Consideração importante sobre a definição de propriedades personalizadas

As propriedades personalizadas devem ser definidas corretamente em New-ProvScheme e Set-ProvScheme nos ambientes GCP e Azure. Se você especificar uma propriedade ou propriedades personalizadas não existentes, receberá a seguinte mensagem de erro e os comandos falharão ao serem executados.

No Azure: Invalid property found: <invalid property>. Ensure that the CustomProperties parameter supports the property.
No GCP: Invalid property found: <invalid property>. Ensure that the value supplied for the property is supported in the Hypervisor.

Solução de problemas

Importante:

Após criar o catálogo de máquinas usando o Web Studio, você não pode mais usar o comando PowerShell Get-ProvTask para recuperar as tarefas associadas à criação do catálogo de máquinas. Essa restrição é resultado do Web Studio excluir essas tarefas após a criação do catálogo de máquinas, independentemente de o catálogo ter sido criado com sucesso.

A Citrix recomenda coletar logs para ajudar a equipe de Suporte a fornecer soluções. Ao usar o Citrix Provisioning, use o seguinte procedimento para gerar arquivos de log:

Na imagem mestre, crie a seguinte chave de registro com o valor 1 (como um valor DWORD (32 bits)): HKLM\Software\Citrix\MachineIdentityServiceAgent\LOGGING.
Desligue a imagem mestre e crie um instantâneo.
No Delivery Controller, execute o seguinte comando PowerShell: Set-ProvServiceConfigurationData -Name ImageManagementPrep_NoAutoShutdown -Value $True.
Crie um catálogo com base nesse instantâneo.
Quando a VM de preparação for criada no hipervisor, faça login e extraia os seguintes arquivos da raiz de C:\: Image-prep.log e PvsVmAgentLog.txt.
Desligue a máquina, momento em que ela relata a falha.
Execute o seguinte comando PowerShell para reativar o desligamento automático das máquinas de preparação de imagem: Remove-ProvServiceConfigurationData -Name ImageManagementPrep_NoAutoShutdown.

Atribuir uma letra de unidade específica a um disco de cache de write-back de E/S do MCS

Você pode atribuir uma letra de unidade específica a um disco de cache de write-back de E/S do MCS. Essa implementação ajuda a evitar conflitos entre a letra da unidade de quaisquer aplicativos que você usa e a letra da unidade do disco de cache de write-back de E/S do MCS. Para fazer isso, você pode usar comandos PowerShell. Os hipervisores suportados são Azure, GCP, VMware, SCVMM e XenServer.

Nota:

Este recurso requer VDA versão 2305 ou posterior.

Limitações

Aplicável apenas ao sistema operacional Windows
Letra de unidade aplicável para disco de cache de write-back: E a Z
Não aplicável quando o disco temporário do Azure é usado como um disco de cache de write-back
Aplicável apenas ao criar um novo catálogo de máquinas

Atribuir uma letra de unidade a um disco de cache de write-back

Para atribuir uma letra de unidade ao disco de cache de write-back:

Abra a janela do PowerShell.
Execute asnp citrix*.
Crie um pool de identidades, se ainda não tiver sido criado. Para obter informações, consulte Criando um Catálogo.

Crie um esquema de provisionamento usando o comando New-ProvScheme com a propriedade WriteBackCacheDriveLetter. Por exemplo:

New-ProvScheme -CleanOnBoot `
-HostingUnitName "<name>" `
-IdentityPoolName $schemeName `
-ProvisioningSchemeName $schemeName `
-InitialBatchSizeHint 1 `
-UseWriteBackCache -WriteBackCacheDiskSize 127 -WriteBackCacheMemorySize 256 -WriteBackCacheDriveLetter E `
-MasterImageVM "XDHyp:\HostingUnits\<name>\image.folder\abcd-resources.resourcegroup\MCSIOMasterVm_OsDisk_1_d3e2d6352xxxxxxxxx2130aa145ec77.manageddisk" `
-NetworkMapping @{"0"="XDHyp:\\HostingUnits\\name\\virtualprivatecloud.folder\\East US.region\\virtualprivatecloud.folder\\abcd-resources.resourcegroup\\abcd-resources-vnet.virtualprivatecloud\\default.network"} `
-ServiceOffering "XDHyp:\\HostingUnits\\<name>\\serviceoffering.folder\\Standard_D2s_v5.serviceoffering" `
-CustomProperties '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
<Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS"/>
<Property xsi:type="StringProperty" Name="PersistWBC" Value="false" />
<Property xsi:type="StringProperty" Name="PersistOsDisk" Value="false" />
<Property xsi:type="StringProperty" Name="PersistVm" Value="false" />
<Property xsi:type="StringProperty" Name="WBCDiskStorageType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="UseTempDiskForWBC" Value="false" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="abcd-group1" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
<Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
</CustomProperties>'
<!--NeedCopy-->

Conclua a criação do catálogo.

Valide a configuração antes de criar um catálogo de máquinas MCS

Você pode validar as configurações antes de criar um catálogo de máquinas MCS usando o parâmetro -validate no comando New-ProvScheme. Depois de executar este comando PowerShell com o parâmetro, você receberá uma mensagem de erro apropriada se um parâmetro incorreto for usado ou se um parâmetro entrar em conflito com outro. Você pode então usar a mensagem de erro para resolver o problema e criar com sucesso um catálogo de máquinas MCS usando o PowerShell. Atualmente, este recurso é aplicável a ambientes de virtualização AWS, Azure, GCP e VMware.

Nota:

Durante a validação, você não deve criar um catálogo de máquinas MCS real. Você deve usar o resultado do comando para corrigir os erros e, em seguida, criar um catálogo bem-sucedido. Portanto, ao executar o comando New-ProvScheme, use um nome de pool de identidade falso.

Para validar a configuração, siga as etapas abaixo:

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

Execute o comando New-ProvScheme e use o parâmetro -validate. Forneça um nome de pool de identidade falso para que o comando funcione. Por exemplo,

$result =New-ProvScheme  -CleanOnBoot -HostingUnitName "vSanRg" -IdentityPoolName "mptmpcatalogdemo" -InitialBatchSizeHint 1  -MasterImageVM "XDHyp:\HostingUnits\vSanRg\Windows19MasterImage.vm\Citrix_XD_NonMachineProfileWin19Machines.snapshot" -NetworkMapping @{"0"="XDHyp:\HostingUnits\vSanRg\\VM Network.network"} -ProvisioningSchemeName "MachineProfileW10Machines"  -Scope @()
-VMCpuCount 2  -VM
MemoryMB 6143 -MachineProfile "XDHyp:\HostingUnits\vSanRg\TRW-Win11-tpm-BL-TEMPLATE.template" -TenancyType Shared  -FunctionalLevel "L7_20" -Validate
$result.TerminatingError | Format-List -Property *
<!--NeedCopy-->

Mensagem de erro:

ErrorData    : {[[ValidationFailureCount, xxx], [InvalidMemoryValue, The memory size provided 6143 must be a multiple of 4 MB and must be greater than or equal to 4 MB.], [InconsistentGuestOsSetting, The GuestOs setting - windows9_64Guest of the selected machine profile does not match with the setting - windows2019srv_64Guest of master image. Please select a machine profile that matches the GuestOs setting of the master image.], [InconsistentVtpmSetting, The vTPM setting of the selected machine profile does not match with the selected master image. Please select a machine profile that matches the vTPM setting of the master image.], [InconsistentFirmwareSetting, The firmware setting - efi of the selected machine profile does not match with the setting - bios of master image. Please select a machine profile that matches the firmware setting of the master image ErrorId      : ValidationFailure
ErrorMessage : ValidationFailure
Operation    : ValidatingInputs
<!--NeedCopy-->

Após validar a configuração, você pode criar um catálogo de máquinas MCS com um nome de pool de identidade real e parâmetros corretos.

Onde ir em seguida

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

Se este for o primeiro catálogo criado, o Web Studio o guiará para criar um grupo de entrega.

Para revisar todo o processo de configuração, consulte Instalar e configurar.

Você pode criar um catálogo do Citrix Provisioning usando o Web Studio e o PowerShell. Esta implementação oferece as seguintes vantagens:

Um único console unificado para gerenciar catálogos MCS e Citrix Provisioning.
Ter novos recursos para catálogos do Citrix Provisioning, como solução de gerenciamento de identidade, provisionamento sob demanda e assim por diante.

Atualmente, esse recurso está disponível apenas para cargas de trabalho do Azure e VMware. No entanto, em ambientes VMware, você pode criar os catálogos usando apenas comandos do PowerShell. Para obter mais informações, consulte Criar catálogos do Citrix Provisioning no Citrix Studio.

Mais informações

A versão oficial desta documentação do produto está em inglês. Qualquer versão em outro idioma é fornecida apenas para sua conveniência e pode incluir conteúdo traduzido automaticamente. Para obter mais informações, consulte o Aviso Legal sobre Tradução Automática em Cloud Software Group home.

Isso foi útil?

Criar catálogos de máquinas

May 31, 2026

Contribuição de:

May 31, 2026

Contribuição de:

Neste artigo

Isso foi útil?