Documentazione dei prodotti
Citrix Virtual Apps and Desktops
Current Release Service 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR

Creare un catalogo Azure Local

May 31, 2026
Grazie al contributo di: 
C

(/it-it/citrix-virtual-apps-desktops/2511/install-configure/machine-catalogs-create.html) descrive le procedure guidate che creano un catalogo di macchine. Le seguenti informazioni coprono i dettagli specifici per gli ambienti Azure Local.

Nota:

Prima di creare un catalogo di macchine Azure Local, è necessario completare la creazione di una connessione ad Azure Local. Vedere (/it-it/citrix-virtual-apps-desktops/2511/install-configure/connections/connection-azure-local.html).

Requisiti

  • Versione VDA: 2507 e successive
  • Il carico di lavoro multi-sessione di Windows 10/11 non è supportato

Creare un’immagine master

È necessaria un’immagine master per creare un catalogo di macchine.

MCS utilizza l’immagine VM di Azure Local come immagine master. Prima di utilizzare MCS per il provisioning del carico di lavoro nel cluster Azure Local, è necessario preparare un’immagine VM di Azure Local con VDA installato.

  1. Creare una VM Azure Local utilizzando il portale di Azure.
  2. Connettersi alla VM Azure Local creata per installare VDA e il software richiesto.

  3. Creare un’attività pianificata utilizzando Utilità di pianificazione di Windows per eseguire lo script seguente all’avvio della VM nel contesto di sistema. Questa attività di pianificazione di un’attività nell’immagine master è richiesta solo per la versione VDA 2511 o precedente.

    $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-->
  4. Arrestare la VM Azure Local.
  5. Fare riferimento a Creare un’immagine VM da una VM Azure Local esistente per creare un’immagine VM di Azure Local dalla VM Azure Local preparata.

Nota:

Quando si prepara un’immagine master utilizzando una VM locale di Azure con l’agente Azure Connected Machine versione 1.61 o successiva installato e configurato, la creazione del catalogo in MCS fallisce nel processo di preparazione dell’immagine a causa del rifiuto dell’accesso durante l’eliminazione del file di configurazione dell’agente. Come soluzione alternativa, eseguire le seguenti operazioni durante la creazione di un’immagine master: Passare a C:\ProgramData\AzureConnectedMachineAgent\Config\agentconfig.json, fare clic con il pulsante destro del mouse sul file, selezionare Proprietà e deselezionare la casella di controllo dell’attributo Sola lettura.

È possibile creare cataloghi locali di Azure per creare, distribuire e gestire l’alimentazione delle macchine nell’ambiente locale di Azure.

Nota:

  • La lunghezza del nome del catalogo non deve superare i 49 caratteri.
  • Evitare di utilizzare parole riservate di Microsoft Azure nel nome del catalogo o nello schema di denominazione delle macchine. Per i dettagli, consultare il documento Microsoft.

È possibile creare il catalogo utilizzando:

Creare un catalogo utilizzando Web Studio

È possibile creare un catalogo di macchine MCS nell’ambiente locale di Azure.

Nella procedura guidata di configurazione del catalogo macchine:

  1. Nella pagina Sistema operativo, selezionare SO multisessione o SO a sessione singola.
  2. Nella pagina Gestione macchine:
    1. Selezionare Macchine con gestione dell’alimentazione (ad esempio, macchine virtuali o PC blade).
    2. Selezionare per distribuire le macchine utilizzando la tecnologia di provisioning Citrix.
    3. Selezionare l’unità di hosting locale di Azure in Citrix Machine Creation Services (MCS).
  3. Nella pagina Esperienza desktop, selezionare l’opzione in base al tipo di macchina selezionato nella pagina Tipo di macchina.
  4. Nella pagina Immagine:
    1. Selezionare un’immagine master. Attualmente, Azure Local non supporta l’immagine preparata.
    2. È possibile aggiungere una nota all’immagine selezionata.

    Nota:

    • Il tipo di sistema operativo viene popolato automaticamente dopo aver selezionato l’immagine master.
    • Il profilo macchina non è supportato.
  5. Nella pagina NIC, selezionare una o più NIC, associare una rete virtuale a ciascuna scheda.

  6. Nella pagina Macchine virtuali:

    1. Specificare quante macchine virtuali creare. Immettere 0 se non si desidera crearne alcuna. Successivamente, è possibile creare VM per un catalogo vuoto aggiungendo macchine.
    2. Scegliere la quantità di memoria (in MB) e il numero di CPU virtuali di ogni VM.
    3. Configurare la cache di write-back per le macchine per migliorare le prestazioni I/O.
  7. Seguire le istruzioni visualizzate per completare i passaggi rimanenti, che non includono informazioni specifiche di Azure Local.

È inoltre possibile utilizzare Web Studio per creare cataloghi Azure Local per fornire e gestire la potenza delle macchine esistenti nel cluster Azure Local.

Nella procedura guidata di configurazione del catalogo macchine:

  1. Nella pagina Sistema operativo, selezionare Sistema operativo multisessione o Sistema operativo a sessione singola.
  2. Nella pagina Gestione macchine, selezionare Macchine con gestione dell’alimentazione, quindi selezionare Altro servizio o tecnologia come metodo di distribuzione delle macchine.

  3. Nella pagina Macchine virtuali, aggiungere le macchine e i relativi account macchina di Active Directory. È possibile:

    • Aggiungere macchine manualmente: fare clic su Aggiungi macchine per aggiungere macchine manualmente. Viene visualizzata la finestra Seleziona VM. Espandere la connessione Azure Local creata in precedenza e selezionare le VM che si desidera aggiungere. Quindi aggiungere i nomi degli account macchina associati.
    • Aggiungere macchine utilizzando un file CSV: fare clic su Importa da file CSV per aggiungere macchine in blocco. Per informazioni sull’utilizzo dei file CSV per aggiungere macchine, vedere Utilizzare i file CSV per aggiungere macchine in blocco a un catalogo.
  4. Seguire le istruzioni visualizzate per completare i passaggi rimanenti, che non includono informazioni specifiche di Azure Local.

Creare un catalogo utilizzando PowerShell

È possibile creare un catalogo macchine MCS nell’ambiente Azure Local utilizzando i comandi PowerShell.

Intestazione dello script

Assicurarsi di fornire i valori dei parametri corretti definiti nell’intestazione dello 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-->

Creare un catalogo MCS con 1 VM

Aggiungi gli snap-in Citrix

Crea catalogo macchine 
New-BrokerCatalog -AllocationType "Random" -IsRemotePC $false -MinimumFunctionalLevel "L7_34" -Name $catalogName -PersistUserChanges "Discard" -ProvisioningType "MCS" -SessionSupport "SingleSession"
<!--NeedCopy-->
Crea pool di identità 
New-AcctIdentityPool -AllowUnicode $true -Domain "test.local" -IdentityPoolName $catalogName -IdentityType "ActiveDirectory" -NamingScheme "demoVM#" -NamingSchemeType "Numeric" -OU "CN=Computers,DC=test,DC=local"
<!--NeedCopy-->
Crea schema di provisioning 
New-ProvScheme -CleanOnBoot $true -CustomProperties $customPropertiesXml -HostingUnitName $hostingUnitName -IdentityPoolName $catalogName -MasterImageVM $masterImagePath -NetworkMapping $networkMapping -ProvisioningSchemeName $catalogName -ProvisioningSchemeType "MCS" -VMCpuCount 4 -VMMemoryMB 8192
<!--NeedCopy-->
Collega catalogo allo schema di provisioning 
$schemeUid =(Get-ProvScheme -ProvisioningSchemeName $catalogName).ProvisioningSchemeUid.Guid

Set-BrokerCatalog -Name $catalogName -ProvisioningSchemeId $schemeUid
<!--NeedCopy-->
Crea account AD 
New-AcctADAccount -Count 1 -IdentityPoolName $catalogName
<!--NeedCopy-->
Esegui provisioning VM 
New-ProvVM -ADAccountName "domain\demoVM1" -ProvisioningSchemeName $catalogName
<!--NeedCopy-->
Aggiungi macchina al catalogo del broker 
New-BrokerMachine -CatalogName $catalogName -MachineName 'domain\demoVM1'
<!--NeedCopy-->

Dove andare dopo

Ulteriori informazioni

Creare un catalogo Azure Local
May 31, 2026
Grazie al contributo di: 
C
May 31, 2026
Grazie al contributo di: 
C

In questo articolo

Feedback sito | Your privacy choices footer linkScelte di privacy | Privacy e condizioni legali | Preferenze cookie | Impostazioni di consenso | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.