Janela de Serviço

Last published : Nov 13, 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 quaisquer usuários que estejam logados quando a operação for executada.
  • Especificar por quantos dias os metadados da tarefa devem ser retidos após a conclusão.
  • 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.

Vantagens

Experiência do usuário e continuidade aprimoradas

  • Tratamento elegante de sessões: 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 econômicas: 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 logoffs de sessão, garantindo que seu catálogo evolua para atender a 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.

Operações da Janela de Serviço

A Janela de Serviço atualmente suporta redefinições de disco do SO, reparo de conta do Active Directory para catálogos provisionados por MCS existentes, habilitação do Entra Hybrid join para catálogos provisionados por MCS existentes e alterações na configuração de hardware. Essas operações podem ser realizadas usando o Web Studio ou o PowerShell.
Web Studio: Atualmente, suportado exclusivamente para ambientes Azure. Para obter orientação, consulte os artigos específicos do hipervisor.
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 da configuração da 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 da Janela de Serviço associados às atualizações do 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 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.
Observação:
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 da Janela de Serviço associados a atualizações de hardware da VM. 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

Reparar conta AD para catálogos existentes

Você pode reparar contas de computador do Active Directory (AD) para catálogos de máquinas MCS existentes, ingressados no AD local e ingressados no Microsoft Entra Hybrid, usando a Janela de Serviço. Isso é útil quando as VMs perderam a confiança do domínio. Este recurso se aplica a catálogos de máquinas MCS persistentes e não persistentes.
Para reparar contas AD para um catálogo de máquinas MCS existente, você pode usar comandos PowerShell para concluir as seguintes etapas:
  1. Abra uma janela do PowerShell.
  2. Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.
  3. Execute o comando New-ProvIdentityUpdate de uma das seguintes maneiras:
    • Para reparar a conta do AD para VMs específicas por nome:
      New-ProvIdentityUpdate -MaintenanceCycleDescription 'repair AD account' -Operation RepairADAccount -MaxDurationInMinutes 60 -ProvisioningSchemeName <catalog-name> -VMName @("vm-1", "vm-2") -StartsNow
    • Para agendar a operação para um horário futuro em vez de iniciar imediatamente:
      New-ProvIdentityUpdate -MaintenanceCycleDescription 'repair AD account' -Operation RepairADAccount -MaxDurationInMinutes 60 -ProvisioningSchemeName <catalog-name> -AllVMs -ScheduledStartTimeInUTC "2026-04-01T02:00:00Z"
  4. Execute Get-ProvMaintenanceCycle para verificar o status do ciclo de manutenção.
Para mais informações, consulte Citrix PowerShell SDK
Observação:
  • Este recurso se aplica apenas a catálogos de máquinas MCS ingressados no Active Directory local e ingressados no Microsoft Entra Hybrid. Ele não oferece suporte a máquinas ingressadas no Entra ID e não ingressadas no domínio.
  • O pool de identidade do esquema de provisionamento deve ter uma conta de serviço do Active Directory local com permissão suficiente para redefinir a senha da conta do computador no domínio.

Habilitar o ingresso híbrido do Entra para catálogos provisionados do MCS existentes

Agora você pode converter catálogos de máquinas MCS existentes ingressados no Active Directory local em catálogos ingressados no Microsoft Entra Híbrido usando a Janela de Serviço. Este recurso se aplica a catálogos de máquinas MCS persistentes e não persistentes.
Para habilitar o ingresso híbrido do Entra para um catálogo de máquinas MCS existente, você pode usar comandos do PowerShell para concluir as seguintes etapas:
  1. Abra uma janela do PowerShell.
  2. Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.
  3. Execute o comando New-ProvIdentityUpdate de uma das seguintes maneiras:
    • Para habilitar o ingresso híbrido do Entra para todas as VMs em um catálogo imediatamente:
      New-ProvIdentityUpdate -MaintenanceCycleDescription 'enable Entra hybrid join' -Operation MigrateActiveDirectoryToEntraHybridJoin -MaxDurationInMinutes 60 -ProvisioningSchemeName <catalog-name> -AllVMs -StartsNow
    • Para habilitar o ingresso híbrido do Entra para VMs específicas por nome: :
      New-ProvIdentityUpdate -MaintenanceCycleDescription 'enable Entra hybrid join' -Operation MigrateActiveDirectoryToEntraHybridJoin -MaxDurationInMinutes 60 -ProvisioningSchemeName <catalog-name> -VMName @("vm-1", "vm-2") -StartsNow
    • Para habilitar o ingresso híbrido do Entra e especificar uma OU de destino para novas VMs:
      New-ProvIdentityUpdate -MaintenanceCycleDescription 'enable Entra hybrid join' -Operation MigrateActiveDirectoryToEntraHybridJoin -MaxDurationInMinutes 60 -ProvisioningSchemeName <catalog-name> -AllVMs -StartsNow -OU "OU=SyncedDevices,DC=example,DC=com"
    • Para agendar a operação para um horário futuro em vez de iniciar imediatamente:
      New-ProvIdentityUpdate -MaintenanceCycleDescription 'enable Entra hybrid join' -Operation MigrateActiveDirectoryToEntraHybridJoin -MaxDurationInMinutes 60 -ProvisioningSchemeName <catalog-name> -AllVMs -ScheduledStartTimeInUTC "2026-04-01T02:00:00Z"
  4. Execute Get-ProvMaintenanceCycle para verificar o status do ciclo de manutenção.
Para obter mais informações, consulte (https://developer-docs.citrix.com/pt-br/citrix-virtual-apps-desktops-sdk/2607 LTSR/)
Observação:
  • Para garantir que o catálogo funcione corretamente, você deve converter todas as máquinas virtuais existentes no catálogo para o ingresso híbrido do Microsoft Entra.
  • Este recurso não oferece suporte a catálogos provisionados por MCS que compartilham um pool de identidade.
  • A imagem base do esquema de provisionamento existente deve ter a versão 2212 ou posterior do VDA instalada, consulte Requisitos para ingresso híbrido do Microsoft Entra.
  • O pool de identidade do esquema de provisionamento deve ter uma conta de serviço do Active Directory local com permissão para definir a propriedade userCertificate no domínio.
  • Certifique-se de que a OU que contém as contas de computador esteja configurada para sincronizar com o Entra ID por meio do Microsoft Entra Connect. Você tem duas opções:
    • Configure o Azure AD Connect para sincronizar dispositivos da OU original para o Entra ID.
    • Mova as contas de computador existentes para uma OU configurada para sincronização do Azure AD Connect manualmente.

Comandos diversos do PowerShell 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
    • Falha
    • Concluído
    • Cancelando
    • Cancelado
    • Não Processado
    • 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 com falha 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

Próximos passos

Para gerenciar operações da Janela de Serviço usando o Web Studio no Azure, consulte operações da Janela de Serviço no Azure.