Janela de Serviço
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 conectados quando a operação for executada.
- Configurar quantos minutos de buffer são concedidos para salvar o trabalho dos usuários conectados antes que a operação seja executada àforça.
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 agendado: 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. 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 de forma inteligente o fluxo de atualização, verificando a necessidade de reinicialização e lidando com 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 SKUs, o que anteriormente exigia a recriação manual do catálogo.
- Suporte àhibernação para VMs existentes: Supera a limitação do “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 ao usuário: Os usuários conectados 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.
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 oferece suporte a redefinições de disco do sistema operacional e alterações de configuração de hardware usando o PowerShell.
-
Comandos PowerShell: Comandos genéricos são descritos neste artigo, enquanto scripts detalhados e especÃÂficos de hypervisor podem ser encontrados em nossa página do GitHub https://github.com/citrix/citrix-mcs-sdk-samples/.
Redefinir disco do sistema operacional
- As redefinições de disco do sistema operacional 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 sistema operacional 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 sistema operacional 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 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 oferecer suporte àhibernação.
- O SKU da VM e o sistema operacional devem oferecer suporte à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 sistema operacional 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
- Execute
New-ProvSchemeVersionpara 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. - Execute o comando PowerShell
New-ProvSchemeHardwareUpdatepara 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
<!--NeedCopy-->
Exemplo: NewVMsOnly (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" -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](https://developer-docs.citrix.com/en-us/citrix-virtual-apps-desktops-sdk/2511/machinecreation/new-provvmconfiguration).
- Execute o comando PowerShell
New-ProvVmHardwareUpdatepara 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
<!--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-->
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 <!--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
- 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 <!--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 que falharam ou não foram 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-->