Citrix DaaS

Creare un catalogo di AWS

In Creare cataloghi di macchine sono descritte le procedure guidate per la creazione di un catalogo di macchine. Le informazioni che seguono riguardano i dettagli specifici degli ambienti di virtualizzazione AWS.

Nota:

Prima di creare un catalogo di AWS, è necessario completare la creazione di una connessione ad AWS. Vedere Connessione ad AWS.

Impostazioni di rete durante la preparazione dell’immagine

Durante la preparazione dell’immagine, viene creata una macchina virtuale (VM) di preparazione basata sulla macchina virtuale originale. Questa macchina virtuale di preparazione è disconnessa dalla rete. Per disconnettere la rete dalla macchina virtuale 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 il GUID viene generato casualmente.

Tenancy di AWS

AWS offre le seguenti opzioni di tenancy: tenancy condivisa (il tipo predefinito) e tenancy dedicata. “Tenacy condivisa” significa che più istanze di Amazon EC2 di clienti diversi potrebbero risiedere sullo stesso componente hardware fisico. “Tenancy dedicata” significa che le istanze di EC2 vengono eseguite solo su hardware con altre istanze distribuite. Gli altri clienti non utilizzano lo stesso hardware.

È possibile utilizzare MCS per eseguire il provisioning di host AWS dedicati utilizzando l’interfaccia Full Configuration (Configurazione completa) o PowerShell.

Configurare la tenancy dell’host AWS dedicato utilizzando l’interfaccia Full Configuration (Configurazione completa)

Quando si utilizza MCS per creare un catalogo per il provisioning delle macchine in AWS, la pagina Machine Catalog Setup > Security (Configurazione del catalogo delle macchine > Sicurezza) presenta le seguenti opzioni:

  • Use shared hardware (Usa hardware condiviso). Questa impostazione è adatta per la maggior parte delle distribuzioni. Più clienti condividono componenti hardware anche se non interagiscono tra loro. L’utilizzo di hardware condiviso è l’opzione meno costosa per l’esecuzione delle istanze di Amazon EC2.

  • Use dedicated host (Usa un host dedicato). Un host dedicato di Amazon EC2 è un server fisico con capacità di istanza EC2 completamente dedicata, che consente di utilizzare licenze software esistenti per socket o per macchina virtuale. Gli host dedicati hanno un utilizzo preimpostato in base al tipo di istanza. Ad esempio, un singolo host dedicato allocato di tipi di istanza C4 Large è limitato all’esecuzione di 16 istanze. Per ulteriori informazioni, consultare il sito di AWS.

    I requisiti per il provisioning sugli host AWS includono:

    • Un’immagine BYOL (Bring Your Own License) importata (AMI). Con host dedicati, utilizzare e gestire le licenze esistenti.
    • Un’allocazione di host dedicati con un utilizzo sufficiente per soddisfare le richieste di provisioning.
    • Abilitazione del posizionamento automatico.

    Questa impostazione è adatta per le distribuzioni con restrizioni di licenza o requisiti di sicurezza che richiedono l’uso di un host dedicato. Con un host dedicato, si possiede un intero host fisico e l’addebito viene effettuato su base oraria. La proprietà di tale host consente di avviare tante istanze EC2 quante ne consente l’host, senza costi aggiuntivi.

    In alternativa, è possibile effettuare il provisioning di host AWS dedicati tramite PowerShell. A tale scopo, utilizzare il cmdlet New-ProvScheme con il parametro TenancyType impostato su Host. Per ulteriori informazioni, consultare la documentazione per gli sviluppatori Citrix.

  • Use dedicated instance (Usa un’istanza dedicata). Questa impostazione è più adatta per le distribuzioni con requisiti di sicurezza o conformità specifici. Con un’istanza dedicata, si hanno comunque i vantaggi di avere un host separato dagli altri clienti AWS, ma non si paga per l’intero host. La capacità dell’host non è motivo di preoccupazione, ma viene addebitata una tariffa più alta per le istanze.

Configurare la tenancy dell’host AWS dedicato utilizzando PowerShell

È possibile creare un catalogo di macchine con tenancy 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 macchina virtuale.

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

I requisiti per il provisioning sugli host AWS includono:

  • Un’immagine BYOL (Bring Your Own License) importata (AMI). Con host dedicati, utilizzare e gestire le licenze esistenti.
  • Un’allocazione di host dedicati con un utilizzo sufficiente per soddisfare le richieste di provisioning.
  • abilitare il posizionamento automatico.

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 ulteriori informazioni, consultare la documentazione per gli sviluppatori Citrix.

Acquisire la proprietà dell’istanza AWS

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 tale AMI, MCS utilizza una snapshot del disco. Nelle versioni precedenti, se si voleva avere 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à delle istanze AWS, è necessario disporre di una macchina virtuale associata all’AMI.

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

Le proprietà acquisite includono:

  • Ruoli IAM: applicati alle istanze di cui è stato eseguito il provisioning.
  • Tag: applicati alle istanze di cui è stato eseguito il provisioning, il relativo disco e le NIC. Questi tag vengono applicati alle risorse Citrix transitorie, tra cui: bucket e oggetti S3, AMI, snapshot e modelli di avvio.

Suggerimento:

L’etichettatura delle risorse Citrix transitorie è facoltativa ed è configurabile utilizzando la proprietà personalizzata AwsOperationalResourcesTagging. Per applicare correttamente i tag e creare un catalogo di AWS con tag delle risorse operative, non eliminare l’istanza EC2 utilizzata per creare l’immagine AMI.

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 ulteriori informazioni, consultare la documentazione per gli sviluppatori Citrix.

Nota:

AwsCaptureInstanceProperties è obsoleto.

Applicare le proprietà delle istanze AWS e assegnare tag alle risorse operative nell’interfaccia Full Configuration

Quando si crea un catalogo per il provisioning delle 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 tag delle macchine alle risorse operative. Sono disponibili le due opzioni seguenti:

Proprietà dei tag delle macchine e dei modelli AWS

  • Apply machine template properties to virtual machines (Applica le proprietà dei modelli di macchine alle macchine virtuali)
    • Controlla se applicare il ruolo IAM e le proprietà dei tag associati al modello di macchina selezionato alle macchine virtuali in questo catalogo.
  • Apply machine tags to operational resources (Applica i tag delle macchine alle risorse operative)
    • Controlla se applicare i tag delle macchine a ogni elemento creato nell’ambiente AWS che facilita il provisioning delle macchine. Le risorse operative vengono create come sottoprodotti della creazione del catalogo. Includono risorse sia temporanee che persistenti, come l’istanza delle macchine virtuali di preparazione e l’AMI.

Applicare tag a una risorsa operativa AWS

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. È possibile utilizzare un’AMI per distribuire servizi che utilizzano l’ambiente EC2. Quando si crea un catalogo per eseguire il provisioning di macchine utilizzando MCS per AWS, selezionare l’AMI che funge da immagine golden per quel catalogo.

Importante:

La creazione di cataloghi mediante l’acquisizione di una proprietà di istanza e di un modello di avvio è necessaria per utilizzare la codifica delle risorse operative.

Per creare un catalogo di AWS, è necessario innanzitutto creare un’AMI per l’istanza in cui si desidera collocare l’immagine golden. MCS legge i tag di quell’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 delle macchine virtuali
  • Interfacce di rete delle macchine virtuali
  • Bucket S3
  • Oggetti S3
  • Modelli di lancio
  • AMI

Applicare tag a una risorsa operativa

Per utilizzare PowerShell per etichettare le risorse:

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

Per etichettare una risorsa per una macchina virtuale di cui è stato eseguito il provisioning, utilizzare la nuova proprietà personalizzata AwsOperationalResourcesTagging. La sintassi di questa proprietà è la seguente:

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

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 di cui è stato effettuato il provisioning. Le proprietà acquisite possono includere, ad esempio, le proprietà del volume EBS, il tipo di istanza, l’ottimizzazione EBS, la grafica elastica e altre configurazioni AWS supportate.

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

Nota:

Le proprietà del volume EBS derivano solo dal profilo di una macchina.

Considerazioni importanti

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

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

    **Nota:

    AwsCaptureInstanceProperties è obsoleto.

  • È necessario fornire esplicitamente i valori delle seguenti proprietà:

    • TenancyType
    • Gruppo di sicurezza
    • NIC 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 di macchine MCS sono:

  • Solo le nuove macchine virtuali aggiunte al catalogo sono interessate dalla modifica.
  • Non è possibile trasformare un catalogo da basato su profili di macchina in non basato su profili macchina.

Creare un catalogo di macchine utilizzando un profilo macchina

Per creare un catalogo di macchine utilizzando un profilo macchina:

  1. Aprire una finestra di PowerShell.
  2. Eseguire il comando 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 ulteriori informazioni, vedere Citrix PowerShell SDK.

Per aggiornare il profilo macchina su un catalogo di cui inizialmente era stato effettuato il provisioning con un profilo macchina:

  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 di macchine MCS con una versione del modello di avvio come input per il profilo macchina. È inoltre possibile aggiornare l’input di un catalogo di profili di macchina da una macchina virtuale a una versione del modello di avvio e da una versione del modello di avvio a una macchina virtuale.

Sulla 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 dei VDA di cui è stato eseguito il 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 sono forniti 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 servizi non è fornita nel modello di avvio con profilo macchina o come parametro nel comando New-ProvScheme, viene visualizzato 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 il comando 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" `
    -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-->
    

    È anche possibile ignorare parametri quali offerta di servizi, gruppi di sicurezza, tenancy e reti. 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-01xxxx).launchtemplate\lt-01xxxx (1).launchtemplateversion" `
    -ServiceOffering "XDHyp:\HostingUnits\xxxd-ue1a\T3 Large Instance.serviceoffering"
    <!--NeedCopy-->
    
  6. Registrare lo schema di provisioning come catalogo del 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 ulteriori informazioni, vedere Citrix PowerShell SDK.

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

  • Per aggiornare l’input di un catalogo di profili macchina da una macchina virtuale 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 macchina virtuale:

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

Creare un catalogo di macchine virtuali abilitate con l’acceleratore Grafica elastica

Utilizzando un flusso di lavoro basato sul profilo macchina, è possibile creare un catalogo di macchine virtuali abilitate con l’acceleratore Grafica elastica. È possibile utilizzare una macchina virtuale e un modello di avvio come input del profilo macchina.

I passaggi dettagliati per creare un catalogo sono:

  1. Abilitare un acceleratore Grafica elastica su una macchina virtuale o su un modello di avvio. Per informazioni sull’attivazione dell’acceleratore Grafica elastica, vedere Utilizzo di Grafica elastica.
  2. Verifica il tipo di acceleratore Grafica elastica utilizzato dalla macchina virtuale o dalla versione del modello di avvio. Se la chiave ElasticGpuType non è presente nei dati aggiuntivi, la macchina virtuale o il modello di avvio non hanno l’acceleratore Grafica elastica abilitato.

    • Ad esempio: per una macchina virtuale

       (Get-Item -LiteralPath 'XDHyp:\HostingUnits\abc-resources\us-eat-1a.availibilityzone\abcelastic (i-0584xxxxxab8b2206).vm').AdditionalData
       <!--NeedCopy-->
      
    • Ad esempio: per un modello di lancio

       (Get-Item -LiteralPath 'XDHyp:\HostingUnits\abc-resources\ElasticGC (lt-015f531351188cd2e).launchtemplate\lt-015f531351188cd2e (1).launchtemplateversion).AdditionalData
       <!--NeedCopy-->
      
  3. Creare un catalogo di macchine MCS con il flusso di lavoro dei profili macchina, selezionando una VM o specifiche del modello. È possibile creare il catalogo delle macchine utilizzando Web Studio o eseguendo i comandi PowerShell.

Nota:

Il catalogo di macchine deve soddisfare i prerequisiti di Grafica elastica per una corretta creazione del catalogo di macchine. Pertanto, assicurati che il tipo di istanza EC2 sia compatibile con Grafica elastica. Per informazioni, vedere Nozioni di base su Grafica elastica.

Filtrare le istanze di VM

Un’istanza di macchina virtuale AWS che si usa come macchina virtuale con profilo macchina deve essere compatibile perché il catalogo macchine venga creato e funzioni correttamente. Per elencare le istanze di macchine virtuali AWS che possono essere utilizzate come macchine virtuali di input per il profilo macchina, è possibile utilizzare il comando Get-HypInventoryItem. Il comando può effettuare il paging e filtrare l’inventario delle VM disponibili su un’unità di hosting.

Paging:

Get-HypInventoryItem supporta due modalità di paging:

  • La modalità di paging utilizza i parametri -MaxRecords e -Skip per restituire set di elementi:
    • -MaxRecords: l’impostazione predefinita è 1. Questo controlla quanti elementi restituire.
    • -Skip: l’impostazione predefinita è 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: l’impostazione predefinita è True. Questa viene utilizzata con -MaxRecords per restituire il set successivo di record corrispondenti o il precedente set di record corrispondenti.
    • -ContinuationToken: restituisce gli elementi immediatamente dopo (o prima se ForwardDirection è falso) ma non include l’articolo indicato nel ContinuationToken.

Esempi di paging:

  • 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 dieci 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 una matrice di record che termina con il nome più alto:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ForwardDirection $False -MaxRecords 10 | select Name
     <!--NeedCopy-->
    
  • Per restituire una matrice di record a partire dal modello di macchina associato al ContinuationToken dato:

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

Filtraggio:

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

  • -ContainsName "my_name": se la stringa specificata corrisponde a una parte del nome AMI, l’AMI viene incluso nel risultato di 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 incluso nel risultato di 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 del tag Not Tagged corrisponde agli elementi che non contengono il tag specificato nel loro elenco di tag. Il valore del tag All values corrisponde agli elementi che contengono il tag indipendentemente dal valore del tag. Altrimenti, la corrispondenza avviene solo se l’elemento contiene il tag e il valore è uguale a quello indicato nel filtro.

  • -Id "ami-0a2d913927e0352f3": se l’AMI corrisponde all’ID specificato, viene incluso nel risultato di Get. Ad esempio:

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

Filtraggio in base al parametro AdditionalData:

Il parametro di filtraggio AdditionalData elenca i modelli o le macchine virtuali 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 macchine virtuali incompatibili. Le macchine virtuali sono incluse in un campo AdditionalData denominato Warning (Avviso). Ad esempio:

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

Passaggi successivi

Ulteriori informazioni