Crea un catalogo AWS

May 31, 2026

Grazie al contributo di:

(/it-it/citrix-virtual-apps-desktops/2503/install-configure/machine-catalogs-create.html) descrive le procedure guidate che creano un catalogo di macchine. Le seguenti informazioni riguardano i dettagli specifici degli ambienti di virtualizzazione AWS.

Nota:

Prima di creare un catalogo AWS, è necessario completare la creazione di una connessione ad AWS. Vedere (/it-it/citrix-virtual-apps-desktops/2503/install-configure/connections/connection-aws.html).

Limitazione

Da Citrix Virtual Apps and Desktops™ 2203 LTSR e versioni successive, il plug-in MCS AWS effettua la chiamata API AWS DescribeInstanceTypes e, se questa ha successo, MCS utilizza il nome dell’inventario creato dalla risposta API.

Pertanto, quando si esegue l’aggiornamento da Citrix Virtual Apps and Desktops 1912 alla versione 2203 o successiva, disabilitare l’autorizzazione DefineInstanceType su AWS, quindi aggiornare il catalogo esistente utilizzando il comando Set-ProvScheme per corrispondere allo schema di denominazione AWS. Quindi, aggiungere nuovamente le autorizzazioni DescribeInstanceType dopo che l’aggiornamento del catalogo è completo e l’offerta di servizi corrisponde allo schema di denominazione AWS.

Impostazioni di rete durante la preparazione dell’immagine

Durante la preparazione dell’immagine, viene creata una macchina virtuale (VM) di preparazione basata sulla VM originale. Questa VM di preparazione è disconnessa dalla rete. Per disconnettere la rete dalla VM di preparazione, viene creato un gruppo di sicurezza di rete per negare tutto il traffico in entrata e in uscita. Questo gruppo di sicurezza di rete persiste e viene riutilizzato. Il nome del gruppo di sicurezza di rete è Citrix.XenDesktop.IsolationGroup-GUID, dove GUID è generato casualmente.

Configurare la tenancy AWS

AWS offre le seguenti opzioni di tenancy:

Tenancy condivisa (il tipo predefinito): più istanze Amazon EC2 di clienti diversi potrebbero risiedere sullo stesso hardware fisico.
Tenancy dedicata: le istanze EC2 vengono eseguite solo su hardware con altre istanze che sono state distribuite. Altri clienti non utilizzano lo stesso hardware.

È possibile utilizzare MCS per il provisioning di host dedicati AWS tramite PowerShell.

Configurare la tenancy di host dedicati AWS tramite PowerShell

È possibile creare un catalogo di macchine con tenancy dell’host definita tramite PowerShell.

Un [EC2] host dedicato Amazon è un server fisico con capacità di istanza [EC2] completamente dedicata, che consente di utilizzare licenze software esistenti per socket o per VM.

Gli host dedicati hanno un utilizzo preimpostato in base al tipo di istanza. Ad esempio, un singolo host dedicato allocato di tipo di istanza C4 Large è limitato all’esecuzione di 16 istanze. Per maggiori informazioni, consultare il sito AWS.

I requisiti per il provisioning su host AWS includono:

Un’immagine BYOL (bring your own license) importata (AMI). Con gli host dedicati, utilizzare e gestire le licenze esistenti.
Un’allocazione di host dedicati con un utilizzo sufficiente per soddisfare le richieste di provisioning.
abilitare auto-placement.

Per eseguire il provisioning su un host dedicato in AWS utilizzando PowerShell, utilizzare il cmdlet New-ProvScheme con il parametro TenancyType impostato su Host.

Per maggiori informazioni, consultare la documentazione per sviluppatori Citrix.

Acquisire le proprietà della macchina dai profili macchina

Quando si crea un catalogo per il provisioning di macchine AWS utilizzando MCS, è possibile utilizzare un profilo macchina per preimpostare determinate impostazioni delle proprietà della macchina.

Per farlo, seguire questi passaggi:

Archiviare i profili macchina nella stessa zona di disponibilità delle risorse in cui si sta creando questo catalogo.
Nella pagina Modello macchina della procedura guidata di creazione del catalogo, selezionare Usa un profilo macchina. Vengono visualizzati i profili macchina che si trovano nella stessa zona disponibile delle risorse selezionate.
Selezionare un profilo macchina secondo necessità.

Assegnare tag alle risorse operative AWS

Quando si crea un catalogo per il provisioning di macchine in AWS utilizzando MCS, è possibile controllare se applicare il ruolo IAM e le proprietà dei tag a tali macchine. È inoltre possibile controllare se applicare i tag delle macchine alle risorse operative.

Un’Amazon Machine Image (AMI) rappresenta un tipo di appliance virtuale utilizzata per creare una macchina virtuale all’interno dell’ambiente Amazon Cloud, comunemente denominato EC2. Si utilizza un’AMI per distribuire servizi che utilizzano l’ambiente EC2. Quando si crea un catalogo per il provisioning di macchine utilizzando MCS per AWS, si seleziona l’AMI che fungerà da immagine d’oro per tale catalogo.

Importante:

La creazione di cataloghi utilizzando sia un profilo macchina che un modello di avvio è necessaria per l’utilizzo del tagging delle risorse operative.

Per creare un catalogo AWS, è necessario prima creare un’AMI per l’istanza che si desidera sia l’immagine d’oro. MCS legge i tag da tale istanza e li incorpora nel modello di avvio. I tag del modello di avvio vengono quindi applicati a tutte le risorse Citrix® create nell’ambiente AWS, inclusi:

Macchine virtuali
Dischi VM
Interfacce di rete VM
Bucket S3
Oggetti S3
Modelli di avvio
AMI

Assegnare tag alle risorse operative utilizzando Web Studio

Quando si crea un catalogo per il provisioning di macchine in AWS utilizzando MCS, è possibile controllare se applicare i tag delle macchine alle risorse operative selezionando l’opzione Applica tag macchina alle risorse operative nella pagina Modello macchina.

Questa opzione controlla se applicare i tag macchina a ogni elemento creato nel tuo ambiente AWS che facilita il provisioning delle macchine. Le risorse operative vengono create come sottoprodotti della creazione del catalogo. Includono risorse temporanee e persistenti, come l’istanza VM di preparazione e l’AMI.

Assegnare tag alle risorse operative usando PowerShell

Per usare PowerShell per assegnare tag alle risorse:

Aprire una finestra PowerShell dall’host DDC.
Eseguire il comando asnp citrix per caricare i moduli PowerShell specifici di Citrix.

Per assegnare un tag a una risorsa per una VM con provisioning, usare la proprietà personalizzata AwsOperationalResourcesTagging. Esempio:

New-ProvScheme -ProvisioningSchemeName test
-CustomProperties “AwsOperationalResourcesTagging,true”
-MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion"
... <Other <standard provscheme parameters>
<!--NeedCopy-->

Copiare i tag sulle VM

È possibile copiare i tag su NIC e dischi (disco di identità, disco della cache di write-back e disco del sistema operativo) specificati nel profilo macchina su VM appena create in un catalogo macchine MCS. È possibile specificare questi tag in una qualsiasi delle origini del profilo macchina (istanza VM AWS o versione del modello di avvio AWS). Questa funzionalità è applicabile a cataloghi macchine e VM persistenti e non persistenti.

Nota:

Nella console AWS EC2, non è possibile visualizzare i valori di Tag Network Interfaces in Launch Template Version Resource Tags. Tuttavia, è possibile eseguire il comando PowerShell aws ec2 describe-launch-template-versions --launch-template-id lt-0bb652503d45dcbcd --versions 12 per visualizzare le specifiche dei tag.

Se un’origine del profilo macchina (VM o versione del modello di avvio) ha due interfacce di rete (eni-1 ed eni-2), e eni-1 ha il tag t1 ed eni-2 ha il tag t2, allora la VM ottiene i tag di entrambe le due interfacce di rete.

Creare un catalogo usando un profilo macchina

È possibile utilizzare un profilo macchina per acquisire le proprietà hardware da un’istanza EC2 (VM) o da una versione del modello di avvio e applicarle alle macchine con provisioning. Le proprietà acquisite possono includere, ad esempio, proprietà del volume EBS, tipo di istanza, ottimizzazione EBS, opzioni CPU, tipo di tenancy, capacità di ibernazione e altre configurazioni AWS supportate.

È possibile utilizzare un’istanza AWS EC2 (VM) o una versione del modello di avvio AWS come input del profilo macchina.

Nota:

Le proprietà del volume EBS sono derivate solo da un profilo macchina.

MCS esegue il provisioning delle VM con dischi di identità di tipo volume GP3. Poiché il tipo di volume GP3 è l’opzione più economica offerta da AWS, questa funzionalità riduce al minimo i costi. L’implementazione è applicabile solo alle VM aggiunte a un nuovo catalogo e alle nuove VM aggiunte a un catalogo esistente. Le VM esistenti create prima di questa funzionalità continueranno ad avere dischi ID con tipo di volume GP2, a meno che il disco ID non venga reimpostato.

Considerazioni importanti

Le considerazioni importanti durante la creazione di un catalogo macchine MCS:

Se si aggiungono parametri di proprietà hardware della macchina nei comandi New-ProvScheme e Set-ProvScheme, i valori forniti nei parametri sovrascrivono i valori nel profilo macchina.
Se si imposta AwsCaptureInstanceProperties come true e non si imposta la proprietà MachineProfile, vengono acquisiti solo i ruoli IAM e i tag.
Non è possibile impostare AwsCaptureInstanceProperties e MachineProfile contemporaneamente.

Nota:

Il AwsCaptureInstanceProperties è deprecato.
Se non viene fornito un profilo macchina, è necessario fornire esplicitamente i valori delle seguenti proprietà:
- Gruppo di sicurezza
- ENI o rete virtuale
È possibile abilitare AwsOperationalResourcesTagging solo se si abilita AwsCaptureInstanceProperties o si specifica un profilo macchina.

Le considerazioni importanti dopo la creazione di un catalogo macchine MCS:

Non è possibile modificare un catalogo da basato su profilo macchina a non basato su profilo macchina.

Creare un catalogo macchine utilizzando un profilo macchina

Per creare un catalogo macchine utilizzando un profilo macchina:

Aprire una finestra di PowerShell.
Eseguire asnp citrix* per caricare i moduli PowerShell specifici di Citrix.

Creare un pool di identità se non è già stato creato. Ad esempio,

New-AcctIdentityPool -IdentityPoolName idPool -NamingScheme ms## -Domain abcdf -NamingSchemeType Numeric
<!--NeedCopy-->

Eseguire il comando New-ProvScheme. Ad esempio:

New-ProvScheme -ProvisioningSchemeName demet-test-1
-HostingUnitUid aa633238-9xxd-4cf6-80e8-232a758a1xx1
-IdentityPoolUid 34d5b088-e312-416f-907d-16573xxxxxc4
-CleanOnBoot
-MasterImageVM 'XDHyp:\HostingUnits\cvad-test-scalestress\citrix-demet-ami.0 (ami-0ca813xxxxxx061ef).template'
-MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm'
<!--NeedCopy-->

Completare la creazione del catalogo. Per maggiori informazioni, consultare Citrix PowerShell SDK.

Aggiornare il profilo macchina

Per aggiornare il profilo macchina su un catalogo inizialmente fornito con un profilo macchina, procedere come segue. È inoltre possibile modificare il tipo di tenancy e la capacità di ibernazione dell’origine del profilo macchina durante la modifica di un catalogo macchine MCS.

Eseguire il comando Set-ProvScheme. Ad esempio,

Set-ProvScheme `
-ProvisioningSchemeUid "<ID" `
-MachineProfile "XDHyp:\HostingUnits\abc\us-east-1a.availabilityzone\citrix-cvad-machineprofile-instance (i-0xxxxxxxx).vm"
<!--NeedCopy-->

Creare un catalogo con la versione del modello di avvio

È possibile creare un catalogo macchine MCS con una versione del modello di avvio come input del profilo macchina. È inoltre possibile aggiornare l’input di un catalogo di profili macchina da una VM a una versione del modello di avvio e da una versione del modello di avvio a una VM.

Nella console AWS EC2, è possibile fornire le informazioni di configurazione dell’istanza di un modello di avvio insieme al numero di versione. Quando si specifica la versione del modello di avvio come input del profilo macchina durante la creazione o l’aggiornamento di un catalogo macchine, le proprietà di quella versione del modello di avvio vengono copiate nelle VM VDA fornite.

Le seguenti proprietà possono essere fornite utilizzando l’input del profilo macchina o esplicitamente come parametri nei comandi New-ProvScheme o Set-ProvScheme. Se vengono fornite nei comandi New-ProvScheme o Set-ProvScheme, hanno la precedenza sui valori del profilo macchina di queste proprietà.

Offerta di servizi
Reti
Gruppi di sicurezza
Tipo di tenancy

Nota:

Se l’offerta di servizio non è fornita nel modello di avvio del profilo macchina o come parametro nel comando New-ProvScheme, si riceve un errore appropriato.

Per creare un catalogo utilizzando la versione del modello di avvio come input del profilo macchina:

Aprire una finestra PowerShell.
Eseguire asnp citrix* per caricare i moduli PowerShell specifici di Citrix.

Ottenere l’elenco delle versioni del modello di avvio di un modello di avvio. Ad esempio:

XDHyp:\HostingUnits\test\test-mp-sard (lt-01xxxxx).launchtemplate> ls | Select FullPath
<!--NeedCopy-->

Creare un pool di identità se non è stato creato. Ad esempio:

New-AcctIdentityPool `
-IdentityPoolName "abc11" `
-NamingScheme "abc1-##" `
-NamingSchemeType Numeric `
-Domain "citrix-xxxxxx.local" `
-ZoneUid "xxxxxxxx" `
<!--NeedCopy-->

Creare uno schema di provisioning con una versione del modello di avvio come input del profilo macchina. Ad esempio:

New-ProvScheme `
-ProvisioningSchemeName "MPLT1" `
-HostingUnitUid "c7f71f6a-3f45-4xxx-xxxx-xxxxxxxxxx" `
-IdentityPoolUid "bf3a6ba2-1f80-4xxx-xxxx-xxxxxxxxx" `
-MasterImageVM "XDHyp:\HostingUnits\xxxd-ue1a\apollo-non-persistent-vda-win2022 (ami-0axxxxxxxxxxx).template" `
-CleanOnBoot `
-MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion"
<!--NeedCopy-->

Registrare lo schema di provisioning come catalogo broker. Ad esempio:

New-BrokerCatalog -Name "MPLT1" `
-AllocationType Random `
-Description "Machine profile catalog" `
-ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `
-ProvisioningType Mcs `
-SessionSupport MultiSession `
-PersistUserChanges Discard
<!--NeedCopy-->

Completare la creazione del catalogo. Per maggiori informazioni, consultare Citrix PowerShell SDK

È anche possibile aggiornare l’input di un catalogo di profili macchina da una VM a una versione del modello di avvio e da una versione del modello di avvio a una VM. Ad esempio:

Per aggiornare l’input di un catalogo di profili macchina da una VM a una versione del modello di avvio:

 Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
 -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-0bxxxxxxxxxxxx).launchtemplate\lt-0bxxxxxxxxxxxx (1).launchtemplateversion"
 <!--NeedCopy-->

Per aggiornare l’input di un catalogo di profili macchina da una versione di modello di avvio a una VM:

 Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
 -MachineProfile "XDHyp:\HostingUnits\sard-ue1a\us-east-1a.availabilityzone\apollo-non-persistent-vda-win2022-2 (i-08xxxxxxxxx).vm"
 <!--NeedCopy-->

Catalogo abilitato per MCSIO

L’ottimizzazione dell’archiviazione MCS (MCSIO) migliora le prestazioni della VM memorizzando nella cache le operazioni su disco, sia in memoria che su un disco piccolo e ad alta velocità. È possibile creare un catalogo non persistente abilitato per MCSIO utilizzando i comandi PowerShell. Per creare un catalogo di questo tipo, è necessario installare il driver MCSIO durante l’installazione o l’aggiornamento del VDA durante la preparazione dell’istanza AMI. Per impostazione predefinita, tale driver non è installato.

Dopo aver preparato un’AMI MCSIO, è possibile creare un catalogo non persistente abilitato per MCSIO.

Creare un catalogo abilitato per MCSIO

I quattro parametri aggiunti al comando PowerShell New-ProvScheme sono:

UseWriteBackCache: Attiva la memorizzazione nella cache (cache write-back) per lo schema di provisioning specificato
WriteBackCacheDiskSize: Specifica la dimensione in GB del disco temporaneo utilizzato per la memorizzazione nella cache
WriteBackCacheMemorySize: Specifica la quantità di memoria in MB da utilizzare per la memorizzazione nella cache. Questo è un parametro facoltativo.
WriteBackCacheDriverLetter: Specifica la lettera di unità da assegnare al disco di archiviazione della cache. Questo è un parametro facoltativo.

Nota:

Il valore di WriteBackCacheDiskSize deve essere maggiore di zero perché è richiesto almeno 1 GB di spazio su disco per la cache. La dimensione del disco della cache non deve essere maggiore della dimensione del disco del sistema operativo.

Il valore di WriteBackCacheMemorySize deve essere diverso da zero e inferiore alla dimensione della memoria del catalogo macchine.

Le proprietà personalizzate che influenzano MCSIO sono:

WBCDiskStorageType: Definisce il tipo di volume utilizzato per il disco temporaneo in AWS. Questo parametro accetta un argomento stringa nel formato volume-type[:iops][:throughput]. I seguenti sono i tipi di volume:
- gp2: Non utilizzare i parametri iops e throughput per questo tipo di volume
- gp3: Utilizzare i parametri iops e throughput per questo tipo di volume
- io1: Utilizzare solo il parametro iops per questo tipo di volume
- io2: Utilizzare solo il parametro iops per questo tipo di volume
Il tipo di volume predefinito è gp2.
PersistWBC: Controlla se mantenere o eliminare il disco cache ogni volta che l’istanza AWS viene spenta. Se impostato su true, il disco cache viene mantenuto. Se impostato su false (impostazione predefinita), il disco cache viene creato e mantenuto solo mentre l’istanza AMI è accesa.
PersistOSDisk: Controlla se mantenere o eliminare il disco del sistema operativo ogni volta che l’istanza AWS viene spenta. Se impostato su true, il disco del sistema operativo viene mantenuto. Se impostato su false (impostazione predefinita), il disco del sistema operativo viene creato e mantenuto solo mentre l’istanza AMI è accesa.

Eseguire i seguenti passaggi nella finestra di PowerShell per creare un catalogo non persistente abilitato per MCSIO:

Aprire la finestra di PowerShell.
Eseguire asnp citrix* per caricare i moduli PowerShell specifici di Citrix.
Creare un catalogo broker e un pool di identità.

Creare lo schema di provisioning. Ad esempio:

$HostingUnitUid = '0xxxx1d9-bbfc-xxxf-bxxb-exxxxxe008b2'
$MasterImageVM = 'XDHyp:\HostingUnits\ctx-test\aws-apollo-non-persistent-multi-mcsio-vda-win2022 (ami-0bf1810488acbxxxb).template'
$NetworkMap = @{ 'NetworkPath' = 'XDHyp:\HostingUnits\ctx-test\us-east-1a.availabilityzone\10.0.128.0`/17 (vpc-0fa6e41d72507fxxx).network' }
$SecurityGroup = $( 'XDHyp:\HostingUnits\ctx-test\us-east-1a.availabilityzone\private.securitygroup' )
$ServiceOffering = 'XDHyp:\HostingUnits\ctx-test\T3 Medium Instance.serviceoffering'
$CustomProperties = 'WBCDiskStorageType,gp3:6000:250;PersistWBC,false'


$provScheme = New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
-IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot `
- MasterImageVM $MasterImageVM `
-NetworkMap $NetworkMap `
-ServiceOffering $ServiceOffering `
-SecurityGroup $SecurityGroup `
-CustomProperties $CustomProperties `
-UseWriteBackCache -WriteBackCacheDiskSize 16 -WriteBackCacheMemorySize 256
<!--NeedCopy-->

Aggiungere le VM al catalogo.

Migliorare le prestazioni di avvio con MCSIO

È possibile migliorare le prestazioni di avvio delle VM se si abilita MCSIO e si impostano le proprietà personalizzate PersistWBC e PersistOSDisk come true. Con tale impostazione, le VM possono avviarsi più velocemente perché non devono inizializzare un nuovo disco cache o ricreare un disco radice dal loro modello.

Crittografare i dischi OS, ID e WBC

È possibile creare un catalogo persistente e non persistente di VM con chiavi AWS KMS (chiave gestita dal cliente e chiave gestita da AWS) che possono essere utilizzate per crittografare il disco del sistema operativo, il disco di identità (ID) e il disco della cache di write-back (WBC).

Le chiavi gestite da AWS vengono ruotate automaticamente ogni anno.
Le chiavi gestite dal cliente sono opzionali per la rotazione automatica e possono essere gestite manualmente.

Per ulteriori informazioni sulle chiavi KMS, consultare i seguenti documenti AWS:

Per la crittografia dei dischi OS, ID e WBC, configurare una delle seguenti opzioni:

Utilizzare un’immagine master crittografata (ad esempio, un’AMI creata da un’istanza o uno snapshot che contiene un volume root EBS crittografato con chiave KMS)
Utilizzare un’origine del profilo macchina (VM o modello di avvio) che contenga un volume root EBS crittografato.

Limitazioni

Considerare le seguenti limitazioni:

MCS attualmente supporta un solo disco sull’AMI dell’immagine master.
Non è possibile crittografare direttamente volumi o snapshot EBS esistenti non crittografati, né modificare la chiave KMS di un volume crittografato esistente. Per farlo, è necessario:
1. Creare un nuovo snapshot di quel volume.
2. Crea un nuovo volume da quello snapshot
3. Crittografa il nuovo volume.

Vedere i seguenti documenti AWS:

Crittografare le risorse non crittografate
Limitazioni della crittografia automatica o predefinita dei volumi EBS: Crittografare automaticamente i volumi Amazon EBS esistenti e nuovi.

Creare un catalogo con crittografia del disco

È possibile creare un catalogo di macchine MCS con crittografia del disco utilizzando:

Immagine master
Profilo macchina

Le considerazioni sull’utilizzo dell’input del profilo macchina sono:

La chiave KMS dell’input del profilo macchina ha la precedenza sulla chiave KMS dell’immagine master.
Se non viene fornito alcun input del profilo macchina, la chiave KMS dell’AMI dell’immagine master viene utilizzata per crittografare i dischi delle VM del catalogo.
Se il profilo macchina presenta mappature dei dispositivi a blocchi, i dispositivi a blocchi presenti nel modello di immagine master (AMI) e nel profilo macchina devono corrispondere. Ad esempio, se l’AMI ha un dispositivo definito su /dev/sda1, anche il profilo macchina deve avere un dispositivo definito su /dev/sda1.
Se non è presente alcuna chiave nell’origine del profilo macchina e l’immagine master non è crittografata, i dischi delle VM del catalogo non vengono crittografati.
Quando l’immagine master è crittografata, una VM di origine del profilo macchina o un modello di avvio deve avere un volume root crittografato per essere considerato un input valido.

Modificare un catalogo esistente

È possibile modificare un catalogo esistente utilizzando il comando PowerShell Set-ProvScheme per avere:

Un input del profilo macchina con un volume contenente una nuova chiave KMS.
Un’AMI modello di immagine master crittografata con una nuova chiave KMS.

Considerazioni importanti:

I volumi delle nuove VM aggiunte al catalogo sono crittografati con la nuova chiave KMS.
Per aggiornare le impostazioni di crittografia quando esiste un profilo macchina esistente, eseguire Set-ProvScheme con un nuovo profilo macchina.
Non è possibile modificare un catalogo esistente passando da volumi crittografati a volumi non crittografati. Non è possibile eseguire un aggiornamento dell’immagine da un’AMI master crittografata a un’AMI master non crittografata.

Abilitare NitroTPM e l’avvio protetto UEFI per le istanze VM

Quando si crea un catalogo, è ora possibile selezionare un’immagine master (AMI) con NitroTPM e/o l’avvio protetto UEFI abilitati. Di conseguenza, anche le VM sottoposte a provisioning nel catalogo sono abilitate con NitroTPM e/o l’avvio protetto UEFI. Questa implementazione garantisce che le VM siano protette e affidabili. Per ulteriori informazioni su NitroTPM e l’avvio protetto UEFI, consultare la documentazione di Amazon.

Limitazioni

È possibile utilizzare sia NitroTPM che Secure Boot attualmente in tutte le regioni AWS (incluse le regioni AWS GovCloud (US)), ad eccezione della Cina.
Non è possibile abilitare NitroTPM e l’avvio protetto UEFI sui cataloghi esistenti. Se si desidera un catalogo con NitroTPM e l’avvio protetto UEFI abilitati, creare un nuovo catalogo.

Passaggi chiave

Configurare l’ambiente AWS.
Crea una connessione ad AWS.
Crea un’immagine master (AMI) abilitata con NitroTPM e/o avvio protetto UEFI.
Crea un catalogo di macchine selezionando l’immagine master con NitroTPM e avvio protetto UEFI abilitati nel menu di creazione del catalogo di Web Studio o durante la creazione di uno schema di provisioning utilizzando i comandi PowerShell.

Le VM aggiunte al catalogo creato hanno NitroTPM e avvio protetto UEFI abilitati.

Crea un’AMI che supporti NitroTPM e l’avvio protetto UEFI

È possibile creare un’AMI da una VM che ha NitroTPM e/o l’avvio protetto UEFI abilitati.
1. Crea l’istanza utilizzando le immagini del marketplace AWS. Ad esempio, cerca TPM-Windows_Server-2022-English-Full-Base on the aws-marketplace.
2. Scarica VDA a sessione singola o multipla.
3. Crea un’AMI da quella VM.
Usa il comando register-image:
```
--boot-mode (string)
--tpm-support (string)

```
Per maggiori informazioni, consulta register-image.

Vedi i seguenti documenti AWS:

È possibile aprire una finestra PowerShell dall’host del Delivery controller™ per verificare se uno specifico:

l’offerta di servizi supporta NitroTPM o l’avvio protetto UEFI

 (Get-Item -Path “XDHyp:\HostingUnits\aws\T3 Medium Instance.serviceoffering”).AdditionalData.BootMode
 (Get-Item -Path “XDHyp:\HostingUnits\aws\T3 Medium Instance.serviceoffering”).AdditionalData.NitroTpmSupportVersions
 <!--NeedCopy-->

il modello supporta NitroTPM o l’avvio protetto UEFI

 (Get-HypInventoryItem -LiteralPath “XDHyp:\HostingUnits\aws” -ResourceType “template -Id “ID”).AdditionalData.BootMode

 (Get-HypInventoryItem -LiteralPath “XDHyp:\HostingUnits\aws” -ResourceType “template -Id “ID”).AdditionalData.TpmSupport
 <!--NeedCopy-->

Aggiornare l’offerta di servizi del catalogo esistente

È possibile modificare l’offerta di servizi di un catalogo esistente utilizzando Set-ProvScheme. La modifica si applica alle VM appena aggiunte. Tuttavia, si verificano errori nei seguenti scenari:

Modalità di avvio delle AMI	L’AMI supporta Nitro TPM?	L’offerta di servizi supporta NitroTPM e l’avvio protetto UEFI?
UEFI	No	No
BIOS legacy	Sì	No
UEFI	Sì	No
UEFI preferito	Sì	No

Filtrare le istanze VM

Un’istanza AWS EC2 che si utilizza come VM del profilo macchina deve essere compatibile affinché il catalogo macchine possa essere creato e funzionare correttamente. Per elencare le istanze AWS EC2 che possono essere utilizzate come VM di input del profilo macchina, è possibile utilizzare il comando Get-HypInventoryItem. Il comando può impaginare e filtrare l’inventario delle VM disponibili su un’unità di hosting.

Impaginazione:

Get-HypInventoryItem supporta due modalità di impaginazione:

La modalità di impaginazione utilizza i parametri -MaxRecords e -Skip per restituire set di elementi:
- -MaxRecords: Il valore predefinito è 1. Questo controlla quanti elementi restituire.
- -Skip: Il valore predefinito è 0. Questo controlla quanti elementi saltare dall’inizio assoluto (o dalla fine assoluta) dell’elenco nell’hypervisor.
La modalità di scorrimento utilizza i parametri -MaxRecords, -ForwardDirection e -ContinuationToken per consentire lo scorrimento dei record:
- -ForwardDirection: Il valore predefinito è True. Questo viene utilizzato insieme a -MaxRecords per restituire il set successivo di record corrispondenti o il set precedente di record corrispondenti.
- -ContinuationToken: Restituisce gli elementi immediatamente dopo (o prima se ForwardDirection è false) ma non include l’elemento specificato in ContinuationToken.

Esempi di impaginazione:

Per restituire un singolo record del modello di macchina con il nome più basso. Il campo AdditionalData ha TotalItemsCount e TotalFilteredItemsCount:
```
 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template
 
```

Per restituire 10 record del modello di macchina con il nome più basso:

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 10 | select Name
 <!--NeedCopy-->

Per restituire un array di record che terminano con il nome più alto:

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ForwardDirection $False -MaxRecords 10 | select Name
 <!--NeedCopy-->

Per restituire un array di record che iniziano dal modello di macchina associato a ContinuationToken:

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ContinuationToken "ami-07xxxxxxxxxx" -MaxRecords 10
 <!--NeedCopy-->

Filtro:

I seguenti parametri opzionali aggiuntivi sono supportati per il filtro. È possibile combinare questi parametri con le opzioni di paginazione.

-ContainsName "my_name": Se la stringa fornita corrisponde a una parte di un nome AMI, l’AMI viene inclusa nel risultato Get. Ad esempio:

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -ContainName ‘apollo’ | select Name
 <!--NeedCopy-->

-Tags '{ "Key0": "Value0", "Key1": "Value1", "Key2": "Value2" }': Se un’AMI ha almeno uno di questi tag, viene inclusa nel risultato Get. Ad esempio:
```
 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -Tags '{"opex owner": "Not tagged"}' | select Name
 
```
Nota:

Sono supportati due valori di tag. Il valore del tag Non taggato corrisponde agli elementi che non hanno il tag specificato nel loro elenco di tag. Il valore del tag Tutti i valori corrisponde agli elementi che hanno il tag indipendentemente dal valore del tag. Altrimenti, la corrispondenza avviene solo se l’elemento ha il tag e il valore è uguale a quello specificato nel filtro.

-Id "ami-0a2d913927e0352f3": Se l’AMI corrisponde all’ID fornito, viene inclusa nel risultato Get. Ad esempio:

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -Id ami-xxxxxxxxxxxxx
 <!--NeedCopy-->

Filtro sul parametro AdditionalData:

Il parametro di filtro AdditionalData elenca i modelli o le VM in base alla loro capacità, offerta di servizio o qualsiasi proprietà presente in AdditionalData. Ad esempio:

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200).AdditionalData
<!--NeedCopy-->

È inoltre possibile aggiungere un parametro -Warn per indicare le VM incompatibili. Le VM sono incluse con un campo AdditionalData denominato Avviso. Ad esempio:

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200 -Template "ami-015xxxxxxxxx" -Warn $true).AdditionalData
<!--NeedCopy-->

Elenco SKU di backup per le VM

I cloud pubblici possono talvolta esaurire la capacità per un tipo di istanza EC2 specifico (SKU primario). Se la configurazione VM primaria non è disponibile, la VM non può avviarsi, con conseguente perdita di tempo e interruzione dell’attività. Per affrontare tali scenari, fornire un elenco di tipi di istanza EC2 di backup (SKU di backup) a cui MCS può ricorrere in caso di problemi legati alla capacità.

Utilizzare una proprietà personalizzata BackupVmConfiguration durante la creazione o l’aggiornamento di un catalogo di macchine MCS per fornire un elenco di tipi di istanza EC2 di backup (Elenco SKU di backup).

Se l’istanza EC2 primaria non riesce, MCS tenta di ricorrere ai tipi di istanza EC2 di backup nell’ordine specificato. Se MCS non è in grado di ricorrere a nessuno dei tipi di istanza EC2 di backup forniti, viene visualizzato un messaggio di errore. È quindi possibile provare ad accendere nuovamente l’istanza EC2 primaria. Se l’operazione non riesce, MCS riprova con i tipi di istanza EC2 di backup.

L’elenco SKU di backup può contenere istanze on-demand.

Questa funzionalità è applicabile a cataloghi di macchine MCS sia persistenti che non persistenti.

Considerazioni importanti

È possibile fornire più tipi di istanza EC2 di backup nell’elenco SKU di backup.
L’elenco SKU di backup deve essere univoco.
Un’istanza EC2 di backup non può essere uguale all’istanza EC2 primaria.
Le istanze EC2 di backup devono essere tipi di istanza AWS validi.
Non specificare offerte di servizi duplicate. Esempio: BackupVmConfiguration,t2.small|t3.small|t2.small non è valido.
L’offerta di servizi specificata nell’elenco deve essere compatibile con la configurazione del catalogo di macchine. Ad esempio, se il catalogo utilizza UEFI e l’offerta di servizi specificata nell’elenco di backup non lo supporta, la creazione o l’aggiornamento del catalogo non riesce durante il preflight.
È possibile modificare l’elenco SKU di backup di un catalogo esistente utilizzando il comando PowerShell Set-ProvScheme. È possibile modificare le VM esistenti utilizzando i comandi PowerShell Set-ProvVM e Set-ProvVMUpdateTimeWindow.

Configurare le istanze EC2 di backup

Aprire una finestra PowerShell.
Eseguire asnp citrix\* per caricare i moduli PowerShell specifici di Citrix.
Creare un catalogo Broker.
Creare un pool di identità.

Aggiungere un elenco di istanze EC2 di backup utilizzando la proprietà personalizzata BackupVmConfiguration e creare uno schema di provisioning. Ad esempio:

$serviceOffering = "XDHyp:\HostingUnits\$hostingUnitName\T3 Medium Instance.serviceoffering"
$customProperties = "AwsCaptureInstanceProperties,false;AwsOperationalResourcesTagging,false;BackupVmConfiguration,t2.small|t2.large|t3.small|t3.large;"
$createdProvScheme = New-ProvScheme -ProvisioningSchemeName $provisioningSchemeName -HostingUnitName $hostingUnitName -IdentityPoolName $provisioningSchemeName -NetworkMapping $networkMapping -SecurityGroup $securityGroupPath -ServiceOffering $serviceOffering -MasterImageVM $masterImageVm -CustomProperties $customProperties
<!--NeedCopy-->

Aggiornare il BrokerCatalog con l’ID univoco dello schema di provisioning.
Creare e aggiungere VM al catalogo.

Dove andare dopo

Se questo è il primo catalogo creato, Web Studio ti guida a creare un gruppo di consegna
Per rivedere l’intero processo di configurazione, vedere Installazione e configurazione
Per gestire i cataloghi, vedere Gestire i cataloghi di macchine e Gestire un catalogo AWS

Ulteriori informazioni

La versione ufficiale di questo prodotto è in lingua inglese. Qualsiasi versione non in lingua inglese viene fornita unicamente per comodità dell'utente e può includere contenuti oggetto di traduzione automatica. Per ulteriori informazioni, fare riferimento al Machine Translation Disclaimer di cui alla pagina Cloud Software Group home.

È stato utile?

Crea un catalogo AWS

May 31, 2026

Grazie al contributo di:

May 31, 2026

Grazie al contributo di:

In questo articolo

Limitazione
Impostazioni di rete durante la preparazione dell’immagine
Configurare la tenancy AWS
Acquisire le proprietà della macchina dai profili macchina
Assegnare tag alle risorse operative AWS
Copiare i tag sulle VM
Creare un catalogo usando un profilo macchina
Catalogo abilitato per MCSIO
Crittografare i dischi OS, ID e WBC
Abilitare NitroTPM e l’avvio protetto UEFI per le istanze VM
Filtrare le istanze VM
Elenco SKU di backup per le VM
Dove andare dopo
Ulteriori informazioni

È stato utile?