Documentazione dei prodotti
Citrix DaaS™
Visualizza PDF

Creare cataloghi utilizzando immagini preparate in AWS EC2

May 4, 2026
Grazie al contributo di: 
C

  • Creare immagini preparate e utilizzare le immagini preparate per creare un catalogo di macchine MCS utilizzando:

  • Studio
  • Comandi PowerShell

I passaggi chiave per creare un catalogo di macchine MCS utilizzando l’immagine preparata sono:

  1. Creare la definizione dell’immagine e le versioni iniziali dell’immagine.
  2. Utilizzare la versione dell’immagine come immagine preparata per creare un catalogo

Creare una definizione dell’immagine e la versione iniziale dell’immagine

Utilizzare Studio

Per creare una definizione dell’immagine e la versione iniziale dell’immagine, procedere come segue:

  1. Da Studio, accedere al nodo Immagini e fare clic su Crea definizione immagine. Fare clic su Avanti nella pagina Introduzione.
  2. Nella pagina Definizione immagine, specificare il tipo di sistema operativo e il tipo di sessione per la definizione dell’immagine.

  3. Nella pagina Immagine, selezionare Risorse (vengono elencate solo le risorse applicabili per la connessione impostata), un’immagine master da utilizzare come modello per la creazione della versione dell’immagine e un profilo macchina da cui acquisire le proprietà hardware. Selezionare un profilo macchina per acquisire le proprietà hardware da un’istanza VM o da una versione del modello di avvio.

    Nota:

    • Prima di selezionare un’immagine, verificare che l’immagine master abbia VDA 2311 o versione successiva installata e che il driver MCSIO sia installato sul VDA.
    • Sono supportati sia il servizio di metadati dell’istanza (IMDS) V1 che V2.
  4. Nella pagina Specifiche macchina, selezionare una dimensione della macchina. La dimensione della macchina del profilo macchina (selezionata nella pagina Immagine) è selezionata per impostazione predefinita.
  5. Nella pagina NIC, selezionare o aggiungere NIC per l’immagine di preparazione. Per ogni NIC, selezionare una sottorete VPC associata.
  6. Nella pagina Descrizione versione, immettere una descrizione per la versione iniziale dell’immagine creata.
  7. 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. Accedere 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 dell’immagine configurata inizialmente, 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.

Utilizzare PowerShell

I comandi PowerShell dettagliati per creare una specifica di versione dell’immagine preparata sono i seguenti:

  1. Controllare i nomi delle definizioni di immagine disponibili utilizzando il comando Test-ProvImageDefinitionNameAvailable. Ad esempio,

    
Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>

<!--NeedCopy-->

  2. Creare una definizione di immagine utilizzando il comando New-ProvImageDefinition. Ad esempio,

    
New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession

<!--NeedCopy-->

  3. Creare una nuova configurazione per la definizione dell’immagine nella connessione di hosting specificata utilizzando il comando Add-ProvImageDefinitionConnection.

    
Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn

<!--NeedCopy-->

  4. Creare una versione dell’immagine utilizzando il comando New-ProvImageVersion. Ad esempio,

    
New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"

<!--NeedCopy-->

  5. Aggiungere una specifica di versione dell’immagine master alla versione dell’immagine utilizzando il comando Add-ProvImageVersionSpec. Ad esempio,

    
Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName aws -MasterImagePath "XDHyp:\HostingUnits\aws\win10-2411-ami (ami-00123456789abcdef).template”"

<!--NeedCopy-->

    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. Il parametro SourceImageVersionSpecUid deriva dal comando Add-ProvImageVersionSpec. Ad esempio,

    ```

  • New-ProvImageVersionSpec
  • -SourceImageVersionSpecUid 00000000-0000-0000-0000-00000000000

  • -MachineProfile ‘XDHyp:\HostingUnits\aws\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion’ -RunAsynchronously

    ```

Esempio del set completo di comandi Powershell per creare la definizione dell’immagine, la versione dell’immagine e la specifica della versione dell’immagine preparata:


New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
 
 
Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName aws-CustomProperties $CustomProperties
 
$imageVersion = New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
 
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid `
    -HostingUnitUid $hostingunit.HostingUnitUid `
    -MasterImagePath "XDHyp:\HostingUnits\aws\win10-2411-ami (ami-00123456789abcdef).template”
 
New-ProvImageVersionSpec -MachineProfile 'XDHyp:\HostingUnits\aws\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid 00000000-0000-0000-0000-00000000000-HostingUnitName aws
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid | Where SourceImageVersionSpecUid-eq $SourceImageVersionSpec.ImageVersionSpecUid

<!--NeedCopy-->

Nota:

  • Tutte le specifiche di versione dell’immagine in una definizione di immagine devono appartenere alla stessa unità di hosting.
  • Una versione dell’immagine può avere una sola specifica di versione dell’immagine master e una sola specifica di versione dell’immagine preparata.
  • Tutte le specifiche di versione dell’immagine devono avere un profilo macchina.

Condividere immagini preparate tra zone di disponibilità e regioni

È ora possibile condividere una singola immagine preparata tra diverse zone di disponibilità, collegate a diverse unità di hosting, all’interno della stessa regione AWS o in regioni diverse per gli ambienti AWS EC2. Ciò consente di utilizzare un’unica immagine preparata per creare e aggiornare cataloghi di macchine MCS in varie zone di disponibilità e regioni. Quando si condivide tra diverse AZ in regioni diverse, la versione dell’immagine preparata verrà copiata dalla regione originale alle regioni di destinazione.

È possibile mantenere una singola immagine preparata e utilizzarla per creare e aggiornare cataloghi di macchine in più zone di disponibilità e regioni collegate a diverse unità di hosting. Ciò riduce significativamente il sovraccarico di gestione delle immagini, garantisce la coerenza tra le distribuzioni e semplifica il processo di provisioning. È inoltre possibile aggiornare senza problemi i cataloghi di macchine esistenti con immagini preparate da una zona di disponibilità o regione diversa.

Casi d’uso

  • Gestione centralizzata delle immagini: Si crea un’immagine preparata in una zona di disponibilità (ad esempio, us-east-1a). È quindi possibile condividere questa immagine con altre zone di disponibilità come us-east-1b all’interno della stessa regione AWS us-east-1 o us-west-1a in una regione us-west-1 diversa. Ciò consente a una singola immagine di servire più unità di hosting e semplifica la manutenzione.
  • Creazione e aggiornamento efficienti dei cataloghi: È possibile utilizzare un’immagine preparata creata in AZ 1 (ad esempio, us-east-1a) per creare nuovi cataloghi in AZ 1. Dopo aver condiviso questa immagine con AZ 2 (ad esempio, us-east-1b), è possibile utilizzare l’immagine condivisa in AZ 2 per creare e aggiornare cataloghi in AZ 2.
  • Distribuzioni tra unità di hosting e connessioni di hosting: Se l’ambiente dispone di più unità di hosting nella stessa o in diverse regioni AWS, è possibile condividere in modo efficiente le immagini preparate tra queste unità di hosting.

Limitazioni

  • Condivisione specifica per regione: È possibile condividere immagini preparate solo tra zone di disponibilità all’interno della stessa regione AWS. Non è possibile condividere tra regioni AWS diverse o account AWS diversi nell’implementazione attuale.

Considerazioni importanti

  • Ordine di eliminazione: Per eliminare una specifica della versione dell’immagine preparata originale, è necessario eliminare prima tutte le specifiche della versione dell’immagine condivise. In alternativa, è necessario eliminare le specifiche originali e condivise simultaneamente.
  • Dipendenza della versione dell’immagine: Quando si rimuove una versione dell’immagine, è necessario rimuovere prima tutte le configurazioni di condivisione che dipendono da quella specifica versione dell’immagine. I cataloghi creati dall’immagine originale (non condivisa) possono rimanere intatti.
  • Retrocompatibilità del catalogo: È possibile aggiornare i cataloghi di macchine esistenti distribuiti prima dell’introduzione di questa funzionalità. Utilizzare immagini preparate create in una zona di disponibilità o regione diversa da quella in cui è stato originariamente distribuito il catalogo.
  • Eliminazione completa: Quando si elimina un’immagine preparata, non è più possibile utilizzarla in nessuna zona di disponibilità in cui è stata condivisa o originariamente creata. Inoltre, una versione dell’immagine preparata non può essere eliminata finché non vengono eliminati prima tutti i cataloghi collegati a tale versione dell’immagine preparata.

Prerequisiti

Prima di configurare o utilizzare questa funzionalità, assicurarsi di soddisfare le seguenti condizioni:

  • L’ambiente deve essere un ambiente AWS EC2.
  • È necessario configurare più unità di hosting (ognuna può essere collegata a diverse zone di disponibilità) e connessioni host (ognuna può essere collegata a una regione diversa) sotto lo stesso account AWS.

Configurare tramite PowerShell

Attualmente è possibile condividere immagini preparate tra zone di disponibilità collegate a diverse unità di hosting utilizzando solo comandi PowerShell.

Per condividere un’immagine preparata

  1. Assicurarsi di disporre dell’ImageVersionSpecUid dell’immagine preparata che si desidera condividere. È possibile recuperare questo utilizzando Get-ProvImageVersionSpec o comandi Get- simili in PowerShell.
  2. Determinare l’HostingUnitName della zona di disponibilità (può essere la stessa regione o una regione diversa) in cui si desidera rendere disponibile l’immagine preparata. Questo è il nome dell’unità di hosting configurata per quella specifica zona di disponibilità.

  3. Eseguire il comando Add-ProvImageVersionSpecHostingUnit: Utilizzare il seguente comando PowerShell. Sostituire <ImageVersionSpecUid> con l’Uid dell’immagine e <targetHostingUnitName> con il nome dell’unità di hosting nella zona di disponibilità di destinazione con cui si desidera condividere la specifica della versione dell’immagine:

    
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>

<!--NeedCopy-->
  4. Dopo l’esecuzione riuscita, è possibile visualizzare lo stato dell’immagine nell’interfaccia utente di Studio, indicando che è stata condivisa con l’unità di hosting specificata.

  • Per rimuovere la condivisione di un’immagine preparata

    1. Assicurarsi di disporre dell’ImageVersionSpecUid dell’immagine preparata dalla quale si desidera rimuovere la condivisione.
  1. Determinare l’HostingUnitName della zona di disponibilità dalla quale si desidera rimuovere l’immagine condivisa.

  2. Eseguire il comando Remove-ProvImageVersionSpecHostingUnit: Utilizzare il seguente comando PowerShell. Sostituire <ImageVersionSpecUid> con l’Uid dell’immagine e <targetHostingUnitName> con il nome dell’unità di hosting nella zona di disponibilità di destinazione dalla quale si desidera rimuovere la condivisione della specifica della versione dell’immagine:

    
Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>

<!--NeedCopy-->

Creare un catalogo di macchine

Utilizzare Studio

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 di macchine dal nodo Cataloghi macchine.

Per creare un catalogo di macchine MCS dal nodo Immagini, procedere come segue:

  1. Selezionare una versione dell’immagine e fare clic su Crea catalogo. Fare clic su Avanti nella pagina Introduzione.
  2. Nelle pagine Gestione macchine e Immagine, le impostazioni sono preselezionate in base alla versione dell’immagine selezionata. Nella pagina Immagine, inserire una nota per l’immagine preparata selezionata.
  3. Completare le impostazioni nelle pagine seguenti.
  4. Nella pagina Riepilogo, controllare i dettagli del catalogo di macchine. Inserire un nome e una descrizione per il catalogo di macchine. Fare clic su Fine.
  5. Andare al nodo Cataloghi macchine per visualizzare il catalogo di macchine creato.

Creare un catalogo di macchine dal nodo Cataloghi macchine

Per creare un catalogo di macchine MCS dal nodo Cataloghi macchine, procedere come segue:

  1. Fare clic su Cataloghi macchine nel riquadro di navigazione a sinistra.
  2. Fare clic su Crea catalogo di macchine. Viene visualizzata la pagina Configurazione catalogo di macchine.
  3. Nella pagina Tipo di macchina, selezionare un tipo di macchina per il catalogo, ad esempio, Sistema operativo multisessione.

  4. Nella pagina Gestione macchine, selezionare le seguenti impostazioni:

    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, selezionare le risorse (Zona di disponibilità) configurate durante la creazione della connessione host e fare clic su Avanti.
  5. Nella pagina Esperienza desktop, selezionare un desktop casuale o statico che si desidera che gli utenti abbiano al momento dell’accesso. Se è selezionato un desktop statico, specificare ulteriormente se si desidera salvare le modifiche apportate dall’utente sul disco locale (persistente o non persistente).

  6. Nella pagina Immagine, fare clic su Seleziona un’immagine per selezionare un’immagine preparata per il catalogo di macchine. Selezionare la versione preparata creata. 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. Fare clic su Fine.

    Viene visualizzato il profilo macchina associato all’immagine preparata e le sue proprietà hardware (ad esempio, tipo di istanza, tipo di tenancy, mappature di rete, gruppi di sicurezza, proprietà del volume) vengono utilizzate per creare macchine nei cataloghi. Per modificare l’origine del profilo macchina in un’altra VM o versione del modello di avvio, fare clic sul pulsante di modifica.

  7. Nella pagina Macchine virtuali:

    1. Immettere il numero di VM per il catalogo.
    2. Viene visualizzata la specifica della macchina predefinita, basata sul profilo macchina. Per modificarla, selezionare l’icona di modifica e selezionare una specifica della macchina.
  8. Nella pagina NIC, selezionare le NIC (o ENI) per le VM.
  9. Nella pagina Identità macchina, configurare Active Directory locale o Microsoft Entra ibrido per le macchine nel catalogo selezionando il dominio e creando nuovi account AD per le VM da creare in questo catalogo di macchine. Le VM sottoposte a provisioning vengono unite al dominio selezionato. Specificare lo schema di denominazione degli account per i nuovi account AD da creare per le VM. Fare clic su Avanti.
  10. Nella pagina Credenziali di dominio, fare clic su Immetti credenziali per fornire le credenziali per il dominio selezionato. Immettere nome utente e password a livello di amministratore quando richiesto. È inoltre possibile utilizzare un account di servizio se si dispone di credenziali di dominio già salvate in precedenza seguendo la nostra documentazione del prodotto.
  11. Scorrere le pagine rimanenti fino alla pagina Riepilogo. Immettere un nome per il catalogo di macchine e selezionare Fine per creare il catalogo di macchine.

Utilizzare PowerShell

Creare un catalogo utilizzando una specifica della versione dell’immagine preparata e un profilo macchina

  • Creare un catalogo di macchine MCS non persistente dalla specifica della versione dell’immagine preparata utilizzando il comando New-ProvScheme. Ad esempio,

    
 New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $true] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”]

 <!--NeedCopy-->

  • Creare un catalogo di macchine MCS persistente dalla specifica della versione dell’immagine preparata utilizzando il comando New-ProvScheme. Ad esempio,

    
 New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $false] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”] 

 <!--NeedCopy-->

Esempio del set completo di comandi Powershell per creare un catalogo:


$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "awscatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"

$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "domainname" -IdentityPoolName "awscatalog" -IdentityType "ActiveDirectory"  -NamingScheme "aws##" -NamingSchemeType "Numeric" -Scope @()

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

$Task = New-ProvScheme -ProvisioningSchemeName awscatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName aws -IdentityPoolName awscatalog -CleanOnBoot -Scope @() -SecurityGroup @() -MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm' -RunAsynchronously

Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName awscatalog

Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid

<!--NeedCopy-->

Passi successivi

Ulteriori informazioni

Creare cataloghi utilizzando immagini preparate in AWS EC2
May 4, 2026
Grazie al contributo di: 
C
May 4, 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.