Menggunakan titik akhir istimewa di Azure Stack Hub
Anda dapat menggunakan titik akhir istimewa untuk memantau kemajuan proses pembaruan Azure Stack Hub. Anda juga dapat menggunakan titik akhir istimewa untuk melanjutkan proses pembaruan yang gagal dari langkah terakhir yang berhasil jika portal Azure Stack Hub menjadi tidak tersedia. Menggunakan portal Azure Stack Hub adalah metode yang disarankan untuk mengelola pembaruan di Azure Stack Hub.
Cmdlet PowerShell baru berikut untuk manajemen pembaruan disertakan dalam pembaruan 1710 untuk sistem terintegrasi Azure Stack Hub.
| Cmdlet | Deskripsi |
|---|---|
Get-AzureStackUpdateStatus |
Menampilkan status pembaruan yang sedang berjalan, selesai, atau gagal. Memberikan status tingkat tinggi dari operasi pembaruan dan dokumen XML yang menjelaskan langkah saat ini dan status yang sesuai. |
Resume-AzureStackUpdate |
Melanjutkan pembaruan yang gagal pada titik kegagalan tersebut. Dalam skenario tertentu, Anda mungkin harus menyelesaikan langkah-langkah mitigasi sebelum melanjutkan pembaruan. |
Pastikan cmdlet tersedia
Karena cmdlet adalah hal yang baru dalam paket pembaruan 1710 untuk Azure Stack Hub, proses pembaruan 1710 perlu sampai ke titik tertentu sebelum kemampuan pemantauan tersedia. Biasanya, cmdlet tersedia jika status di portal administrator menunjukkan bahwa pembaruan 1710 berada pada langkah Hidupkan Ulang Host Penyimpanan. Secara khusus, pembaruan cmdlet berlangsung selama Langkah: Menjalankan langkah 2.6 - Perbarui daftar PrivilegedEndpoint yang diizinkan.
Anda juga dapat menentukan apakah cmdlet tersedia secara terprogram dengan mengkueri daftar perintah dari titik akhir istimewa. Untuk melakukan kueri ini, jalankan perintah berikut dari host siklus hidup perangkat keras atau dari Stasiun Kerja Akses Istimewa. Selain itu, pastikan titik akhir istimewa adalah host tepercaya. Untuk informasi selengkapnya, lihat langkah 1 Akses titik akhir istimewa.
Buat sesi PowerShell di salah satu mesin virtual (VM) ERCS di lingkungan Azure Stack Hub Anda (Prefix-ERCS01, Prefix-ERCS02, atau Prefix-ERCS03). Ganti Prefiks dengan string prefiks VM yang khusus untuk lingkungan Anda.
$cred = Get-Credential $pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)Jika dimintai informasi masuk, gunakan akun <Azure Stack Hub domain>\cloudadmin, atau akun yang merupakan anggota grup CloudAdmins. Untuk akun CloudAdmin, masukkan kata sandi yang sama yang disediakan pada saat penginstalan akun administrator domain AzureStackAdmin.
Dapatkan daftar lengkap perintah yang tersedia di titik akhir istimewa.
$commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command }Pastikan apakah titik akhir istimewa telah diperbarui.
$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." }Buat daftar perintah khusus untuk modul Microsoft.AzureStack.UpdateManagement.
$commands | ? Source -eq $updateManagementModuleNameContohnya:
$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
Menggunakan cmdlet manajemen pembaruan
Catatan
Jalankan perintah berikut dari host siklus hidup perangkat keras atau dari Stasiun Kerja Akses Istimewa. Selain itu, pastikan titik akhir istimewa adalah host tepercaya. Untuk informasi selengkapnya, lihat langkah 1 Akses titik akhir istimewa.
Menyambungkan ke titik akhir istimewa dan menetapkan variabel sesi
Jalankan perintah berikut untuk membuat sesi PowerShell pada salah satu VM ERCS di lingkungan Azure Stack Hub Anda (Prefix-ERCS01, Prefix-ERCS02, atau Prefix-ERCS03), dan untuk menetapkan variabel sesi.
$cred = Get-Credential
$pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
Jika dimintai informasi masuk, gunakan akun <Azure Stack Hub domain>\cloudadmin, atau akun yang merupakan anggota grup CloudAdmins. Untuk akun CloudAdmin, masukkan kata sandi yang sama yang disediakan pada saat penginstalan akun administrator domain AzureStackAdmin.
Dapatkan status tingkat tinggi dari proses pembaruan saat ini
Untuk mendapatkan status tingkat tinggi dari proses pembaruan saat ini, jalankan perintah berikut:
$statusString = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus -StatusOnly }
$statusString.Value
Nilai yang mungkin termasuk:
- Berjalan
- Selesai
- Gagal
- Batal
Anda dapat menjalankan perintah ini berulang kali untuk melihat status terbaru. Untuk memeriksa lagi, Anda tidak perlu membuat ulang koneksi.
Mendapatkan status proses pembaruan lengkap dengan detailnya
Anda bisa mendapatkan ringkasan proses pembaruan lengkap dalam string XML. Anda dapat menulis string ke file untuk pemeriksaan, atau mengonversinya ke dokumen XML dan menggunakan PowerShell untuk menguraikannya. Perintah berikut mengurai XML untuk mendapatkan daftar hierarkis dari langkah-langkah yang sedang dijalankan:
[xml]$updateStatus = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus }
$updateStatus.SelectNodes("//Step[@Status='InProgress']")
Dalam contoh berikut, langkah tingkat atas (Pembaruan Cloud) memiliki rencana turunan untuk memperbarui dan menghidupkan ulang host penyimpanan. Ini menunjukkan bahwa paket Hidupkan Ulang Host Penyimpanan memperbarui layanan Blob Storage di salah satu host.
[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
Melanjutkan operasi pembaruan yang gagal
Jika pembaruan gagal, Anda dapat melanjutkan proses pembaruan dari langkah terakhir yang berhasil.
Invoke-Command -Session $pepSession -ScriptBlock { Resume-AzureStackUpdate }
Pecahkan masalah
Titik akhir istimewa tersedia di semua VM ERCS di lingkungan Azure Stack Hub. Karena koneksi tidak dibuat ke titik akhir yang sangat tersedia, Anda mungkin mendapatkan gangguan, peringatan, atau pesan kesalahan sesekali. Pesan tersebut mungkin menunjukkan bahwa sesi terputus atau terjadi kesalahan saat berkomunikasi dengan Layanan ECE. Perilaku ini diharapkan. Anda dapat mencoba kembali operasi dalam beberapa menit atau membuat sesi titik akhir istimewa baru di salah satu VM ERCS lainnya.
Untuk informasi selengkapnya tentang pemecahan masalah pembaruan, lihat Pemecahan Masalah Azure Stack
Langkah berikutnya
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk