Menginstal dan mengelola ekstensi

  • Berlaku untuk: ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Pusat Admin Windows adalah platform yang dapat diperluas di mana setiap jenis dan alat koneksi adalah ekstensi yang dapat Anda instal, hapus instalan, dan perbarui satu per satu. Anda dapat mencari ekstensi baru yang diterbitkan oleh Microsoft dan pengembang lain, serta menginstal dan memperbaruinya satu per satu tanpa harus memperbarui seluruh penginstalan Pusat Admin Windows. Anda juga dapat mengonfigurasi umpan NuGet terpisah atau berbagi file dan mendistribusikan ekstensi untuk digunakan secara internal dalam organisasi Anda.

Important

Jika konektivitas keluar dibatasi oleh firewall atau server proksi Anda, pastikan URL jaringan Anda dikonfigurasi dengan benar. Jika jaringan Anda tidak dikonfigurasi dengan benar, Anda tidak akan menerima pembaruan ekstensi.

Menginstal ekstensi

Pusat Admin Windows memperlihatkan ekstensi yang tersedia dari umpan NuGet yang ditentukan. Secara default, Pusat Admin Windows menunjuk ke umpan NuGet resmi Microsoft yang menghosting ekstensi yang diterbitkan oleh Microsoft dan pengembang lainnya.

  1. Pilih tombol Pengaturan di sudut kanan atas. Di panel kiri, pilih Ekstensi.
  2. Tab Ekstensi yang Tersedia mencantumkan ekstensi pada umpan yang tersedia untuk penginstalan.
  3. Pilih ekstensi untuk menampilkan deskripsi ekstensi, versi, penerbit, dan informasi lainnya di panel Detail .
  4. Pilih Instal untuk menginstal ekstensi. Jika gateway harus berjalan dalam mode yang ditingkatkan untuk membuat perubahan ini, Anda akan melihat permintaan elevasi Kontrol Akun Pengguna (UAC). Setelah penginstalan selesai, browser Anda secara otomatis me-refresh dan Windows Admin Center dimuat ulang dengan ekstensi baru yang terinstal. Jika ekstensi yang coba Anda instal adalah pembaruan ke ekstensi yang diinstal sebelumnya, Anda dapat memilih tombol Perbarui ke terbaru untuk menginstal pembaruan. Anda juga bisa masuk ke tab Ekstensi Terinstal untuk melihat ekstensi yang diinstal dan melihat apakah pembaruan tersedia di kolom Status .

Menginstal ekstensi dari umpan yang berbeda

Pusat Admin Windows mendukung beberapa umpan dan Anda dapat melihat dan mengelola paket dari lebih dari satu umpan sekaligus. Anda dapat menambahkan umpan NuGet apa pun yang mendukung API NuGet V2 atau berbagi file ke Pusat Admin Windows untuk menginstal ekstensi.

  1. Pilih tombol Pengaturan di sudut kanan atas. Di panel kiri, pilih Ekstensi.
  2. Di panel kanan, pilih tab Umpan .
  3. Pilih tombol Tambahkan untuk menambahkan umpan lain. Untuk umpan NuGet, masukkan URL umpan NuGet V2. Penyedia umpan NuGet atau administrator harus dapat memberikan informasi URL. Untuk berbagi file, masukkan jalur lengkap berbagi file tempat file paket ekstensi (.nupkg) disimpan. Jika Anda menambahkan berbagi file sebagai umpan, file tersebut harus memenuhi kriteria berikut:
  4. Pilih Tambahkan. Jika gateway harus berjalan dalam mode yang ditingkatkan untuk membuat perubahan ini, Anda akan menerima permintaan elevasi UAC. Perintah ini hanya muncul jika Anda menjalankan Pusat Admin Windows dalam mode desktop.

Daftar Ekstensi yang Tersedia menampilkan ekstensi dari semua umpan terdaftar. Anda dapat memeriksa umpan mana setiap ekstensi berasal dengan menggunakan kolom Umpan Paket .

Copot pemasangan ekstensi

Anda dapat menghapus instalan ekstensi apa pun yang sebelumnya Anda instal, atau bahkan menghapus instalan alat apa pun yang telah diinstal sebelumnya sebagai bagian dari penginstalan Pusat Admin Windows.

  1. Pilih tombol Pengaturan di sudut kanan atas. Di panel kiri, pilih Ekstensi.
  2. Pilih tab Ekstensi Terinstal untuk melihat semua ekstensi yang terinstal.
  3. Pilih ekstensi untuk menghapus instalan, lalu pilih Hapus instalan.

Setelah proses penghapusan instalasi selesai, browser Anda secara otomatis di-refresh dan Pusat Admin Windows dimuat ulang dengan ekstensi dihapus. Jika Anda menghapus instalan alat yang telah diinstal sebelumnya sebagai bagian dari Pusat Admin Windows, Anda dapat menginstal ulang alat di tab Ekstensi yang Tersedia .

Menginstal ekstensi di komputer tanpa konektivitas internet

Jika Anda menginstal Pusat Admin Windows pada komputer yang tidak tersambung ke internet atau menggunakan proksi, mungkin tidak dapat mengakses dan menginstal ekstensi dari umpan Pusat Admin Windows. Anda dapat mengunduh paket ekstensi secara manual atau dengan menggunakan skrip PowerShell, dan mengonfigurasi Pusat Admin Windows untuk mengambil paket dari berbagi file atau drive lokal.

Mengunduh paket ekstensi secara manual

  1. Di komputer lain yang memiliki konektivitas internet, buka browser web dan buka URL berikut: https://dev.azure.com/WindowsAdminCenter/Windows%20Admin%20Center%20Feed/_artifacts/feed/wac-public-extensions

    Anda mungkin perlu membuat akun Microsoft dan masuk untuk melihat paket ekstensi.

  2. Pilih nama paket yang ingin Anda instal untuk melihat halaman detail paket.

  3. Pilih tautan Unduh di bilah navigasi atas halaman detail paket dan unduh .nupkg file untuk ekstensi.

  4. Ulangi langkah 2 dan 3 untuk semua paket yang ingin Anda unduh.

  5. Salin file paket ke berbagi file yang bisa Anda akses dari komputer tempat Anda menginstal Pusat Admin Windows, atau ke disk lokal komputer tempat Anda menginstal Pusat Admin Windows.

  6. Ikuti instruksi untuk menginstal ekstensi dari umpan yang berbeda.

Mengunduh paket dengan skrip PowerShell

Anda dapat menemukan skrip di internet untuk mengunduh paket NuGet dari umpan NuGet. Gunakan skrip yang disediakan oleh Jon Galloway, Manajer Program Senior di Microsoft.

  1. Seperti yang dijelaskan dalam posting blog, instal skrip sebagai paket NuGet, atau salin dan tempel skrip ke dalam POWERShell ISE.

  2. Editlah baris pertama skrip ke URL v2 dari umpan NuGet Anda. Jika Anda mengunduh paket dari umpan resmi Pusat Admin Windows, gunakan URL berikut:

    $feedUrlBase = "https://aka.ms/wac-public-extensions"

  3. Jalankan skrip. Ini mengunduh semua paket NuGet dari umpan ke folder lokal berikut: %USERPROFILE%\Documents\NuGetLocal.

  4. Ikuti instruksi untuk menginstal ekstensi dari umpan yang berbeda.

Mengelola ekstensi dengan PowerShell

Pratinjau Pusat Admin Windows menyertakan modul PowerShell untuk mengelola ekstensi gateway Anda.

# Add the module to the current session
Import-Module "$env:ProgramFiles\windows admin center\PowerShell\Modules\ExtensionTools"
# Available cmdlets: Get-Feed, Add-Feed, Remove-Feed, Get-Extension, Install-Extension, Uninstall-Extension, Update-Extension

# List feeds
Get-Feed "https://wac.contoso.com"

# Add a new extension feed
Add-Feed -GatewayEndpoint "https://wac.contoso.com" -Feed "\\WAC\our-private-extensions"

# Remove an extension feed
Remove-Feed -GatewayEndpoint "https://wac.contoso.com" -Feed "\\WAC\our-private-extensions"

# List all extensions
Get-Extension "https://wac.contoso.com"

# Install an extension (locate the latest version from all feeds and install it)
Install-Extension -GatewayEndpoint "https://wac.contoso.com" "msft.sme.containers"

# Install an extension (latest version from a specific feed, if the feed is not present, it will be added)
Install-Extension -GatewayEndpoint "https://wac.contoso.com" "msft.sme.containers" -Feed "https://aka.ms/sme-extension-feed"

# Install an extension (install a specific version)
Install-Extension "https://wac.contoso.com" "msft.sme.certificate-manager" "0.133.0"

# Uninstall-Extension
Uninstall-Extension "https://wac.contoso.com" "msft.sme.containers"

# Update-Extension
Update-Extension "https://wac.contoso.com" "msft.sme.containers"

Note

Anda harus menjadi administrator gateway untuk mengubah ekstensi Pusat Admin Windows dengan PowerShell.

Pelajari selengkapnya tentang membangun ekstensi dengan Windows Admin Center SDK.

Plug-in Ekstensi Gateway

Ekstensi plug-in gateway dari Windows Admin Center paling terpengaruh oleh perubahan pada gateway yang telah diperbarui. Plug-in gerbang Windows Admin Center memungkinkan komunikasi API dari UI alat atau solusi Anda ke node target. Pusat Admin Windows menghosting layanan gateway yang menyampaikan perintah dan skrip dari plug-in gateway yang akan dijalankan pada simpul target. Anda dapat memperluas layanan gateway untuk menyertakan plug-in gateway kustom yang mendukung protokol selain yang default (PowerShell dan WMI).

Karena plug-in gateway berkomunikasi dengan backend Windows Admin Center untuk mengaktifkan komunikasi API, kode plug-in gateway dapat menyertakan komponen yang ditulis dengan .NET Framework versi 4.6.2, yang tidak berfungsi dengan .NET 8.

Selain itu, cara kerja plug-in berubah dengan versi 2410. Alih-alih mengembangkan kelas C# yang mengimplementasikan IPlugIn antarmuka dari Microsoft.ManagementExperience.FeatureInterfaces namespace untuk memperluas plug-in gateway, Anda sekarang menulis ekstensi dalam bentuk pengontrol MVC ASP.NET. Pengontrol ini memiliki fleksibilitas yang meningkat dibandingkan dengan kelas C# sederhana dan dokumentasi yang luas.

Lihat dokumentasi pengembang kami untuk mempelajari selengkapnya tentang pengembangan plug-in gateway di Pusat Admin Windows.

Ekstensi tersedia saat diinstal

Ekstensi yang tidak disertakan dalam alat penginstal Pusat Admin Windows, termasuk ekstensi mitra eksternal, tidak tersedia kecuali Anda menambahkannya menggunakan umpan ekstensi.

Saat menginstal Pusat Admin Windows, Anda mendapatkan ekstensi berikut:

  • Aplikasi & fitur
  • Azure Backup
  • Sinkronisasi File Azure
  • Pusat hibrid Azure
  • Azure Kubernetes Service
  • Sertifikat
  • Pembuatan Kluster
  • Pengelola Kluster
  • Panduan Pengembang
  • Perangkat
  • Peristiwa
  • Perangkat klaster failover
  • File dan Berbagi File
  • Firewall
  • Pengguna & grup lokal
  • Alat Pengontrol Jaringan dan jaringan Virtual SDN
  • Jaringan
  • Pemantauan paket
  • Pemantau Kinerja
  • PowerShell
  • Processes
  • Registry
  • Desktop Jauh
  • Peran & fitur
  • Tugas terjadwal
  • Koneksi SDN Gateway
  • Infrastruktur SDN
  • Jaringan Logis SDN
  • Grup keamanan Jaringan SDN
  • Keamanan
  • Manajer Server dan Manajemen Komputer
  • Services
  • Storage
  • Layanan Migrasi Penyimpanan
  • Replika Penyimpanan
  • Wawasan Sistem
  • Pembaruan
  • Komputer virtual dan sakelar
  • Last updated on