Citrix Virtual Apps and Desktops

Criar um catálogo Azure Local

May 31, 2026

Contribuição de:

Criar catálogos de máquinas descreve os assistentes que criam um catálogo de máquinas. As informações a seguir cobrem detalhes específicos para ambientes Azure Local.

Nota:

Antes de criar um catálogo de máquinas Azure Local, você precisa concluir a criação de uma conexão com o Azure Local. Consulte Conexão com o Azure Local.

Requisitos

Versão do VDA: 2507 e posterior
Carga de trabalho multi-sessão do Windows 10/11 não é suportada

Criar uma imagem mestre

Uma imagem mestre é necessária para criar um catálogo de máquinas.

O MCS usa a imagem da VM do Azure Local como a imagem mestre. Antes de usar o MCS para provisionar a carga de trabalho no cluster do Azure Local, você precisa preparar uma imagem da VM do Azure Local com o VDA instalado.

Crie uma VM do Azure Local usando o portal do Azure.
Conecte-se à VM do Azure Local criada para instalar o VDA e o software necessário.

Crie uma tarefa agendada usando o Agendador de Tarefas do Windows para executar o seguinte script na inicialização da VM sob o contexto do Sistema. Esta tarefa de agendar uma tarefa na imagem mestre é necessária apenas para a versão 2511 ou anterior do VDA.

$tagFileName = 'E6DA6616-8EC4-48E0-BE93-58CE6ACE3CFB.tag'

$foundDrive = $null

foreach ($drive in Get-PSDrive -PSProvider FileSystem) {

$tagPath = Join-Path $drive.Root $tagFileName

if (Test-Path $tagPath) {

    $foundDrive = $drive.Root

    break

}

}

if ([string]::IsNullOrEmpty($foundDrive)) { exit 0 }

$installScript = Join-Path $foundDrive 'install.ps1'

if (Test-Path $installScript) {

powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installScript

} else { exit 1 }

sc.exe stop mocguestagent 2>$null

sc.exe delete mocguestagent 2>$null

Remove-Item 'HKLM:\SYSTEM\CurrentControlSet\Services\EventLog\Application\mocguestagent' -Recurse -Force -ErrorAction SilentlyContinue

$setupComplete = 'C:\Windows\Setup\Scripts\SetupComplete.cmd'

if (Test-Path $setupComplete) { & $setupComplete }
<!--NeedCopy-->

Pare a VM do Azure Local.
Consulte Criar imagem de VM a partir de uma VM Azure Local existente para criar uma imagem de VM Azure Local a partir da VM Azure Local preparada.

Nota:

Ao preparar uma imagem mestre usando uma VM Local do Azure com o agente do Azure Connected Machine versão 1.61 ou posterior instalado e integrado, a criação do catálogo no MCS falha no processo de preparação da imagem devido à negação de acesso ao excluir o arquivo de configuração do agente. Como solução alternativa, faça o seguinte ao criar uma imagem mestre: Navegue até C:\ProgramData\AzureConnectedMachineAgent\Config\agentconfig.json, clique com o botão direito do mouse no arquivo, selecione Propriedades e desmarque a caixa de seleção do atributo Somente leitura.

Criar um catálogo

Você pode criar catálogos Locais do Azure para criar, entregar e gerenciar o consumo de energia de máquinas em seu ambiente Local do Azure.

Nota:

O comprimento do nome do catálogo não deve exceder 49 caracteres.

Evite usar palavras reservadas do Microsoft Azure no nome do catálogo ou no esquema de nomenclatura da máquina. Consulte o documento da Microsoft para obter detalhes.

Você pode criar o catálogo usando:

Web Studio
PowerShell

Criar um catálogo usando o Web Studio

Você pode criar um catálogo de máquinas MCS no ambiente Local do Azure.

No assistente de Configuração do Catálogo de Máquinas:

Na página Sistema operacional, selecione SO multi-sessão ou SO de sessão única.
Na página Gerenciamento de Máquinas:
1. Selecione Máquinas que são gerenciadas por energia (por exemplo, máquinas virtuais ou PCs blade).
2. Selecione para implantar máquinas usando a tecnologia de provisionamento Citrix.
3. Selecione a unidade de hospedagem Azure Local em Citrix Machine Creation Services (MCS).
Na página Experiência da Área de Trabalho, selecione a opção de acordo com o tipo de máquina que você selecionou na página Tipo de Máquina.
Na página Imagem:
1. Selecione uma imagem mestre. Atualmente, o Azure Local não oferece suporte a imagens preparadas.
2. Você pode adicionar uma nota à imagem selecionada.
Nota:
- O tipo de SO é preenchido automaticamente após a seleção da imagem mestre.
- O perfil da máquina não é suportado.
Na página NICs, selecione uma ou mais NICs, associe uma rede virtual a cada placa.
Na página Máquinas Virtuais:
1. Especifique quantas máquinas virtuais criar. Digite 0 se não quiser criar nenhuma. Mais tarde, você pode criar VMs para um catálogo vazio adicionando máquinas.
2. Escolha a quantidade de memória (em MB) e a contagem de CPU virtual que cada VM possui.
3. Configure o Cache de Write-Back para máquinas para melhorar o desempenho de E/S.
Siga as instruções na tela para concluir as etapas restantes, que não incluem informações específicas do Azure Local.

Você também pode usar o Web Studio para criar catálogos do Azure Local para entregar e gerenciar o poder das máquinas existentes em seu cluster do Azure Local.

No assistente de Configuração do Catálogo de Máquinas:

Na página Sistema Operacional, selecione SO de várias sessões ou SO de sessão única.
Na página Gerenciamento de Máquinas, selecione Máquinas com gerenciamento de energia e, em seguida, selecione Outro serviço ou tecnologia como a forma de implantar máquinas.
Na página Máquinas Virtuais, adicione máquinas e suas contas de máquina do Active Directory. Você pode:
- Adicionar máquinas manualmente: Clique em Adicionar Máquinas para adicionar máquinas manualmente. A janela Selecionar VMs é exibida. Expanda a conexão do Azure Local que você criou anteriormente e selecione as VMs que deseja adicionar. Em seguida, adicione os nomes das contas de máquina associadas.
- Adicionar máquinas usando um arquivo CSV: Clique em Importar de arquivo CSV para adicionar máquinas em massa. Para obter informações sobre como usar arquivos CSV para adicionar máquinas, consulte Usar arquivos CSV para adicionar máquinas em massa a um catálogo.
Siga as instruções na tela para concluir as etapas restantes, que não incluem informações específicas do Azure Local.

Criar um catálogo usando o PowerShell

Você pode criar um catálogo de máquinas MCS no ambiente Azure Local usando comandos do PowerShell.

Cabeçalho do script

Certifique-se de fornecer os valores de parâmetro corretos definidos no cabeçalho do script.

$catalogName = "" # Name of the catalog you want to create

$masterImageResourceGroupName = "" # Name of resource group that the master Azure Local VM image resides in

$catalogResourceGroup = "" # Name of resource group that the created VMs reside in

$masterImage = "" # Name of the master Azure Local VM image you want to use

$vNet = "" # Name of the logical network that the created VMs should be attached to

$masterImagePath = "XDHyp:\HostingUnits\$hostingUnitName\image.folder\$masterImageResourceGroupName.resourcegroup\$masterImage"

$networkMapping = @{"0"="XDHyp:\HostingUnits\$hostingUnitName\\network.folder\$vNet.network"}

$customPropertiesXml = "<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=`"$catalogResourceGroup`" /><Property xsi:type=`"StringProperty`" Name=`"OsType`" Value=`"Windows`" /></CustomProperties>"
<!--NeedCopy-->

Criar um catálogo MCS com 1 VM

Adicionar snap-ins Citrix

Criar Catálogo de Máquinas

New-BrokerCatalog -AllocationType "Random" -IsRemotePC $false -MinimumFunctionalLevel "L7_34" -Name $catalogName -PersistUserChanges "Discard" -ProvisioningType "MCS" -SessionSupport "SingleSession"
<!--NeedCopy-->

Criar Pool de Identidade

New-AcctIdentityPool -AllowUnicode $true -Domain "test.local" -IdentityPoolName $catalogName -IdentityType "ActiveDirectory" -NamingScheme "demoVM#" -NamingSchemeType "Numeric" -OU "CN=Computers,DC=test,DC=local"
<!--NeedCopy-->

Criar Esquema de Provisionamento

New-ProvScheme -CleanOnBoot $true -CustomProperties $customPropertiesXml -HostingUnitName $hostingUnitName -IdentityPoolName $catalogName -MasterImageVM $masterImagePath -NetworkMapping $networkMapping -ProvisioningSchemeName $catalogName -ProvisioningSchemeType "MCS" -VMCpuCount 4 -VMMemoryMB 8192
<!--NeedCopy-->

Vincular Catálogo ao Esquema de Provisionamento

$schemeUid =(Get-ProvScheme -ProvisioningSchemeName $catalogName).ProvisioningSchemeUid.Guid

Set-BrokerCatalog -Name $catalogName -ProvisioningSchemeId $schemeUid
<!--NeedCopy-->

Criar conta AD

New-AcctADAccount -Count 1 -IdentityPoolName $catalogName
<!--NeedCopy-->

Provisionar VM

New-ProvVM -ADAccountName "domain\demoVM1" -ProvisioningSchemeName $catalogName
<!--NeedCopy-->

Adicionar máquina ao catálogo do broker

New-BrokerMachine -CatalogName $catalogName -MachineName 'domain\demoVM1'
<!--NeedCopy-->

Onde ir em seguida

Se este for o primeiro catálogo criado, o Web Studio o guiará para criar um grupo de entrega
Para gerenciar o consumo de energia de VMs Locais do Azure, consulte Gerenciar o consumo de energia de VMs Locais do Azure.

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 um catálogo Azure Local

May 31, 2026

Contribuição de:

May 31, 2026

Contribuição de:

Isso foi útil?