Documentazione dei prodotti
Citrix DaaS™
Visualizza PDF

Creare un catalogo di istanze gestite di Amazon WorkSpaces Core

September 16, 2025
Grazie al contributo di: 
C

Creare cataloghi macchine descrive le procedure guidate per la creazione di un catalogo macchine. Le seguenti informazioni riguardano i dettagli specifici delle istanze gestite di Amazon WorkSpaces Core.

Nota:

Attualmente, è supportata solo la creazione di cataloghi di VM non persistenti (la proprietà CleanOnBoot è True).

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

  • Le proprietà del volume EBS sono derivate solo da un profilo macchina.
  • È supportato solo il servizio di metadati dell’istanza (IMDS) V2 e non IMDS V1. Per informazioni, vedere How Instance Metadata Service Version 2 works.

Tenancy AWS

AWS offre le seguenti opzioni di tenancy: tenancy condivisa (il tipo predefinito) e tenancy dedicata. La tenancy condivisa significa che più istanze di Amazon WorkSpaces Core di clienti diversi potrebbero risiedere sullo stesso hardware fisico. La tenancy dedicata significa che le istanze di 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 macchina

Quando si utilizza MCS per creare un catalogo per il provisioning di macchine in AWS, il tipo di tenancy viene acquisito dal profilo 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 macchina. È possibile utilizzare un’istanza VM AWS o una versione del modello di avvio AWS come input del profilo macchina.

È possibile creare un catalogo utilizzando:

Creare un catalogo tramite Studio

Creare un catalogo 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 dell’immagine preparata nel flusso di lavoro di creazione del catalogo. Vedere Creare un catalogo macchine dal nodo Cataloghi macchine.

Per creare un catalogo macchine MCS dal nodo Immagini, 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 macchine. Inserire un nome e una descrizione per il catalogo macchine. Fare clic su Fine.
  5. Andare al nodo Cataloghi macchine per visualizzare il catalogo macchine creato.

Creare un catalogo macchine dal nodo Cataloghi macchine

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

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

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

    1. Selezionare Macchine con gestione dell’alimentazione (ad esempio, macchine virtuali o blade PC).
    2. Selezionare Tecnologia di provisioning Citrix. Quindi, selezionare Citrix Machine Creation Services™.
    3. Nel campo Risorse, selezionare le risorse (Zona di disponibilità) configurate durante la creazione della connessione host e fare clic su Avanti.
  5. Nella pagina Esperienza desktop, selezionare un desktop casuale o statico che gli utenti desiderano avere quando accedono.

  6. Nella pagina Immagine, fare clic su Seleziona un’immagine per selezionare un’immagine preparata per il catalogo 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 predefinita della macchina, basata sul profilo macchina. Per modificarla, selezionare l’icona di modifica e selezionare una specifica della macchina.
  8. Nella pagina NIC, selezionare le NIC (o ENI) per le VM.
  9. Nella pagina Identità macchina, configurare Active Directory locale o Azure Active Directory ibrido per le macchine nel catalogo selezionando il dominio e creando nuovi account AD per le VM da creare in questo catalogo macchine. Le VM sottoposte a provisioning vengono unite al dominio selezionato. Specificare lo schema di denominazione degli account per i nuovi account AD da creare per le VM. Fare clic su Avanti.
  10. Nella pagina Credenziali di dominio, fare clic su Immetti credenziali per fornire le credenziali per il dominio selezionato. Immettere nome utente e password a livello di amministratore quando richiesto. È anche possibile utilizzare un account di servizio se sono già state salvate in precedenza le credenziali di dominio seguendo la nostra documentazione del prodotto.
  11. Fare clic sulle pagine rimanenti fino alla pagina Riepilogo. Immettere un nome per il catalogo macchine e selezionare Fine per creare il catalogo macchine.

Creare un catalogo tramite PowerShell

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

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

New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $true] [-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 azure -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 sottoposto a provisioning con un profilo macchina, procedere come segue. È 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 tramite PowerShell

È 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 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 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 viene fornita nel modello di avvio del profilo macchina o come parametro nel comando New-ProvScheme, si riceverà 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" `
-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

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

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

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 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’AMI 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 ha mappature di dispositivi a blocchi presenti, 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 c’è 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 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 l’avvio protetto UEFI abilitati. Di conseguenza, le VM sottoposte a provisioning nel catalogo sono anch’esse 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 l’avvio protetto attualmente in tutte le regioni AWS (incluse le regioni AWS GovCloud (US)) eccetto la 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 l’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 macchine selezionando l’immagine preparata con NitroTPM e l’avvio protetto UEFI abilitati nel menu di creazione del catalogo di Citrix 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 una specifica:

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

  • 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 AMI AMI supporta Nitro TPM? L’offerta di servizi supporta NitroTPM e l’avvio protetto UEFI?
UEFI No No
Legacy BIOS Sì No
UEFI Sì No
UEFI Preferred Sì No

Copiare i tag sulle VM

È possibile copiare i tag su NIC e dischi (disco di identità, disco di cache di scrittura 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 ai cataloghi macchine e alle VM persistenti e non persistenti.

Nota:

  • Nella console AWS EC2, non è possibile visualizzare i valori di Tag Network Interfaces (Tag interfacce di rete) in Launch Template Version Resource Tags (Tag risorsa versione modello di avvio). 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 due interfacce di rete.

Filtrare le istanze VM tramite PowerShell

Un’istanza VM AWS utilizzata 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.

Paginazione:

Get-HypInventoryItem supporta due modalità di paginazione:

  • La modalità di paginazione utilizza i parametri -MaxRecords e -Skip per restituire set di elementi:
    • -MaxRecords: il valore predefinito è 1. Controlla quanti elementi restituire.
    • -Skip: il valore predefinito è 0. 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. 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 paginazione:

  • Per restituire un singolo record del modello di macchina con il nome più basso. Il campo AdditionalData contiene 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 paginazione.

  • -ContainsName "my_name": se la stringa specificata 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 Not Tagged (Non taggato) corrisponde agli elementi che non hanno il tag specificato nel loro elenco di tag. Il valore di tag All values (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à, offerta di servizi o 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-->

Prossimi passi

Ulteriori informazioni

Creare un catalogo di istanze gestite di Amazon WorkSpaces Core
September 16, 2025
Grazie al contributo di: 
C
September 16, 2025
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.