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

Crea un catalogo di istanze gestite di Amazon WorkSpaces Core

May 31, 2026
Grazie al contributo di: 
C

Crea cataloghi di macchine descrive le procedure guidate che creano un catalogo di macchine. Le seguenti informazioni riguardano i dettagli specifici delle istanze gestite di Amazon WorkSpaces Core.

Nota:

Attualmente, è supportata la creazione di cataloghi di VM sia persistenti che non persistenti (la proprietà CleanOnBoot è True o False).

Prerequisiti

Prima di creare un catalogo di istanze gestite di Amazon WorkSpaces Core, è necessario completare la creazione di:

  1. Una connessione alle istanze gestite di Amazon WorkSpaces Core. Vedere Connessione alle istanze gestite di Amazon WorkSpaces Core
  2. Un’immagine preparata. Vedere Creare un’immagine preparata per le istanze gestite di Amazon WorkSpaces Core.

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.

Un catalogo di macchine basato su 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 sottoposte a provisioning. Le proprietà acquisite possono includere, ad esempio, il tipo di tenancy, il tipo di istanza, i gruppi di sicurezza, le mappature di rete, le proprietà del volume EBS, l’ottimizzazione EBS, le opzioni CPU, 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:

Tenancy AWS

AWS offre le seguenti opzioni di tenancy: tenancy condivisa (il tipo predefinito) e tenancy dedicata. La tenancy condivisa significa che più istanze Amazon WorkSpaces Core di clienti diversi potrebbero risiedere sullo stesso hardware fisico. La tenancy dedicata significa che le istanze Amazon WorkSpaces Core vengono eseguite solo su hardware con altre istanze che sono state distribuite.

Nota:

Sono supportate solo le istanze dedicate (gli host dedicati non sono attualmente supportati). Altri clienti non utilizzano lo stesso hardware.

Il tipo di tenancy viene acquisito dal profilo della macchina

Quando si utilizza MCS per creare un catalogo per il provisioning di macchine in AWS, il tipo di tenancy viene acquisito dal profilo della macchina.

  • Hardware condiviso: questa impostazione è adatta per la maggior parte delle distribuzioni. Più clienti condividono parti di hardware anche se non interagiscono tra loro. L’utilizzo di hardware condiviso è l’opzione meno costosa per l’esecuzione delle istanze Amazon EC2.
  • Istanza dedicata: questa impostazione è più adatta per distribuzioni con requisiti specifici di sicurezza o conformità. Con un’istanza dedicata, si godono comunque i vantaggi di avere un host separato dagli altri clienti AWS, ma non si paga per l’intero host. Non è necessario preoccuparsi della capacità dell’host, ma viene addebitata una tariffa più alta per le istanze. Inoltre, le istanze dedicate forniscono un supporto limitato per Bring Your Own License (BYOL).

Per la creazione di cataloghi di istanze gestite di Amazon WorkSpaces Core sono necessari un’immagine preparata e un profilo della macchina. È possibile utilizzare un’istanza VM AWS o una versione del modello di avvio AWS come input del profilo della macchina.

È possibile creare un catalogo utilizzando:

Creare un catalogo utilizzando Web 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. Immettere 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, SO multi-sessione.

  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à o zona locale) configurate durante la creazione della connessione host e fare clic su Avanti.
  5. Nella pagina Esperienza desktop, selezionare il 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 macchina predefinita, basata sul profilo macchina. Per modificarla, selezionare l’icona di modifica e selezionare una specifica macchina.
  8. Nella pagina NIC, selezionare le NIC (o ENI) per le VM.

  9. Nella pagina Identità macchina, configurare il tipo di identità macchina per le macchine nel catalogo:

    1. Per configurare macchine aggiunte a un dominio (Active Directory locale o Microsoft Entra ibrido), selezionare il dominio e creare nuovi account AD per le VM da creare in questo catalogo di macchine. Le VM con provisioning vengono aggiunte al dominio selezionato. Per eseguire il provisioning di macchine non aggiunte a un dominio, selezionare l’opzione di non aggiunta a un dominio.
    2. Specificare lo schema di denominazione degli account per i nuovi account da creare per le VM.
  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. È anche possibile utilizzare un account di servizio se si dispone di credenziali di dominio già salvate in precedenza seguendo la nostra documentazione del prodotto.
  11. Fare clic sulle pagine rimanenti fino alla pagina Riepilogo. Immettere un nome per il catalogo di macchine e selezionare Fine per creare il catalogo di macchine.

Limitazioni sulla creazione di un catalogo di macchine in una zona locale AWS

  • Alcune zone locali supportano solo determinate configurazioni hardware (ad esempio, la zona locale di Perth non supporta i volumi GP3, ma solo i GP2).
  • Poiché solo gp2 è universalmente supportato in tutte le zone locali, e non tutte supportano gp3, la creazione del disco ID utilizza per impostazione predefinita il tipo di volume gp2.
  • È necessario selezionare un profilo macchina con specifiche hardware supportate nella zona locale desiderata.
  • Gli snapshot delle AMI delle immagini preparate e gli snapshot dei dischi ID vengono per impostazione predefinita posizionati nella regione, anziché nella zona locale (a causa delle limitazioni di AWS relative alla visibilità del supporto degli snapshot EBS nelle zone locali).
  • Solo le zone locali che supportano i servizi EC2 ed EBS completi sono zone supportate.

Creare un catalogo utilizzando PowerShell

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

  • Creare un catalogo di macchine non persistenti MCS dalla specifica di 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 persistenti MCS dalla specifica di 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 "wsccatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"

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

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

$Task = New-ProvScheme -ProvisioningSchemeName wsccatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName wsc -IdentityPoolName wsccatalog -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 wsccatalog

Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

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 di 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 utilizzando PowerShell

È possibile creare un catalogo di 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 di macchine, le proprietà di quella versione del modello di avvio vengono copiate nelle VM VDA sottoposte a provisioning.

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

Nota:

Se l’offerta di servizi 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 di 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 è già 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" `
-ImageVersionSpecUid ‘24dfb047-e867-527g-896c-25664xxxxx1t’ `
-CleanOnBoot `
-MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion"
<!--NeedCopy-->

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

Aggiornare l’origine 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. 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 del 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-->

Crittografare i dischi del sistema operativo e ID

È possibile creare un catalogo 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 e il disco di identità (ID).

  • 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 del sistema operativo e ID, configurare una delle seguenti opzioni:

  • Utilizzare un’immagine preparata 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 preparata.

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

Creare un catalogo con crittografia del disco

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

  • Immagine preparata (creata utilizzando la gestione delle immagini da un’immagine master che ha un disco crittografato)
  • 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 preparata.
  • Se non viene fornito alcun input del profilo macchina, la chiave KMS dell’AMI dell’immagine preparata viene utilizzata per crittografare i dischi delle VM del catalogo.
  • Se il profilo macchina presenta mappature di dispositivi a blocchi, i dispositivi a blocchi presenti nel modello di immagine preparata (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 preparata non è crittografata, i dischi delle VM del catalogo non vengono crittografati.
  • Quando l’immagine preparata è 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’immagine preparata creata dall’immagine master con AMI crittografata utilizzando la gestione delle immagini.

Considerazioni importanti:

  • I volumi delle nuove VM aggiunte al catalogo vengono 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 di immagine preparata crittografata a un’AMI di immagine preparata non crittografata.

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

Quando si crea un catalogo, è ora possibile selezionare un’immagine preparata (AMI) con NitroTPM e/o avvio protetto UEFI abilitati. Di conseguenza, anche le VM sottoposte a provisioning nel catalogo sono abilitate con NitroTPM e/o 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’immagine preparata dall’immagine master. Vedere Creare un’immagine preparata per le istanze gestite di Amazon WorkSpaces Core.
  5. Creare un catalogo di macchine selezionando l’immagine preparata con NitroTPM e l’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 l’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:

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

  • service offering 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 service offering del catalogo esistente

È possibile modificare il service offering 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? Il service offering supporta NitroTPM e l’avvio protetto UEFI?
UEFI No No
BIOS legacy Sì No
UEFI Sì No
UEFI preferito Sì No

Copia 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 nelle 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), ed eni-1 ha il tag t1 ed eni-2 ha il tag t2, la VM ottiene i tag di entrambe le interfacce di rete.

Filtrare le istanze VM usando PowerShell

Un’istanza VM AWS 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 VM AWS 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 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 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 macchina associato al dato 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 filtraggio. È possibile combinare questi parametri con le opzioni di impaginazione.

  • -ContainsName "my_name": Se la stringa fornita corrisponde a 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-->

È inoltre 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-->

Dove andare dopo

Ulteriori informazioni

Crea un catalogo di istanze gestite di Amazon WorkSpaces Core
May 31, 2026
Grazie al contributo di: 
C
May 31, 2026
Grazie al contributo di: 
C

In questo articolo

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