Dukungan PowerShell untuk kluster gateway data lokal
Skrip PowerShell tersedia di galeri PowerShell. Skrip yang dijelaskan dalam artikel ini adalah untuk PowerShell versi 5. Saat Anda menggunakan PowerShell versi 7, lihat Cmdlet PowerShell untuk manajemen gateway data lokal. Anda bisa menggunakan skrip PowerShell untuk melakukan operasi berikut:
- Ambil daftar kluster gateway yang tersedia untuk pengguna.
- Ambil daftar instans gateway yang terdaftar dalam kluster dan status online atau offlinenya.
- Ubah status aktifkan atau nonaktifkan untuk instans gateway dalam kluster dan properti gateway lainnya.
- Menghapus gateway.
Jalankan perintah PowerShell
Untuk menginstal cmdlet ini, jalankan perintah berikut dalam sesi PowerShell yang ditingkatkan:
Install-Module -Name OnPremisesDataGatewayHAMgmt
Seluruh daftar cmdlet dapat ditemukan menggunakan perintah berikut:
Get-Command -Module OnPremisesDataGateway*
Contoh dan deskripsi disertakan dalam cmdlet dan Anda dapat mengaksesnya menggunakan perintah berikut:
get-help <cmdlet-name>
Sekarang Anda dapat menggunakan perintah dalam tabel berikut untuk mengelola kluster gateway Anda.
| Perintah | Keterangan | Parameter |
|---|---|---|
| Login-OnPremisesDataGateway | Gunakan perintah ini untuk masuk untuk mengelola kluster gateway data lokal Anda. Anda harus menjalankan perintah ini dan masuk sebelum perintah ketersediaan tinggi lainnya dapat berfungsi dengan baik. Catatan: Token autentikasi ID Microsoft Entra yang diperoleh sebagai bagian login dari panggilan hanya berlaku selama 1 jam, setelah kedaluwarsa. Anda dapat menjalankan login ulang perintah untuk memperoleh token baru. |
Nama pengguna dan kata sandi ID Microsoft Entra (disediakan sebagai bagian dari eksekusi perintah, bukan pemanggilan awal). |
| Get-OnPremisesDataGatewayClusters | Mengambil daftar kluster gateway untuk pengguna yang masuk. | Secara opsional, Anda dapat meneruskan parameter pemformatan ke perintah ini untuk keterbacaan yang lebih baik, seperti Format-Tabel -AutoSize -Wrap. |
| Get-OnPremisesDataClusterGateways | Mengambil daftar gateway dalam kluster yang ditentukan dan informasi tambahan untuk setiap gateway seperti status online atau offline dan nama komputer. | -ClusterObjectID xyz (di mana xyz diganti dengan nilai ID objek kluster aktual, yang dapat diambil dengan menggunakan perintah Get-OnPremisesDataGatewayClusters ). |
| Set-OnPremisesDataGateway | Gunakan perintah ini untuk mengatur nilai properti untuk gateway tertentu dalam kluster, yang mencakup kemampuan untuk mengaktifkan atau menonaktifkan instans gateway tertentu. | -ClusterObjectID xyz (di mana xyz diganti dengan nilai ID objek kluster aktual, yang dapat diambil dengan menggunakan perintah Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (di mana abc diganti dengan nilai ID objek gateway aktual, yang dapat diambil dengan menggunakan perintah Get-OnPremisesDataClusterGateways , mengingat ID objek kluster). |
| Get-OnPremisesDataGatewayStatus | Gunakan perintah ini untuk mengambil status untuk instans gateway tertentu dalam kluster. | -ClusterObjectID xyz (di mana xyz diganti dengan nilai ID objek kluster aktual, yang dapat diambil dengan menggunakan perintah Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (di mana abc diganti dengan nilai ID objek gateway aktual, yang dapat diambil dengan menggunakan perintah Get-OnPremisesDataClusterGateways , mengingat ID objek kluster). |
| Remove-OnPremisesDataGateway | Gunakan perintah ini untuk menghapus instans gateway dari kluster. Catatan: Gateway utama dalam kluster tidak dapat dihapus hingga semua gateway lain dalam kluster dihapus. | -ClusterObjectID xyz (di mana xyz diganti dengan nilai ID objek kluster aktual, yang dapat diambil dengan menggunakan perintah Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (di mana abc diganti dengan nilai ID objek gateway aktual, yang dapat diambil dengan menggunakan perintah Get-OnPremisesDataClusterGateways , mengingat ID objek kluster). |