使用具有特殊權限的端點來監視 Azure Stack Hub 中的更新

發行項
03/29/2024

您可以使用具有特殊權限的端點來監視 Azure Stack Hub 更新執行的進度。如果 Azure Stack Hub 入口網站變得無法使用，您也可以使用具特殊權限的端點，從最後一個成功的步驟繼續執行失敗的更新。建議使用 Azure Stack Hub 入口網站在 Azure Stack Hub 中管理更新。

下列適用於更新管理的新 PowerShell Cmdlet 隨附於適用於 Azure Stack Hub 整合系統的 1710 更新中。

Cmdlet	描述
`Get-AzureStackUpdateStatus`	傳回目前正在執行、已完成或失敗之更新的狀態。提供更新作業的高階狀態，以及說明目前步驟和對應狀態的 XML 文件。
`Resume-AzureStackUpdate`	從更新失敗的地方繼續執行失敗的更新。在某些情況下，您可能必須先完成風險降低步驟，然後才能繼續執行更新。

確認 Cmdlet 可供使用

因為 Cmdlet 是適用於 Azure Stack Hub 之 1710 更新程式封裝中的新功能，所以 1710 更新程序需要先到達某個點，才能使用監視功能。一般而言，如果系統管理員入口網站中的狀態表示 1710 更新位於重新啟動儲存體主機步驟中，則可使用 Cmdlet。具體來說，Cmdlet 更新會在步驟：正在執行步驟 2.6 - 更新 PrivilegedEndpoint 允許清單期間發生。

您也可以藉由從具有特殊權限的端點查詢命令清單，來判斷 Cmdlet 是否可以程式設計方式使用。若要執行此查詢，請從硬體生命週期主機或特殊權限存取工作站執行下列命令。此外，確定具有特殊權限的端點是信任的主機。如需詳細資訊，請參閱存取具有特殊權限的端點的步驟 1。

在您的 Azure Stack Hub 環境中的任何 ERCS 虛擬機器 (VM) 上建立 PowerShell 工作階段 (Prefix-ERCS01、Prefix-ERCS02 或 Prefix-ERCS03)。使用您環境專屬的 VM 前置字串來取代 Prefix。
```
$cred = Get-Credential

$pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
```
當系統提示您輸入認證時，請使用 <Azure Stack Hub 網域>\cloudadmin 帳戶或屬於 CloudAdmins 群組成員的帳戶。針對 CloudAdmin 帳戶，輸入 AzureStackAdmin 網域系統管理員帳戶安裝期間所提供的相同密碼。

取得具有特殊權限之端點中可用的完整命令清單。

$commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command }

判斷具有特殊權限的端點是否已更新。

$updateManagementModuleName = "Microsoft.Azurestack.UpdateManagement"
 if (($commands | ? Source -eq $updateManagementModuleName)) {
Write-Host "Privileged endpoint was updated to support update monitoring tools."
 } else {
Write-Host "Privileged endpoint has not been updated yet. Please try again later."
 }

列出 Microsoft.AzureStack.UpdateManagement 模組特有的命令。

$commands | ? Source -eq $updateManagementModuleName

例如：

$commands | ? Source -eq $updateManagementModuleName

CommandType     Name                                               Version    Source                                                  PSComputerName
 -----------     ----                                               -------    ------                                                  --------------
Function        Get-AzureStackUpdateStatus                         0.0        Microsoft.Azurestack.UpdateManagement                   Contoso-ercs01
Function        Resume-AzureStackUpdate                            0.0        Microsoft.Azurestack.UpdateManagement                   Contoso-ercs01

使用更新管理 Cmdlet

注意

從硬體生命週期主機或特殊權限存取工作站執行下列命令。此外，確定具有特殊權限的端點是信任的主機。如需詳細資訊，請參閱存取具有特殊權限的端點的步驟 1。

連接到具有特殊權限的端點並指派工作階段變數

執行下列命令，在您的 Azure Stack Hub 環境中的任何 ERCS VM 上建立 PowerShell 工作階段 (Prefix-ERCS01、Prefix-ERCS02 或 Prefix-ERCS03)，以及指派工作階段變數。

$cred = Get-Credential

$pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)

當系統提示您輸入認證時，請使用 <Azure Stack Hub 網域>\cloudadmin 帳戶或屬於 CloudAdmins 群組成員的帳戶。針對 CloudAdmin 帳戶，輸入 AzureStackAdmin 網域系統管理員帳戶安裝期間所提供的相同密碼。

取得目前更新執行的高階狀態

若要取得目前更新執行的高階狀態，請執行下列命令：

$statusString = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus -StatusOnly }

$statusString.Value

可能的值包括：

執行中
Completed
失敗
已取消

您可以重複執行這些命令來查看最新狀態。您不需要重新建立連線來再次檢查。

取得完整更新執行狀態以及詳細資料

您可以 XML 字串形式取得完整的更新執行摘要。您可以將字串寫入檔案，以供檢查之用，或將它轉換成 XML 文件，並使用 PowerShell 進行剖析。下列命令會剖析 XML，以取得目前執行中步驟的階層式清單：

[xml]$updateStatus = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus }

$updateStatus.SelectNodes("//Step[@Status='InProgress']")

在下列範例中，最上層步驟 (更新雲端) 具有更新並重新啟動儲存體主機的子方案。它會顯示「重新啟動儲存體主機」方案正在其中一部主機上更新 Blob 儲存體服務。

[xml]$updateStatus = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus }

$updateStatus.SelectNodes("//Step[@Status='InProgress']") 

    FullStepIndex : 2
    Index         : 2
    Name          : Cloud Update
    Description   : Perform cloud update.
    StartTimeUtc  : 2017-10-13T12:50:39.9020351Z
    Status        : InProgress
    Task          : Task
    
    FullStepIndex  : 2.9
    Index          : 9
    Name           : Restart Storage Hosts
    Description    : Restart Storage Hosts.
    EceErrorAction : Stop
    StartTimeUtc   : 2017-10-13T15:44:06.7431447Z
    Status         : InProgress
    Task           : Task
    
    FullStepIndex : 2.9.2
    Index         : 2
    Name          : PreUpdate ACS Blob Service
    Description   : Check function level, update deployment artifacts, configure Blob service settings
    StartTimeUtc  : 2017-10-13T15:44:26.0708525Z
    Status        : InProgress
    Task          : Task

繼續執行失敗的更新作業

如果更新失敗，您可以從更新中斷的位置繼續進行更新執行。

Invoke-Command -Session $pepSession -ScriptBlock { Resume-AzureStackUpdate }

疑難排解

具有特殊權限的端點適用於 Azure Stack Hub 環境中的所有 ERCS VM 上。由於並未與高度可用的端點建立連線，因此，您可能會遇到偶發性的中斷、警告或錯誤訊息。這些訊息可能表示工作階段已中斷連線，或者與 ECE 服務通訊時發生錯誤。這是預期的行為。您可以在幾分鐘後重試此作業，或者在其他 ERCS VM 的其中一部上新建具有特殊權限的端點工作階段。

如需如何針對更新進行疑難排解的詳細資訊，請參閱 Azure Stack 疑難排解

後續步驟

在 Azure Stack Hub 中管理更新