Citrix Virtual Apps and Desktops

Gestione dei cataloghi di macchine con immagine preparata

January 23, 2026

Grazie al contributo di:

È possibile aggiornare un catalogo di macchine MCS esistente con un’immagine preparata diversa e gestire le definizioni e le versioni delle immagini utilizzando:

Web Studio
PowerShell

Utilizzare Web Studio

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:

Fare clic su Cataloghi macchine nel riquadro di navigazione sinistro e selezionare un catalogo di macchine da aggiornare. Fare clic con il pulsante destro del mouse e selezionare Cambia immagine preparata.
Nella pagina Immagine, selezionare un’immagine preparata.

Nota:

Applicabile ad Azure: è anche possibile scegliere un’immagine con ACG non abilitato e in seguito selezionare la casella di controllo Posiziona immagine preparata in Azure Compute Gallery per posizionare le immagini nella galleria.
Nella pagina Strategia di implementazione, selezionare quando si desidera aggiornare questo catalogo con l’immagine preparata selezionata.
Nella pagina Riepilogo, controllare i dettagli. Fare clic su Fine.

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

Selezionare un catalogo di macchine.
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 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:

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:

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:

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:

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.

Utilizzare PowerShell

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 della 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 di immagine.
Una versione di immagine non può essere eliminata se contiene una specifica di versione di 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 catalogo di macchine MCS.
Un’unità di hosting non può essere eliminata se è utilizzata da qualsiasi altra specifica di versione dell’immagine preparata.

I passaggi dettagliati sono i seguenti:

Rimuovere il catalogo di macchine. Ad esempio,

Remove-ProvScheme -ProvisioningScheneName decouplingCatalog
<!--NeedCopy-->

Rimuovere la specifica di versione dell’immagine preparata condivisa. Ad esempio,

Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest
<!--NeedCopy-->

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

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

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronousl
<!--NeedCopy-->

Nota:

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

Rimuovere una versione dell’immagine. Ad esempio,

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

Rimuovere la configurazione per la definizione dell’immagine nella connessione di hosting specificata. Ad esempio,
```
Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx

```

Rimuovere una definizione di immagine. Ad esempio,

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

Esempio del set completo di comandi PowerShell quando l’immagine preparata non è condivisa tra le unità host:

Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

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

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

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

Esempio del set completo di comandi PowerShell quando l’immagine preparata è condivisa tra le unità host:

Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> 
-HostingUnitName AzureWest

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

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx

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 di immagine.

Ridenominare 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 della 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 della versione dell’immagine preparata utilizzando il comando Get-ProvImageVersionSpec. Ad esempio:
- Per elencare tutte le specifiche della versione dell’immagine preparata in una versione dell’immagine,
```
 Get-ProvImageVersionSpec -ImageVersionUid <Guid>
 
```
- 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"'
 
```
- 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"'
 
```
- Per ottenere le specifiche della versione dell’immagine preparata riuscite 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"'
 
```
- Per ottenere un dettaglio della specifica della versione dell’immagine preparata,
```
 Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
 
```

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

Ulteriori informazioni

Gestione delle immagini

La versione ufficiale di questo contenuto è in inglese. Per alcuni dei contenuti della documentazione Cloud Software Group è stata impiegata la traduzione automatica solo per comodità. Cloud Software Group non ha alcun controllo sui contenuti tradotti in modo automatico, che possono contenere errori, imprecisioni o linguaggio inadatto. Non viene offerta alcuna garanzia di alcun tipo, espressa o implicita, circa l'accuratezza, l'affidabilità, l'idoneità o la correttezza di qualsiasi traduzione dall'originale inglese in qualsiasi altra lingua, o che il prodotto o servizio Cloud Software Group sia conforme a qualsiasi contenuto in traduzione automatica, e qualsiasi garanzia fornita ai sensi del contratto di licenza per l'utente finale applicabile o i termini di servizio, o qualsiasi altro accordo con Cloud Software Group che il prodotto o il servizio sia conforme a qualsiasi documentazione non si applicheranno nella misura in cui tale documentazione sia in traduzione automatica. Cloud Software Group non sarà ritenuta responsabile per eventuali danni o problemi che potrebbero derivare dall'utilizzo di contenuti per cui si è impiegata la traduzione automatica.

È stato utile?

Gestione dei cataloghi di macchine con immagine preparata

January 23, 2026

Grazie al contributo di:

January 23, 2026

Grazie al contributo di:

In questo articolo

Utilizzare Web Studio
- Aggiornare un catalogo di macchine con un’immagine preparata diversa
- Gestire le definizioni e le versioni delle immagini
Utilizzare PowerShell
Ulteriori informazioni

È stato utile?