在 Azure 虛擬桌面中使用工作階段主機更新更新工作階段主機 （預覽）

以下說明如何使用 Azure 入口網站 排程會話主機的新更新。

1. 登入 Azure 入口網站。

2. 在搜尋列中輸入「Azure 虛擬桌面」，並選取相符的服務項目。

3. 選取 [ 主機集區]，然後選取具有您要更新之會話主機組態的主機集區。

4. 選取 [ 工作話主機]。

5. 如果您想要在排程更新之前檢閱會話主機設定，請選取 [管理會話主機設定]，然後選取 [檢視]。 檢閱會話主機設定之後，請選取 [ 取消]。

6. 若要排程新的更新，請選取 [管理會話主機更新]，然後選取 [ 新增更新]。 或者，選取 [管理會話主機設定]，然後選取 [編輯]。

7. 在 [基本] 索引標籤上，輸入下列資訊：

   參數	值/描述
   在更新之後啟用儲存原始虛擬機	在復原案例中很有用，但一般成本適用於儲存原始 VM 的元件。
   目前的主機集區大小 （唯讀）	主機集區中的會話主機數目。
   在更新期間授權從主機集區移除的 VM 批次大小	一次更新的會話主機數目上限。 當更新啟動時，只會先更新一個稱為 初始的會話主機，先確認更新程式，再批次更新其餘的會話主機。 如果初始的更新未成功，更新就會停止。
   更新期間可用的工作階段主機 （唯讀）	更新期間可供用戶會話使用的會話主機數目下限。

   完成此索引標籤之後，請選取 [下一步：會話主機]。

8. 在 [ 工作階段主機] 索引標籤上，您可以選擇性地更新會話主機組態中的下列參數：

   參數	值/描述
   安全性類型	選取 [標準]、[可信啟動虛擬機器] 或 [機密虛擬機器]。 - 如果您選取 [可信啟動虛擬機器]，則會自動選取安全開機和 vTPM 的選項。 - 如果您選取 [機密虛擬機器]，則會自動選取安全開機、vTPM，以及完整性監視的選項。 使用機密 VM 時，您無法退出 vTPM。
   映像	從清單中選取您想要使用的OS映像，或選取 [查看所有映射] 來查看更多，包括您建立並儲存為 Azure 計算資源庫共用映像或受控映像的任何自定義映射。
   虛擬機器大小	從清單中選取建議的 SKU。 如果您要使用不同的 SKU，請選擇 [ 查看所有大小]，然後從清單中選取 。
   OS 磁碟類型	選取要用於工作階段主機的磁碟類型。 建議您針對生產工作負載使用 進階 SSD 。 必須在選取的 VM 系列和大小上支援磁碟類型。 請確定您選取 Azure 計算支援的組合。 更新會話主機的OS磁碟名稱具有格式 SessionHostName-DateTime_Hash的新名稱。
   要加入的網域
   選取您要加入的目錄	選取 [Active Directory]，然後選取密鑰保存庫，其中包含網域加入帳戶之使用者名稱和密碼的秘密。 您可以選擇性地指定功能變數名稱和組織單位路徑。
   虛擬機器系統管理員帳戶	為更新的會話主機 VM 的本機系統管理員帳戶選取密鑰保存庫和密碼，以完成相關參數。 用戶名稱和密碼必須符合 Azure 中 Windows VM 的需求。
   自訂組態
   自訂設定指令碼 URL	如果您想要在部署期間執行 PowerShell 指令碼，可以在這裡輸入 URL。

   檢閱或完成會話主機設定的變更之後，請選取 [ 下一步：排程]。

9. 在 [排程] 索引標籤上，核取 [立即排程更新] 方塊，或選取您要啟動更新的日期、時間和時區，最多從目前時間起兩周。

   設定排程之後，請選取 [ 下一步：通知]。

10. 在 [ 通知] 索引 標籤上，完成下列資訊：

    參數	值/描述
    用戶註銷前幾分鐘	更新開始時間之後要等候的時間量，讓使用者會收到註銷的通知。此值可在 0 到 60 分鐘之間設定。 經過此時間之後，系統會自動註銷使用者。
    註銷訊息	您可以指定來通知使用者他們所使用的工作階段主機即將開始更新的訊息。

    完成此索引標籤之後，請選取 [ 下一步：檢閱]。

11. 在 [ 檢閱] 索引標籤上，確定驗證通過，並檢閱更新期間使用的資訊。

12. 選取 [ 更新] 以排程更新。 當您檢視會話主機清單時，[目前版本] 資料行會顯示會話主機所使用的會話主機組態版本的時間戳。 如果 [目前版本] 資料行有警告圖示，表示 [目標版本] 數據行中的版本時間戳是稍後，而且會話主機需要更新。

以下說明如何使用 Az.DesktopVirtualization PowerShell 模組排程會話主機的新更新。 當您排程更新時，會使用主機集區的會話主機設定。 您必須在排程更新之前變更會話主機設定。

您可以先更新會話主機管理原則，再排程更新，其中變更會持續供日後使用。 或者，您可以在排程更新時覆寫會話主機管理原則中的值，但它們只適用於該更新。

1. 在 Azure 入口網站中使用 PowerShell 終端機類型開啟 Azure Cloud Shell，或在本機裝置上執行 PowerShell。

   • 如果您使用 Cloud Shell，請確定您的 Azure 內容已設定為您想要使用的訂用帳戶。

   • 如果您在本機使用 PowerShell，請先使用 Azure PowerShell 登入，然後確認您的 Azure 內容已設定為您想要使用的訂用帳戶。

2. Update-AzWvdSessionHostConfiguration使用 Cmdlet 來更新會話主機組態，而您只需要指定您想要變更的參數。 以下是一些範例命令：

   • 若要為要使用的會話主機指定不同的自定義映像，請執行下列命令。 如需如何尋找 Marketplace 映射值的資訊，請參閱 搭配 Azure PowerShell 尋找和使用 Azure Marketplace VM 映射。

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

   • 若要變更儲存本機系統管理員帳戶密碼的金鑰保存庫和秘密，請執行下列命令：

     $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
     

   • 若要將虛擬機大小變更為 D8s_v5 ，並將 OS 磁碟類型變更為 進階 SSD，請執行下列命令。 更新會話主機的OS磁碟名稱具有格式 SessionHostName-DateTime_Hash的新名稱。

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

   執行下列命令來檢視會話主機組態，以確認變更：

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

3. 選擇性：如果您想要在排程更新之前更新會話主機管理原則，請使用 Update-AzWvdSessionHostManagement Cmdlet 執行下列命令。 或者，您可以在排程只用於該更新的更新時覆寫特定值。 如需有效的時區值，請參閱 Get-TimeZone PowerShell 參考 並使用 來自 StandardName 屬性的值。

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

   您可以執行下列命令來檢視更新工作階段主機管理原則的屬性：

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

4. 若要排程更新，請使用 Invoke-AzWvdInitiateSessionHostUpdate Cmdlet 搭配下列範例。 您可以排程更新立即啟動，或指定您希望更新啟動的時間，最多兩周。 以下是一些範例命令：

   • 若要排程更新以立即啟動並使用會話主機管理原則中的值，請執行下列命令：

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

   • 若要在指定的時間和日期排程更新（格式 為YYYY-MM-DD HH：mm），並使用會話主機管理原則中的值，請執行下列命令。

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

   • 若要啟動已排程的更新，請執行下列命令：

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

5. 您可以執行下列命令來檢視排程更新的屬性：

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

以下說明如何使用 Azure 入口網站監視更新的進度。

1. 從 Azure 虛擬桌面概觀中，選取 [ 主機集區]，然後選取您排程更新的主機集區。

2. 選取 [ 工作話主機]。

3. 藍色橫幅提供更新的狀態。 它只會顯示時間點，因此您必須選取 [ 重新 整理] 以檢查最新的進度。

如果您選取立即啟動更新，訊息會指出更新會在更新開始時排程，但當您重新整理之後，就會更新此訊息。 在更新期間，您會看到更新期間從主機集區移除的會話主機批次大小數目。

以下說明如何使用 Az.DesktopVirtualization PowerShell 模組來監視更新的進度。

從現有的PowerShell工作階段中，使用 Get-AzWvdSessionHostManagementsUpdateStatus Cmdlet 搭配下列範例來取得目前更新的詳細數據。

• 若要查看最新更新的進度，請執行下列命令：

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

• 若要查看最新更新的所有參數，請執行下列命令：

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

以下說明如何使用 Azure 入口網站 暫停、繼續、取消或重試更新。

1. 從 Azure 虛擬桌面概觀中，選取 [ 主機集區]，然後選取您排程更新的主機集區。

2. 選取 [會話主機]，然後選取 [ 管理會話主機更新]。

3. 根據更新的目前狀態，選取 [暫停]、[繼續]、[取消] 或 [重試]。

4. 選取 [ 重新整理 ] 以在藍色橫幅中更新狀態消息。 顯示正確狀態可能需要大約 20 秒的時間。

以下說明如何使用 Az.DesktopVirtualization PowerShell 模組暫停、繼續、取消或重試更新。

從現有的PowerShell工作階段中，使用 Invoke-AzWvdControlSessionHostUpdate Cmdlet 搭配下列範例來暫停或繼續目前的更新。

1. 首先，執行下列命令來檢查更新狀態：

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

2. 視您想要採取的動作而定，請使用下列其中一個範例。

   • 若要暫停更新，請執行下列命令：

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

   • 若要繼續更新，請執行下列命令：

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

   • 若要取消更新並包含訊息，請執行下列命令：

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

   • 若要重試更新，請執行下列命令：

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

3. 執行下列命令，檢查執行動作之後的更新動作和狀態：

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