Membuat modul di skrip Windows PowerShell

  • 5 menit

Anda dapat membuat modul untuk menyimpan fungsi dan berbagi fungsi tersebut di antara skrip. Setelah Anda memasukkan fungsi Anda ke dalam modul, fungsi tersebut dapat ditemukan sama seperti cmdlet. Seperti modul Windows bawaan, modul Anda juga dimuat secara otomatis saat fungsi diperlukan.

Catatan

Beri nama fungsi Anda dalam modul menggunakan konvensi penamaan kata kerja yang sama dengan cmdlet. Misalnya, gunakan format kata kerja-kata benda.

Catatan

Fungsi dalam modul dapat menyertakan bantuan berbasis komentar yang dapat ditemukan Get-Help . Sertakan informasi bantuan di setiap fungsi untuk mengaktifkan ini.

Jika Anda sudah memiliki fungsi dalam file skrip PowerShell Windows, konversikan ke modul dengan mengganti nama dengan ekstensi file .psm1. Struktur file tidak perlu diubah.

Windows PowerShell menggunakan variabel lingkungan $PSModulePath untuk menentukan jalur tempat modul dimuat. Di Windows PowerShell 5.1, jalur berikut dicantumkan:

  • C:\Users\UserID\Documents\WindowsPowerShell\Modules
  • C:\Program Files\WindowsPowerShell\Modules
  • C:\Windows\System32\WindowsPowerShell\1.0\Modules

Windows PowerShell 7 mencakup jalur lain berikut:

  • C:\Users\UserID\Documents\PowerShell\Modules
  • C:\Program Files\PowerShell\Modules
  • C:\Program Files\PowerShell\7\Modules

Catatan

Jalur cakupan pengguna PowerShell 7 (Documents\PowerShell\Modules) berbeda dari jalur cakupan pengguna Windows PowerShell 5.1 (Documents\WindowsPowerShell\Modules). Modul yang disimpan di jalur 5.1 tidak dimuat secara otomatis dalam sesi cakupan pengguna PS7.

Catatan

Jika Anda menyimpan modul di C:\Users\UserID\Documents\WindowsPowerShell\Modules, modul hanya tersedia untuk satu pengguna.

Modul tidak ditempatkan langsung di direktori Modul . Sebagai gantinya, Anda harus membuat subfolder dengan nama yang sama dengan file dan menempatkan file di folder tersebut. Misalnya, jika Anda memiliki modul bernama AdatumFunctions.psm1, Anda akan menempatkannya di C:\Program Files\WindowsPowerShell\Modules\AdatumFunctions.