Bagikan melalui

Memulai Galeri PowerShell

  • Artikel

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

Nota

Dimungkinkan untuk mengunduh paket dari Galeri PowerShell secara langsung, tetapi ini bukan pendekatan yang direkomendasikan. Untuk detail selengkapnya, lihat Unduhan Paket Manual.

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 mengidentifikasi paket yang Anda minati, Anda mungkin ingin mempelajarinya lebih lanjut. Anda dapat melakukan ini dengan memeriksa halaman spesifik paket tersebut di Galeri. Pada halaman tersebut, Anda akan dapat melihat semua metadata yang diunggah dengan paket. Metadata ini disediakan oleh penulis paket, dan tidak diverifikasi oleh Microsoft. Pemilik paket sangat terikat dengan akun Galeri yang digunakan untuk menerbitkan paket, dan lebih dapat dipercaya daripada bidang Penulis.

Jika Anda menemukan paket yang menurut Anda tidak diterbitkan dengan itikad baik, klik 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 inspeksi, jalankan cmdlet Save-Module atau Save-Script, tergantung pada jenis paket. Ini memungkinkan Anda menyimpan paket secara lokal tanpa menginstalnya, dan memeriksa konten paket. Ingatlah untuk menghapus paket yang disimpan secara manual.

Beberapa paket ini 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 diterbitkan dengan itikad baik, klik 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.

Install-Module menginstal modul untuk $env:ProgramFiles\WindowsPowerShell\Modules secara default. Ini memerlukan akun administrator. Jika Anda menambahkan parameter -Scope CurrentUser, modul diinstal ke $HOME\Documents\WindowsPowerShell\Modules .

Install-Script menginstal skrip untuk $env:ProgramFiles\WindowsPowerShell\Scripts secara default. Ini memerlukan akun administrator. Jika Anda menambahkan parameter -Scope CurrentUser, skrip diinstal ke $HOME\Documents\WindowsPowerShell\Scripts .

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

Menyebarkan

Untuk menyebarkan paket dari Galeri PowerShell ke Azure Automation, klik Azure Automation, lalu klik Sebarkan ke Azure Automation pada halaman detail paket. Anda dialihkan ke Portal Manajemen Azure tempat Anda masuk menggunakan kredensial akun Azure Anda. Perhatikan bahwa 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 tambahan, 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 tambahan, 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 telah Anda instal dari Galeri PowerShell, jalankan cmdlet Get-InstalledModule. Perintah ini mencantumkan semua modul yang Anda miliki di sistem Anda yang diinstal langsung dari Galeri PowerShell.

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

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

Host yang diperlukan untuk penemuan dan pengunduhan paket:

  • onegetcdn.azureedge.net
  • powershellgallery.azureedge.net
  • psg-prod-eastus.azureedge.net

Host diperlukan saat menggunakan situs web Galeri PowerShell:

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

Penting

Pada April 2020, Galeri PowerShell tidak lagi mendukung Transport Layer Security (TLS) versi 1.0 dan 1.1. 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

Untuk informasi selengkapnya, lihat pengumuman di blog PowerShell.

  • 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