Ayrıcalıklı uç noktayı kullanarak Azure Stack Hub güncelleştirmelerini izlemeMonitor updates in Azure Stack Hub using the privileged endpoint

Azure Stack hub 'ı güncelleştirme çalıştırmasının ilerlemesini izlemek için ayrıcalıklı uç noktasını kullanabilirsiniz.You can use the privileged endpoint to monitor the progress of an Azure Stack Hub update run. Ayrıca, son başarılı adımdan başarısız bir güncelleştirme çalıştırmasını sürdürmeden Azure Stack hub portalının kullanılamaz hale gelebilmesi için ayrıcalıklı uç noktasını da kullanabilirsiniz.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. Azure Stack hub portalının kullanılması, Azure Stack hub 'da güncelleştirmeleri yönetmek için önerilen yöntemdir.Using the Azure Stack Hub portal is the recommended method to manage updates in Azure Stack Hub.

Güncelleştirme yönetimi için aşağıdaki yeni PowerShell cmdlet 'leri, Azure Stack hub tümleşik sistemleri için 1710 güncelleştirmesine dahildir.The following new PowerShell cmdlets for update management are included in the 1710 update for Azure Stack Hub integrated systems.

CmdletCmdlet AçıklamaDescription
Get-AzureStackUpdateStatus Şu anda çalışan, tamamlanan veya başarısız güncelleştirme durumunu döndürür.Returns the status of the currently running, completed, or failed update. , Güncelleştirme işleminin ve hem geçerli adımı hem de karşılık gelen durumu açıklayan bir XML belgesinin üst düzey durumunu sağlar.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 Başarısız olan bir güncelleştirmeyi başarısız olduğu noktada sürdürür.Resumes a failed update at the point where it failed. Bazı senaryolarda, güncelleştirmeyi sürdürmeye başlamadan önce risk azaltma adımlarını tamamlamanızı gerekebilir.In certain scenarios, you may have to complete mitigation steps before you resume the update.

Cmdlet 'lerinin kullanılabilir olduğunu doğrulayınVerify the cmdlets are available

Azure Stack Hub için 1710 güncelleştirme paketinde cmdlet 'ler yeni olduğundan, 1710 güncelleştirme işleminin izleme yeteneği kullanılabilir olmadan önce belirli bir noktaya sahip olması gerekir.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. Genellikle, yönetici portalındaki durum 1710 güncelleştirmesinin depolama Konakları yeniden Başlat adımında olduğunu gösteriyorsa cmdlet 'ler kullanılabilir.Typically, the cmdlets are available if the status in the administrator portal indicates that the 1710 update is at the Restart Storage Hosts step. Özellikle, Adım: 2,6-güncelleştirme PrivilegedEndpoint beyaz listesini çalıştıran adım sırasında cmdlet güncelleştirmesi oluşur.Specifically, the cmdlet update occurs during Step: Running step 2.6 - Update PrivilegedEndpoint whitelist.

Ayrıca, ayrıcalıklı uç noktadan komut listesini sorgulayarak cmdlet 'lerin programlı olarak kullanılabilir olup olmayacağını belirleyebilirsiniz.You can also determine whether the cmdlets are available programmatically by querying the command list from the privileged endpoint. Bu sorguyu yapmak için, donanım yaşam döngüsü konaktan veya ayrıcalıklı erişim Iş Istasyonundan aşağıdaki komutları çalıştırın.To do this query, run the following commands from the hardware lifecycle host or from a Privileged Access Workstation. Ayrıca, ayrıcalıklı uç noktanın güvenilen bir konak olduğundan emin olun.Also, make sure the privileged endpoint is a trusted host. Daha fazla bilgi için bkz. ayrıcalıklı uç noktaya erişim1. adım.For more information, see step 1 of Access the privileged endpoint.

  1. Azure Stack hub ortamınızdaki tüm ERCS sanal makinelerinde (VM) bir PowerShell oturumu oluşturun (ön ek-ERCS01, ön ek-ERCS02 veya önek-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). Öneki , ORTAMıNıZA özgü VM ön eki dizesiyle değiştirin.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 
    

    Kimlik bilgileri istendiğinde, < Azure Stack hub etki alanı > \Cloudadmin hesabını ya da cloudadmins grubunun üyesi olan bir hesabı kullanın.When prompted for credentials, use the <Azure Stack Hub domain>\cloudadmin account, or an account that's a member of the CloudAdmins group. CloudAdmin hesabı için, AzureStackAdmin etki alanı yönetici hesabı için yükleme sırasında girilen parolayı girin.For the CloudAdmin account, enter the same password that was provided during installation for the AzureStackAdmin domain administrator account.

  2. Ayrıcalıklı uç noktada kullanılabilen komutların tam listesini alın.Get the full list of commands that are available in the privileged endpoint.

    $commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command } 
    
  3. Ayrıcalıklı uç noktanın güncelleştirilip güncelleştirilmediğini belirleme.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. Microsoft. AzureStack. UpdateManagement modülüne özgü komutları listeleyin.List the commands specific to the Microsoft.AzureStack.UpdateManagement module.

    $commands | ? Source -eq $updateManagementModuleName 
    

    Örnek: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
    

Güncelleştirme yönetimi cmdlet 'lerini kullanmaUse the update management cmdlets

Not

Donanım yaşam döngüsü konaktan veya ayrıcalıklı erişim Iş Istasyonundan aşağıdaki komutları çalıştırın.Run the following commands from the hardware lifecycle host or from a Privileged Access Workstation. Ayrıca, ayrıcalıklı uç noktanın güvenilen bir konak olduğundan emin olun.Also, make sure the privileged endpoint is a trusted host. Daha fazla bilgi için bkz. ayrıcalıklı uç noktaya erişim1. adım.For more information, see step 1 of Access the privileged endpoint.

Ayrıcalıklı uç noktaya bağlanma ve oturum değişkenini atamaConnect to the privileged endpoint and assign session variable

Azure Stack hub ortamınızdaki ERCS sanal makinelerinde (ön ek-ERCS01, ön ek-ERCS02 veya ön ek-ERCS03) bir PowerShell oturumu oluşturmak ve bir oturum değişkeni atamak için aşağıdaki komutları çalıştırın.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 

Kimlik bilgileri istendiğinde, < Azure Stack hub etki alanı > \Cloudadmin hesabını ya da cloudadmins grubunun üyesi olan bir hesabı kullanın.When prompted for credentials, use the <Azure Stack Hub domain>\cloudadmin account, or an account that's a member of the CloudAdmins group. CloudAdmin hesabı için, AzureStackAdmin etki alanı yönetici hesabı için yükleme sırasında girilen parolayı girin.For the CloudAdmin account, enter the same password that was provided during installation for the AzureStackAdmin domain administrator account.

Geçerli güncelleştirme çalıştırmasının üst düzey durumunu alGet high-level status of the current update run

Geçerli güncelleştirme çalıştırmasının üst düzey durumunu almak için aşağıdaki komutları çalıştırın: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 

Olası değerler şunlardır:Possible values include:

  • ÇalışmaRunning
  • TamamlandıCompleted
  • BaşarısızFailed
  • İptal edildiCanceled

En güncel durumu görmek için, bu komutları tekrar tekrar çalıştırabilirsiniz.You can run these commands repeatedly to see the most up-to-date status. Yeniden denetlemek için bir bağlantıyı yeniden oluşturmanız gerekmez.You don't have to re-establish a connection to check again.

Ayrıntıları içeren tam güncelleştirme çalıştırması durumunu alınGet the full update run status with details

Tam güncelleştirme çalıştırması özetini bir XML dizesi olarak alabilirsiniz.You can get the full update run summary as an XML string. İnceleme için bir dosyaya dize yazabilir veya bir XML belgesine dönüştürebilir ve PowerShell kullanarak bunu ayrıştırmaya ekleyebilirsiniz.You can write the string to a file for examination, or convert it to an XML document and use PowerShell to parse it. Aşağıdaki komut, şu anda çalışan adımların hiyerarşik bir listesini almak için XML 'i ayrıştırır: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']")

Aşağıdaki örnekte, üst düzey adım (bulut güncelleştirmesi), depolama konaklarınızı güncelleştirmek ve yeniden başlatmak için bir alt plana sahiptir.In the following example, the top-level step (Cloud Update) has a child plan to update and restart the storage hosts. Yeniden başlatma depolama Konakları planının, konaklardan birindeki blob Storage hizmetini güncelleştirdiğinden emin olur.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

Başarısız bir güncelleştirme işlemini sürdürürResume a failed update operation

Güncelleştirme başarısız olursa, güncelleştirme çalıştırmasını kaldığınız yerden sürdürebilirsiniz.If the update fails, you can resume the update run where it left off.

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

Sorun gidermeTroubleshoot

Ayrıcalıklı uç nokta, Azure Stack hub ortamındaki tüm ERCS sanal makinelerinde kullanılabilir.The privileged endpoint is available on all ERCS VMs in the Azure Stack Hub environment. Bağlantı, yüksek oranda kullanılabilir bir uç noktada yapılmadığından, zaman zaman kesintiler, uyarı veya hata iletileriyle karşılaşabilirsiniz.Because the connection isn't made to a highly available endpoint, you may experience occasional interruptions, warning, or error messages. Bu iletiler, oturumun bağlantısının kesileceğini veya ECE hizmetiyle iletişim kurulurken bir hata olduğunu gösteriyor olabilir.These messages may indicate that the session was disconnected or that there was an error communicating with the ECE Service. Bu beklenen bir davranıştır.This behavior is expected. İşlemi birkaç dakika içinde yeniden deneyebilir veya diğer ERCS sanal makinelerinden birinde yeni bir ayrıcalıklı uç nokta oturumu oluşturabilirsiniz.You can retry the operation in a few minutes or create a new privileged endpoint session on one of the other ERCS VMs.

Güncelleştirme sorunlarını giderme hakkında daha fazla bilgi için bkz. Azure Stack sorun gidermeFor more information on troubleshooting updates, see Azure Stack Troubleshooting

Sonraki adımlarNext steps