Gestire un catalogo VMware

Last published : Nov 13, 2026
Gestire i cataloghi di macchine descrive le procedure guidate che gestiscono un catalogo di macchine. Le seguenti informazioni riguardano i dettagli specifici degli ambienti di virtualizzazione VMware.
Nota:
Prima di gestire un catalogo VMware, è necessario completare la creazione di un catalogo VMware. Vedere Creare un catalogo VMware.

Aggiornare l'ID della cartella di un catalogo di macchine

È possibile aggiornare l'ID della cartella di un catalogo di macchine MCS specificando FolderId nelle proprietà personalizzate del comando Set-ProvScheme. Le VM create dopo l'aggiornamento dell'ID della cartella vengono create sotto questo nuovo ID della cartella. Se questa proprietà non è specificata in CustomProperties, le VM vengono create nella cartella in cui si trova l'immagine master.
Eseguire i seguenti passaggi per aggiornare l'ID della cartella di un catalogo di macchine.
  1. Aprire un browser Web e immettere l'URL per il vSphere Web Client.
  2. Immettere le credenziali e fare clic su Login.
  3. Creare una cartella di posizionamento VM in vSphere Web Client.
  4. Aprire una finestra di PowerShell.
  5. Eseguire asnp citrix®* per caricare i moduli PowerShell specifici di Citrix.
  6. Specificare FolderID in CustomProperties di Set-ProvScheme. In questo esempio, il valore dell'ID della cartella è group-v2406.
    Set-ProvScheme -ProvisioningSchemeUid "50bb319c-2e83-4a37-9ea1-94f630687372" -CustomProperties "<CustomProperties xmlns=""http://schemas.citrix.com/2014/xd/machinecreation"" xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance""><Property xsi:type=""StringProperty"" Name=""FolderId"" Value=""group-v2406"" /></CustomProperties>"
  7. Aggiungere una VM al catalogo di macchine utilizzando Studio.
  8. Controllare la nuova VM su vSphere Web Client. La nuova VM viene creata nella nuova cartella.

Trovare l'ID della cartella in vSphere

Accedere a Managed Object Browser (MOB) su qualsiasi sistema server ESXi o vCenter per trovare l'ID della cartella delle VM.
Il MOB è un'applicazione server basata sul web disponibile integrata in tutti i sistemi server ESX/ESXi e vCenter. Questa utility vSphere consente di visualizzare informazioni dettagliate su oggetti come VM, datastore e pool di risorse.
  1. Aprire un browser web e inserire http://x.x.x.x/mob, dove x.x.x.x è l'indirizzo IP del server vCenter o dell'host ESX/ESXi. Ad esempio, <https://10.60.4.70/mob>.
  2. Nella pagina Home del MOB, fare clic sul valore della proprietà content.
  3. Fare clic sul valore di rootFolder.
  4. Fare clic sul valore di childEntity.
  5. Fare clic sul valore di vmFolder.
  6. È possibile trovare l'ID della cartella nel valore di childEntity.

Migrazione dello storage delle VM

È possibile spostare l'archiviazione su disco delle VM esistenti da un'archiviazione precedente a una nuova archiviazione. Durante la migrazione, MCS mantiene le funzionalità della VM come la gestione dell'alimentazione, il ripristino del disco del sistema operativo e così via. È anche possibile aggiungere nuove VM al catalogo macchine utilizzando la nuova archiviazione su disco. Per fare ciò, utilizzare il comando PowerShell Move-ProvVMDisk.
Attualmente, è possibile migrare solo VM persistenti con clone completo.
Il nuovo storage deve soddisfare le seguenti condizioni:
  • Deve trovarsi nello stesso cluster del vecchio storage.
  • L'host su cui è in esecuzione la VM deve avere accesso sia ai datastore vecchi che a quelli nuovi.
È possibile eseguire le seguenti attività:
  • Migrare lo storage su disco
  • Deprecare la vecchia archiviazione

Migrare lo storage su disco

Per migrare lo storage su disco:
  1. Aggiungere una nuova archiviazione a un'unità di hosting esistente. Modificare la vecchia archiviazione in Sostituita. È possibile farlo utilizzando Web Studio o i comandi PowerShell.
    • Se si utilizza Web Studio, vedere Modifica archiviazione.
    • Se si utilizzano i comandi PowerShell:
      • Eseguire Add-Hyphostingunitstorage per aggiungere il nuovo storage all'unità di hosting esistente.
      • Eseguire Set-Hyphostingunitstorage con Superseded impostato su true per disabilitare la creazione di nuove VM nel vecchio storage.
  2. Spegnere le VM e attivare la Modalità di manutenzione.
  3. Spostare lo storage su disco delle VM nel nuovo storage e aggiornare le informazioni di storage. Ad esempio:
    Move-ProvVMDisk -ProvisioningSchemeName "myFullCloneProvScheme" -VMName ("VMware-TestVM01", "VMware-TestVM02") -DiskType OS,Identity -DestinationStorageId datastore1,datastore1
  4. Ottenere l'ID dell'attività di migrazione. Ad esempio:
    ,(Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName xxxxx -DiskType OS,Identity -DestinationStorageId datastore1,datastore1
  5. Controllare lo stato della migrazione.
    • (Get-ProvTask -TaskID xxxxxxxxx).DiskMovedVirtualMachines: Fornisce l'elenco delle VM con migrazione del disco riuscita, incluse le VM già migrate nel nuovo storage.
    • (Get-ProvTask -TaskID xxxxxxxxx).DiskMoveFailedVirtualMachines: Fornisce l'elenco delle VM con migrazione non riuscita.
    • (Get-ProvTask -TaskID xxxxxxxxx).NotStartedVirtualMachines: Fornisce l'elenco delle VM la cui migrazione non è ancora iniziata.
    • Get-ProvVM -ProvisioningSchemeName xxxxx -VMName "VMware-TestVM01: Fornisce le proprietà aggiornate della VM dopo la migrazione. Controllare le proprietà come StorageId, AssignedImage, BootedImage, IdentityDiskId, IdentityDiskStorage e LastBootTime.
Dopo aver migrato i dischi delle VM create da MCS con snapshot, potrebbe apparire l'avviso Consolidation is required in the VSphere Client. Per consolidare ed evitare la perdita di dati:
  1. Eseguire un backup della VM VMware. Ad esempio, trasferire tutti i file della VM in un'altra cartella su un datastore.
  2. Dopo aver visualizzato l'avviso, fare clic su Consolidate, quindi su OK per confermare il consolidamento.

Deprecare il vecchio storage

Per deprecate il vecchio storage dopo la migrazione del disco delle VM:
  1. Ottenere le informazioni sui dischi di base e sul conteggio delle macchine in ogni storage su disco dell'unità di hosting. Ad esempio:
    $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
    $result
    $result.ProvResourceInStorage | Format-List -Property *
    Dopo una migrazione riuscita, MCS rimuove automaticamente il disco di base obsoleto e non ci sono macchine nel vecchio storage. Pertanto, dopo aver eseguito il comando, assicurarsi che non ci siano macchine e dischi di base nel vecchio storage.
  2. Eseguire Remove-Hyphostingunitstorage per rimuovere completamente il vecchio storage dall'unità di hosting. È anche possibile utilizzare Web Studio per rimuovere il vecchio storage.

Identificare le risorse create da MCS

Di seguito sono riportati i tag che MCS aggiunge alle risorse. I tag nella tabella sono rappresentati come "chiave":"valore".
Nome risorsa Tag
VM di preparazione "CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"XdConfig:"XdProvisioned=True"
VM nel catalogo "CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"XdConfig:"XdProvisioned=True"

Ulteriori informazioni