Documentação de produtos
Citrix Virtual Apps and Desktops
Serviço 2607 LTSR Versão Atual 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
Ver PDF

Criar um catálogo de máquinas de imagem preparada no Azure Local

September 15, 2026
Contribuição de: 
C

Crie imagens preparadas e use as imagens preparadas para criar um catálogo de máquinas MCS usando:

As principais etapas para criar um catálogo de máquinas MCS usando a imagem preparada são:

  1. Crie a definição da imagem e as versões iniciais da imagem.
  2. Use a versão da imagem como uma imagem preparada para criar um catálogo.

Usar o Web Studio

Criar uma definição de imagem e a versão inicial da imagem

Para criar uma definição de imagem e a versão inicial da imagem, faça o seguinte:

  1. No Web Studio, vá para o nó Imagens e clique em Criar Definição de Imagem. Clique em Avançar na página Introdução.
  2. Na página Definição de Imagem, especifique o Tipo de SO e o Tipo de Sessão para a definição de imagem.
  3. Selecione um grupo de recursos existente ou crie um novo para armazenar os recursos da imagem.

  4. Na página Imagem, selecione Recursos (somente os recursos aplicáveis para a conexão definida são listados) e uma imagem para usar como modelo para criar a versão da imagem.

    Nota:

    • Antes de selecionar uma imagem, verifique se a imagem mestre tem o VDA 2311 ou posterior instalado e se o driver MCSIO está instalado no VDA.
    • Para a seleção da imagem, você pode selecionar uma Imagem da Galeria Local do Azure ou uma Máquina Virtual.
  5. Na página Especificação da Máquina, selecione CPU e memória para a VM de preparação.
  6. Na página NICs, selecione as NICs para a imagem de preparação. Para cada NIC, selecione uma rede virtual associada.
  7. Na página Descrição da Versão, insira uma descrição para a versão inicial da imagem criada.
  8. Na página Resumo, verifique os detalhes da definição da imagem e da versão inicial da imagem criada. Insira um nome e uma descrição para a definição da imagem. Clique em Concluir.

Criar versões de imagem

As versões de imagem permitem o gerenciamento de diferentes iterações ou atualizações de uma imagem específica. Essa funcionalidade permite manter várias versões de uma imagem para diferentes finalidades.

Para criar versões de imagem a partir da versão inicial da imagem, faça o seguinte:

Nota:

A unidade de hospedagem de todas as versões de imagem deve ser a mesma.

  1. Vá para o nó Imagens, selecione uma versão de imagem ou uma definição de imagem e clique em Criar Versão da Imagem.
  2. Na página Definição da Imagem, você pode alterar a unidade de hospedagem e selecionar novamente a imagem mestre e o perfil da máquina para essa versão da imagem.
  3. Se você quiser que a configuração da versão da imagem seja diferente da versão inicial da imagem configurada, configure as definições nas páginas Especificação da Máquina e NICs da caixa de diálogo Criar Versão da Imagem.
  4. Adicione uma descrição para a versão da imagem. Clique em Concluir.

Nota:

Se a criação da versão da imagem falhar por qualquer motivo, a guia Solução de problemas na parte inferior oferece uma opção de Tentar novamente.

Criar um catálogo de máquinas a partir do nó Imagens

Use a opção Criar catálogo no nó Imagens para criar um catálogo usando a versão da imagem.

Alternativamente, você pode selecionar a versão ao criar um catálogo no nó Catálogos de Máquinas, vinculando à opção de imagem preparada no fluxo de trabalho de criação de catálogo. Consulte Criar um catálogo de máquinas a partir do nó Catálogos de Máquinas.

Para criar um catálogo de máquinas MCS a partir do nó Imagens, faça o seguinte:

  1. Selecione uma versão da imagem e clique em Criar catálogo. Clique em Avançar na página Introdução.
  2. Na página Experiência da Área de Trabalho, selecione a experiência da área de trabalho necessária.
  3. Da página Imagem à página NICs, as configurações são pré-selecionadas com base na versão da imagem selecionada.
  4. Na página Grupo de Recursos, você pode optar por criar um novo grupo de recursos ou usar um grupo de recursos existente para colocar os recursos deste catálogo.
  5. Conclua as configurações nas páginas seguintes.
  6. Na página Resumo, verifique os detalhes do catálogo de máquinas. Insira um nome e uma descrição para o catálogo de máquinas. Clique em Concluir.
  7. Vá para o nó Catálogos de Máquinas para ver o catálogo de máquinas criado.

Criar um catálogo de máquinas a partir do nó Catálogos de Máquinas

Para criar um catálogo de máquinas MCS a partir do nó Catálogos de Máquinas, faça o seguinte:

  1. Clique em Catálogos de Máquinas no painel de navegação esquerdo.
  2. Clique em Criar Catálogo de Máquinas. A página Configuração do Catálogo de Máquinas é exibida. Clique em Avançar nas páginas Introdução e Tipo de Máquina.

  3. Na página Gerenciamento de Máquinas:

    1. Selecione Máquinas com gerenciamento de energia (por exemplo, máquinas virtuais ou PCs blade).
    2. Selecione Tecnologia de provisionamento Citrix. Em seguida, selecione Citrix Machine Creation Services™.
    3. No campo Recursos, os recursos pertencentes a diferentes zonas são listados. Selecione qualquer recurso de rede do Azure e clique em Avançar.

  4. Na página Imagem:

    • Para o tipo de imagem Mestra, siga estas etapas:

      1. Selecione Imagem Mestra.
      2. Em Imagem Mestra, selecione uma imagem. O painel lista todas as imagens que pertencem à mesma região que as dos Recursos.
      3. Clique em Concluído.

    • Para o tipo de imagem Preparada, siga estas etapas:

      1. Selecione Imagem preparada.
      2. Em Imagem preparada, selecione uma versão de imagem de uma definição de imagem. Se necessário, adicione uma nota para a versão da imagem preparada selecionada.
      3. Clique no nome da versão da imagem. Para ver mais detalhes sobre a versão da imagem selecionada, clique no número da versão, que está sublinhado.
  5. Configure as configurações nas páginas a seguir.
  6. Na página Grupo de Recursos, você pode optar por criar um novo grupo de recursos ou usar um grupo de recursos existente para alocar os recursos deste catálogo.
  7. Conclua as configurações nas páginas a seguir.
  8. Na página Resumo, verifique os detalhes do catálogo de máquinas. Insira um nome e uma descrição para o catálogo de máquinas. Clique em Concluir.

Usar PowerShell

Criar uma imagem preparada

Os comandos detalhados do PowerShell para criar uma especificação de versão de imagem preparada para o Azure Local são os seguintes:

  1. Verifique os nomes de definição de imagem disponíveis usando o Test-ProvImageDefinitionNameAvailable command. Por exemplo,

    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
<!--NeedCopy-->

  2. Crie uma definição de imagem usando o comando New-ProvImageDefinition. Por exemplo,

    New-ProvImageDefinition -ImageDefinitionName arc-ACG-image-climber-demo -OsType Windows -VDASessionSupport SingleSession -Description "arc ACG image for arc"
<!--NeedCopy-->

  3. Crie uma nova configuração para a definição de imagem na conexão de hospedagem especificada usando o comando Add-ProvImageDefinitionConnection.

    O CustomProperties para Add-ProvImageDefinitionConnection pode incluir o seguinte. Se você não usar os parâmetros, os valores padrão serão usados.

    ResourceGroups: O grupo de recursos que contém os discos base.

    Por exemplo, no caso de um grupo de recursos fornecido pelo cliente:

    $CustomerOwnRsourceGroupProperties = @"
<CustomProperties xmlns="http:// schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="sz_res_group" />
</CustomProperties>
"@
<!--NeedCopy-->

    Add-ProvImageDefinitionConnection -HypervisorConnectionName Azurelocal -ImageDefinitionName arc-ACG-image-climber-demo [-CustomProperties $CustomProperties]
<!--NeedCopy-->

  4. Crie uma versão de imagem usando o comando New-ProvImageVersion. Por exemplo,

    New-ProvImageVersion -ImageDefinitionName arc-ACG-image-climber-demo
<!--NeedCopy-->

  5. Adicione uma especificação de versão de imagem mestre à versão de imagem usando o comando Add-ProvImageVersionSpec. Por exemplo,

    Add-ProvImageVersionSpec -ImageVersionNumber 1 -HostingUnitName network-2 -MasterImagePath XDHyp:\HostingUnits\network-2\image.folder\MST-W11WS-2507-11-10-no-sysprep.galleryimage
<!--NeedCopy-->

    Nota:

    Você pode adicionar apenas uma especificação de versão de imagem mestre a uma versão de imagem para uma unidade de hospedagem.

  6. Crie uma especificação de versão de imagem preparada a partir da especificação de versão de imagem mestre usando o comando New-ProvImageVersionSpec. Por exemplo,

    New-ProvImageVersionSpec -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"ResourceGroups`" Value=`"citrix-xd-39d65e7a-f6c0-4772-9e8d-d6eacb36287f-hilxi`" /><Property xsi:type=`"StringProperty`" Name=`"OsType`" Value=`"Windows`" /></CustomProperties>" -NetworkMapping @{"0"="XDHyp:\HostingUnits\network-2\network.folder\VM-Network-2.network"} -SourceImageVersionSpecUid "86c1a467-f900-4434-990a-c4ae39faca10"
<!--NeedCopy-->

Exemplo do conjunto completo de comandos PowerShell para criar definição de imagem, versão de imagem e especificação de versão de imagem preparada:

## create image definition
New-ProvImageDefinition -ImageDefinitionName arc-ACG-image-climber-demo -OsType Windows -VDASessionSupport SingleSession -Description "arc ACG image for arc"
## create image definition connection
Add-ProvImageDefinitionConnection -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -HypervisorConnectionUid "8eac2ad2-fc81-45d6-9153-9545a779f8d2" -ImageDefinitionUid "39d65e7a-f6c0-4772-9e8d-d6eacb36287f"
## create new image verison
New-ProvImageVersion -ImageDefinitionName arc-ACG-image-climber-demo
## select azure arc ACG image
Import-Module Citrix.Host.Commands
Get-ChildItem -LiteralPath @("XDHyp:\HostingUnits\network-2\image.folder") | select-object fullpath
## add verison spec through Azure Arc ACG
Add-ProvImageVersionSpec -ImageVersionUid "29da7e07-b7e9-4c8c-a5f2-4c03dbcba451" -HostingUnitUid "51305f67-34b3-4b22-a5d2-b6d7deaff9ba" -MasterImagePath XDHyp:\HostingUnits\network-2\image.folder\MST-W11WS-2507-11-10-no-sysprep.galleryimage
## create new version spec
New-ProvImageVersionSpec -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"ResourceGroups`" Value=`"citrix-xd-39d65e7a-f6c0-4772-9e8d-d6eacb36287f-hilxi`" /><Property xsi:type=`"StringProperty`" Name=`"OsType`" Value=`"Windows`" /></CustomProperties>" -NetworkMapping @{"0"="XDHyp:\HostingUnits\network-2\network.folder\VM-Network-2.network"} -SourceImageVersionSpecUid "86c1a467-f900-4434-990a-c4ae39faca10"
<!--NeedCopy-->

Nota:

  • Todas as especificações de versão de imagem em uma definição de imagem devem pertencer à mesma unidade de hospedagem.
  • Uma versão de imagem pode ter apenas uma especificação de versão de imagem mestre e uma especificação de versão de imagem preparada.

Criar um catálogo usando uma especificação de versão de imagem preparada

Crie um catálogo de máquinas MCS a partir da especificação de versão de imagem preparada usando o comando New-ProvScheme. Por exemplo,

New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>][-ImageAssignmentNote <string>]
<!--NeedCopy-->

Ou,

New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitName <string> -IdentityPoolName <string> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>][-ImageAssignmentNote <string>]
<!--NeedCopy-->

Exemplo do conjunto completo de comandos PowerShell para criar um catálogo:

New-AcctIdentityPool -IdentityPoolName arc-climbers-local -NamingScheme "arc-c-vm-###" -NamingSchemeType Numeric -Domain "CLIMBERS.LOCAL"
New-ProvScheme -ProvisioningSchemeName arc-ACG-img-climber-3 -HostingUnitName network-2 -IdentityPoolName arc-climbers-local -ImageVersionSpecUid 0525360d-6cb5-4f08-bb2c-aaf5678a0d54
New-BrokerCatalog -ProvisioningSchemeId 93fbcebd-3a7a-499e-9d8d-c09e02021c5a -AllocationType Static -Name arc-ACG-img-climber-3 -PersistUserChanges OnLocal -ProvisioningType MCS -SessionSupport SingleSession
<!--NeedCopy-->

Mais informações

Onde ir em seguida

Criar um catálogo de máquinas de imagem preparada no Azure Local
September 15, 2026
Contribuição de: 
C
September 15, 2026
Contribuição de: 
C

Neste artigo

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