Aktualisieren von Sitzungshosts mithilfe des Sitzungshostupdates in Azure Virtual Desktop (Vorschau)

Hier erfahren Sie, wie Sie mithilfe der Azure-Portal ein neues Update für Ihre Sitzungshosts planen.

1. Melden Sie sich beim Azure-Portal an.

2. Geben Sie in der Suchleiste Azure Virtual Desktop ein, und wählen Sie den entsprechenden Diensteintrag aus.

3. Wählen Sie Hostpools und dann den Hostpool mit einer Sitzungshostkonfiguration aus, die Sie aktualisieren möchten.

4. Wählen Sie Sitzungshosts aus.

5. Wenn Sie die Sitzungshostkonfiguration überprüfen möchten, bevor Sie ein Update planen, wählen Sie Sitzungshostkonfiguration verwalten und dann Anzeigen aus. Nachdem Sie die Konfiguration des Sitzungshosts überprüft haben, wählen Sie Abbrechen aus.

6. Um ein neues Update zu planen, wählen Sie Sitzungshostupdate verwalten und dann Neues Update aus. Wählen Sie alternativ Sitzungshostkonfiguration verwalten und dann Bearbeiten aus.

7. Geben Sie auf der Registerkarte Grundlagen die folgenden Informationen ein:

   Parameter	Wert/Beschreibung
   Aktuelle Hostpoolgröße (schreibgeschützt)	Die Anzahl der Sitzungshosts in Ihrem Hostpool.
   VM-Batchgröße, die während des Updates zum Entfernen aus dem Hostpool autorisiert ist	Die maximale Anzahl von Sitzungshosts, die gleichzeitig aktualisiert werden. Wenn das Update gestartet wird, wird zuerst nur ein Sitzungshost, der als initial bezeichnet wird, aktualisiert, um den Aktualisierungsprozess zu überprüfen, bevor die verbleibenden Sitzungshosts in Batches aktualisiert werden. Wenn das Update des anfangs nicht erfolgreich ist, wird das Update beendet.
   Während des Updates verfügbare Sitzungshosts (schreibgeschützt)	Die Mindestanzahl von Sitzungshosts, die während des Updates für Benutzersitzungen verfügbar sind.

   Nachdem Sie diese Registerkarte abgeschlossen haben, wählen Sie Weiter: Sitzungshosts aus.

8. Auf der Registerkarte Sitzungshosts können Sie optional die folgenden Parameter in Ihrer Sitzungshostkonfiguration aktualisieren:

   Parameter	Wert/Beschreibung
   Sicherheitstyp	Wählen Sie Standard, virtuelle Computer mit vertrauenswürdigem Start oder Vertrauliche virtuelle Computer aus. – Wenn Sie virtuelle Computer vertrauenswürdig starten auswählen, werden die Optionen für den sicheren Start und vTPM automatisch ausgewählt. – Wenn Sie Vertrauliche virtuelle Computer auswählen, werden die Optionen für den sicheren Start, vTPM und Integritätsüberwachung automatisch ausgewählt. Sie können vTPM nicht deaktivieren, wenn Sie einen vertraulichen virtuellen Computer verwenden.
   Bild	Wählen Sie das zu verwendende Betriebssystemimage aus der Liste aus, oder wählen Sie Alle Images anzeigen aus, um mehr anzuzeigen, einschließlich aller benutzerdefinierten Images, die Sie als freigegebenes Azure Compute Gallery-Image oder verwaltetes Image erstellt und gespeichert haben.
   Größe des virtuellen Computers	Wählen Sie eine empfohlene SKU aus der Liste aus. Wenn Sie eine andere SKU verwenden möchten, wählen Sie Alle Größen anzeigen und dann aus der Liste aus.
   Betriebssystem-Datentyp	Wählen Sie den Datenträgertyp aus, der für Ihre Sitzungshosts verwendet werden soll. Es wird empfohlen, SSD Premium für Produktionsworkloads zu verwenden. Der Datenträgertyp muss für die vm-Familie und die ausgewählte Größe unterstützt werden. Stellen Sie sicher, dass Sie eine Kombination auswählen, die Azure Compute unterstützt. Der Name des Betriebssystemdatenträgers der aktualisierten Sitzungshosts hat einen neuen Namen im Format SessionHostName-DateTime_Hash.
   Domäne zum Beitreten
   Verzeichnis auswählen, dem Sie beitreten möchten	Wählen Sie entweder Microsoft Entra oder Active Directory aus. Wenn Sie Active Directory verwenden, wählen Sie den Schlüsseltresor aus, der die Geheimnisse für den Benutzernamen und das Kennwort für das Domänenbeitrittskonto enthält. Optional können Sie einen Domänennamen und einen Organisationseinheitspfad angeben.
   Administratorkonto für virtuelle Computer	Schließen Sie die relevanten Parameter ab, indem Sie den Schlüsseltresor und das Geheimnis für den Benutzernamen und das Kennwort für das lokale Administratorkonto der aktualisierten Sitzungshost-VMs auswählen. Der Benutzername und das Kennwort müssen die Anforderungen für virtuelle Windows-Computer in Azure erfüllen.
   Benutzerdefinierte Konfiguration
   URL des benutzerdefinierten Konfigurationsskripts	Wenn Sie während der Bereitstellung ein PowerShell-Skript ausführen möchten, können Sie die URL hier eingeben.

   Nachdem Sie die Konfiguration des Sitzungshosts überprüft oder geändert haben, wählen Sie Weiter: Zeitplan aus.

9. Aktivieren Sie auf der Registerkarte Zeitplan entweder das Kontrollkästchen Update jetzt planen, oder wählen Sie ein Datum, eine Uhrzeit und eine Zeitzone aus, für die das Update bis zu maximal zwei Wochen ab dem aktuellen Zeitpunkt gestartet werden soll.

   Nachdem Sie Ihren Zeitplan festgelegt haben, wählen Sie Weiter: Benachrichtigungen aus.

10. Geben Sie auf der Registerkarte Benachrichtigungen die folgenden Informationen ein:

    Parameter	Wert/Beschreibung
    Minuten vor der Abmeldung der Benutzer	Die Zeitspanne, die nach der Startzeit des Updates gewartet werden soll, bis Benutzer benachrichtigt werden, sich abzumelden. Dieser Wert kann zwischen 0 und 60 Minuten konfiguriert werden. Benutzer werden nach dieser verstrichenen Zeit automatisch abgemeldet.
    Abmeldenachricht	Eine Meldung, die Sie angeben können, um Benutzer darüber zu informieren, dass der verwendete Sitzungshost mit dem Aktualisieren beginnen wird.

    Nachdem Sie diese Registerkarte abgeschlossen haben, wählen Sie Weiter: Überprüfen aus.

11. Stellen Sie auf der Registerkarte Überprüfen sicher, dass die Überprüfung erfolgreich ist, und überprüfen Sie die Informationen, die während des Updates verwendet werden.

12. Wählen Sie Aktualisieren aus, um das Update zu planen. Wenn Sie die Liste der Sitzungshosts anzeigen, zeigt die Spalte Aktuelle Version den Zeitstempel der Version der Sitzungshostkonfiguration an, die der Sitzungshost verwendet. Wenn die Spalte Aktuelle Version ein Warnsymbol enthält, bedeutet dies, dass der Zeitstempel der Version in der Spalte Zielversion höher ist und der Sitzungshost aktualisiert werden muss.

Hier erfahren Sie, wie Sie mithilfe des PowerShell-Moduls Az.DesktopVirtualization ein neues Update für Ihre Sitzungshosts planen. Wenn Sie ein Update planen, wird die Sitzungshostkonfiguration für den Hostpool verwendet. Sie müssen Änderungen an der Sitzungshostkonfiguration vornehmen, bevor Sie ein Update planen.

Sie können die Sitzungshostverwaltungsrichtlinie aktualisieren, bevor Sie ein Update planen, wobei die Änderungen für die zukünftige Verwendung beibehalten werden. Alternativ können Sie die Werte in der Sitzungshostverwaltungsrichtlinie beim Planen eines Updates außer Kraft setzen, aber sie gelten nur für dieses Update.

1. Öffnen Sie Azure Cloud Shell im Azure-Portal mit dem PowerShell-Terminaltyp, oder führen Sie PowerShell auf Ihrem lokalen Gerät aus.

   • Wenn Sie Cloud Shell verwenden, stellen Sie sicher, dass Ihr Azure-Kontext auf das Abonnement festgelegt ist, das Sie verwenden möchten.

   • Wenn Sie PowerShell lokal verwenden, melden Sie sich zuerst mit Azure PowerShell an, und stellen Sie dann sicher, dass Ihr Azure-Kontext auf das Abonnement festgelegt ist, das Sie verwenden möchten.

2. Verwenden Sie das Update-AzWvdSessionHostConfiguration Cmdlet, um die Sitzungshostkonfiguration zu aktualisieren, in der Sie nur die Parameter angeben müssen, die Sie ändern möchten. Hier sind einige Beispielbefehle:

   • Führen Sie den folgenden Befehl aus, um ein anderes benutzerdefiniertes Image für Ihre Sitzungshosts anzugeben. Informationen zum Suchen der Werte für das Marketplace-Image finden Sie unter Suchen und Verwenden von Azure Marketplace-VM-Images mit Azure PowerShell.

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          ImageInfoType = 'Custom'
          CustomInfoResourceID  = '/subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroupName>/providers/Microsoft.Compute/galleries/<GalleryName>/images/<ImageName>/versions/<ImageVersion>'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   • Führen Sie den folgenden Befehl aus, um den Schlüsseltresor und das Geheimnis zu ändern, in dem das Kennwort für das lokale Administratorkonto gespeichert wird:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          VMAdminCredentialsUsernameKeyVaultSecretUri = 'https://<VaultName>.vault.azure.net/secrets/<SecretName>/<Version>'
          VMAdminCredentialsPasswordKeyVaultSecretUri = 'https://<VaultName>.vault.azure.net/secrets/<SecretName>/<Version>'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   • Führen Sie den folgenden Befehl aus, um die Größe des virtuellen Computers in D8s_v5 und den Betriebssystemdatenträgertyp in SSD Premium zu ändern. Der Name des Betriebssystemdatenträgers der aktualisierten Sitzungshosts hat einen neuen Namen im Format SessionHostName-DateTime_Hash.

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          VMSizeId = 'Standard_D8s_v5'
          DiskInfoType = 'Premium_LRS'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   Zeigen Sie die Sitzungshostkonfiguration an, um die Änderungen zu überprüfen, indem Sie den folgenden Befehl ausführen:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostConfiguration @parameters | FL *
   

3. Optional: Wenn Sie die Sitzungshostverwaltungsrichtlinie aktualisieren möchten, bevor Sie ein Update planen, führen Sie den folgenden Befehl mithilfe des Update-AzWvdSessionHostManagement Cmdlets aus. Alternativ können Sie beim Planen eines Updates bestimmte Werte außer Kraft setzen, die nur für dieses Update verwendet werden. Gültige Zeitzonenwerte finden Sie unter Get-TimeZone PowerShell-Referenz , und verwenden Sie den Wert aus der StandardName -Eigenschaft. Es wird empfohlen, festzulegenUpdateDeleteOriginalVM = $true, damit Sie nach einem Update keine Sitzungshostressourcen sauber müssen.

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       ScheduledDateTimeZone = '<TimeZoneID>'
       UpdateDeleteOriginalVM = <$true or $false>
       UpdateMaxVmsRemoved = '<Quantity>'
       UpdateLogOffDelayMinute = '<Minutes>'
       UpdateLogOffMessage = '<Message>'
   }
   
   Update-AzWvdSessionHostManagement @parameters
   

   Sie können die Eigenschaften der aktualisierten Sitzungshostverwaltungsrichtlinie anzeigen, indem Sie den folgenden Befehl ausführen:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagement @parameters
   

4. Verwenden Sie zum Planen eines Updates das Invoke-AzWvdInitiateSessionHostUpdate Cmdlet mit den folgenden Beispielen. Sie können planen, dass ein Update sofort gestartet wird, oder eine Zeit angeben, zu der das Update gestartet werden soll, bis zu maximal zwei Wochen. Hier sind einige Beispielbefehle:

   • Führen Sie den folgenden Befehl aus, um den sofortigen Start eines Updates zu planen und die Werte aus der Sitzungshostverwaltungsrichtlinie zu verwenden:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

   • Führen Sie den folgenden Befehl aus, um ein Update zu einem bestimmten Zeitpunkt und Datum (im Format JJJJ-MM-TT HH:mm) zu planen und die Werte aus der Sitzungshostverwaltungsrichtlinie zu verwenden.

     $dateTime = Get-Date -Date "2024-03-15 01:30"
     
     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          ScheduledDateTime = $dateTime
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

   • Führen Sie den folgenden Befehl aus, um ein geplantes Update zu starten:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = Start
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

5. Sie können die Eigenschaften des geplanten Updates anzeigen, indem Sie den folgenden Befehl ausführen:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
   

Hier erfahren Sie, wie Sie den Fortschritt eines Updates mithilfe des Azure-Portal überwachen.

1. Wählen Sie in der Übersicht von Azure Virtual Desktop Hostpools und dann den Hostpool aus, für den Sie ein Update geplant haben.

2. Wählen Sie Sitzungshosts aus.

3. Ein blaues Banner stellt die status des Updates bereit. Es wird nur ein Zeitpunkt angezeigt, sodass Sie Aktualisieren auswählen müssen, um den aktuellen Fortschritt zu überprüfen.

Wenn Sie ausgewählt haben, das Update sofort zu starten, wird in der Meldung angegeben, dass das Update geplant ist, während es beginnt. Diese Meldung wird jedoch nach der Aktualisierung aktualisiert. Während eines Updates wird die Batchgröße der Sitzungshosts angezeigt, die während des Updates aus dem Hostpool entfernt werden.

Hier erfahren Sie, wie Sie den Fortschritt eines Updates mithilfe des PowerShell-Moduls Az.DesktopVirtualization überwachen.

Verwenden Sie aus Ihrer vorhandenen PowerShell-Sitzung das Get-AzWvdSessionHostManagementsUpdateStatus Cmdlet mit den folgenden Beispielen, um die Details des aktuellen Updates abzurufen.

• Führen Sie die folgenden Befehle aus, um den Fortschritt des neuesten Updates anzuzeigen:

  $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
  }
  
  $updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters |
       FL PercentComplete,
       ProgressExecutionStartTime,
       ProgressSessionHostsCompleted,
       ProgressSessionHostsInProgress,
       ProgressSessionHostsRollbackFailed,
       ProgressTotalSessionHost,
       EndTime
  
  $updateProgress
  

• Führen Sie den folgenden Befehl aus, um alle Parameter für das neueste Update anzuzeigen:

  $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
  }
  $updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
  
  $updateProgress
  

Hier erfahren Sie, wie Sie ein Update mithilfe des Azure-Portal anhalten, fortsetzen, abbrechen oder wiederholen.

1. Wählen Sie in der Übersicht von Azure Virtual Desktop Hostpools und dann den Hostpool aus, für den Sie ein Update geplant haben.

2. Wählen Sie Sitzungshosts und dann Sitzungshostupdate verwalten aus.

3. Wählen Sie je nach aktuellem Status des Updates Anhalten, Fortsetzen, Abbrechen oder Wiederholen aus.

4. Wählen Sie Aktualisieren aus, um die status Nachricht im blauen Banner zu aktualisieren. Es kann ungefähr 20 Sekunden dauern, bis die richtige status angezeigt wird.

Hier erfahren Sie, wie Sie ein Update mithilfe des PowerShell-Moduls Az.DesktopVirtualization anhalten, fortsetzen, abbrechen oder wiederholen.

Verwenden Sie in Ihrer vorhandenen PowerShell-Sitzung das Invoke-AzWvdControlSessionHostUpdate Cmdlet mit den folgenden Beispielen, um das aktuelle Update anzuhalten oder fortzusetzen.

1. Überprüfen Sie zunächst die update-status, indem Sie den folgenden Befehl ausführen:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Status
   

2. Je nachdem, welche Aktion Sie ausführen möchten, verwenden Sie eines der folgenden Beispiele.

   • Führen Sie den folgenden Befehl aus, um ein Update anzuhalten:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Pause'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Führen Sie den folgenden Befehl aus, um das Update fortzusetzen:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Resume'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Führen Sie den folgenden Befehl aus, um ein Update abzubrechen und eine Nachricht einzuschließen:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Cancel'
          CancelMessage = '<Message>'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Führen Sie den folgenden Befehl aus, um ein Update erneut zu versuchen:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Retry'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

3. Überprüfen Sie die Aktualisierungsaktion und status, nachdem Sie eine Aktion ausgeführt haben, indem Sie den folgenden Befehl ausführen:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Action, Status