Citrix DaaS™

Servicefenster

Die Funktion Servicefenster bietet die Möglichkeit, Vorgänge auf MCS-bereitgestellten VMs zu planen und zu automatisieren. Diese Funktion unterstützt derzeit verschiedene Vorgänge wie das Zurücksetzen des Betriebssystemdatenträgers und Änderungen an der Hardwarekonfiguration. Sie können diese Vorgänge planen und später die Fertigstellung überprüfen, anstatt Updates manuell durchzuführen.

  • Sie können Vorgänge entweder für eine bestimmte Liste von VMs oder einen gesamten Maschinenkatalog planen. Jeder Vorgang wird zur angegebenen Zeit ausgeführt. Mehrere Vorgänge können für dieselbe VM geplant werden. Sie können jedoch nicht mehr als ein Hardware-Update für eine einzelne VM planen.

  • Sie können auch:

  • Eine Beschreibung für das Servicefenster hinzufügen.
  • Eine detaillierte Nachricht bereitstellen, die allen angemeldeten Benutzern angezeigt wird, wenn der Vorgang ausgeführt wird.
  • Konfigurieren, wie viele Puffer-Minuten zum Speichern der Arbeit für die angemeldeten Benutzer gewährt werden, bevor der Vorgang zwangsweise ausgeführt wird.

Vorteile

Verbesserte Benutzererfahrung und Kontinuität

  • Anmutige Sitzungsbehandlung: Anstelle abrupter Trennungen können Sie eine professionelle Benachrichtigung definieren, um die Arbeit zu speichern, bevor die VM heruntergefahren wird.
  • Geplante Ausfallzeiten: Sie können umfangreiche Update-Aufgaben in Nebenzeiten (z. B. 2:00 Uhr morgens) verschieben, ohne sich zu diesem Zeitpunkt manuell anmelden zu müssen.
  • Kosteneffiziente Hardware-Updates: Die Aktualisierung der Hardware mithilfe des Servicefensters spart erhebliche Kosten bei großen Implementierungen. Diese Funktion analysiert automatisch, ob eine VM einen Neustart benötigt, um Einstellungen anzuwenden. Durch die Vermeidung unnötiger Neustarts minimiert das Servicefenster diese Ausgaben.

Erweiterte Hardware-Flexibilität

  • Hardwarekonfigurationen aktualisieren: Verwenden Sie das Servicefenster, um Hardware-Updates zu planen. Das System verwaltet den Update-Fluss intelligent, prüft die Notwendigkeit eines Neustarts und handhabt Sitzungsabmeldungen, um sicherzustellen, dass Ihr Katalog sich an neue Ressourcenanforderungen anpasst, ohne manuelle Überwachung.
  • Flexible SKU-Rekonfiguration: SKUs können einfach aktualisiert werden, was zuvor eine manuelle Neuerstellung des Katalogs erforderte.
  • Ruhezustandsunterstützung für bestehende VMs: Überwindet die Einschränkung des “temporären Datenträgers”. Das Servicefenster ermöglicht es dem MCSIO-Treiber, die Auslagerungsdatei auf das Laufwerk C: zu verschieben und Ruhezustandseigenschaften auf bereits bereitgestellten VMs zu aktivieren.

Wichtige Überlegung

  • Benutzerbenachrichtigung: Angemeldete Benutzer erhalten eine erste Benachrichtigung über den Servicefenster-Vorgang, um sicherzustellen, dass sie genügend Zeit haben, ihre Arbeit zu speichern. Nach Ablauf der Benachrichtigungsfrist fährt die Maschine automatisch herunter, um den Vorgang auszuführen.

Einschränkung

Die WBC-Datenträgergröße kann auf den vorhandenen VMs nicht geändert werden. Sie könnte auf den Maschinenkatalog für die neuen VMs angewendet werden.

Servicefenster-Vorgänge

  • Das Servicefenster unterstützt derzeit das Zurücksetzen von Betriebssystemdatenträgern und Änderungen an der Hardwarekonfiguration mithilfe von PowerShell.

  • PowerShell-Befehle: Generische Befehle sind in diesem Artikel beschrieben, während detaillierte, hypervisorspezifische Skripte auf unserer GitHub-Seite https://github.com/citrix/citrix-mcs-sdk-samples/ zu finden sind.

Betriebssystemdatenträger zurücksetzen

-  Das Zurücksetzen des Betriebssystemdatenträgers kann mit dem PowerShell-Befehl `New-ProvMaintenanceCycle` durchgeführt werden. Die Befehle erstellen ein neues Servicefenster für einen gesamten Katalog oder bestimmte VMs. Der Zyklus beginnt zu der von Ihnen in `ScheduledStartTimeInUTC` angegebenen Zeit. Sie geben auch `MaxDurationInMinutes` an, was die maximale Laufzeit des Servicefensters angibt.

Beispiel: Betriebssystemdatenträger für bestimmte VMs zurücksetzen

-  ```

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


### Beispiel: Betriebssystemdatenträger für den gesamten Katalog zurücksetzen

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


## Hardwareeinstellungen aktualisieren

Planen Sie Hardware-Updates mithilfe des Servicefensters und haben Sie so die volle Kontrolle darüber, wann die Änderungen wirksam werden. Sie können wählen, ob Sie nur die neu erstellten VMs, einen gesamten Katalog (neue und bestehende VMs) oder bei Bedarf bestimmte VMs ansprechen möchten.

    -  Um Hardwareeinstellungen für neue VMs oder den gesamten Katalog zu aktualisieren, wählen Sie eine Bereitstellungsschemaversion aus und führen Sie den PowerShell-Befehl `New-ProvSchemeHardwareUpdate` aus. Sie können eine zuvor erstellte Bereitstellungsschemaversion auf VMs anwenden. Sie können auch den Ruhezustand auf einer VM mit temporärem Datenträger aktivieren.
    -  Um Hardwareeinstellungen für bestimmte VMs zu aktualisieren, wählen Sie eine VM-Konfigurationsversion aus und führen Sie den PowerShell-Befehl `New-ProvVmHardwareUpdate` aus.

### Wichtige Überlegungen

-  Neue Maschinen, die nach der Planung eines Hardware-Updates zu einem Katalog hinzugefügt werden, werden weiterhin mit älteren Spezifikationen erstellt, bis die angegebene UTC-Zeit für die Anwendung neuer Spezifikationen erreicht ist.
-  Ein einzelner Validierungsfehler während der Erstellung des Servicefensters verhindert die Erstellung des Zyklus und gibt eine Fehlermeldung zurück.
    -  Für die Aktivierung des Ruhezustands beachten Sie Folgendes:
    -  Die VDA-Version muss größer als 2503 sein.
    -  Machine Creation Services I/O (MCSIO) muss installiert sein.
    -  Das Maschinenprofil muss den Ruhezustand unterstützen.
    -  Die VM-SKU und das Betriebssystem müssen den Ruhezustand unterstützen.
    -  Wenn VBS aktiviert ist, muss auch Hyper-V aktiviert sein. Geschachtelte Virtualisierung erfordert Trusted Launch auf der VM.
    -  Die freie Größe des Betriebssystemdatenträgers muss größer sein als die Speichergröße der VM.

### Hardware-Updates für einen gesamten Maschinenkatalog oder neue VMs planen

1.  Führen Sie `New-ProvSchemeVersion` aus, um eine neue Bereitstellungsschemaversion mit aktualisierten Hardwareeinstellungen zu erstellen. Weitere Informationen finden Sie in der [SDK-Dokumentation](https://developer-docs.citrix.com/en-us/citrix-virtual-apps-desktops-sdk/2511/machinecreation/new-provschemeversion).
1.  Führen Sie den PowerShell-Befehl `New-ProvSchemeHardwareUpdate` aus, um ein Servicefenster für Hardware-Updates gemäß der Bereitstellungsschemaversion zu planen.

**Beispiel: `AllVMs` (neue und bestehende) im Maschinenkatalog werden für das Update berücksichtigt:**

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


**Beispiel: `NewVMsOnly` (neue und bestehende) im Maschinenkatalog werden für das Update berücksichtigt:**

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 -


    -  Führen Sie `Get-ProvSchemeHardwareUpdate` aus, um Servicefenster-Objekte abzurufen, die mit Hardware-Schema-Updates verknüpft sind. Beispiel:

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

Hardware-Updates für bestimmte VMs planen

    1. Führen Sie New-ProvVmConfiguration aus, um eine neue Bereitstellungs-VM-Konfiguration zu erstellen. Weitere Informationen finden Sie in der SDK-Dokumentation.
  1. Führen Sie den PowerShell-Befehl New-ProvVmHardwareUpdate aus, um ein Servicefenster für Hardware-Updates gemäß der VM-Konfigurationsversion zu planen.
  • Hinweis:

    Für jede VM haben personalisierte Einstellungen (VM-Konfigurationsversion) immer Vorrang vor den in der Bereitstellungsschemaversion definierten Spezifikationen. Wenn eine bestimmte Einstellung auf der VM nicht personalisiert ist, wird ihr Wert von der zugehörigen Bereitstellungsschemaversion geerbt.

  • Beispiel:
New-ProvVmHardwareUpdate -ProvVmConfigurationVersion 4 -StartsNow -MaxDurationInMinutes 100 -ProvisioningSchemeName CVC -VMName AbcTest01
-  <!--NeedCopy-->

Führen Sie Get-ProvVmHardwareUpdate aus, um Servicefenster-Objekte abzurufen, die mit Hardware-VM-Updates verknüpft sind. Beispiel:


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

<!--NeedCopy-->

Sie können auch eine Personalisierung, die zur Erstellung von Bereitstellungs-VM-Versionen verwendet wurde, mit dem Befehl Remove-ProvVmConfiguration entfernen. Beispiel:


Remove-ProvVmConfiguration -Version 2 -VMName AbcTest01

<!--NeedCopy-->

Verschiedene PowerShell-Befehle, die mit dem Servicefenster verknüpft sind

  • Get-ProvMaintenanceCycle: Ruft Informationen zu allen Servicefenstern ab. Beispiel:

     Get-ProvMaintenanceCycle -MaintenanceCycleId 10073b8e-7e94-4527-8580-0e448eae0ad1
     <!--NeedCopy-->
    
  • Get-ProvMaintenanceCycleVM: Ruft Informationen zu jedem Servicefenster-Vorgang für einzelne VMs zusammen mit dessen Status ab. Beispiel:

     Get-ProvMaintenanceCycleVM -MaintenanceOperation HardwareUpdate -VirtualMachineSid 42263076-44ae-1ff9-f58b-62d57ddf8db5
     <!--NeedCopy-->
    

    Die verschiedenen Status des Servicefensters sind:

    • Wird ausgeführt
    • Fehlgeschlagen
    • Abgeschlossen
    • Wird abgebrochen
    • Abgebrochen
    • Nicht verarbeitet
    • Ausstehend
    • Unvollständig
    • Repariert
    • Wird wiederhergestellt
  • Remove-ProvMaintenanceCycle: Entfernt ein Servicefenster, wenn das Servicefenster nicht aktiv ist. Beispiel:

     Remove-ProvMaintenanceCycle -MaintenanceCycleId 867af1ba-5b72-402e-9dc3-033298248f8e
     <!--NeedCopy-->
    
  • Cancel-ProvMaintenanceCycle: Wenn der Vorgang von MCS auf einer VM noch nicht gestartet wurde, bricht dieser PowerShell-Befehl den Vorgang ab. MCS bricht einen Vorgang, der derzeit auf der VM ausgeführt wird, nicht ab. Beispiel:

     Cancel-ProvMaintenanceCycle -MaintenanceCycleId 867af1ba-5b72-402e-9dc3-033298248f8e
     <!--NeedCopy-->
    
  • Restart-ProvMaintenanceCycle: Wenn ein Wartungsfenster aufgrund externer Ursachen, wie z. B. eines ausgefallenen Hypervisors oder unzureichender Zeit, fehlgeschlagen oder unvollständig ist, hilft dieser Befehl, den Zyklus neu zu starten und alle fehlgeschlagenen oder nicht verarbeiteten Aufträge zu bearbeiten. Beispiel:

     Restart-ProvMaintenanceCycle -MaintenanceCycleId 4f363b78-458a-403a-82e5-7fcc6caa498b -ScheduledStartTimeInUTC "June 19th 2024, 6AM" -MaxAllocatedDurationInMinutes 400
     <!--NeedCopy-->
    
  • Update-ProvMaintenanceCycle: Wenn ein Wartungsfenster bereits geplant ist und noch nicht begonnen hat, ändert dieser Befehl bestimmte Parameter.

    Beispiel: Maximale Dauer aktualisieren:

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

    Beispiel: VMs für ein Bereitstellungsschema aktualisieren:

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