Documentazione dei prodotti
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Visualizza PDF

Gestione delle immagini

January 23, 2026
Grazie al contributo di: 
C

Introduzione

Il processo di creazione o aggiornamento del catalogo MCS ha due fasi:

  • Mastering: un’immagine di origine viene convertita in un’immagine pubblicata
  • Cloning: nuove VM vengono create dall’immagine pubblicata

Con la funzionalità di gestione delle immagini, MCS separa la fase di mastering dal flusso di lavoro complessivo di provisioning.

È possibile preparare varie versioni di immagini MCS (Immagine preparata) da una singola immagine di origine e utilizzarle in più cataloghi di macchine MCS diversi. Questa implementazione riduce significativamente i costi di archiviazione e tempo e semplifica il processo di distribuzione delle VM e di aggiornamento delle immagini.

I vantaggi dell’utilizzo di questa funzionalità di gestione delle immagini sono:

  • Generare immagini preparate in anticipo senza creare un catalogo.
  • Riutilizzare le immagini preparate in più scenari, come la creazione e l’aggiornamento di un catalogo.
  • Ridurre significativamente il tempo di creazione o aggiornamento del catalogo.

Nota:

  • Questa funzionalità è attualmente applicabile agli ambienti di virtualizzazione Azure e VMware.
  • È possibile creare un catalogo di macchine MCS senza utilizzare immagini preparate. In tal caso, non sarà possibile usufruire dei vantaggi della funzionalità.
  • La funzionalità è generalmente disponibile a partire da Citrix Virtual Apps and Desktops™ 2402 LTSR CU2.

Casi d’uso

Alcuni dei casi d’uso della funzionalità di gestione delle immagini sono:

  • Gestione delle versioni: le versioni delle immagini consentono di:

    • gestire diverse iterazioni o aggiornamenti di una particolare immagine.
    • mantenere più versioni di un’immagine per scopi diversi.

  • Raggruppamento logico: è possibile creare più definizioni di immagine per:

    • raggruppare logicamente le versioni delle immagini in base a vari criteri come progetto, reparto o tipo di applicazione e desktop.
    • gestire le immagini in modo più efficiente all’interno di un’organizzazione.

Che cos’è un’immagine preparata?

Con la funzionalità di gestione delle immagini, MCS disaccoppia la fase di mastering dal flusso di lavoro complessivo di creazione o aggiornamento del catalogo e suddivide il processo in due fasi:

  1. Creare immagini preparate da una singola immagine di origine.
  2. Utilizzare l’immagine preparata per creare o aggiornare un catalogo di macchine MCS.

È possibile creare le immagini preparate in anticipo. È possibile utilizzare una singola immagine preparata per creare o aggiornare più cataloghi di macchine con provisioning MCS.

Comprendere come un’immagine preparata viene utilizzata in più cataloghi di macchine MCS quando si utilizza Web Studio dall’immagine:

Panoramica dell'immagine preparata

Definizione dell’immagine: le definizioni dell’immagine sono un raggruppamento logico delle versioni di un’immagine. La definizione dell’immagine contiene informazioni su:

  • il motivo per cui l’immagine è stata creata
  • per quale sistema operativo è destinata
  • altre informazioni sull’utilizzo dell’immagine.

Un catalogo non viene creato da una definizione di immagine, ma dalle versioni dell’immagine create in base alla definizione dell’immagine.

Versione dell’immagine: le versioni dell’immagine gestiscono il versioning per la definizione dell’immagine. Una definizione di immagine può avere più versioni di immagine. Utilizzare le versioni dell’immagine come immagini preparate per creare o aggiornare un catalogo.

In alternativa, se si desidera utilizzare i comandi PowerShell per creare uno schema di provisioning per creare o aggiornare un catalogo, è necessario creare una specifica di versione dell’immagine preparata basata sulla specifica di versione dell’immagine master, come richiesto per il proprio ambiente.

Requisito

  • Per le immagini master di Windows, sono supportate solo le immagini VDA versione 2311 o successive. Il componente MCS/IO deve essere selezionato e installato esplicitamente. L’abilitazione o la disabilitazione della configurazione I/O di MCS deve essere determinata durante la creazione o gli aggiornamenti del catalogo di macchine, poiché non è abilitata per impostazione predefinita.

Limitazioni

Attualmente, la funzionalità non supporta quanto segue:

  • NIC multiple in Azure
  • Funzionalità del disco dati persistente
  • Ibernazione per multi-sessione
  • Modifica del tipo di immagine

Gestione del ciclo di vita dell’immagine tramite Web Studio

Il ciclo di vita dell’immagine quando si utilizza Web Studio è:

  1. Creare un’immagine preparata: creare una definizione di immagine e la sua versione iniziale.
  2. Creare versioni dell’immagine dalla versione iniziale dell’immagine.
  3. Utilizzare una versione dell’immagine come immagine preparata per creare cataloghi.
  4. Aggiornare un catalogo di macchine con un’immagine preparata diversa.
  5. Gestire le definizioni e le versioni delle immagini: modificare il nome e la descrizione delle versioni delle immagini e la descrizione di una definizione di immagine.
  6. Eliminare una versione dell’immagine.
  7. Eliminare una definizione di immagine.

In alternativa, è possibile gestire le immagini anche utilizzando PowerShell. Vedere Gestione del ciclo di vita dell’immagine tramite PowerShell.

Creare o aggiornare un catalogo utilizzando un’immagine preparata

Creare immagini preparate e utilizzare le immagini preparate per creare o aggiornare un catalogo di macchine MCS utilizzando:

Utilizzare Web Studio

Vedere i seguenti argomenti:

Comprendere il nodo Immagini

Utilizzare il nodo Immagini per creare e gestire le immagini preparate da MCS. La sua vista principale è divisa in quattro parti:

vista-principale-nodo-immagine

Etichetta Parte Descrizione
A Definizioni di immagine Elenca le definizioni di immagine create in precedenza.
B Versioni dell’immagine Visualizza le versioni dell’immagine della definizione di immagine selezionata.
C


Dettagli


  • La scheda Dettagli visualizza informazioni dettagliate sulla definizione o versione dell’immagine selezionata, come Immagine master, Risorsa, Hypervisor, nome della definizione dell’immagine, tipo di sistema operativo e tipo di sessione.
  • La scheda Schema immagine visualizza informazioni sul modello utilizzato per la preparazione delle immagini, come disco rigido, dimensione della macchina, tipo di licenza, set di crittografia del disco, profilo della macchina e così via.
  • La scheda Schemi di provisioning visualizza il nome dello schema di provisioning utilizzato per la creazione del catalogo.
  • La scheda Risoluzione dei problemi fornisce lo stato di errore della versione dell’immagine selezionata.
D Barra delle azioni Elenca le azioni che è possibile eseguire su definizioni e versioni di immagini, come Crea versione immagine, Modifica descrizione, Elimina versione immagine e Crea catalogo.

Creare un catalogo di macchine utilizzando l’immagine preparata

I passaggi chiave per creare un catalogo di macchine MCS utilizzando l’immagine preparata sono:

  1. Creare la definizione dell’immagine e le versioni iniziali dell’immagine.
  2. Utilizzare la versione dell’immagine come immagine preparata per creare un catalogo.

Creare una definizione di immagine e la versione iniziale dell’immagine

Per creare una definizione di immagine e la versione iniziale dell’immagine, procedere come segue:

  1. Accedere a Web Studio e selezionare il nodo Immagini. Fare clic su Avanti nella pagina Introduzione.
  2. Nella pagina Definizione immagine, specificare il tipo di sistema operativo e il tipo di sessione per la definizione dell’immagine.

  3. Nella pagina Immagine, selezionare Risorse e un’immagine master da utilizzare come modello per la creazione della versione dell’immagine. È possibile selezionare la casella di controllo Usa un profilo macchina e selezionare un profilo macchina.

    Nota:

    Prima di selezionare un’immagine, verificare che l’immagine master abbia VDA 2311 o versione successiva installata e che il driver MCSIO sia installato sul VDA.

  4. (Solo per Azure) Nella pagina Tipi di archiviazione e licenze, selezionare il tipo di archiviazione e licenza da utilizzare come parte del processo di preparazione dell’immagine.

    Nota:

    Se si seleziona un profilo macchina nella pagina Immagine, il tipo di licenza del profilo macchina viene preselezionato in base all’impostazione del profilo.

  5. Nella pagina Specifiche macchina:

    • Per Azure, selezionare una dimensione della macchina. Se si seleziona un profilo macchina nella pagina Immagine, la dimensione della macchina del profilo macchina viene selezionata per impostazione predefinita.
    • Per VMware, se si seleziona un profilo macchina, è possibile visualizzare il numero di CPU virtuali derivato dal profilo macchina ed è immodificabile. Se non si seleziona un profilo macchina, è possibile visualizzare solo la dimensione della memoria derivata dall’immagine master.

  6. Nella pagina NIC, selezionare o aggiungere NIC per l’immagine di preparazione. Per ogni NIC, selezionare una rete virtuale associata.

    Per VMware, se non si seleziona un profilo macchina, la NIC associata all’immagine master viene selezionata per impostazione predefinita. Se si seleziona un profilo macchina, le NIC vengono derivate dal profilo macchina e il conteggio è immodificabile.

    Nota:

    Le NIC multiple non sono supportate in Azure.

  7. (Solo per Azure) Nella pagina Impostazioni disco, selezionare la chiave di crittografia gestita dal cliente (CMEK). Se il profilo macchina non ha una CMEK ma l’immagine master sì, preseleziona la CMEK dall’immagine master.
  8. Nella pagina Descrizione versione, immettere una descrizione per la versione iniziale dell’immagine creata.
  9. Nella pagina Riepilogo, controllare i dettagli della definizione dell’immagine e della versione iniziale dell’immagine creata. Immettere un nome e una descrizione per la definizione dell’immagine. Fare clic su Fine.

Creare versioni dell’immagine

Le versioni delle immagini consentono la gestione di diverse iterazioni o aggiornamenti di una particolare immagine. Questa funzionalità consente di mantenere più versioni di un’immagine per scopi diversi.

Per creare versioni dell’immagine dalla versione iniziale dell’immagine, procedere come segue:

Nota:

L’unità di hosting di tutte le versioni dell’immagine deve essere la stessa.

  1. Andare al nodo Immagini, selezionare una versione dell’immagine e selezionare Crea versione immagine.
  2. Se si desidera che la configurazione della versione dell’immagine sia diversa dalla versione iniziale configurata, configurare le impostazioni nelle pagine Immagine, Tipi di archiviazione e licenze, Specifiche macchina, NIC e Impostazioni disco della finestra di dialogo Crea versione immagine.
  3. Aggiungere una descrizione per la versione dell’immagine. Fare clic su Fine.

crea-versioni-immagine

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. Nella pagina Esperienza desktop, selezionare l’esperienza desktop richiesta.
  3. Dalla pagina Immagine alla pagina Impostazioni disco, le impostazioni sono preselezionate in base alla versione dell’immagine selezionata.
  4. (Per Azure) Nella pagina Gruppo di risorse, è possibile scegliere di creare un nuovo gruppo di risorse o utilizzare un gruppo di risorse esistente per posizionare le risorse di questo catalogo.
  5. Completare le impostazioni nelle pagine seguenti.
  6. 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.
  7. 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 sinistro.
  2. Fare clic su Crea catalogo macchine. Viene visualizzata la pagina Configurazione catalogo macchine. Fare clic su Avanti nelle pagine Introduzione, Tipo di macchina e Gestione macchine.
  3. Nella pagina Immagine:
    1. Selezionare Immagine preparata.
    2. Sotto Immagine preparata, selezionare una versione dell’immagine di una definizione di immagine.
    3. 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.
    4. Se la versione dell’immagine selezionata è configurata con un profilo macchina, selezionare un profilo macchina. Se la versione dell’immagine selezionata non è configurata con un profilo macchina, non è possibile scegliere di utilizzare un profilo macchina.
  4. Configurare le impostazioni nelle pagine seguenti.
  5. Nella pagina Impostazioni disco, se l’immagine preparata selezionata utilizza un set di crittografia del disco, non è possibile rimuovere il set di crittografia, ma è possibile modificare la chiave con un’altra chiave di crittografia.
  6. (Per Azure) Nella pagina Gruppo di risorse, è possibile scegliere di creare un nuovo gruppo di risorse o utilizzare un gruppo di risorse esistente per posizionare le risorse di questo catalogo.
  7. Completare le impostazioni nelle pagine seguenti.
  8. 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.

Aggiornare un catalogo di macchine con un’immagine preparata diversa

Per aggiornare un catalogo di macchine MCS esistente con un’immagine preparata diversa, procedere come segue:

  1. Fare clic su Cataloghi macchine nel riquadro di navigazione sinistro e selezionare un catalogo di macchine che si desidera aggiornare. Fare clic con il pulsante destro del mouse e selezionare Cambia immagine preparata.
  2. Nella pagina Immagine, selezionare un’immagine preparata.
  3. Nella pagina Strategia di implementazione, selezionare quando si desidera aggiornare questo catalogo con l’immagine preparata selezionata.
  4. Nella pagina Riepilogo, controllare i dettagli. Fare clic su Fine.

È possibile visualizzare la cronologia delle modifiche dell’immagine apportate a un catalogo. Per visualizzare la cronologia, procedere come segue:

  1. Selezionare un catalogo di macchine.
  2. Nella scheda Proprietà modello nel campo Immagine preparata, fare clic su Visualizza cronologia immagine.

Gestire le definizioni e le versioni delle immagini

È possibile modificare ed eliminare le definizioni e le versioni delle immagini per gestire l’utilizzo delle varie versioni e definizioni di immagini create.

Modificare una definizione di immagine

È possibile modificare il nome e la descrizione di una definizione di immagine.

Per modificare una definizione di immagine, procedere come segue:

  1. Andare al nodo Immagini, selezionare una definizione di immagine e selezionare Modifica definizione immagine.

Modificare la versione dell’immagine

È possibile modificare la descrizione di una versione dell’immagine per specificare lo scopo di tale versione dell’immagine.

Per modificare una versione dell’immagine, procedere come segue:

  1. Andare al nodo Immagini, selezionare una versione dell’immagine e selezionare Modifica descrizione.

Eliminare una versione dell’immagine

Per eliminare una versione dell’immagine, procedere come segue:

  1. Andare al nodo Immagini, selezionare una versione dell’immagine e selezionare Elimina versione immagine.

Nota:

Non è possibile eliminare una versione dell’immagine se è utilizzata da un catalogo di macchine.

Eliminare una definizione di immagine

Per eliminare una definizione di immagine, procedere come segue:

  1. Andare al nodo Immagini, selezionare una definizione di immagine e selezionare Elimina definizione immagine.

Nota:

Non è possibile eliminare una definizione di immagine se contiene una versione dell’immagine.

Gestione del ciclo di vita dell’immagine tramite PowerShell

Se si desidera utilizzare i comandi PowerShell per creare uno schema di provisioning, è necessario creare una specifica di versione dell’immagine preparata basata sulla specifica di versione dell’immagine master, come richiesto per il proprio ambiente.

Specifica di versione dell’immagine master: una specifica di versione dell’immagine master è un’immagine specifica aggiunta o creata in una versione dell’immagine. È possibile aggiungere un’immagine esistente nell’hypervisor come specifica di versione dell’immagine master o creare una specifica di versione dell’immagine preparata basata sulla specifica di versione dell’immagine master, come richiesto per il proprio ambiente. La specifica di versione dell’immagine preparata può essere utilizzata per più schemi di provisioning.

Il ciclo di vita di un’immagine quando si utilizzano i comandi PowerShell è:

  1. Creare un’immagine:

    1. Creare una definizione di immagine.
    2. Creare una versione dell’immagine.
    3. Aggiungere una specifica di versione dell’immagine master.
    4. Creare una specifica di versione dell’immagine preparata.

  2. Creare un catalogo di macchine MCS utilizzando una specifica di versione dell’immagine preparata:

    1. Creare un catalogo broker.
    2. Creare un pool di identità.
    3. Creare uno schema di provisioning con il parametro Uid della specifica di versione dell’immagine preparata utilizzando il comando New-ProvScheme.
    4. Collegare il catalogo broker allo schema di provisioning.
  3. Creare VM nel catalogo di macchine MCS.
  4. Modificare la specifica di versione dell’immagine preparata di uno schema di provisioning utilizzando il comando Set-ProvScheme.
  5. Gestire le definizioni e le versioni delle immagini: modificare le versioni e le definizioni delle immagini.
  6. Eliminare un catalogo di macchine MCS: l’ordine di eliminazione è: specifica di versione dell’immagine preparata > specifica di versione dell’immagine master > versione dell’immagine > definizione dell’immagine. Prima di eliminare la specifica di versione dell’immagine, assicurarsi che la specifica di versione dell’immagine preparata non sia associata ad alcun catalogo di macchine MCS.

Utilizzare PowerShell

È possibile eseguire le seguenti operazioni utilizzando i comandi PowerShell:

Creare un’immagine preparata

I comandi PowerShell dettagliati per creare una specifica di versione dell’immagine preparata sono i seguenti:

  1. Controllare i nomi delle definizioni di immagine disponibili utilizzando il comando Test-ProvImageDefinitionNameAvailable. Ad esempio,

    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
<!--NeedCopy-->

  2. Creare una definizione di immagine utilizzando il comando New-ProvImageDefinition. Ad esempio,

    New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
<!--NeedCopy-->

  3. Creare una versione dell’immagine utilizzando il comando New-ProvImageVersion. Ad esempio,

    New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
<!--NeedCopy-->

  4. Aggiungere una specifica di versione dell’immagine master alla versione dell’immagine utilizzando il comando Add-ProvImageVersionSpec. Ad esempio,

    Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName azure -MasterImagePath "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
<!--NeedCopy-->

    Nota:

    È possibile aggiungere una sola specifica di versione dell’immagine master a una versione dell’immagine per un’unità di hosting.

  5. Creare una specifica di versione dell’immagine preparata dalla specifica di versione dell’immagine master utilizzando il comando New-ProvImageVersionSpec. Ad esempio,

    New-ProvImageVersionSpec
-SourceImageVersionSpecUid  c6e7384c-b2f8-46d6-9519-29a2c57ed3cb
-NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"
-ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously
<!--NeedCopy-->

    Nota:

    Un’unità di hosting e un tipo di preparazione possono avere una sola istanza preparata.

Esempio del set completo di comandi PowerShell per creare la definizione dell’immagine, la versione dell’immagine e la specifica di versione dell’immagine preparata in Azure:

$ImageDefintion = New-ProvImageDefinition
-ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
 $ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName azure -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid  $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
<!--NeedCopy-->

Esempio del set completo di comandi PowerShell per creare la definizione dell’immagine, la versione dell’immagine e la specifica di versione dell’immagine preparata in VMware:

$ImageDefintion = New-ProvImageDefinition -ImageDefinitionName image2 -OsType Windows -VdaSessionSupport SingleSession
$ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\vmware\win10-master.vm\win10-master-snap.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName vmware -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid  $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
<!--NeedCopy-->

Nota:

  • Tutte le specifiche di versione dell’immagine in una definizione di immagine devono appartenere alla stessa unità di hosting.
  • Una versione dell’immagine può avere una sola specifica di versione dell’immagine master e una sola specifica di versione dell’immagine preparata.
  • Tutte le specifiche di versione dell’immagine devono avere un profilo macchina o nessuna delle specifiche di versione dell’immagine deve avere un profilo macchina.
  • Non è possibile specificare un gruppo di risorse durante la creazione di una specifica di versione dell’immagine.

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

Creare un catalogo di macchine 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> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
<!--NeedCopy-->

Oppure,

New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitName <string> -IdentityPoolName <string> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
<!--NeedCopy-->

Esempio del set completo di comandi PowerShell per creare un catalogo in Azure:

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "azurecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "azure.local" -IdentityPoolName "azurecatalog" -IdentityType "ActiveDirectory"  -NamingScheme "azure##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName azure -IdentityPoolName azurecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2s.serviceoffering" -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"StorageAccountType`" Value=`"StandardSSD_LRS`" /></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName azurecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

Esempio del set completo di comandi PowerShell per creare un catalogo in VMware:

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "vmwarecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "vmware.local" -IdentityPoolName "vmwarecatalog" -IdentityType "ActiveDirectory"  -NamingScheme "vmware##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image2 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName vmwarecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName vmware -IdentityPoolName vmwarecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName vmwarecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

Aggiornare un catalogo utilizzando una specifica di versione dell’immagine preparata

È possibile aggiornare un catalogo utilizzando il comando Set-ProvSchemeImage. Ad esempio,

Set-ProvSchemeImage -ProvisioningSchemeUid <Guid> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
<!--NeedCopy-->

Oppure,

Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
<!--NeedCopy-->

Esempio del set completo di comandi PowerShell per aggiornare un catalogo:

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 2 -Filter "PreparationType -eq 'Mcs'"
Set-ProvSchemeImage -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
<!--NeedCopy-->

Eliminare la definizione dell’immagine, la versione dell’immagine e la specifica di versione dell’immagine preparata

Considerare quanto segue prima di eliminare una definizione di immagine, una versione di immagine e una specifica di versione di immagine preparata:

  • Una definizione di immagine non può essere eliminata se contiene una versione dell’immagine.
  • Una versione dell’immagine non può essere eliminata se contiene una specifica di versione dell’immagine.
  • Una specifica di versione dell’immagine master non può essere eliminata se è utilizzata da qualsiasi altra specifica di versione dell’immagine preparata.
  • Una specifica di versione dell’immagine preparata non può essere eliminata se è utilizzata da qualsiasi schema di provisioning.

I passaggi dettagliati sono i seguenti:

  1. Rimuovere una specifica di versione dell’immagine preparata. Ad esempio,

    $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
<!--NeedCopy-->

    Nota:

    La specifica di versione dell’immagine master può essere eliminata solo quando non è presente alcuna specifica di versione dell’immagine preparata associata.

  2. Rimuovere la specifica di versione dell’immagine master. Ad esempio,

    $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
<!--NeedCopy-->

  3. Rimuovere una versione dell’immagine. Ad esempio,

    Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
<!--NeedCopy-->

  4. Rimuovere una definizione di immagine. Ad esempio,

    Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Esempio del set completo di comandi PowerShell:

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Gestire la definizione dell’immagine e la versione dell’immagine

È possibile rinominare e modificare una definizione di immagine e modificare una versione dell’immagine.

  • Rinominare una definizione di immagine utilizzando il comando Rename-ProvImageDefinition. Ad esempio:

     Rename-ProvImageDefinition -ImageDefinitionUid <Guid> -NewImageDefinitionName <string>
 <!--NeedCopy-->

    Oppure,

     Rename-ProvImageDefinition -ImageDefinitionName <string> -NewImageDefinitionName <string>
 <!--NeedCopy-->

  • Modificare una definizione di immagine utilizzando il comando Set-ProvImageDefinition. Ad esempio:

     Set-ProvImageDefinition -ImageDefinitionUid <Guid> [-Description <string>]
 <!--NeedCopy-->

    Oppure,

     Set-ProvImageDefinition -ImageDefinitionName <string> [-Description <string>]
 <!--NeedCopy-->

  • Modificare una versione dell’immagine utilizzando il comando Set-ProvImageVersion. Ad esempio:

     Set-ProvImageVersion -ImageVersionUid <Guid> [-Description <string>]
 <!--NeedCopy-->

    Oppure,

     Set-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> [-Description <string>]
 <!--NeedCopy-->

Ottenere i dettagli della definizione dell’immagine, della versione dell’immagine, della specifica di versione dell’immagine preparata e dello schema di provisioning

  • Ottenere i dettagli della definizione dell’immagine utilizzando il comando Get-ProvImageDefinition. Ad esempio:

     Get-ProvImageDefinition [-ImageDefinitionName <string>] [-ImageDefinitionUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <int>] [-Skip <int>] [-SortBy <string>] [-Filter <string>]
 <!--NeedCopy-->

  • Ottenere i dettagli della versione dell’immagine utilizzando il comando Get-ProvImageVersion. Ad esempio:

    • Per elencare le versioni dell’immagine in una definizione di immagine,

       Get-ProvImageVersion -ImageDefinitionUid <Guid>
 <!--NeedCopy-->

      Oppure,

       Get-ProvImageVersion -ImageDefinitionName <string>
 <!--NeedCopy-->

    • Per ottenere un dettaglio della versione dell’immagine,

       Get-ProvImageVersion -ImageVersionUid <Guid>
 <!--NeedCopy-->

      Oppure,

       Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int>
 <!--NeedCopy-->

  • Ottenere la specifica di versione dell’immagine preparata utilizzando il comando Get-ProvImageVersionSpec. Ad esempio:

    • Per elencare tutte le specifiche di versione dell’immagine preparate in una versione dell’immagine,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid>
 <!--NeedCopy-->

    • Per elencare le specifiche di versione dell’immagine master in una specifica di versione dell’immagine preparata,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"'
 <!--NeedCopy-->

    • Per elencare le specifiche di versione dell’immagine preparate in una versione dell’immagine, associata a un’immagine master,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"'
 <!--NeedCopy-->

    • Per ottenere le specifiche di versione dell’immagine preparate con successo in una versione dell’immagine,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -and ImageVersionSpecStatus -eq "Complete"'
 <!--NeedCopy-->

    • Per ottenere un dettaglio della specifica di versione dell’immagine preparata,

       Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
 <!--NeedCopy-->

  • Ottenere i dettagli dello schema di provisioning utilizzando il comando Get-ProvScheme. Ad esempio:

     Get-ProvScheme [[-ProvisioningSchemeName] <String>] [-ProvisioningSchemeUid <Guid>] [-ScopeId <Guid>] [-ScopeName <String>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
 <!--NeedCopy-->

  • Ottenere la cronologia delle specifiche di versione dell’immagine preparata di uno schema di provisioning utilizzando il comando Get-ProvSchemeImageVersionSpecHistory. Ad esempio:

     Get-ProvSchemeImageVersionSpecHistory [-ProvisioningSchemeName <String>] [-ProvisioningSchemeUid <Guid>] [-ImageVersionSpecUid <Guid>] [-ImageVersionSpecHistoryUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
 <!--NeedCopy-->
Gestione delle immagini
January 23, 2026
Grazie al contributo di: 
C
January 23, 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.