Monitorizar as atualizações no Azure Stack Hub com o ponto final com privilégiosMonitor updates in Azure Stack Hub using the privileged endpoint

Pode utilizar o ponto final privilegiado para monitorizar o progresso de uma atualização do Azure Stack Hub.You can use the privileged endpoint to monitor the progress of an Azure Stack Hub update run. Também pode utilizar o ponto final privilegiado para retomar uma atualização falhada executada a partir do último passo bem sucedido caso o portal Azure Stack Hub fique indisponível.You can also use the privileged endpoint to resume a failed update run from the last successful step should the Azure Stack Hub portal become unavailable. A utilização do portal Azure Stack Hub é o método recomendado para gerir atualizações no Azure Stack Hub.Using the Azure Stack Hub portal is the recommended method to manage updates in Azure Stack Hub.

Os seguintes cmdlets PowerShell para gestão de atualizações estão incluídos na atualização de 1710 para sistemas integrados Azure Stack Hub.The following new PowerShell cmdlets for update management are included in the 1710 update for Azure Stack Hub integrated systems.

CmdletCmdlet DescriçãoDescription
Get-AzureStackUpdateStatus Devolve o estado da atualização atualmente em execução, concluída ou falhada.Returns the status of the currently running, completed, or failed update. Fornece o estado de alto nível da operação de atualização e um documento XML que descreve tanto o passo atual como o estado correspondente.Provides the high-level status of the update operation and an XML document that describes both the current step and the corresponding state.
Resume-AzureStackUpdate Retoma uma atualização falhada no ponto em que falhou.Resumes a failed update at the point where it failed. Em certos cenários, poderá ter de completar os passos de mitigação antes de retomar a atualização.In certain scenarios, you may have to complete mitigation steps before you resume the update.

Verifique se os cmdlets estão disponíveisVerify the cmdlets are available

Como os cmdlets são novos no pacote de atualização de 1710 para o Azure Stack Hub, o processo de atualização de 1710 precisa de chegar a um determinado ponto antes da capacidade de monitorização estar disponível.Because the cmdlets are new in the 1710 update package for Azure Stack Hub, the 1710 update process needs to get to a certain point before the monitoring capability is available. Normalmente, os cmdlets estão disponíveis se o estado no portal do administrador indicar que a atualização 1710 está na etapa de Recomeçar os Anfitriões de Armazenamento.Typically, the cmdlets are available if the status in the administrator portal indicates that the 1710 update is at the Restart Storage Hosts step. Especificamente, a atualização do cmdlet ocorre durante o passo: Passo de execução 2.6 - Atualização PrivilegedEndpoint whitelist.Specifically, the cmdlet update occurs during Step: Running step 2.6 - Update PrivilegedEndpoint whitelist.

Também pode determinar se os cmdlets estão disponíveis programáticamente consultando a lista de comando a partir do ponto final privilegiado.You can also determine whether the cmdlets are available programmatically by querying the command list from the privileged endpoint. Para fazer esta consulta, executar os seguintes comandos a partir do anfitrião do ciclo de vida do hardware ou de uma estação de trabalho de acesso privilegiado.To do this query, run the following commands from the hardware lifecycle host or from a Privileged Access Workstation. Além disso, certifique-se de que o ponto final privilegiado é um hospedeiro de confiança.Also, make sure the privileged endpoint is a trusted host. Para mais informações, consulte o passo 1 do Access o ponto final privilegiado.For more information, see step 1 of Access the privileged endpoint.

  1. Crie uma sessão PowerShell em qualquer uma das máquinas virtuais ERCS (VMs) no ambiente Azure Stack Hub (Prefix-ERCS01, Prefix-ERCS02 ou Prefix-ERCS03).Create a PowerShell session on any of the ERCS virtual machines (VMs) in your Azure Stack Hub environment (Prefix-ERCS01, Prefix-ERCS02, or Prefix-ERCS03). Substitua o prefixo pelo prefixo VM específico do seu ambiente.Replace Prefix with the VM prefix string that's specific to your environment.

    $cred = Get-Credential
    
    $pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint 
    

    Quando solicitado para obter credenciais, use o < domínio Azure Stack Hub > \cloudadmin account, ou uma conta que é membro do grupo CloudAdmins.When prompted for credentials, use the <Azure Stack Hub domain>\cloudadmin account, or an account that's a member of the CloudAdmins group. Para a conta CloudAdmin, introduza a mesma palavra-passe que foi fornecida durante a instalação para a conta de administrador de domínio AzureStackAdmin.For the CloudAdmin account, enter the same password that was provided during installation for the AzureStackAdmin domain administrator account.

  2. Obtenha a lista completa de comandos que estão disponíveis no ponto final privilegiado.Get the full list of commands that are available in the privileged endpoint.

    $commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command } 
    
  3. Determinar se o ponto final privilegiado foi atualizado.Determine if the privileged endpoint was updated.

    $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."
     } 
    
  4. Listar os comandos específicos do módulo Microsoft.AzureStack.UpdateManagement.List the commands specific to the Microsoft.AzureStack.UpdateManagement module.

    $commands | ? Source -eq $updateManagementModuleName 
    

    Por exemplo:For example:

    $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
    

Utilize os cmdlets de gestão de atualizaçãoUse the update management cmdlets

Nota

Executar os seguintes comandos a partir do anfitrião do ciclo de vida do hardware ou de uma estação de trabalho de acesso privilegiado.Run the following commands from the hardware lifecycle host or from a Privileged Access Workstation. Além disso, certifique-se de que o ponto final privilegiado é um hospedeiro de confiança.Also, make sure the privileged endpoint is a trusted host. Para mais informações, consulte o passo 1 do Access o ponto final privilegiado.For more information, see step 1 of Access the privileged endpoint.

Ligue-se ao ponto final privilegiado e atribua variável de sessãoConnect to the privileged endpoint and assign session variable

Executar os seguintes comandos para criar uma sessão PowerShell em qualquer um dos VMs ERCS no seu ambiente Azure Stack Hub (Prefix-ERCS01, Prefix-ERCS02 ou Prefix-ERCS03) e atribuir uma variável de sessão.Run the following commands to create a PowerShell session on any of the ERCS VMs in your Azure Stack Hub environment (Prefix-ERCS01, Prefix-ERCS02, or Prefix-ERCS03), and to assign a session variable.

$cred = Get-Credential

$pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint 

Quando solicitado para obter credenciais, use o < domínio Azure Stack Hub > \cloudadmin account, ou uma conta que é membro do grupo CloudAdmins.When prompted for credentials, use the <Azure Stack Hub domain>\cloudadmin account, or an account that's a member of the CloudAdmins group. Para a conta CloudAdmin, introduza a mesma palavra-passe que foi fornecida durante a instalação para a conta de administrador de domínio AzureStackAdmin.For the CloudAdmin account, enter the same password that was provided during installation for the AzureStackAdmin domain administrator account.

Obtenha o estado de alto nível da corrente execução da atualizaçãoGet high-level status of the current update run

Para obter um estado de alto nível da atual atualização, execute os seguintes comandos:To get a high-level status of the current update run, run the following commands:

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

$statusString.Value 

Valores possíveis incluem:Possible values include:

  • Em ExecuçãoRunning
  • ConcluídoCompleted
  • Com falhasFailed
  • CanceladoCanceled

Pode executar estes comandos repetidamente para ver o estado mais atualizado.You can run these commands repeatedly to see the most up-to-date status. Não precisa restabelecer uma ligação para verificar de novo.You don't have to re-establish a connection to check again.

Obtenha o estado de execução da atualização completa com detalhesGet the full update run status with details

Pode obter o resumo completo da atualização como uma cadeia XML.You can get the full update run summary as an XML string. Pode escrever o string a um ficheiro para exame, ou convertê-lo num documento XML e usar o PowerShell para analisá-lo.You can write the string to a file for examination, or convert it to an XML document and use PowerShell to parse it. O seguinte comando analisa o XML para obter uma lista hierárquica dos passos atualmente em execução:The following command parses the XML to get a hierarchical list of the currently running steps:

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

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

No exemplo seguinte, o passo de nível superior (Cloud Update) tem um plano para a criança atualizar e reiniciar os anfitriões de armazenamento.In the following example, the top-level step (Cloud Update) has a child plan to update and restart the storage hosts. Mostra que o plano Restart Storage Hosts está a atualizar o serviço de armazenamento blob num dos anfitriões.It shows that the Restart Storage Hosts plan is updating the Blob Storage service on one of the hosts.

[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

Retomar uma operação de atualização falhadaResume a failed update operation

Se a atualização falhar, pode retomar a atualização onde esta foi deixada.If the update fails, you can resume the update run where it left off.

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

Resolução de problemasTroubleshoot

O ponto final privilegiado está disponível em todos os VMs ERCS no ambiente Azure Stack Hub.The privileged endpoint is available on all ERCS VMs in the Azure Stack Hub environment. Como a ligação não é feita a um ponto final altamente disponível, pode sofrer interrupções ocasionais, mensagens de aviso ou erro.Because the connection isn't made to a highly available endpoint, you may experience occasional interruptions, warning, or error messages. Estas mensagens podem indicar que a sessão foi desligada ou que houve um erro de comunicação com o Serviço ECE.These messages may indicate that the session was disconnected or that there was an error communicating with the ECE Service. Este comportamento é esperado.This behavior is expected. Pode voltar a tentar a operação em poucos minutos ou criar uma nova sessão privilegiada de ponto final numa das outras VMs ERCS.You can retry the operation in a few minutes or create a new privileged endpoint session on one of the other ERCS VMs.

Para obter mais informações sobre atualizações de resolução de problemas, consulte a resolução de problemas da Stack Azure StackFor more information on troubleshooting updates, see Azure Stack Troubleshooting

Passos seguintesNext steps