Unduhan Paket Manual

Galeri PowerShell mendukung pengunduhan paket dari situs web secara langsung, tanpa menggunakan cmdlet PowerShellGet. Anda dapat mengunduh paket apa pun sebagai file paket NuGet (.nupkg), yang kemudian dapat Anda salin ke repositori internal.

Catatan

Unduhan paket manual tidak dimaksudkan sebagai pengganti Install-Module cmdlet. Mengunduh paket tidak menginstal modul atau skrip. Dependensi tidak disertakan dalam paket NuGet yang diunduh. Instruksi berikut disediakan hanya untuk tujuan referensi.

Menggunakan unduhan manual untuk memperoleh paket

Setiap halaman memiliki tautan untuk Unduh manual, seperti yang ditunjukkan di sini:

Untuk mengunduh secara manual, klik Unduh file nupkg mentah. Salinan paket disalin ke folder unduhan untuk browser Anda dengan nama <name>.<version>.nupkg.

Paket NuGet adalah arsip ZIP dengan file tambahan yang berisi informasi tentang konten paket. Beberapa browser, seperti Internet Explorer, secara otomatis mengganti .nupkg ekstensi file dengan .zip. Untuk memperluas paket, ganti nama .nupkg file menjadi .zip, jika diperlukan, lalu ekstrak konten ke folder lokal.

File paket NuGet menyertakan elemen khusus NuGet berikut yang bukan bagian dari kode paket asli:

• Folder bernama _rels - berisi .rels file yang mencantumkan dependensi
• Folder bernama package - berisi data khusus NuGet
• File bernama [Content_Types].xml - menjelaskan cara kerja ekstensi seperti PowerShellGet dengan NuGet
• File bernama <name>.nuspec - berisi sebagian besar metadata

Menginstal modul PowerShell dari paket NuGet

Catatan

Instruksi ini TIDAK memberikan hasil yang sama seperti menjalankan Install-Module. Instruksi ini memenuhi persyaratan minimum. Mereka tidak dimaksudkan untuk menjadi pengganti .Install-Module Beberapa langkah yang dilakukan oleh Install-Module tidak disertakan.

Pendekatan termampu adalah menghapus elemen khusus NuGet dari folder. Menghapus elemen meninggalkan kode PowerShell yang dibuat oleh pembuat paket. Untuk daftar elemen khusus NuGet, lihat Menggunakan unduhan manual untuk memperoleh paket.

Langkah langkahnya adalah sebagai berikut:

1. Buka blokir file paket NuGet yang diunduh Internet (.nupkg), misalnya menggunakan Unblock-File -Path C:\Downloads\module.nupkg cmdlet.
2. Ekstrak isi paket NuGet ke folder lokal.
3. Hapus elemen khusus NuGet dari folder .
4. Ganti nama folder. Nama folder default biasanya <name>.<version>. Versi dapat mencakup -prerelease apakah modul ditandai sebagai versi prarilis. Ganti nama folder menjadi nama modul saja. Misalnya, azurerm.storage.5.0.4-preview menjadi azurerm.storage.
5. Salin folder ke salah satu folder di $env:PSModulePath value. $env:PSModulePath adalah sekumpulan jalur yang dibatasi titik koma tempat PowerShell harus mencari modul.

Penting

Unduhan manual tidak menyertakan dependensi apa pun yang diperlukan oleh modul. Jika paket memiliki dependensi, paket harus diinstal pada sistem agar modul ini berfungsi dengan benar. Galeri PowerShell menunjukkan semua dependensi yang diperlukan oleh paket.

Menginstal skrip PowerShell dari paket NuGet

Catatan

Instruksi ini TIDAK memberikan hasil yang sama seperti menjalankan Install-Script. Instruksi ini memenuhi persyaratan minimum. Mereka tidak dimaksudkan untuk menjadi pengganti .Install-Script

Pendekatan termampu adalah mengekstrak paket NuGet, lalu menggunakan skrip secara langsung.

Langkah langkahnya adalah sebagai berikut:

1. Buka blokir file paket NuGet yang diunduh Internet (.nupkg), misalnya menggunakan Unblock-File -Path C:\Downloads\package.nupkg cmdlet.
2. Ekstrak konten paket NuGet.
3. File .PS1 dalam folder dapat digunakan langsung dari lokasi ini.
4. Anda dapat menghapus elemen khusus NuGet di folder .

Untuk daftar elemen khusus NuGet, lihat Menggunakan unduhan manual untuk memperoleh paket.

Penting

Unduhan manual tidak menyertakan dependensi apa pun yang diperlukan oleh modul. Jika paket memiliki dependensi, paket harus diinstal pada sistem agar modul ini berfungsi dengan benar. Galeri PowerShell menunjukkan semua dependensi yang diperlukan oleh paket.