Janela de Serviço

Last published : Nov 03, 2026
O recurso Janela de Serviço oferece a capacidade de agendar e automatizar operações em VMs provisionadas por MCS. Atualmente, esse recurso oferece suporte a várias operações, como redefinição de disco do sistema operacional e alterações na configuração de hardware. Você pode agendar essas operações e retornar mais tarde para verificar a conclusão, em vez de realizar as atualizações manualmente.
Você pode agendar operações para uma lista específica de VMs ou para um catálogo de máquinas inteiro. Cada operação é executada no horário especificado. Várias operações podem ser agendadas para a mesma VM. No entanto, você não pode agendar mais de uma atualização de hardware para uma única VM.
Você também pode:
  • Adicionar uma descrição para a Janela de Serviço.
  • Fornecer uma mensagem detalhada a ser exibida para todos os usuários que estiverem logados quando a operação for executada.
  • Configurar quantos minutos de buffer são concedidos para salvar o trabalho dos usuários logados antes que a operação seja executada à força.
Related information
Planejar e construir uma implantação

Vantagens

Experiência do usuário e continuidade aprimoradas

  • Tratamento de sessão elegante: Em vez de desconexões abruptas, você pode definir uma notificação profissional para salvar o trabalho antes que a VM seja desligada.
  • Tempo de inatividade programado: Você pode mover tarefas de atualização pesadas para horários de pico (por exemplo, 2:00 AM) sem precisar fazer login manualmente nesse horário.
  • Atualizações de hardware com custo-benefício: A atualização de hardware usando a Janela de Serviço economiza custos significativos em grandes implementações. Esse recurso analisa automaticamente se uma VM requer uma reinicialização para aplicar as configurações. Portanto, ao evitar reinicializações desnecessárias, a Janela de Serviço minimiza essas despesas.

Flexibilidade avançada de hardware

  • Atualizar configurações de hardware: Use a Janela de Serviço para agendar as atualizações de hardware. O sistema gerencia inteligentemente o fluxo de atualização, verificando a necessidade de reinicialização e lidando com os log-offs de sessão, garantindo que seu catálogo evolua para atender às novas demandas de recursos com supervisão manual zero.
  • Reconfiguração flexível de SKU: Atualize facilmente os SKUs, o que antes exigia a recriação manual do catálogo.
  • Suporte à hibernação para VMs existentes: Supera a limitação de "disco temporário". A Janela de Serviço permite que o driver MCSIO realoque o arquivo de paginação para a unidade C: e habilite as propriedades de hibernação em VMs que já foram implantadas.

Consideração importante

  • Notificação do usuário: Usuários logados recebem um alerta inicial sobre a operação da Janela de Serviço, garantindo que tenham tempo suficiente para salvar seu trabalho. Assim que o período de notificação expira, a máquina é desligada automaticamente para realizar a operação.

Limitação

O tamanho do disco WBC não pode ser alterado nas VMs existentes. Ele pode ser aplicado ao catálogo de máquinas para as novas VMs.

Operações da Janela de Serviço

A Janela de Serviço atualmente suporta redefinições de disco do SO e alterações de configuração de hardware usando PowerShell.
Comandos PowerShell: Comandos genéricos são descritos neste artigo, enquanto scripts detalhados e específicos do hipervisor podem ser encontrados em nossa página do GitHub <https://github.com/citrix/citrix-mcs-sdk-samples/>.

Redefinir disco do SO

As redefinições de disco do SO podem ser feitas usando o comando PowerShell New-ProvMaintenanceCycle. Os comandos criam uma nova Janela de Serviço para um catálogo inteiro ou VMs específicas. O ciclo começa no horário que você especificar em ScheduledStartTimeInUTC. Você também fornece MaxDurationInMinutes, que indica o tempo máximo que a Janela de Serviço pode ser executada.

Exemplo: Redefinir disco do SO para VMs específicas

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

Exemplo: Redefinir disco do SO para o catálogo inteiro

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

Atualizar configurações de hardware

Agende atualizações de hardware usando a Janela de Serviço, tendo assim controle total sobre quando as alterações entram em vigor. Você pode optar por direcionar apenas as VMs recém-criadas, um catálogo inteiro (VMs novas e existentes) ou VMs específicas, conforme necessário.
  • Para atualizar as configurações de hardware para novas VMs ou para o catálogo inteiro, selecione uma versão do esquema de provisionamento e execute o comando PowerShell New-ProvSchemeHardwareUpdate. Você pode aplicar uma versão do esquema de provisionamento criada anteriormente às VMs. Você também pode habilitar a hibernação em uma VM com disco temporário.
  • Para atualizar as configurações de hardware para VMs específicas, selecione uma versão de configuração de VM e execute o comando PowerShell New-ProvVmHardwareUpdate.

Considerações importantes

  • Novas máquinas adicionadas a um catálogo após o agendamento de uma atualização de hardware continuam a ser criadas com especificações mais antigas até o horário UTC especificado para a aplicação de novas especificações.
  • Uma única falha de validação durante a criação da Janela de Serviço impede que o ciclo seja criado e retorna uma mensagem de erro.
  • Para habilitar a hibernação, considere o seguinte:
    • A versão do VDA deve ser superior a 2503.
    • O Machine Creation Services I/O (MCSIO) deve estar instalado.
    • O perfil da máquina deve suportar hibernação.
    • O SKU da VM e o sistema operacional devem suportar hibernação.
    • Se o VBS estiver habilitado, o Hyper-V também deve estar habilitado. A virtualização aninhada requer o Trusted Launch na VM.
    • O tamanho livre do disco do SO deve ser maior que o tamanho da memória da VM.

Agendar atualizações de hardware em um catálogo de máquinas inteiro ou em novas VMs

  1. Execute New-ProvSchemeVersion para criar uma nova versão do esquema de provisionamento com configurações de hardware atualizadas. Para obter mais informações, consulte a documentação do SDK.
  2. Execute o comando PowerShell New-ProvSchemeHardwareUpdate para agendar uma Janela de Serviço para atualizações de hardware conforme especificado na versão do esquema de provisionamento.
Exemplo: AllVMs (novas e existentes) no catálogo de máquinas são consideradas para a atualização:
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
Exemplo: NewVMsOnly (novos e existentes) no catálogo de máquinas são considerados para a atualização:
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
Execute Get-ProvSchemeHardwareUpdate para recuperar objetos de Janela de Serviço associados a atualizações de esquema de hardware. Exemplo:
Get-ProvSchemeHardwareUpdate -MaintenanceCycleId xxxx-xxxx-yyyy-zzzz

Agendar atualizações de hardware em VMs específicas

  1. Execute New-ProvVmConfiguration para criar uma nova configuração de VM de provisionamento. Para obter mais informações, consulte a documentação do SDK.
  2. Execute o comando PowerShell New-ProvVmHardwareUpdate para agendar uma Janela de Serviço para atualizações de hardware conforme especificado na versão da configuração da VM.
Nota:
Para cada VM, quaisquer configurações personalizadas (versão da configuração da VM) sempre têm precedência sobre as especificações definidas na versão do esquema de provisionamento. Se uma configuração específica não for personalizada na VM, seu valor será herdado da versão do esquema de provisionamento associado.
Exemplo:
New-ProvVmHardwareUpdate -ProvVmConfigurationVersion 4 -StartsNow -MaxDurationInMinutes 100 -ProvisioningSchemeName CVC -VMName AbcTest01
Execute Get-ProvVmHardwareUpdate para recuperar objetos de Janela de Serviço associados a atualizações de VM de hardware. Exemplo:
Get-ProvVmHardwareUpdate -MaintenanceCycleId xxxx-xxxx-yyyy-zzzz
Você também pode remover uma personalização usada para criar versões de VM de provisionamento usando o comando Remove-ProvVmConfiguration. Exemplo:
Remove-ProvVmConfiguration -Version 2 -VMName AbcTest01

Comandos PowerShell diversos associados à Janela de Serviço

  • Get-ProvMaintenanceCycle: Recupera informações de todas as Janelas de Serviço. Exemplo:
    Get-ProvMaintenanceCycle -MaintenanceCycleId 10073b8e-7e94-4527-8580-0e448eae0ad1
  • Get-ProvMaintenanceCycleVM: Recupera informações de cada operação da Janela de Serviço para VMs individuais, juntamente com seu status. Exemplo:
    Get-ProvMaintenanceCycleVM -MaintenanceOperation HardwareUpdate -VirtualMachineSid 42263076-44ae-1ff9-f58b-62d57ddf8db5
    Os vários status da Janela de Serviço são:
    • Em execução
    • Falhou
    • Concluído
    • Cancelando
    • Cancelado
    • NãoProcessado
    • Pendente
    • Incompleto
    • Reparado
    • Recuperando
  • Remove-ProvMaintenanceCycle: Remove uma Janela de Serviço quando a Janela de Serviço não está ativa. Exemplo:
    Remove-ProvMaintenanceCycle -MaintenanceCycleId 867af1ba-5b72-402e-9dc3-033298248f8e
  • Cancel-ProvMaintenanceCycle: Se a operação ainda não foi iniciada pelo MCS em uma VM, este comando PowerShell cancela a operação. O MCS não cancela uma operação que está atualmente em execução na VM. Exemplo:
    Cancel-ProvMaintenanceCycle -MaintenanceCycleId 867af1ba-5b72-402e-9dc3-033298248f8e
  • Restart-ProvMaintenanceCycle: Se uma Janela de Serviço falhou ou está incompleta devido a causas externas, como o hipervisor estar inativo ou tempo insuficiente, este comando ajuda a reiniciar o ciclo e processar quaisquer trabalhos falhos ou não processados. Exemplo:
    Restart-ProvMaintenanceCycle -MaintenanceCycleId 4f363b78-458a-403a-82e5-7fcc6caa498b -ScheduledStartTimeInUTC "June 19th 2024, 6AM" -MaxAllocatedDurationInMinutes 400
  • Update-ProvMaintenanceCycle: Se uma Janela de Serviço já está agendada e não foi iniciada, este comando altera certos parâmetros.
    Exemplo: Atualizar duração máxima:
    Update-ProvMaintenanceCycle -MaintenanceCycleId 4f363b78-458a-403a-82e5-7fcc6caa498b -MaxDurationInMinutes 100
    Exemplo: Atualizar VMs para um esquema de provisionamento:
    Update-ProvMaintenanceCycle -MaintenanceCycleId 4f363b78-458a-403a-82e5-7fcc6caa498b -ProvisioningSchemeUid 867af1ba-5b72-402e-9dc3-033298248f8e -VMName ncn01,ncn02