Bagikan melalui

Menginstal dan mengelola ekstensi

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

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 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 kanan > atas Di panel kiri, pilih Ekstensi.
  2. Tab Ekstensi yang Tersedia mencantumkan ekstensi pada umpan yang tersedia untuk pemasangan.
  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 Anda coba instal adalah pembaruan untuk 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. Umpan NuGet apa pun yang mendukung API NuGet V2 atau berbagi file dapat ditambahkan ke Pusat Admin Windows untuk menginstal ekstensi.

  1. Pilih tombol Pengaturan di kanan > atas Di panel kiri, pilih Ekstensi.
  2. Pada 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 menambahkan berbagi file sebagai umpan, file harus memenuhi kriteria berikut:
    • Akses ke file harus diberikan ke NTAuthority\Network Service
    • Jalur file tidak dapat menyertakan folder C:\Users
    • Paket pada berbagi file harus ditandatangani, kecuali mode operasi Anda diatur ke "Pengembangan"
  4. Pilih Tambahkan. Jika gateway harus berjalan dalam mode yang ditingkatkan untuk membuat perubahan ini, Anda akan menerima permintaan elevasi UAC. Perintah ini hanya akan disajikan jika Anda menjalankan Pusat Admin Windows dalam mode desktop.

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

Menghapus pemasangan 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. Pilih tombol Pengaturan di 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 penghapusan instalasi selesai, browser Anda secara otomatis me-refresh dan Windows Admin Center dimuat ulang dengan ekstensi dihapus. Jika Anda menghapus instalan alat yang diinstal sebelumnya sebagai bagian dari Pusat Admin Windows, alat tersebut tersedia untuk penginstalan ulang di tab Ekstensi Tersedia.

Menginstal ekstensi di komputer tanpa konektivitas internet

Jika Windows Admin Center diinstal pada komputer yang tidak tersambung ke internet atau berada di belakang proksi, Windows Admin Center mungkin tidak dapat mengakses dan menginstal ekstensi dari umpan Windows Admin Center. 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. Pilih pada nama paket yang ingin Anda instal untuk melihat halaman detail paket.

  3. Pilih 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 penyimpanan bersama yang dapat diakses dari komputer tempat Windows Admin Center diinstal, atau ke disk lokal komputer tersebut.

  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. 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/sme-extension-feed"
  1. Jalankan skrip dan 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.