當你想用 session host 設定更新主機池中的 session host 時,就使用 session host update。 會話主機更新讓你能更新虛擬機底層 (虛擬機) 映像、大小、磁碟類型及其他設定屬性。 在更新過程中,現有的虛擬機器會被刪除或重新分配,並建立新的虛擬機,並將更新的設定儲存在會話主機的設定中。 更新同時也會利用會話主機管理政策中的值來決定會話主機應該如何更新。
本文將教你如何更新主機池的會話主機設定、更新該池中的會話主機,以及如何使用 Azure 入口網站和 Azure PowerShell 監控更新進度。
想了解更多會話主機更新的運作方式,請參見 會話主機更新。
必要條件
在使用 session host 更新會話主機之前,你需要:
排程更新並編輯會話主機設定
當你排程更新時,會使用主機池的會話主機設定。 你必須在排程更新時更改會話主機設定,否則你的會話主機會被重新部署到相同的會話主機設定值。 你在排程更新時所做的任何變更都會被儲存在會話主機的設定中。
若要為您的會話主機安排更新,請選擇該情境相關的分頁並依照步驟操作。
重要事項
更新期間,使用者會話可用的會話主機數量減少,且所有已登入的使用者都會被要求登出。 我們建議您在較不繁忙的時段安排更新,以減少對終端用戶的干擾。
以下是如何使用 Azure 入口網站為您的會話主機排程新更新的方法。
提示
當你使用 Azure 入口網站排程更新時,數值會從會話主機設定中自動填入。 如果這是第一次更新且尚未建立會話主機設定,入口網站會顯示預設的會話主機設定,直到會話主機設定建立。 你在更新期間對會話主機設定所做的任何更改都會被保存。
如果你用 Azure 入口網站編輯會話主機設定,你必須排程更新。
登入 Azure 入口網站。
在搜尋欄輸入 Azure 虛擬桌面,並選擇匹配的服務條目。
選擇主機池,然後選擇你想更新的會話主機設定的主機池。
選擇 會話主持人。
如果你想在排程更新前先檢視會話主機設定,請選擇 「管理會話主機設定」,然後選擇 檢視。 檢視會話主機設定後,選擇 取消。
要排程新更新,請選擇 「管理會話主機更新」,再選擇 「新更新」。 或者,選擇 管理會話主機設定,然後 編輯。
在 基礎 標籤中,請填寫以下資訊:
| 參數 |
價值/描述 |
| 目前主機池大小 (唯讀) |
你主機池中會話主持人的數量。 |
| 更新時授權從主機池移除的虛擬機批次大小 |
每次更新最多的會話主機數量。
當更新開始時,只有一個會話主機(稱為 初始主機)會先被更新以驗證更新過程,然後再批次更新剩餘的會話主機。 如果初始更新失敗,更新就會停止。 |
| 更新期間可用的會話主機 (唯讀) |
更新期間可供使用者工作階段使用的最低會話主機數。 |
完成此分頁後,選擇 下一頁:會話主持人。
在 會話主機 標籤中,您可以選擇性地更新會話主機設定中的以下參數:
| 參數 |
價值/描述 |
| 安全類型 |
可選擇 Standard、Trusted Launch 虛擬機或 Confidential 虛擬機。
- 若選擇 受信任啟動虛擬機,則會自動選擇 安全開機 與 vTPM 選項。
- 若選擇 機密虛擬機,則會自動選擇 安全開機、 vTPM 及 完整性監控 選項。 使用機密虛擬機時,你無法選擇退出 vTPM。 |
| 影像 |
從列表中選擇你想使用的作業系統映像,或選擇「查看所有映像」以查看更多內容,包括你建立並儲存為 Azure Compute Gallery 共享映像或受管理映像的任何自訂映像。 |
| 虛擬機器大小 |
從清單中選擇推薦的SKU。 如果你想使用不同的 SKU,請選擇 「查看所有尺寸」,然後從列表中選擇。 |
| [作業系統] 磁碟類型 |
選擇要用於會話主機的磁碟類型。 我們建議你在生產工作負載上使用 Premium SSD 。
磁碟類型需要支援虛擬機家族,並選擇大小。 請確保你選擇的是 Azure 運算支援的組合。 更新後會話主機的作業系統磁碟名稱在格式 SessionHostName-DateTime_Hash中有新名稱。 |
|
要加入的網域 |
|
| 選取您要加入的目錄 |
選擇 Microsoft Entra 或 Active Directory。 如果使用 Active Directory,請選擇包含網域加入帳號使用者名稱和密碼秘密的金鑰庫。
你可以選擇指定網域名稱和組織單位路徑。 |
|
虛擬機管理員帳號 |
透過選擇更新後會話主機虛擬機的本地管理員帳號的使用者名稱和密碼的金鑰庫與密碼,來完成相關參數。 使用者名稱和密碼必須符合 Azure 中 Windows 虛擬機的需求。 |
|
自訂配置 |
|
| 自訂設定腳本 URL |
如果你想在部署時執行 PowerShell 腳本,可以在這裡輸入網址。 |
當您檢視或完成對會話主機設定的變更後,請選擇 下一步:排程。
在 排程 標籤中,勾選立即 排程更新的選項,或選擇你希望更新開始的日期、時間和時區,最多可從當前時間起兩週內開始。
設定好行程後,選擇「下一頁:通知」。
在 通知 標籤中,請填寫以下資訊:
| 參數 |
價值/描述 |
| 使用者登出前幾分鐘 |
更新開始時間後,等待用戶登出通知的時間。這個數值可設定在 0 到 60 分鐘之間。 用戶在此時間後將自動登出。 |
| 登出訊息 |
你可以指定一個訊息,通知使用者他們使用的會話主機即將開始更新。 |
完成此分頁後,選擇 下一頁:評論。
在 審查 標籤中,確保驗證通過並檢視更新期間使用的資訊。
選擇 「更新 」以排程更新。 當你查看會話主機清單時,欄位「 Current Version」顯示 該主機所使用的會話主機設定版本的時間戳記。 如果「 目前版本 」欄位有警告圖示,表示「 目標版本 」欄位中版本的時間戳記較晚,且需要更新會話主機。
注意事項
第一次排程更新時,你提供的設定會覆寫會 話主機管理政策中的預設設定。 後續更新時會預先填入這些參數,任何變更都會被保存。
以下是如何使用 Az.DesktopVirtualization PowerShell 模組為你的會話主機排程新更新的方法。 當你排程更新時,會使用主機池的會話主機設定。 你需要先修改會話主機的設定,才能排程更新。
你可以在排程更新前先更新會話主機管理政策,這樣變更會持續以供未來使用。 或者你也可以在排程更新時覆蓋會話主機管理政策中的值,但這些值只適用於該更新。
重要事項
在以下範例中,你需要更改 <placeholder> 自己的數值。
在 PowerShell 終端機類型Azure 入口網站開啟 Azure Cloud Shell,或在本地裝置上執行 PowerShell。
用 Update-AzWvdSessionHostConfiguration cmdlet 更新會話主機設定,只需要指定你想更改的參數。 以下是一些範例指令:
若要指定不同的自訂映像檔供你的會話主機使用,請執行以下指令。 關於如何找到 Marketplace 映像檔的數值,請參見「Find and use Azure Marketplace VM images with 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
要更改儲存本地管理員帳號密碼的金鑰庫與秘密,請執行以下指令:
$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 ,作業系統磁碟類型改為 高級 SSD,請執行以下指令。 更新後會話主機的作業系統磁碟名稱在格式 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 *
可選:如果你想在排程更新前更新會話主機管理政策,請使用 Update-AzWvdSessionHostManagement 指令碼執行以下指令。 或者,你也可以在排程更新時覆蓋特定值,這些值只用於該更新。 關於有效的時區值,請參閱 Get-TimeZone PowerShell 參考 ,並使用屬性中的 StandardName 值。 我們建議設定 UpdateDeleteOriginalVM = $true 為更新後不需要清理會話主機資源。
$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
要排程更新,請使用 Invoke-AzWvdInitiateSessionHostUpdate 包含以下範例的 cmdlet。 你可以安排更新立即開始,或指定更新開始的時間,最多兩週內。 以下是一些範例指令:
若要立即排程更新並使用會話主機管理政策中的值,請執行以下指令:
$parameters = @{
HostPoolName = '<HostPoolName>'
ResourceGroupName = '<ResourceGroupName>'
}
$update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
若要在指定時間與日期 (以 YYYY-MM-DD HH:mm) 格式排程更新,並使用 session host 管理政策中的值,請執行以下指令。
$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
您可以透過執行以下指令查看排程更新的屬性:
$parameters = @{
HostPoolName = '<HostPoolName>'
ResourceGroupName = '<ResourceGroupName>'
}
Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
重要事項
一旦更新排程完成,你就無法編輯行程或設定。 如果你需要做任何更改,就必須取消更新並排定新的更新。
更新期間不要從主機池移除任何虛擬機。 這樣做可能會對持續更新造成問題。
更新進行期間,不要更改主機池中任何虛擬機的排水模式。 虛擬機的排水模式會根據更新的哪個階段自動改變。 若更新後無法恢復會話主機,則其排水模式設定會被啟用。 更新完成後,耗電模式會被重置。
主機更新大約需要 20 分鐘。 你在批次大小中指定的會話主機數量會同步更新,然後才會進入下一個批次。 你應該把整體完成時間算進你的預定時間裡。
監控更新進度
一旦更新開始,你可以查看進度。 選擇你情境相關的分頁,並依照步驟操作。
以下是如何使用 Azure 入口網站監控更新進度的方法。
在 Azure 虛擬桌面總覽中,選擇主機池,然後選擇你排程更新的主機池。
選擇 會話主持人。
藍色橫幅顯示更新狀態。 它只會顯示一個時間點,所以你需要選擇 重新整理 才能查看最新的進度。
如果你選擇立即開始更新,訊息會在更新開始時顯示已排程,但這個訊息會在你重新整理後更新。 在更新過程中,你會看到從主機池中移除的會話主機的批次數量。
以下是使用 Az.DesktopVirtualization PowerShell 模組來監控更新進度的方法。
從你現有的 PowerShell 工作階段,使用 Get-AzWvdSessionHostManagementsUpdateStatus 帶有以下範例的 cmdlet 來取得目前更新的詳細資訊。
要查看最新更新的進度,請執行以下指令:
$parameters = @{
HostPoolName = '<HostPoolName>'
ResourceGroupName = '<ResourceGroupName>'
}
$updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters |
FL PercentComplete,
ProgressExecutionStartTime,
ProgressSessionHostsCompleted,
ProgressSessionHostsInProgress,
ProgressSessionHostsRollbackFailed,
ProgressTotalSessionHost,
EndTime
$updateProgress
要查看最新更新的所有參數,請執行以下指令:
$parameters = @{
HostPoolName = '<HostPoolName>'
ResourceGroupName = '<ResourceGroupName>'
}
$updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
$updateProgress
暫停、繼續、取消或重試更新
你可以暫停、繼續或取消正在進行的更新。 如果你暫停或取消更新,當前活動會在暫停剩餘更新之前完成。 例如,若一批會話主機正在更新,這些會話主機的更新會先完成。 顯示更新狀態的藍色橫幅會改變,顯示暫停時更新進度。 一旦更新暫停,你只能繼續,且從暫停點開始。
如果你兩週內沒有恢復更新,該更新就會被取消。 一旦更新被取消,就無法恢復。
注意
如果你在更新過程中途取消,主機池中的會話主機之間會有差異,例如不同的作業系統版本,或加入了不同的 Active Directory 網域。 這可能會讓使用者體驗不一致,因此你需要盡快安排下一次更新,以確保所有會話主機之間的一致性。
以下是如何透過 Azure 入口網站暫停、繼續、取消或重試更新的方法。
在 Azure 虛擬桌面總覽中,選擇主機池,然後選擇你排程更新的主機池。
選擇 會話主機,然後選擇 管理會話主機更新。
根據目前更新狀態,選擇暫停、繼續、取消或重試。
選擇 刷新 以更新藍色橫幅中的狀態訊息。 顯示正確狀態大約需要20秒。
以下是如何使用 Az.DesktopVirtualization PowerShell 模組暫停、繼續、取消或重試更新的方法。
在你現有的 PowerShell 工作階段,使用 Invoke-AzWvdControlSessionHostUpdate 以下範例的 cmdlet 來暫停或繼續當前更新。
首先,請執行以下指令檢查更新狀態:
$parameters = @{
HostPoolName = '<HostPoolName>'
ResourceGroupName = '<ResourceGroupName>'
}
Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Status
根據你想採取的行動,請使用以下其中一個例子。
要暫停更新,請執行以下指令:
$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
執行動作後,請執行以下指令檢查更新動作與狀態:
$parameters = @{
HostPoolName = '<HostPoolName>'
ResourceGroupName = '<ResourceGroupName>'
}
Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Action, Status
後續步驟