Mengembangkan ekstensi alat
Ekstensi alat adalah cara utama pengguna berinteraksi dengan Pusat Admin Windows untuk mengelola koneksi, seperti server atau kluster. Saat Anda mengklik koneksi di layar beranda Pusat Admin Windows dan menyambungkan, Anda kemudian akan disajikan dengan daftar alat di panel navigasi kiri. Saat Anda mengklik alat, ekstensi alat dimuat dan ditampilkan di panel kanan.
Saat ekstensi alat dimuat, ekstensi ini dapat menjalankan panggilan WMI atau skrip PowerShell pada server target atau kluster dan menampilkan informasi di UI atau menjalankan perintah berdasarkan input pengguna. Ekstensi alat menentukan solusi mana yang harus ditampilkan, menghasilkan serangkaian alat yang berbeda untuk setiap solusi.
Catatan
Tidak terbiasa dengan berbagai jenis ekstensi? Pelajari selengkapnya tentang arsitektur ekstensibilitas dan jenis ekstensi.
Menyiapkan lingkungan Anda
Jika Anda belum melakukannya, siapkan lingkungan Anda dengan menginstal dependensi dan prasyarat global yang diperlukan untuk semua proyek.
Membuat ekstensi alat baru dengan Windows Admin Center SDK
Setelah menginstal semua dependensi, Anda siap untuk membuat ekstensi alat baru Anda. Buat atau telusuri ke folder yang berisi file proyek Anda, buka prompt perintah, dan atur folder tersebut sebagai direktori kerja. Menggunakan Windows Admin Center SDK yang diinstal sebelumnya, buat ekstensi baru dengan sintaks berikut:
wac create --company "{!Company Name}" --tool "{!Tool Name}" --version latest
| Nilai | Penjelasan | Contoh |
|---|---|---|
{!Company Name} |
Nama perusahaan Anda (dengan spasi) | Contoso Inc |
{!Tool Name} |
Nama alat Anda (dengan spasi) | Manage Foo Works |
Berikut adalah contoh penggunaan:
wac create --company "Contoso Inc" --tool "Manage Foo Works" --version latest
Ini membuat folder baru di dalam direktori kerja saat ini menggunakan nama yang Anda tentukan untuk alat Anda, menyalin semua file templat yang diperlukan ke dalam proyek Anda, dan mengonfigurasi file dengan nama perusahaan dan alat Anda.
Catatan
Bendera --version dalam perintah ini menentukan versi SDK Pusat Admin Windows mana yang ingin Anda targetkan. Baca tentang cara menargetkan versi SDK Pusat Admin Windows yang berbeda untuk terus memperbarui ekstensi Anda dengan perubahan SDK dan platform terbaru.
Selanjutnya, ubah direktori ke dalam folder yang baru saja dibuat, lalu instal dependensi lokal yang diperlukan dengan menjalankan perintah berikut:
npm install
Setelah ini selesai, Anda telah menyiapkan semua yang Anda butuhkan untuk memuat ekstensi baru Anda ke Pusat Admin Windows.
Menambahkan konten ke ekstensi Anda
Sekarang setelah Anda membuat ekstensi dengan Windows Admin Center SDK, Anda siap untuk menyesuaikan konten. Lihat panduan ini untuk contoh apa yang dapat Anda lakukan:
Bahkan lebih banyak contoh dapat ditemukan di Panduan Pengembang kami. Panduan Pengembang adalah ekstensi solusi yang berfungsi penuh yang dapat dimuat ke dalam Pusat Admin Windows, dan berisi kumpulan contoh fungsionalitas sampel dan contoh alat yang kaya yang dapat Anda telusuri dan gunakan di ekstensi Anda sendiri.
Aktifkan ekstensi Panduan Pengembang di halaman Tingkat Lanjut pengaturan Pusat Admin Windows Anda.
Kustomisasi ikon ekstensi Anda
Anda dapat menyesuaikan ikon yang ditampilkan untuk ekstensi Anda di daftar alat. Untuk melakukan ini, ubah semua icon entri untuk manifest.json ekstensi Anda:
"icon": "{!icon-uri}",
| Nilai | Penjelasan | Contoh uri |
|---|---|---|
{!icon-uri} |
Lokasi sumber daya ikon Anda | assets/foo-icon.svg |
CATATAN: Saat ini, ikon kustom tidak terlihat saat sisi memuat ekstensi Anda dalam mode dev. Sebagai solusinya, hapus konten target sebagai berikut:
"target": "",
Konfigurasi ini hanya berlaku untuk pemuatan samping dalam mode dev, jadi penting untuk mempertahankan nilai yang terkandung di dalamnya target lalu memulihkannya sebelum menerbitkan ekstensi Anda.
Bangun dan muat samping ekstensi Anda
Selanjutnya, bangun dan muat sisi ekstensi Anda ke Pusat Admin Windows. Buka jendela perintah, ubah direktori ke direktori sumber Anda, lalu Anda siap untuk membangun.
Bangun dan sajikan dengan gulp:
gulp build gulp serve --port 4201
Perhatikan bahwa Anda perlu memilih port yang saat ini gratis. Pastikan Anda tidak mencoba menggunakan port tempat Pusat Admin Windows dijalankan.
Proyek Anda dapat dimuat ke dalam instans lokal Pusat Admin Windows untuk pengujian dengan melampirkan proyek yang dilayani secara lokal ke Pusat Admin Windows.
Luncurkan Pusat Admin Windows di browser web
Buka debugger (F12)
Buka Konsol dan ketik perintah berikut:
MsftSme.sideLoad("http://localhost:4201")Merefresh browser web
Proyek Anda sekarang akan terlihat di daftar Alat dengan (sisi dimuat) di samping nama.