Creare un catalogo AWS

Creare cataloghi di macchine 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 Connessione ad AWS.

Limitazione

A partire da Citrix Virtual Apps and Desktops™ 2203 LTSR e versioni successive, il plug-in MCS AWS effettua una 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 CVAD 1912 a 2203 o versioni successive, 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 viene 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 possono 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 la tenancy dell’host definita tramite PowerShell.

Un host dedicato Amazon [EC2] è 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 basato sul 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 a soddisfare le richieste di provisioning.
• abilitare l’auto-posizionamento.

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 dalle AMI

Quando si crea un catalogo per il provisioning di macchine utilizzando Machine Creation Services (MCS) in AWS, si seleziona un’AMI per rappresentare l’immagine master/golden di quel catalogo. Da quell’AMI, MCS utilizza uno snapshot del disco. Nelle versioni precedenti, se si desideravano ruoli o tag sulle macchine, si utilizzava la console AWS per impostarli individualmente. Questa funzionalità è abilitata per impostazione predefinita.

Suggerimento:

Per utilizzare l’acquisizione delle proprietà dell’istanza AWS, è necessario disporre di una VM associata all’AMI.

Per migliorare questo processo, MCS legge le proprietà dall’istanza da cui è stata acquisita l’AMI e applica il ruolo e i tag di Identity Access Management (IAM) della macchina alle macchine di cui è stato eseguito il provisioning per un determinato catalogo. Quando si utilizza questa funzionalità opzionale, il processo di creazione del catalogo individua l’istanza di origine AMI selezionata, leggendo un set limitato di proprietà. Queste proprietà vengono quindi archiviate in un modello di avvio AWS, che viene utilizzato per il provisioning delle macchine per quel catalogo. Qualsiasi macchina nel catalogo eredita le proprietà dell’istanza acquisite.

Le proprietà acquisite includono:

• Ruoli IAM – applicati alle istanze sottoposte a provisioning.
• Tag – applicati alle istanze sottoposte a provisioning, ai relativi dischi e alle NIC. Questi tag vengono applicati alle risorse Citrix® temporanee, tra cui: bucket e oggetti S3, AMI, snapshot e modelli di avvio.

Suggerimento:

L’assegnazione di tag alle risorse Citrix temporanee è facoltativa ed è configurabile utilizzando la proprietà personalizzata AwsOperationalResourcesTagging.

Acquisire la proprietà dell’istanza AWS

È possibile utilizzare questa funzionalità specificando una proprietà personalizzata, AwsCaptureInstanceProperties, durante la creazione di uno schema di provisioning per una connessione di hosting AWS:

New-ProvScheme -CustomProperties "AwsCaptureInstanceProperties,true" …<standard provscheme parameters

Per maggiori informazioni, consultare la documentazione per sviluppatori Citrix.

Nota:

Il AwsCaptureInstanceProperties è deprecato. Si consiglia invece di utilizzare i profili macchina per specificare le proprietà della macchina per le VM.

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:

1. Archiviare i profili macchina nella stessa zona di disponibilità delle risorse in cui si sta creando questo catalogo.
2. 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.
3. Selezionare un profilo macchina secondo necessità.

Nota:

È possibile utilizzare un profilo macchina o un’AMI per acquisire le proprietà della macchina. In Web Studio, quando si seleziona Usa un profilo macchina, l’opzione Applica le proprietà del modello macchina alle macchine virtuali viene automaticamente nascosta.

Assegnare tag alla risorsa operativa 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 acquisendo una proprietà dell’istanza e 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, tra cui:

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

Assegnare un tag a una risorsa operativa

Per usare PowerShell per assegnare tag alle risorse:

1. Aprire una finestra PowerShell dall’host DDC.
2. 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, utilizzare la nuova proprietà personalizzata AwsOperationalResourcesTagging. La sintassi per questa proprietà è:

New-ProvScheme -CustomProperties "AwsCaptureInstanceProperties,true; AwsOperationalResourcesTagging,true" …<standard provscheme parameters>

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 ai cataloghi macchine e alle 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 utilizzando 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, le proprietà del volume EBS, il tipo di istanza, l’ottimizzazione EBS, le opzioni CPU, il tipo di tenancy, la 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 derivano solo da un profilo macchina.
• MCS esegue il provisioning di VM con dischi di identità di tipo di 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:

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

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

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

4. 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-->
   

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

Aggiornare il profilo macchina

Per aggiornare il profilo macchina su un catalogo inizialmente fornito con un profilo macchina, eseguire le seguenti operazioni. È anche possibile modificare il tipo di tenancy e la capacità di ibernazione dell’origine del profilo macchina durante la modifica di un catalogo macchine MCS.

1. 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. È 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.

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 servizio
• 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:

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

3. 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-->
   

4. 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-->
   

5. 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-->
   

6. 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-->
   

7. 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 di 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-->
  

Crittografia dischi OS e ID

È possibile creare cataloghi di VM persistenti e non persistenti con chiavi AWS KMS (chiave gestita dal cliente e chiave gestita da AWS) che possono essere utilizzate per crittografare il disco del sistema operativo e il disco di identità.

• 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.

È possibile consultare i seguenti documenti AWS per maggiori informazioni sulle chiavi KMS:

• Concetti di AWS KMS
• Come funziona la rotazione automatica delle chiavi.

Per la crittografia dei dischi del sistema operativo e di identità, 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 contiene 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. Creare un nuovo volume da quello snapshot.
  3. Crittografare 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 macchine MCS con crittografia del disco utilizzando:

• Immagine master
• Profilo macchina

Considerazioni sull’utilizzo dell’input del profilo macchina per la crittografia del disco:

• 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 c’è alcuna chiave nell’origine del profilo macchina e l’immagine master non è crittografata, i dischi delle VM del catalogo non sono 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 Set-ProvScheme per avere:

• Un input del profilo macchina con un volume contenente una nuova chiave KMS.
• Un’AMI del 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, 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

1. Configurare l’ambiente AWS.
2. Creare una connessione ad AWS.
3. Creare un’immagine master (AMI) abilitata con NitroTPM e/o avvio protetto UEFI.
4. Creare 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.

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

1. È possibile creare un’AMI da una VM che ha NitroTPM e/o l’avvio protetto UEFI abilitati.

   1. Creare l’istanza utilizzando le immagini del marketplace AWS. Ad esempio, cercare TPM-Windows_Server-2022-English-Full-Base on the aws-marketplace.
   2. Scaricare VDA a sessione singola o multipla.
   3. Creare un’AMI da quella VM.

2. Utilizzare il comando register-image:

   --boot-mode (string)
   --tpm-support (string)
   <!--NeedCopy-->
   

   Per maggiori informazioni, vedere register-image.

Vedere i seguenti documenti AWS:

• Determinare le modalità di avvio supportate di un tipo di istanza EC2
• Requisiti per l’utilizzo di NitroTPM con istanze Amazon EC2 /.

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

• servizio offerto 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-->
  

• 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 il servizio offerto del catalogo esistente

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

Filtra 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 includendo 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
   <!--NeedCopy-->
  

• 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 a partire dal modello di macchina associato al ContinuationToken specificato:

   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 impaginazione.

• -ContainsName "my_name": Se la stringa specificata 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
   <!--NeedCopy-->
  

  Nota:

  Sono supportati due valori di tag. Il valore di tag Non taggato corrisponde agli elementi che non hanno il tag specificato nel loro elenco di tag. Il valore di 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 specificato, 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à, all’offerta di servizi o a qualsiasi proprietà presente in AdditionalData. Ad esempio:

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

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

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

Passi successivi

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

Ulteriori informazioni

• Creare e gestire connessioni e risorse
• Connessione ad AWS
• Creare cataloghi di macchine