使用特权终结点监视 Azure Stack Hub 中的更新

项目
03/29/2024

可以使用特权终结点来监视 Azure Stack Hub 更新运行的进度。也可以使用特权终结点在 Azure Stack Hub 门户不可用时，从最后一个成功的步骤恢复失败的更新运行。使用 Azure Stack Hub 门户是管理 Azure Stack Hub 中的更新的建议方法。

Azure Stack Hub 集成系统 1710 更新版中包含以下用于更新管理的新 PowerShell cmdlet。

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)（Prefix-ERCS01、Prefix-ERCS02 或 Prefix-ERCS03）上创建 PowerShell 会话。将 Prefix 替换为环境特定的 VM 前缀字符串。
```
$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（Prefix-ERCS01、Prefix-ERCS02 或 Prefix-ERCS03）上创建 PowerShell 会话，并分配会话变量。

$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

可能的值包括：

正在运行
已完成
已失败
已取消

可以重复运行这些命令来查看最新状态。无需重新建立连接即可再次检查状态。

获取完整更新运行状态和详细信息

可以获取 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 中管理更新