Documentação de produtos
Citrix Virtual Apps and Desktops
Serviço 2607 LTSR Versão Atual 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
Ver PDF

Janela de Serviço

September 15, 2026
Contribuição de: 
C

O recurso Janela de Serviço oferece a capacidade de agendar e automatizar operações em VMs provisionadas por MCS. Atualmente, este recurso oferece suporte a várias operações, como redefinição de disco do sistema operacional e alterações de 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ão: 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 a necessidade de 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. Este 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 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 pagefile 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: Os 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 desliga 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 de junção híbrida do Entra para catálogos provisionados por MCS existentes e alterações de 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. O comando cria 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
<!--NeedCopy-->

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

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 o documento 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 (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" -AllVMs
<!--NeedCopy-->

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

Execute Get-ProvSchemeHardwareUpdate para recuperar objetos da Janela de Serviço associados a atualizações de esquema de hardware. Exemplo:

Get-ProvSchemeHardwareUpdate -MaintenanceCycleId xxxx-xxxx-yyyy-zzzz
<!--NeedCopy-->

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

Execute Get-ProvVmHardwareUpdate para recuperar objetos da Janela de Serviço associados a atualizações de VM de hardware. Exemplo:

Get-ProvVmHardwareUpdate -MaintenanceCycleId xxxx-xxxx-yyyy-zzzz
<!--NeedCopy-->

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

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. Esse 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 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
 <!--NeedCopy-->

    • 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"
 <!--NeedCopy-->
  4. Execute Get-ProvMaintenanceCycle para verificar o status do ciclo de manutenção.

Para obter mais informações, consulte Citrix PowerShell SDK

Nota:

  • 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 identidades 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 de computador no domínio.

Habilitar o ingresso híbrido do Entra para catálogos provisionados por 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 Hybrid 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
 <!--NeedCopy-->

    • Para habilitar o Entra Hybrid join 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
 <!--NeedCopy-->

    • Para habilitar o Entra Hybrid join 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"
 <!--NeedCopy-->

    • 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"
 <!--NeedCopy-->
  4. Execute Get-ProvMaintenanceCycle para verificar o status do ciclo de manutenção.

Para obter mais informações, consulte Citrix PowerShell SDK

Nota:

  • Para garantir que o catálogo funcione corretamente, você deve converter todas as máquinas virtuais existentes no catálogo para Microsoft Entra Hybrid joined.
  • 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 Microsoft Entra hybrid joined.
  • 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
 <!--NeedCopy-->

  • 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
 <!--NeedCopy-->

    Os vários status da Janela de Serviço são:

    • Em execução
    • Falhou
    • 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
 <!--NeedCopy-->

  • 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
 <!--NeedCopy-->

  • 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
 <!--NeedCopy-->

  • Update-ProvMaintenanceCycle: Se uma Janela de Serviço já estiver agendada e não tiver sido iniciada, este comando altera certos parâmetros.

    Exemplo: Atualizar duração máxima:

     Update-ProvMaintenanceCycle -MaintenanceCycleId 4f363b78-458a-403a-82e5-7fcc6caa498b -MaxDurationInMinutes 100
 <!--NeedCopy-->

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

Onde ir em seguida

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.

Janela de Serviço
September 15, 2026
Contribuição de: 
C
September 15, 2026
Contribuição de: 
C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.