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

Gestione delle immagini

February 20, 2025
Grazie al contributo di: 
C

Introduzione

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

  • Mastering: un’immagine sorgente viene convertita in un’immagine pubblicata
  • Clonazione: vengono create nuove VM dall’immagine pubblicata

Grazie alla funzionalità di gestione delle immagini, MCS separa la fase di masterizzazione dal flusso di lavoro di provisioning complessivo.

È possibile preparare diverse versioni dell’immagine MCS (Immagine preparata) da un’unica immagine sorgente e utilizzarla in più cataloghi di macchine MCS diversi. Questa implementazione riduce significativamente i costi di archiviazione e di tempo e semplifica il processo di distribuzione delle VM e di aggiornamento delle immagini.

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

  • Genera immagini preparate in anticipo senza creare un catalogo.
  • Riutilizzare le immagini preparate in più scenari, ad esempio la creazione e l’aggiornamento di un catalogo.
  • Ridurre notevolmente i tempi di creazione o aggiornamento del catalogo.

Nota:

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

Casi d’uso

Ecco alcuni casi d’uso della funzionalità di gestione delle immagini:

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

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

  • Raggruppamento logico: Puoi creare più definizioni di immagini per:

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

Cos’è un’immagine preparata?

Grazie alla funzionalità di gestione delle immagini, MCS separa la fase di masterizzazione dal flusso di lavoro complessivo di creazione o aggiornamento del catalogo e suddivide il processo in due fasi:

  1. Crea immagini preparate da un’unica immagine sorgente.
  2. Utilizzare l’immagine preparata per creare o aggiornare un catalogo macchine MCS.

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

Scopri come un’immagine preparata viene utilizzata su più cataloghi di macchine MCS quando utilizzi Web Studio dall’immagine:

Panoramica dell'immagine preparata

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

  • perché è stata creata l’immagine
  • per quale sistema operativo è
  • altre informazioni sull’utilizzo dell’immagine.

Un catalogo non viene creato a partire dalla definizione di un’immagine, ma dalle versioni dell’immagine create in base alla definizione dell’immagine.

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

In alternativa, se si desidera utilizzare i comandi di PowerShell per creare uno schema di provisioning per creare o aggiornare un catalogo, è necessario creare una specifica della versione dell’immagine preparata basata sulla specifica della versione dell’immagine master, in base alle esigenze dell’ambiente.

Requisito

  • Per l’immagine master di Windows, sono supportate solo le immagini VDA con versione 2311 e successive e MCS/IO abilitato.

Limitazioni

Attualmente, la funzionalità non supporta quanto segue:

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

Gestione del ciclo di vita delle immagini tramite Web Studio

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

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

In alternativa, è possibile gestire le immagini anche tramite PowerShell. Vedere Gestione del ciclo di vita delle immagini tramite PowerShell.

Crea o aggiorna un catalogo utilizzando un’immagine preparata

Crea immagini preparate e utilizzale per creare o aggiornare un catalogo di macchine MCS utilizzando:

Utilizzare Web Studio

Vedere i seguenti argomenti:

Nodo Comprendi Immagini

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

immagine-nodo-vista-principale

Etichetta Parte Descrizione
UN Definizioni delle immagini Elenca le definizioni delle immagini create in precedenza.
B Versioni delle immagini Visualizza le versioni immagine della definizione 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 preparare le immagini, come disco rigido, dimensioni della macchina, tipo di licenza, set di crittografia del disco, profilo della macchina e così via.
  • La scheda Schemi di provisioning mostra il nome dello schema di provisioning utilizzato per creare il 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 sulle definizioni e sulle versioni delle immagini, ad esempio Crea versione immagine, Modifica descrizione, Elimina versione immaginee Crea catalogo.

Creare un catalogo macchine utilizzando l’immagine preparata

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

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

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

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

  1. Accedi a Web Studio e seleziona 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 , seleziona Risorse e un’immagine master da utilizzare come modello per creare la versione immagine. È possibile selezionare la casella di controllo Usa un profilo macchina e selezionare un profilo macchina.

    Nota:

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

  4. (Solo per Azure) Nella pagina Tipi di archiviazione e licenze , seleziona 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 Specifica della macchina :

    • Per Azure, seleziona una dimensione della macchina. Se si seleziona un profilo macchina nella pagina Immagine , per impostazione predefinita viene selezionata la dimensione macchina del profilo macchina.
    • Per VMware, se si seleziona un profilo macchina, è possibile visualizzare il conteggio delle CPU virtuali derivato dal profilo macchina, che non è modificabile. Se non si seleziona un profilo macchina, verrà visualizzata solo la dimensione della memoria derivata dall’immagine master.

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

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

    Nota:

    In Azure non sono supportate più NIC.

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

Crea versioni di immagini

Le versioni delle immagini consentono la gestione di diverse iterazioni o aggiornamenti di una particolare immagine. Questa funzionalità consente di gestire 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. Vai al nodo Immagini , seleziona una versione dell’immagine e seleziona Crea versione immagine.
  2. Se si desidera che la configurazione della versione dell’immagine sia diversa dalla versione dell’immagine configurata inizialmente, configurare le impostazioni nelle pagine Immagine, Tipi di archiviazione e licenza, Specifiche macchina, NICe Impostazioni disco della finestra di dialogo Crea versione immagine .
  3. Aggiungere una descrizione per la versione dell’immagine. Fai clic su Fine.

creare-versioni-immagine

Crea un catalogo macchine dal nodo Immagini

Utilizzare l’opzione Crea catalogo nel nodo Immagini per creare un catalogo utilizzando la versione 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 Images , procedere come segue:

  1. Seleziona una versione dell’immagine e fai clic su Crea catalogo. Fare clic su Avanti nella pagina Introduzione .
  2. Nella pagina Esperienza desktop , seleziona 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 ** puoi scegliere di creare un nuovo gruppo di risorse o di utilizzare un gruppo di risorse esistente per posizionare le risorse di questo catalogo.
  5. Completare le impostazioni nelle pagine seguenti.
  6. Nella pagina Riepilogo , controlla i dettagli del catalogo della macchina. Immettere un nome e una descrizione per il catalogo macchine. Fai clic su Fine.
  7. Vai al nodo Cataloghi macchine per vedere il catalogo macchine creato.

Crea 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 a sinistra.
  2. Fare clic su Crea catalogo macchine. Viene visualizzata la pagina Configurazione catalogo macchine . Fare clic su Avanti fino alle pagine Introduzione, Tipo di macchinae Gestione macchina.
  3. Nella pagina Immagine :
    1. Seleziona Immagine preparata.
    2. Sotto Immagine preparata, seleziona una versione 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 della versione, 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 ** puoi scegliere di creare un nuovo gruppo di risorse o di utilizzare un gruppo di risorse esistente per posizionare le risorse di questo catalogo.
  7. Completare le impostazioni nelle pagine seguenti.
  8. Nella pagina Riepilogo , controlla i dettagli del catalogo della macchina. Immettere un nome e una descrizione per il catalogo macchine. Fai clic su Fine.

Aggiornare un catalogo macchine con un’immagine preparata diversa

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

  1. Fare clic su Cataloghi macchine nel riquadro di navigazione a sinistra e selezionare il catalogo macchine che si desidera aggiornare. Fare clic con il tasto destro del mouse e selezionare Modifica immagine preparata.
  2. Nella pagina Immagine , seleziona un’immagine preparata.
  3. Nella pagina Strategia di rollout , seleziona quando desideri aggiornare questo catalogo con l’immagine preparata selezionata.
  4. Nella pagina Riepilogo , controlla i dettagli. Fai clic su Fine.

È possibile visualizzare la cronologia delle modifiche apportate alle immagini di un catalogo. Per visualizzare la cronologia, procedere come segue:

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

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 delle immagini create.

Modificare la definizione di un’immagine

È possibile modificare il nome e la descrizione della definizione di un’immagine.

Per modificare la definizione di un’immagine, procedere come segue:

  1. Vai al nodo Immagini , seleziona una definizione di immagine e seleziona Modifica definizione immagine.

Modifica la versione dell’immagine

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

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

  1. Vai al nodo Immagini , seleziona una versione dell’immagine e seleziona Modifica descrizione.

Elimina una versione dell’immagine

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

  1. Vai al nodo Immagini , seleziona una versione dell’immagine e seleziona Elimina versione immagine.

Nota:

Non è possibile eliminare una versione immagine se è utilizzata da un catalogo macchina.

Eliminare una definizione di immagine

Per eliminare la definizione di un’immagine, procedere come segue:

  1. Vai al nodo Immagini , seleziona una definizione di immagine e seleziona Elimina definizione immagine.

Nota:

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

Gestione del ciclo di vita delle immagini tramite PowerShell

Se si desidera utilizzare i comandi di PowerShell per creare uno schema di provisioning, è necessario creare una specifica della versione dell’immagine preparata basata sulla specifica della versione dell’immagine master, in base alle esigenze dell’ambiente.

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

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

  1. Crea un’immagine:

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

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

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

Utilizzare PowerShell

È possibile effettuare le seguenti operazioni utilizzando i comandi di PowerShell:

Crea un’immagine preparata

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

  1. Controllare i nomi delle definizioni delle immagini disponibili utilizzando il comando Test-ProvImageDefinitionNameAvailable. Per esempio,

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

  2. Crea una definizione di immagine utilizzando il comando New-ProvImageDefinition . Per esempio,

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

  3. Crea una versione immagine utilizzando il comando New-ProvImageVersion . Per esempio,

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

  4. Aggiungere una specifica della versione dell’immagine master alla versione dell’immagine utilizzando il comando Add-ProvImageVersionSpec . Per 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 della versione dell’immagine preparata dalla specifica della versione dell’immagine master utilizzando il comando New-ProvImageVersionSpec . Per 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:

    Ogni unità di hosting e tipo di preparazione può avere una sola istanza preparata.

Esempio del set completo di comandi di Powershell per creare la definizione dell’immagine, la versione dell’immagine e la specifica della 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 le specifiche della 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 della versione dell’immagine in una definizione di immagine devono appartenere alla stessa unità di hosting.
  • Una versione dell’immagine può avere solo una specifica della versione dell’immagine master e una specifica della versione dell’immagine preparata.
  • Tutte le specifiche della versione dell’immagine devono avere un profilo macchina oppure nessuna delle specifiche della 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 macchine MCS dalla specifica della versione dell’immagine preparata utilizzando il comando New-ProvScheme . Per 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-->

O,

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

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

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

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

O,

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

Elimina la definizione dell’immagine, la versione dell’immagine e le specifiche della versione dell’immagine preparata

Prima di eliminare una definizione di immagine, una versione di immagine e una specifica di versione di immagine preparata, tenere presente quanto segue:

  • Non è possibile eliminare la definizione di un’immagine se contiene una qualsiasi versione dell’immagine.
  • Una versione dell’immagine non può essere eliminata se contiene specifiche sulla 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 della versione dell’immagine preparata non può essere eliminata se è utilizzata da uno schema di provisioning.

I passaggi dettagliati sono i seguenti:

  1. Rimuove una specifica della versione dell’immagine preparata. Per esempio,

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

    Nota:

    La specifica della versione dell’immagine master può essere eliminata solo se non è associata alcuna specifica della versione dell’immagine preparata.

  2. Rimuovi la specifica della versione dell’immagine master. Per esempio,

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

  3. Rimuovi una versione dell’immagine. Per esempio,

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

  4. Rimuovi la definizione di un’immagine. Per 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-->

Gestisci la definizione dell’immagine e la versione dell’immagine

È possibile rinominare e modificare la definizione di un’immagine, nonché modificarne la versione.

  • Rinomina una definizione di immagine utilizzando il comando Rename-ProvImageDefinition . Per esempio:

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

    O,

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

  • Modifica la definizione di un’immagine utilizzando il comando Set-ProvImageDefinition . Per esempio:

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

    O,

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

  • Modifica una versione dell’immagine utilizzando il comando Set-ProvImageVersion . Per esempio:

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

    O,

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

Ottieni la definizione dell’immagine, la versione dell’immagine, le specifiche della versione dell’immagine preparata e i dettagli dello schema di provisioning

  • Ottieni i dettagli sulla definizione dell’immagine utilizzando il comando Get-ProvImageDefinition . Per esempio:

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

  • Ottieni i dettagli sulla versione dell’immagine utilizzando il comando Get-ProvImageVersion . Per esempio:

    • Per elencare le versioni delle immagini in una definizione di immagine,

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

      O,

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

    • Per ottenere un dettaglio della versione dell’immagine,

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

      O,

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

  • Ottieni le specifiche della versione dell’immagine preparata utilizzando il comando Get-ProvImageVersionSpec . Per esempio:

    • Per elencare tutte le specifiche della versione dell’immagine preparata in una versione dell’immagine,

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

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

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

    • Per elencare le specifiche della versione dell’immagine preparata 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 specifiche di versione dell’immagine preparata 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 i dettagli delle specifiche della versione dell’immagine preparata,

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

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

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

  • Ottieni la cronologia delle specifiche della versione dell’immagine preparata di uno schema di provisioning utilizzando il comando Get-ProvSchemeImageVersionSpecHistory . Per 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
February 20, 2025
Grazie al contributo di: 
C
February 20, 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.