Monitorar atualizações no Hub Azure Stack usando o ponto de extremidade privilegiadoMonitor updates in Azure Stack Hub using the privileged endpoint

Você pode usar o ponto de extremidade privilegiado para monitorar o progresso de uma execução de atualização do Hub de Azure Stack.You can use the privileged endpoint to monitor the progress of an Azure Stack Hub update run. Você também pode usar o ponto de extremidade privilegiado para retomar uma falha na execução da atualização da última etapa bem-sucedida caso o portal do hub de Azure Stack se torne 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. Usar o Azure Stack portal do hub é o método recomendado para gerenciar atualizações no Hub Azure Stack.Using the Azure Stack Hub portal is the recommended method to manage updates in Azure Stack Hub.

Os seguintes novos cmdlets do PowerShell para gerenciamento de atualizações estão incluídos na atualização 1710 para sistemas integrados de Hub Azure Stack.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 Retorna o status da atualização atualmente em execução, concluída ou com falha.Returns the status of the currently running, completed, or failed update. Fornece o status de alto nível da operação de atualização e um documento XML que descreve a etapa atual e 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 com falha no ponto em que ela falhou.Resumes a failed update at the point where it failed. Em determinados cenários, talvez seja necessário concluir as etapas 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 1710 para o Hub Azure Stack, o processo de atualização 1710 precisa chegar a um determinado ponto antes que o recurso de monitoramento esteja 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 estarão disponíveis se o status no portal do administrador indicar que a atualização 1710 está na etapa reiniciar hosts 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 a etapa: executando a etapa 2,6 – atualizar a lista depermissões do PrivilegedEndpoint.Specifically, the cmdlet update occurs during Step: Running step 2.6 - Update PrivilegedEndpoint whitelist.

Você também pode determinar se os cmdlets estão disponíveis programaticamente consultando a lista de comandos do ponto de extremidade privilegiado.You can also determine whether the cmdlets are available programmatically by querying the command list from the privileged endpoint. Para fazer essa consulta, execute os seguintes comandos do host de ciclo de vida de hardware ou de uma estação de trabalho com acesso privilegiado.To do this query, run the following commands from the hardware lifecycle host or from a Privileged Access Workstation. Além disso, verifique se o ponto de extremidade privilegiado é um host confiável.Also, make sure the privileged endpoint is a trusted host. Para obter mais informações, consulte a etapa 1 de acessar o ponto de extremidade privilegiado.For more information, see step 1 of Access the privileged endpoint.

  1. Crie uma sessão do PowerShell em qualquer uma das VMs (máquinas virtuais) ERCS em seu ambiente de Hub de Azure Stack (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 pela cadeia de caracteres de prefixo da VM específica ao 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 a fornecer credenciais, use a <conta de \cloudadmin do domínio>do Hub Azure Stack ou uma conta que seja 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, insira a mesma senha fornecida durante a instalação para a conta de administrador de domínio do 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 de extremidade privilegiado.Get the full list of commands that are available in the privileged endpoint.

    $commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command } 
    
  3. Determine se o ponto de extremidade 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. Liste os comandos específicos para o 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
    

Usar os cmdlets de gerenciamento de atualizaçõesUse the update management cmdlets

Observação

Execute os seguintes comandos do host de ciclo de vida de hardware ou de uma estação de trabalho com acesso privilegiado.Run the following commands from the hardware lifecycle host or from a Privileged Access Workstation. Além disso, verifique se o ponto de extremidade privilegiado é um host confiável.Also, make sure the privileged endpoint is a trusted host. Para obter mais informações, consulte a etapa 1 de acessar o ponto de extremidade privilegiado.For more information, see step 1 of Access the privileged endpoint.

Conectar-se ao ponto de extremidade privilegiado e atribuir a variável de sessãoConnect to the privileged endpoint and assign session variable

Execute os comandos a seguir para criar uma sessão do PowerShell em qualquer uma das VMs ERCS em seu ambiente de Hub de Azure Stack (prefix-ERCS01, prefix-ERCS02 ou prefix-ERCS03) e para 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 a fornecer credenciais, use a <conta de \cloudadmin do domínio>do Hub Azure Stack ou uma conta que seja 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, insira a mesma senha fornecida durante a instalação para a conta de administrador de domínio do AzureStackAdmin.For the CloudAdmin account, enter the same password that was provided during installation for the AzureStackAdmin domain administrator account.

Obter status de alto nível da execução de atualização atualGet high-level status of the current update run

Para obter um status de alto nível da execução de atualização atual, 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 

Os valores possíveis incluem:Possible values include:

  • ExecutandoRunning
  • ConcluídoCompleted
  • Failed (Falha)Failed
  • CanceledCanceled

Você pode executar esses comandos repetidamente para ver o status mais atualizado.You can run these commands repeatedly to see the most up-to-date status. Você não precisa restabelecer uma conexão para verificar novamente.You don't have to re-establish a connection to check again.

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

Você pode obter o resumo de execução de atualização completa como uma cadeia de caracteres XML.You can get the full update run summary as an XML string. Você pode gravar a cadeia de caracteres em um arquivo para exame ou convertê-lo em um 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 comando a seguir analisa o XML para obter uma lista hierárquica das etapas 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 a seguir, a etapa de nível superior (atualização de nuvem) tem um plano filho para atualizar e reiniciar os hosts de armazenamento.In the following example, the top-level step (Cloud Update) has a child plan to update and restart the storage hosts. Ele mostra que o plano de hosts de armazenamento de reinicialização está atualizando o serviço de armazenamento de BLOBs em um dos hosts.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 com falhaResume a failed update operation

Se a atualização falhar, você poderá retomar a execução da atualização de onde ela parou.If the update fails, you can resume the update run where it left off.

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

Solucionar problemasTroubleshoot

O ponto de extremidade privilegiado está disponível em todas as VMs ERCS no ambiente de Hub de Azure Stack.The privileged endpoint is available on all ERCS VMs in the Azure Stack Hub environment. Como a conexão não é feita com um ponto de extremidade altamente disponível, você pode experimentar interrupções ocasionais, avisos ou mensagens de erro.Because the connection isn't made to a highly available endpoint, you may experience occasional interruptions, warning, or error messages. Essas mensagens podem indicar que a sessão foi desconectada 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. O comportamento é esperado.This behavior is expected. Você pode repetir a operação em alguns minutos ou criar uma nova sessão de ponto de extremidade privilegiada em uma 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 como solucionar problemas de atualizações, consulte Azure Stack solução de problemasFor more information on troubleshooting updates, see Azure Stack Troubleshooting

Próximas etapasNext steps