Documentazione dei prodotti
Citrix DaaS™
Visualizza PDF

Finestra di servizio

May 4, 2026
Grazie al contributo di: 
C

La funzionalità Finestra di servizio offre la possibilità di pianificare e automatizzare le operazioni sulle VM di cui è stato eseguito il provisioning tramite MCS. Questa funzionalità attualmente supporta varie operazioni come la reimpostazione del disco del sistema operativo e le modifiche alla configurazione hardware. È possibile pianificare queste operazioni e tornare in seguito per verificarne il completamento, anziché eseguire gli aggiornamenti manualmente.

  • È possibile pianificare le operazioni per un elenco specifico di VM o per un intero catalogo di macchine. Ogni operazione viene eseguita all’ora specificata. È possibile pianificare più operazioni per la stessa VM. Tuttavia, non è possibile pianificare più di un aggiornamento hardware per una singola VM.

  • È inoltre possibile:

  • Aggiungere una descrizione per la Finestra di servizio.
  • Fornire un messaggio dettagliato da visualizzare a tutti gli utenti che hanno effettuato l’accesso quando l’operazione viene eseguita.
  • Configurare quanti minuti di buffer vengono concessi per salvare il lavoro per gli utenti che hanno effettuato l’accesso prima che l’operazione venga eseguita forzatamente.

Vantaggi

  • Migliore esperienza utente e continuità

  • Gestione elegante delle sessioni: anziché disconnessioni improvvise, è possibile definire una notifica professionale per salvare il lavoro prima che la VM venga spenta.
  • Tempo di inattività pianificato: è possibile spostare attività di aggiornamento pesanti nelle ore non di punta (ad esempio, le 2:00 del mattino) senza che sia necessario accedere manualmente a quell’ora.
  • Aggiornamenti hardware convenienti: l’aggiornamento dell’hardware tramite la Finestra di servizio consente di risparmiare costi significativi nelle implementazioni di grandi dimensioni. Questa funzionalità analizza automaticamente se una VM richiede un riavvio per applicare le impostazioni. Pertanto, evitando riavvii non necessari, la Finestra di servizio riduce al minimo queste spese.

Flessibilità hardware avanzata

  • Aggiornare le configurazioni hardware: utilizzare la Finestra di servizio per pianificare gli aggiornamenti hardware. Il sistema gestisce in modo intelligente il flusso di aggiornamento, verificando la necessità di riavvio e gestendo i disconnessioni delle sessioni, assicurando che il catalogo si evolva per soddisfare nuove esigenze di risorse senza alcuna supervisione manuale.
  • Riconfigurazione SKU flessibile: aggiornare facilmente gli SKU, che in precedenza richiedevano la ricreazione manuale del catalogo.
  • Supporto per l’ibernazione per le VM esistenti: supera la limitazione del “disco temporaneo”. La Finestra di servizio consente al driver MCSIO di rilocare il file di paging nell’unità C: e di abilitare le proprietà di ibernazione sulle VM già distribuite.

Considerazione importante

  • Notifica utente: gli utenti che hanno effettuato l’accesso ricevono un avviso iniziale relativo all’operazione della Finestra di servizio, assicurando loro tempo sufficiente per salvare il proprio lavoro. Una volta scaduto il periodo di notifica, la macchina si spegne automaticamente per eseguire l’operazione.

Limitazione

La dimensione del disco WBC non può essere modificata sulle VM esistenti. Può essere applicata al catalogo di macchine per le nuove VM.

Operazioni della Finestra di servizio

  • La Finestra di servizio attualmente supporta la reimpostazione del disco del sistema operativo e le modifiche alla configurazione hardware tramite PowerShell.

  • Comandi PowerShell: i comandi generici sono descritti in questo articolo, mentre script dettagliati e specifici per hypervisor sono disponibili sulla nostra pagina GitHub https://github.com/citrix/citrix-mcs-sdk-samples/.

Reimpostazione del disco del sistema operativo

-  La reimpostazione del disco del sistema operativo può essere eseguita utilizzando il comando PowerShell `New-ProvMaintenanceCycle`. Il comando crea una nuova Finestra di servizio per un intero catalogo o VM specifiche. Il ciclo inizia all'ora specificata in `ScheduledStartTimeInUTC`. È inoltre necessario fornire `MaxDurationInMinutes`, che indica il tempo massimo di esecuzione della Finestra di servizio.

Esempio: Reimpostazione del disco del sistema operativo per VM specifiche 


New-ProvMaintenanceCycle -Operation ResetOSDisk -MaintenanceCycleDescription "Resetting Boot Disk" -StartsNow -MaxDurationInMinutes 100 -ProvisioningSchemeName CVC -PurgeDBAfterInDays 1 -SessionWarningTimeInMinutes 15 -SessionWarningLogOffTitle "Scheduled Maintenance" -SessionWarningLogOffMessage "There is a scheduled maintenance coming up and involves turning off the machine, please save your work and log out, Thank You" -VMName VDA02,VDA03

<!--NeedCopy-->


New-ProvMaintenanceCycle -Operation ResetOSDisk -MaintenanceCycleDescription "Resetting Boot Disk" -StartsNow -MaxDurationInMinutes 100 -ProvisioningSchemeName CVC -PurgeDBAfterInDays 1 -SessionWarningTimeInMinutes 15 -SessionWarningLogOffTitle "Scheduled Maintenance" -SessionWarningLogOffMessage "There is a scheduled maintenance coming up and involves turning off the machine, please save your work and log out, Thank You" -AllVMs

<!--NeedCopy-->

Aggiornamento delle impostazioni hardware

Pianificare gli aggiornamenti hardware utilizzando la Finestra di servizio, avendo così il pieno controllo su quando le modifiche avranno effetto. È possibile scegliere di indirizzare solo le VM appena create, un intero catalogo (VM nuove ed esistenti) o VM specifiche, a seconda delle necessità.

-  Per aggiornare le impostazioni hardware per nuove VM o per l'intero catalogo, selezionare una versione dello schema di provisioning ed eseguire il comando PowerShell `New-ProvSchemeHardwareUpdate`. È possibile applicare una versione dello schema di provisioning creata in precedenza alle VM. È anche possibile abilitare l'ibernazione su una VM con disco temporaneo.
-  Per aggiornare le impostazioni hardware per VM specifiche, selezionare una versione della configurazione della VM ed eseguire il comando PowerShell `New-ProvVmHardwareUpdate`.

Considerazioni importanti 

-  Le nuove macchine aggiunte a un catalogo dopo la pianificazione di un aggiornamento hardware continuano a essere create con specifiche precedenti fino all'ora UTC specificata per l'applicazione delle nuove specifiche.
  • Un singolo errore di convalida durante la creazione della Finestra di servizio impedisce la creazione del ciclo e restituisce un messaggio di errore.
  • Per abilitare l’ibernazione, considerare quanto segue:
    • La versione VDA deve essere superiore a 2503.
    • Machine Creation Services I/O (MCSIO) deve essere installato.
    • Il profilo della macchina deve supportare l’ibernazione.
    • Lo SKU della VM e il sistema operativo devono supportare l’ibernazione.
    • Se VBS è abilitato, anche Hyper-V deve essere abilitato. La virtualizzazione annidata richiede Trusted Launch sulla VM.
    • La dimensione libera del disco del sistema operativo deve essere maggiore della dimensione della memoria della VM.

Pianificare gli aggiornamenti hardware su un intero catalogo di macchine o nuove VM

  1. Eseguire New-ProvSchemeVersion per creare una nuova versione dello schema di provisioning con impostazioni hardware aggiornate. Per maggiori informazioni, consultare la documentazione SDK.
  2. Eseguire il comando PowerShell New-ProvSchemeHardwareUpdate per pianificare una Finestra di servizio per gli aggiornamenti hardware come specificato nella versione dello schema di provisioning.

Esempio: AllVMs (nuove ed esistenti) nel catalogo di macchine sono considerate per l’aggiornamento:


New-ProvSchemeHardwareUpdate -ProvisioningSchemeVersion 4 -MaintenanceCycleDescription "Updating RAM and CPU Count to 8GB and 4" -StartsNow -MaxDurationInMinutes 100 -ProvisioningSchemeName CVC -PurgeDBAfterInDays 1 -SessionWarningTimeInMinutes 15 -SessionWarningLogOffTitle "Scheduled Maintenance" -SessionWarningLogOffMessage "There is a scheduled maintenance coming up and involves turning off the machine, please save your work and log out, Thank You" -AllVMs

<!--NeedCopy-->

Esempio: NewVMsOnly (nuove ed esistenti) nel catalogo di macchine sono considerate per l’aggiornamento:


New-ProvSchemeHardwareUpdate -ProvisioningSchemeVersion 4 -MaintenanceCycleDescription "Updating RAM and CPU Count to 8GB and 4" -StartsNow -MaxDurationInMinutes 100 -ProvisioningSchemeName CVC -PurgeDBAfterInDays 1 -SessionWarningTimeInMinutes 15 -SessionWarningLogOffTitle "Scheduled Maintenance" -SessionWarningLogOffMessage "There is a scheduled maintenance coming up and involves turning off the machine, please save your work and log out, Thank You" -NewVMsOnly

<!--NeedCopy-->

-  Eseguire `Get-ProvSchemeHardwareUpdate` per recuperare gli oggetti della Finestra di servizio associati agli aggiornamenti dello schema hardware. Esempio:


    -  Get-ProvSchemeHardwareUpdate -MaintenanceCycleId xxxx-xxxx-yyyy-zzzz

<!--NeedCopy-->

-  ### Pianificare gli aggiornamenti hardware su VM specifiche

-  1.  Eseguire `New-ProvVmConfiguration` per creare una nuova configurazione di provisioning VM. Per maggiori informazioni, consultare la [documentazione SDK](https://developer-docs.citrix.com/en-us/citrix-virtual-apps-desktops-sdk/2511/machinecreation/new-provvmconfiguration).
  1. Eseguire il comando PowerShell New-ProvVmHardwareUpdate per pianificare una Finestra di servizio per gli aggiornamenti hardware come specificato nella versione della configurazione della VM.

  • Nota:

    Per ogni VM, le impostazioni personalizzate (versione della configurazione della VM) hanno sempre la precedenza sulle specifiche definite nella versione dello schema di provisioning. Se una particolare impostazione non è personalizzata sulla VM, il suo valore viene ereditato dalla versione dello schema di provisioning associata.

  • Esempio:

New-ProvVmHardwareUpdate -ProvVmConfigurationVersion 4 -StartsNow -MaxDurationInMinutes 100 -ProvisioningSchemeName CVC -VMName AbcTest01

<!--NeedCopy-->

Eseguire Get-ProvVmHardwareUpdate per recuperare gli oggetti della Finestra di servizio associati agli aggiornamenti hardware delle VM. Esempio:


Get-ProvVmHardwareUpdate -MaintenanceCycleId xxxx-xxxx-yyyy-zzzz

<!--NeedCopy-->

È anche possibile rimuovere una personalizzazione utilizzata per creare versioni di provisioning VM utilizzando il comando Remove-ProvVmConfiguration. Esempio:


Remove-ProvVmConfiguration -Version 2 -VMName AbcTest01

<!--NeedCopy-->

Comandi PowerShell vari associati alla Finestra di servizio

  • Get-ProvMaintenanceCycle: Recupera le informazioni di tutte le Finestre di servizio. Esempio:

    
 Get-ProvMaintenanceCycle -MaintenanceCycleId 10073b8e-7e94-4527-8580-0e448eae0ad1

 <!--NeedCopy-->

  • Get-ProvMaintenanceCycleVM: Recupera le informazioni di ogni operazione della Finestra di servizio per le singole VM, insieme al suo stato. Esempio:

    
 Get-ProvMaintenanceCycleVM -MaintenanceOperation HardwareUpdate -VirtualMachineSid 42263076-44ae-1ff9-f58b-62d57ddf8db5

 <!--NeedCopy-->

    I vari stati della Finestra di servizio sono:

    • In esecuzione
    • Non riuscito
    • Completato
    • Annullamento in corso
    • Annullato
    • Non elaborato
    • In sospeso
    • Incompleto
    • Riparato
    • In ripristino

  • Remove-ProvMaintenanceCycle: Rimuove una Finestra di servizio quando la Finestra di servizio non è attiva. Esempio:

    
 Remove-ProvMaintenanceCycle -MaintenanceCycleId 867af1ba-5b72-402e-9dc3-033298248f8e

 <!--NeedCopy-->

  • Cancel-ProvMaintenanceCycle: Se l’operazione non è ancora stata avviata da MCS su una VM, questo comando PowerShell annulla l’operazione. MCS non annulla un’operazione attualmente in esecuzione sulla VM. Esempio:

    
 Cancel-ProvMaintenanceCycle -MaintenanceCycleId 867af1ba-5b72-402e-9dc3-033298248f8e

 <!--NeedCopy-->

  • Restart-ProvMaintenanceCycle: Se una finestra di servizio non è riuscita o è incompleta a causa di cause esterne, come l’hypervisor non disponibile o tempo insufficiente, questo comando aiuta a riavviare il ciclo ed elaborare tutti i processi non riusciti o non elaborati. Esempio:

    
 Restart-ProvMaintenanceCycle -MaintenanceCycleId 4f363b78-458a-403a-82e5-7fcc6caa498b -ScheduledStartTimeInUTC "June 19th 2024, 6AM" -MaxAllocatedDurationInMinutes 400

 <!--NeedCopy-->

  • Update-ProvMaintenanceCycle: Se una finestra di servizio è già pianificata e non è ancora iniziata, questo comando modifica determinati parametri.

    Esempio: Aggiornare la durata massima:

    
 Update-ProvMaintenanceCycle -MaintenanceCycleId 4f363b78-458a-403a-82e5-7fcc6caa498b -MaxDurationInMinutes 100

 <!--NeedCopy-->

    Esempio: Aggiornare le VM per uno schema di provisioning:

    
 Update-ProvMaintenanceCycle -MaintenanceCycleId 4f363b78-458a-403a-82e5-7fcc6caa498b -ProvisioningSchemeUid 867af1ba-5b72-402e-9dc3-033298248f8e -VMName ncn01,ncn02

 <!--NeedCopy-->
Finestra di servizio
May 4, 2026
Grazie al contributo di: 
C
May 4, 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.