Memulai Galeri PowerShell

Galeri PowerShell adalah repositori paket yang berisi skrip, modul, dan sumber daya DSC yang dapat Anda unduh dan gunakan. Anda menggunakan cmdlet dalam modul PowerShellGet untuk menginstal paket dari Galeri PowerShell. Anda tidak perlu masuk untuk mengunduh item dari Galeri PowerShell.

Anda dapat menemukan paket di Galeri PowerShell menggunakan kontrol Pencarian pada halaman beranda PowerShell Gallery, atau dengan menelusuri Modul dan Skrip dari halaman Paket . Anda juga dapat menemukan paket dari Galeri PowerShell dengan menjalankan cmdlet Find-Module, Find-DscResource, dan Find-Script, tergantung pada jenis paket, dengan -Repository PSGallery.

Anda dapat memfilter hasil dari Galeri menggunakan parameter berikut:

  • Nama
  • AllVersions
  • MinimumVersion
  • RequiredVersion
  • Tag
  • Termasuk
  • DscResource
  • RoleCapability
  • Perintah
  • Saringan

Jika Anda hanya tertarik untuk menemukan sumber daya DSC tertentu di Galeri, Anda dapat menjalankan cmdlet Find-DscResource. Find-DscResource mengembalikan data pada sumber daya DSC yang terkandung dalam Galeri. Karena sumber daya DSC selalu dikirimkan sebagai bagian dari modul, Anda masih perlu menjalankan Install-Module untuk menginstal sumber daya DSC tersebut.

Setelah memilih paket, Anda mungkin ingin mempelajarinya lebih lanjut. Periksa halaman paket di Galeri. Halaman paket menyertakan metadata yang diunggah bersama paket. Metadata disediakan oleh penulis paket. Microsoft tidak memverifikasi informasi ini. Pemilik paket dikaitkan dengan akun Galeri yang digunakan untuk menerbitkan paket. Akun Pemilik lebih otoritatif daripada bidang Penulis.

Jika Anda menemukan paket yang menurut Anda tidak dipublikasikan dengan itikad baik, pilih Laporkan Penyalahgunaan di halaman paket tersebut.

Jika Anda menjalankan atau , Anda dapat melihat data ini di objek PSGetModuleInfo yang dikembalikan. Contoh berikut mengembalikan data pada modul PSReadLine di Galeri.

Find-Module -Name PSReadLine -Repository PSGallery | Get-Member

Kami mendorong proses berikut saat mengunduh paket dari Galeri PowerShell:

Periksa

Untuk mengunduh paket dari Galeri untuk diperiksa, gunakan Save-Module cmdlet atau Save-Script pada paket. Perintah ini menyimpan paket secara lokal tanpa menginstalnya. Periksa isi paket. Ingatlah untuk menghapus paket yang disimpan secara manual.

Beberapa paket ditulis oleh Microsoft, dan yang lain ditulis oleh komunitas PowerShell. Microsoft menyarankan agar Anda meninjau isi dan kode paket di galeri ini sebelum penginstalan.

Jika Anda menemukan paket yang menurut Anda tidak dipublikasikan dengan itikad baik, pilih Laporkan Penyalahgunaan di halaman paket tersebut.

Pasang

Untuk menginstal paket dari Galeri untuk digunakan, jalankan cmdlet Install-Module atau Install-Script, tergantung pada jenis paket.

Secara default, Install-Module menginstal modul ke $env:ProgramFiles\WindowsPowerShell\Modules lokasi secara default, yang memerlukan akun administrator. Jika Anda menambahkan -Scope CurrentUser parameter, perintah akan menginstal modul di $HOME\Documents\WindowsPowerShell\Modules .

Secara default, Install-Script menginstal skrip ke $env:ProgramFiles\WindowsPowerShell\Scripts lokasi, yang memerlukan akun administrator. Jika Anda menambahkan -Scope CurrentUser parameter, perintah akan menginstal skrip di $HOME\Documents\WindowsPowerShell\Scripts.

Install-Module Install-Script dan menginstal versi terbaru dari sebuah paket. Untuk menginstal versi paket yang lebih lama, tambahkan parameter -RequiredVersion.

Menyebarkan

Untuk menyebarkan paket dari Galeri PowerShell ke Azure Automation, pilih Azure Automation, lalu pilih Sebarkan ke Azure Automation di halaman detail paket. Anda diarahkan ke Portal Manajemen Azure tempat Anda masuk menggunakan kredensial akun Azure Anda. Menyebarkan paket dengan dependensi menyebarkan semua dependensi ke Azure Automation. Tombol Sebarkan ke Azure Automation dapat dinonaktifkan dengan menambahkan tag AzureAutomationNotSupported ke metadata paket Anda.

Untuk mempelajari selengkapnya tentang Azure Automation, lihat dokumentasi Azure Automation.

Untuk memperbarui paket yang diinstal dari Galeri PowerShell, jalankan cmdlet Update-Module atau Update-Script. Saat dijalankan tanpa parameter lain, Update-Module mencoba memperbarui semua modul yang diinstal dengan menjalankan Install-Module. Untuk memperbarui modul secara selektif, tambahkan parameter -Name.

Demikian pula, ketika dijalankan tanpa parameter lain, Update-Script juga mencoba memperbarui semua skrip yang diinstal dengan menjalankan Install-Script. Untuk memperbarui skrip secara selektif, tambahkan parameter -Name.

Untuk mengetahui modul mana yang Anda instal dari Galeri PowerShell, jalankan Get-InstalledModule cmdlet. Perintah ini mencantumkan semua modul yang Anda miliki di sistem Anda yang diinstal langsung dari Galeri PowerShell.

Demikian pula, untuk mengetahui skrip mana yang Anda instal dari Galeri PowerShell, jalankan Get-InstalledScript cmdlet. Perintah ini mencantumkan semua skrip yang Anda miliki di sistem Anda yang diinstal langsung dari Galeri PowerShell.

Penting

Galeri PowerShell memerlukan Transport Layer Security (TLS) 1.2 atau lebih tinggi. Jika Anda tidak menggunakan TLS 1.2 atau yang lebih tinggi, Anda akan menerima kesalahan saat mencoba mengakses Galeri PowerShell. Gunakan perintah berikut untuk memastikan Anda menggunakan TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol =
    [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

Nama host ini harus ditambahkan ke daftar izinkan yang mengontrol akses dari jaringan Anda.

Host yang diperlukan untuk penemuan dan pengunduhan paket:

  • cdn.oneget.org
  • cdn.powershellgallery.com

Host diperlukan saat menggunakan situs web Galeri PowerShell:

  • *.powershellgallery.com - situs web
  • go.microsoft.com dan aka.ms - layanan pengalihan

Nota

Titik akhir lama yang diakhiri dengan azureedge.net tidak lagi didukung.

  • Find-DscResource
  • Find-Module
  • Find-Script
  • Get-InstallModule
  • Get-InstallScript
  • Install-Module
  • Install-Script
  • Publish-Module
  • Publish-Script
  • Register-PSRepository
  • Save-Module
  • Save-Script
  • Update-Module
  • Update-Script
  • Last updated on