Menginstal dan mengelola ekstensi

  • Artikel

Berlaku untuk: Pusat Admin Windows, Pratinjau Pusat Admin Windows

Pusat Admin Windows dibangun sebagai 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.

Menginstal ekstensi

Pusat Admin Windows akan menampilkan 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. Klik tombol Pengaturan di kanan > atas Di panel kiri, klik Ekstensi.
  2. Tab Ekstensi yang Tersedia akan mencantumkan ekstensi pada umpan yang tersedia untuk penginstalan.
  3. Klik ekstensi untuk menampilkan deskripsi ekstensi, versi, penerbit, dan informasi lainnya di panel Detail .
  4. Klik Instal untuk menginstal ekstensi. Jika gateway harus berjalan dalam mode yang ditingkatkan untuk membuat perubahan ini, Anda akan disajikan dengan permintaan elevasi UAC. Setelah penginstalan selesai, browser Anda akan disegarkan secara otomatis dan Pusat Admin Windows akan dimuat ulang dengan ekstensi baru yang diinstal. Jika ekstensi yang Anda coba instal adalah pembaruan untuk ekstensi yang diinstal sebelumnya, Anda dapat mengklik 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. Umpan NuGet apa pun yang mendukung API NuGet V2 atau berbagi file dapat ditambahkan ke Pusat Admin Windows untuk menginstal ekstensi.

  1. Klik tombol Pengaturan di kanan > atas Di panel kiri, klik Ekstensi.
  2. Di panel kanan, klik tab Umpan .
  3. Klik 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.
  4. Klik Tambahkan. Jika gateway harus berjalan dalam mode yang ditingkatkan untuk membuat perubahan ini, Anda akan disajikan dengan permintaan elevasi UAC. Perintah ini hanya akan disajikan jika Anda menjalankan Pusat Admin Windows dalam mode desktop.

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

Menghapus instalan ekstensi

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

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

Setelah penginstalan selesai, browser Anda akan disegarkan secara otomatis dan Pusat Admin Windows akan dimuat ulang dengan ekstensi dihapus. Jika Anda menghapus instalan alat yang telah diinstal sebelumnya sebagai bagian dari Pusat Admin Windows, alat akan tersedia untuk penginstalan ulang di tab Ekstensi yang Tersedia.

Menginstal ekstensi di komputer tanpa konektivitas internet

Jika Pusat Admin Windows diinstal pada komputer yang tidak tersambung ke internet atau berada di belakang proksi, pusat admin Windows mungkin tidak dapat mengakses dan menginstal ekstensi dari umpan Pusat Admin Windows. Anda dapat mengunduh paket ekstensi secara manual atau dengan 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 navigasikan ke URL berikut: https://dev.azure.com/WindowsAdminCenter/Windows%20Admin%20Center%20Feed/_packaging?_a=feed& feed=WAC

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

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

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

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

  5. Salin file paket ke berbagi file yang dapat diakses dari komputer Windows Admin Center diinstal, atau ke disk lokal komputer tempat Pusat Admin Windows diinstal.

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

Mengunduh paket dengan skrip PowerShell

Ada banyak skrip yang tersedia di Internet untuk mengunduh paket NuGet dari umpan NuGet. Kami akan menggunakan skrip yang disediakan oleh Jon Galloway, Senior Program Manager di Microsoft.

  1. Seperti yang dijelaskan dalam posting blog, instal skrip sebagai paket NuGet, atau salin dan tempel skrip ke dalam POWERShell ISE.
  2. Edit baris pertama skrip ke URL v2 umpan NuGet Anda. Jika Anda mengunduh paket dari umpan resmi Pusat Admin Windows, gunakan URL di bawah ini.
$feedUrlBase = "https://aka.ms/sme-extension-feed"
  1. Jalankan skrip dan akan mengunduh semua paket NuGet dari umpan ke folder lokal berikut: %USERPROFILE%\Documents\NuGetLocal
  2. 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"

Catatan

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

Pelajari selengkapnya tentang membangun ekstensi dengan Windows Admin Center SDK.