Creare un catalogo di macchine con immagine preparata in Azure Local

Last published : Nov 13, 2026
Crea immagini preparate e usa le immagini preparate per creare un catalogo macchine MCS usando:
I passaggi chiave per creare un catalogo macchine MCS usando l'immagine preparata sono:
  1. Crea la definizione dell'immagine e le versioni iniziali dell'immagine.
  2. Utilizzare la versione dell'immagine come immagine preparata per creare un catalogo.
Related information
Creare cataloghi di macchine con immagini preparate

Utilizzare Web Studio

Crea una definizione dell'immagine e la versione iniziale dell'immagine

Per creare una definizione dell'immagine e la versione iniziale dell'immagine, procedi come segue:
  1. Da Web Studio, andare al nodo Immagini e fare clic su Crea definizione immagine. Fare clic su Avanti nella pagina Introduzione.
  2. Nella pagina Definizione immagine, specifica il Tipo di sistema operativo e il Tipo di sessione per la definizione dell'immagine.
  3. Selezionare un gruppo di risorse esistente o crearne uno nuovo per contenere le risorse dell'immagine.
  4. Nella pagina Immagine, selezionare Risorse (vengono elencate solo le risorse applicabili per la connessione impostata) e un'immagine da utilizzare come modello per la creazione della versione dell'immagine.
    Nota:
    • Prima di selezionare un'immagine, verifica che l'immagine master abbia VDA 2311 o versione successiva installata e che il driver MCSIO sia installato sul VDA.
    • Per la selezione dell'immagine, è possibile selezionare un'immagine della galleria locale di Azure o una macchina virtuale.
  5. Nella pagina Specifiche macchina, selezionare CPU e memoria per la VM di preparazione.
  6. Nella pagina NIC, selezionare le NIC per l'immagine di preparazione. Per ogni NIC, selezionare una rete virtuale associata.
  7. Nella pagina Descrizione versione, immettere una descrizione per la versione iniziale dell'immagine creata.
  8. Nella pagina Riepilogo, controllare i dettagli della definizione dell'immagine e della versione iniziale dell'immagine creata. Immettere un nome e una descrizione per la definizione dell'immagine. Fare clic su Fine.

Creare versioni dell'immagine

Le versioni dell'immagine consentono la gestione di diverse iterazioni o aggiornamenti di una particolare immagine. Questa funzionalità consente di mantenere più versioni di un'immagine per scopi diversi.
Per creare versioni dell'immagine dalla versione iniziale dell'immagine, procedere come segue:
Nota:
L'unità di hosting di tutte le versioni dell'immagine deve essere la stessa.
  1. Andare al nodo Immagini, selezionare una versione dell'immagine o una definizione dell'immagine e fare clic su Crea versione immagine.
  2. Nella pagina Definizione immagine, è possibile modificare l'unità di hosting e riselezionare l'immagine master e il profilo macchina per quella versione dell'immagine.
  3. Se si desidera che la configurazione della versione dell'immagine sia diversa dalla versione iniziale dell'immagine configurata, configurare le impostazioni nelle pagine Specifiche macchina e NIC della finestra di dialogo Crea versione immagine.
  4. Aggiungere una descrizione per la versione dell'immagine. Fare clic su Fine.
Nota:
Se la creazione della versione dell'immagine fallisce per qualsiasi motivo, la scheda Risoluzione dei problemi in basso fornisce un'opzione Riprova.

Creare un catalogo di macchine dal nodo Immagini

Utilizzare l'opzione Crea catalogo nel nodo Immagini per creare un catalogo utilizzando la versione dell'immagine.
In alternativa, è possibile selezionare la versione durante la creazione di un catalogo nel nodo Cataloghi macchine, collegandosi all'opzione immagine preparata nel flusso di lavoro di creazione del catalogo. Vedere Creare un catalogo macchine dal nodo Cataloghi macchine.
Per creare un catalogo macchine MCS dal nodo Immagini, effettuare le seguenti operazioni:
  1. Selezionare una versione dell'immagine e fare clic su Crea catalogo. Fare clic su Avanti nella pagina Introduzione.
  2. Nella pagina Esperienza desktop, selezionare l'esperienza desktop richiesta.
  3. Dalla pagina Immagine alla pagina NIC, le impostazioni sono preselezionate in base alla versione dell'immagine selezionata.
  4. Nella pagina Gruppo di risorse, è possibile scegliere di creare un nuovo gruppo di risorse o di utilizzare un gruppo di risorse esistente per posizionare le risorse di questo catalogo.
  5. Completare le impostazioni nelle pagine seguenti.
  6. Nella pagina Riepilogo, controllare i dettagli del catalogo macchine. Immettere un nome e una descrizione per il catalogo macchine. Fare clic su Fine.
  7. Andare al nodo Cataloghi macchine per visualizzare il catalogo macchine creato.

Creare un catalogo macchine dal nodo Cataloghi macchine

Per creare un catalogo macchine MCS dal nodo Cataloghi macchine, effettuare le seguenti operazioni:
  1. Fare clic su Cataloghi macchine nel riquadro di navigazione a sinistra.
  2. Fare clic su Crea catalogo macchine. Viene visualizzata la pagina Configurazione catalogo macchine. Fare clic su Avanti nelle pagine Introduzione e Tipo di macchina.
  3. Nella pagina Gestione macchine:
    1. Selezionare Macchine con gestione dell'alimentazione (ad esempio, macchine virtuali o PC blade).
    2. Selezionare Tecnologia di provisioning Citrix. Quindi, selezionare Citrix Machine Creation Services™.
    3. Nel campo Risorse, sono elencate le risorse appartenenti a zone diverse. Selezionare una risorsa di rete di Azure e fare clic su Avanti.
  4. Nella pagina Immagine:
    • Per il tipo di immagine Master, seguire questi passaggi:
      1. Selezionare l'immagine Master.
      2. Sotto l'immagine Master, selezionare un'immagine. Il pannello elenca tutte le immagini che appartengono alla stessa regione delle Risorse.
      3. Fare clic su Fine.
    • Per il tipo di immagine preparata, seguire questi passaggi:
      1. Selezionare Immagine preparata.
      2. Sotto Immagine preparata, selezionare una versione dell'immagine di una definizione di immagine. Se necessario, aggiungere una nota per la versione dell'immagine preparata selezionata.
      3. Fare clic sul nome della versione dell'immagine. Per visualizzare maggiori dettagli sulla versione dell'immagine selezionata, fare clic sul numero di versione, che è sottolineato.
  5. Configurare le impostazioni nelle pagine seguenti.
  6. Nella pagina Gruppo di risorse, è possibile scegliere di creare un nuovo gruppo di risorse o di utilizzare un gruppo di risorse esistente per posizionare le risorse di questo catalogo.
  7. Completare le impostazioni nelle pagine seguenti.
  8. Nella pagina Riepilogo, controllare i dettagli del catalogo macchine. Immettere un nome e una descrizione per il catalogo macchine. Fare clic su Fine.

Usa PowerShell

Creare un'immagine preparata

I comandi PowerShell dettagliati per creare una specifica di versione dell'immagine preparata per Azure locale sono i seguenti:
  1. Controllare i nomi delle definizioni di immagine disponibili utilizzando Test-ProvImageDefinitionNameAvailable command. Ad esempio,
    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
  2. Creare una definizione di immagine utilizzando il comando New-ProvImageDefinition. Ad esempio,
    New-ProvImageDefinition -ImageDefinitionName arc-ACG-image-climber-demo -OsType Windows -VDASessionSupport SingleSession -Description "arc ACG image for arc"
  3. Creare una nuova configurazione per la definizione dell'immagine nella connessione di hosting specificata utilizzando il comando Add-ProvImageDefinitionConnection.
    CustomProperties per Add-ProvImageDefinitionConnection può includere quanto segue. Se non si utilizzano i parametri, vengono utilizzati i valori predefiniti.
    ResourceGroups: Il gruppo di risorse che contiene i dischi di base.
    Ad esempio, nel caso di un gruppo di risorse fornito dal 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>
    "@    Add-ProvImageDefinitionConnection -HypervisorConnectionName Azurelocal -ImageDefinitionName arc-ACG-image-climber-demo [-CustomProperties $CustomProperties]
  4. Creare una versione dell'immagine utilizzando il comando New-ProvImageVersion. Ad esempio,
    New-ProvImageVersion -ImageDefinitionName arc-ACG-image-climber-demo
  5. Aggiungere una specifica di versione dell'immagine master alla versione dell'immagine utilizzando il comando Add-ProvImageVersionSpec. Ad esempio,
    Add-ProvImageVersionSpec -ImageVersionNumber 1 -HostingUnitName network-2 -MasterImagePath XDHyp:\HostingUnits\network-2\image.folder\MST-W11WS-2507-11-10-no-sysprep.galleryimage
    Nota:
    È possibile aggiungere una sola specifica di versione dell'immagine master a una versione dell'immagine per un'unità di hosting.
  6. Creare una specifica di versione dell'immagine preparata dalla specifica di versione dell'immagine master utilizzando il comando New-ProvImageVersionSpec. Ad esempio,
    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"
Esempio del set completo di comandi PowerShell per creare la definizione dell'immagine, la versione dell'immagine e la specifica di versione dell'immagine preparata:
## 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"
Nota:
  • Tutte le specifiche della versione dell'immagine in una definizione di immagine devono appartenere alla stessa unità di hosting.
  • Una versione dell'immagine può avere solo una specifica della versione dell'immagine master e una specifica della versione dell'immagine preparata.

Creare un catalogo utilizzando una specifica della versione dell'immagine preparata

Creare un catalogo macchine MCS dalla specifica della versione dell'immagine preparata utilizzando il comando New-ProvScheme. Ad esempio,
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>]
Oppure,
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>]
Esempio del set completo di comandi PowerShell per creare un catalogo:
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

Ulteriori informazioni

  • Gestione delle immagini

Passaggi successivi

  • Gestire i cataloghi di macchine con immagine preparata(/it-it/citrix-virtual-apps-desktops/2607-ltsr/install-configure/manage-prepared-image-machine-catalogs.html)