Import-Module
Menambahkan modul ke sesi saat ini.
Sintaks
Import-Module
[-Global]
[-Prefix <String>]
[-Name] <String[]>
[-Function <String[]>]
[-Cmdlet <String[]>]
[-Variable <String[]>]
[-Alias <String[]>]
[-Force]
[-SkipEditionCheck]
[-PassThru]
[-AsCustomObject]
[-MinimumVersion <Version>]
[-MaximumVersion <String>]
[-RequiredVersion <Version>]
[-ArgumentList <Object[]>]
[-DisableNameChecking]
[-NoClobber]
[-Scope <String>]
[<CommonParameters>]
Import-Module
[-Global]
[-Prefix <String>]
[-Name] <String[]>
[-Function <String[]>]
[-Cmdlet <String[]>]
[-Variable <String[]>]
[-Alias <String[]>]
[-Force]
[-SkipEditionCheck]
[-PassThru]
[-AsCustomObject]
[-MinimumVersion <Version>]
[-MaximumVersion <String>]
[-RequiredVersion <Version>]
[-ArgumentList <Object[]>]
[-DisableNameChecking]
[-NoClobber]
[-Scope <String>]
-PSSession <PSSession>
[<CommonParameters>]
Import-Module
[-Global]
[-Prefix <String>]
[-Name] <String[]>
[-Function <String[]>]
[-Cmdlet <String[]>]
[-Variable <String[]>]
[-Alias <String[]>]
[-Force]
[-SkipEditionCheck]
[-PassThru]
[-AsCustomObject]
[-MinimumVersion <Version>]
[-MaximumVersion <String>]
[-RequiredVersion <Version>]
[-ArgumentList <Object[]>]
[-DisableNameChecking]
[-NoClobber]
[-Scope <String>]
-CimSession <CimSession>
[-CimResourceUri <Uri>]
[-CimNamespace <String>]
[<CommonParameters>]
Import-Module
[-Name] <string[]>
-UseWindowsPowerShell
[-Global]
[-Prefix <string>]
[-Function <string[]>]
[-Cmdlet <string[]>]
[-Variable <string[]>]
[-Alias <string[]>]
[-Force]
[-PassThru]
[-AsCustomObject]
[-MinimumVersion <version>]
[-MaximumVersion <string>]
[-RequiredVersion <version>]
[-ArgumentList <Object[]>]
[-DisableNameChecking]
[-NoClobber]
[-Scope <string>]
[<CommonParameters>]
Import-Module
[-Global]
[-Prefix <String>]
[-FullyQualifiedName] <ModuleSpecification[]>
[-Function <String[]>]
[-Cmdlet <String[]>]
[-Variable <String[]>]
[-Alias <String[]>]
[-Force]
[-SkipEditionCheck]
[-PassThru]
[-AsCustomObject]
[-ArgumentList <Object[]>]
[-DisableNameChecking]
[-NoClobber]
[-Scope <String>]
[<CommonParameters>]
Import-Module
[-Global]
[-Prefix <String>]
[-FullyQualifiedName] <ModuleSpecification[]>
[-Function <String[]>]
[-Cmdlet <String[]>]
[-Variable <String[]>]
[-Alias <String[]>]
[-Force]
[-SkipEditionCheck]
[-PassThru]
[-AsCustomObject]
[-ArgumentList <Object[]>]
[-DisableNameChecking]
[-NoClobber]
[-Scope <String>]
-PSSession <PSSession>
[<CommonParameters>]
Import-Module
[-FullyQualifiedName] <ModuleSpecification[]>
-UseWindowsPowerShell
[-Global]
[-Prefix <string>]
[-Function <string[]>]
[-Cmdlet <string[]>]
[-Variable <string[]>]
[-Alias <string[]>]
[-Force]
[-PassThru]
[-AsCustomObject]
[-ArgumentList <Object[]>]
[-DisableNameChecking]
[-NoClobber]
[-Scope <string>]
[<CommonParameters>]
Import-Module
[-Global]
[-Prefix <String>]
[-Assembly] <Assembly[]>
[-Function <String[]>]
[-Cmdlet <String[]>]
[-Variable <String[]>]
[-Alias <String[]>]
[-Force]
[-SkipEditionCheck]
[-PassThru]
[-AsCustomObject]
[-ArgumentList <Object[]>]
[-DisableNameChecking]
[-NoClobber]
[-Scope <String>]
[<CommonParameters>]
Import-Module
[-Global]
[-Prefix <String>]
[-Function <String[]>]
[-Cmdlet <String[]>]
[-Variable <String[]>]
[-Alias <String[]>]
[-Force]
[-SkipEditionCheck]
[-PassThru]
[-AsCustomObject]
[-ModuleInfo] <PSModuleInfo[]>
[-ArgumentList <Object[]>]
[-DisableNameChecking]
[-NoClobber]
[-Scope <String>]
[<CommonParameters>]
Deskripsi
Import-Module
Cmdlet menambahkan satu atau beberapa modul ke sesi saat ini. Mulai dari PowerShell 3.0, modul yang diinstal secara otomatis diimpor ke sesi saat Anda menggunakan perintah atau penyedia apa pun dalam modul. Namun, Anda masih dapat menggunakan Import-Module
perintah untuk mengimpor modul.
Anda dapat menonaktifkan impor modul otomatis menggunakan $PSModuleAutoloadingPreference
variabel preferensi. Untuk informasi selengkapnya tentang variabel, $PSModuleAutoloadingPreference
lihat about_Preference_Variables.
Modul adalah paket yang berisi anggota yang dapat digunakan di PowerShell. Anggota mencakup cmdlet, penyedia, skrip, fungsi, variabel, dan alat dan file lainnya. Setelah modul diimpor, Anda dapat menggunakan anggota modul dalam sesi Anda. Untuk informasi selengkapnya tentang modul, lihat about_Modules.
Secara default, Import-Module
mengimpor semua anggota yang diekspor modul, tetapi Anda dapat menggunakan parameter Alias, Function, Cmdlet, dan Variable untuk membatasi anggota mana yang diimpor. Parameter NoClobber mencegah Import-Module
mengimpor anggota yang memiliki nama yang sama dengan anggota dalam sesi saat ini.
Import-Module
mengimpor modul hanya ke sesi saat ini. Untuk mengimpor modul ke setiap sesi baru, tambahkan Import-Module
perintah ke profil PowerShell Anda. Untuk informasi selengkapnya tentang profil, lihat about_Profiles.
Anda dapat mengelola komputer Windows jarak jauh yang mengaktifkan remoting PowerShell dengan membuat PSSession di komputer jarak jauh. Kemudian gunakan parameter PSSession untuk Import-Module
mengimpor modul yang diinstal pada komputer jarak jauh. Ketika Anda menggunakan perintah yang diimpor dalam sesi saat ini, perintah secara implisit berjalan pada komputer jarak jauh.
Mulai dari Windows PowerShell 3.0, Anda dapat menggunakan Import-Module
untuk mengimpor modul Common Information Model (CIM). Modul CIM menentukan cmdlet dalam file Cmdlet Definition XML (CDXML). Fitur ini memungkinkan Anda menggunakan cmdlet yang diimplementasikan dalam rakitan kode yang tidak dikelola, seperti yang ditulis dalam C++.
Untuk komputer jarak jauh yang tidak mengaktifkan remoting PowerShell, termasuk komputer yang tidak menjalankan sistem operasi Windows, Anda dapat menggunakan parameter Import-Module
CIMSession untuk mengimpor modul CIM dari komputer jarak jauh. Perintah yang diimpor berjalan secara implisit pada komputer jarak jauh. CIMSession adalah koneksi ke Windows Management Instrumentation (WMI) di komputer jarak jauh.
Contoh
Contoh 1: Mengimpor anggota modul ke sesi saat ini
Contoh ini mengimpor anggota modul PSDiagnostics ke dalam sesi saat ini.
Import-Module -Name PSDiagnostics
Contoh 2: Mengimpor semua modul yang ditentukan oleh jalur modul
Contoh ini mengimpor semua modul yang tersedia di jalur yang ditentukan oleh $env:PSModulePath
variabel lingkungan ke dalam sesi saat ini.
Get-Module -ListAvailable | Import-Module
Contoh 3: Mengimpor anggota beberapa modul ke dalam sesi saat ini
Contoh ini mengimpor anggota modul PSDiagnostics dan Dism ke dalam sesi saat ini.
$m = Get-Module -ListAvailable PSDiagnostics, Dism
Import-Module -ModuleInfo $m
Get-Module
Cmdlet mendapatkan modul PSDiagnostics dan Dism dan menyimpan objek dalam $m
variabel. Parameter ListAvailable diperlukan saat Anda mendapatkan modul yang belum diimpor ke dalam sesi.
Parameter ModuleInfo digunakan Import-Module
untuk mengimpor modul ke dalam sesi saat ini.
Contoh 4: Mengimpor semua modul yang ditentukan oleh jalur
Contoh ini menggunakan jalur eksplisit untuk mengidentifikasi modul yang akan diimpor.
Import-Module -Name c:\ps-test\modules\test -Verbose
VERBOSE: Loading module from path 'C:\ps-test\modules\Test\Test.psm1'.
VERBOSE: Exporting function 'my-parm'.
VERBOSE: Exporting function 'Get-Parameter'.
VERBOSE: Exporting function 'Get-Specification'.
VERBOSE: Exporting function 'Get-SpecDetails'.
Menggunakan parameter Verbose menyebabkan Import-Module
kemajuan laporan saat memuat modul.
Tanpa parameter Verbose, PassThru, atau AsCustomObject, Import-Module
tidak menghasilkan output apa pun saat mengimpor modul.
Contoh 5: Membatasi anggota modul yang diimpor ke dalam sesi
Contoh ini menunjukkan cara membatasi anggota modul mana yang diimpor ke dalam sesi dan efek perintah ini pada sesi. Parameter Fungsi membatasi anggota yang diimpor dari modul. Anda juga dapat menggunakan parameter Alias, Variabel, dan Cmdlet untuk membatasi anggota lain yang diimpor modul.
Get-Module
Cmdlet mendapatkan objek yang mewakili modul PSDiagnostics. Properti ExportedCmdlets mencantumkan semua cmdlet yang diekspor modul, meskipun tidak semuanya diimpor.
Import-Module PSDiagnostics -Function Disable-PSTrace, Enable-PSTrace
(Get-Module PSDiagnostics).ExportedCommands
Key Value
--- -----
Disable-PSTrace Disable-PSTrace
Disable-PSWSManCombinedTrace Disable-PSWSManCombinedTrace
Disable-WSManTrace Disable-WSManTrace
Enable-PSTrace Enable-PSTrace
Enable-PSWSManCombinedTrace Enable-PSWSManCombinedTrace
Enable-WSManTrace Enable-WSManTrace
Get-LogProperties Get-LogProperties
Set-LogProperties Set-LogProperties
Start-Trace Start-Trace
Stop-Trace Stop-Trace
Get-Command -Module PSDiagnostics
CommandType Name Version Source
----------- ---- ------- ------
Function Disable-PSTrace 6.1.0.0 PSDiagnostics
Function Enable-PSTrace 6.1.0.0 PSDiagnostics
Menggunakan parameter Modul cmdlet Get-Command
menunjukkan perintah yang diimpor dari modul PSDiagnostics. Hasilnya mengonfirmasi bahwa hanya Disable-PSTrace
cmdlet dan Enable-PSTrace
yang diimpor.
Contoh 6: Mengimpor anggota modul dan menambahkan awalan
Contoh ini mengimpor modul PSDiagnostics ke sesi saat ini, menambahkan awalan ke nama anggota, lalu menampilkan nama anggota awalan. Parameter Awalan menambahkan x
awalan Import-Module
ke semua anggota yang diimpor dari modul. Awalan hanya berlaku untuk anggota dalam sesi saat ini. Ini tidak mengubah modul. Parameter PassThru mengembalikan objek modul yang mewakili modul yang diimpor.
Import-Module PSDiagnostics -Prefix x -PassThru
ModuleType Version Name ExportedCommands
---------- ------- ---- ----------------
Script 6.1.0.0 PSDiagnostics {Disable-xPSTrace, Disable-xPSWSManCombinedTrace, Disable-xW...
Get-Command -Module PSDiagnostics
CommandType Name Version Source
----------- ---- ------- ------
Function Disable-xPSTrace 6.1.0.0 PSDiagnostics
Function Disable-xPSWSManCombinedTrace 6.1.0.0 PSDiagnostics
Function Disable-xWSManTrace 6.1.0.0 PSDiagnostics
Function Enable-xPSTrace 6.1.0.0 PSDiagnostics
Function Enable-xPSWSManCombinedTrace 6.1.0.0 PSDiagnostics
Function Enable-xWSManTrace 6.1.0.0 PSDiagnostics
Function Get-xLogProperties 6.1.0.0 PSDiagnostics
Function Set-xLogProperties 6.1.0.0 PSDiagnostics
Function Start-xTrace 6.1.0.0 PSDiagnostics
Function Stop-xTrace 6.1.0.0 PSDiagnostics
Get-Command
mendapatkan anggota yang telah diimpor dari modul. Output menunjukkan bahwa anggota modul diawali dengan benar.
Contoh 7: Mendapatkan dan menggunakan objek kustom
Contoh ini menunjukkan cara mendapatkan dan menggunakan objek kustom yang dikembalikan oleh Import-Module
.
Objek kustom mencakup anggota sintetis yang mewakili setiap anggota modul yang diimpor. Misalnya, cmdlet dan fungsi dalam modul dikonversi ke metode skrip objek kustom.
Objek kustom berguna dalam pembuatan skrip. Mereka juga berguna ketika beberapa objek yang diimpor memiliki nama yang sama. Menggunakan metode skrip objek setara dengan menentukan nama anggota yang diimpor sepenuhnya memenuhi syarat, termasuk nama modulnya.
Parameter AsCustomObject hanya dapat digunakan saat mengimpor modul skrip. Gunakan Get-Module
untuk menentukan modul mana yang tersedia adalah modul skrip.
Get-Module -List | Format-Table -Property Name, ModuleType -AutoSize
Name ModuleType
---- ----------
Show-Calendar Script
BitsTransfer Manifest
PSDiagnostics Manifest
TestCmdlets Script
...
$a = Import-Module -Name Show-Calendar -AsCustomObject -PassThru
$a | Get-Member
TypeName: System.Management.Automation.PSCustomObject
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
Show-Calendar ScriptMethod System.Object Show-Calendar();
$a."Show-Calendar"()
Modul Show-Calendar
skrip diimpor menggunakan parameter AsCustomObject untuk meminta objek kustom dan parameter PassThru untuk mengembalikan objek. Objek kustom yang dihasilkan disimpan dalam $a
variabel .
Variabel $a
disalurkan ke Get-Member
cmdlet untuk menunjukkan properti dan metode objek yang disimpan. Output menunjukkan Show-Calendar
metode skrip.
Untuk memanggil Show-Calendar
metode skrip, nama metode harus diapit dalam tanda kutip karena namanya menyertakan tanda hubung.
Contoh 8: Reimport modul ke dalam sesi yang sama
Contoh ini menunjukkan cara menggunakan parameter Import-Module
Force saat Anda menimpor ulang modul ke dalam sesi yang sama. Parameter Paksa menghapus modul yang dimuat lalu mengimpornya lagi.
Import-Module PSDiagnostics
Import-Module PSDiagnostics -Force -Prefix PS
Perintah pertama mengimpor modul PSDiagnostics . Perintah kedua mengimpor modul lagi, kali ini menggunakan parameter Awalan.
Tanpa parameter Force, sesi akan menyertakan dua salinan setiap cmdlet PSDiagnostics, satu dengan nama standar dan satu dengan nama awalan.
Contoh 9: Jalankan perintah yang telah disembunyikan oleh perintah yang diimpor
Contoh ini menunjukkan cara menjalankan perintah yang telah disembunyikan oleh perintah yang diimpor. Modul TestModule mencakup fungsi bernama Get-Date
yang mengembalikan tahun dan hari dalam setahun.
Get-Date
Thursday, August 15, 2019 2:26:12 PM
Import-Module TestModule
Get-Date
19227
Get-Command Get-Date -All | Format-Table -Property CommandType, Name, ModuleName -AutoSize
CommandType Name ModuleName
----------- ---- ----------
Function Get-Date TestModule
Cmdlet Get-Date Microsoft.PowerShell.Utility
Microsoft.PowerShell.Utility\Get-Date
Thursday, August 15, 2019 2:28:31 PM
Cmdlet pertama Get-Date
mengembalikan objek DateTime dengan tanggal saat ini. Setelah mengimpor modul TestModule , Get-Date
mengembalikan tahun dan hari dalam setahun.
Menggunakan parameter Semua tampilkan Get-Command
semua Get-Date
perintah dalam sesi. Hasilnya menunjukkan bahwa ada dua Get-Date
perintah dalam sesi, fungsi dari modul TestModule dan cmdlet dari modul Microsoft.PowerShell.Utility .
Karena fungsi lebih diutamakan daripada cmdlet, Get-Date
fungsi dari modul TestModule berjalan, bukan Get-Date
cmdlet. Untuk menjalankan versi Get-Date
asli , Anda harus memenuhi syarat nama perintah dengan nama modul.
Untuk informasi selengkapnya tentang prioritas perintah di PowerShell, lihat about_Command_Precedence.
Contoh 10: Mengimpor versi minimum modul
Contoh ini mengimpor modul PowerShellGet . Ini menggunakan parameter MinimumVersion untuk Import-Module
mengimpor hanya versi 2.0.0
atau lebih besar dari modul.
Import-Module -Name PowerShellGet -MinimumVersion 2.0.0
Anda juga dapat menggunakan parameter RequiredVersion untuk mengimpor versi modul tertentu, atau menggunakan parameter Modul dan Versi kata #Requires
kunci untuk memerlukan versi modul tertentu dalam skrip.
Contoh 11: Mengimpor menggunakan nama yang sepenuhnya memenuhi syarat
Contoh ini mengimpor versi modul tertentu menggunakan FullyQualifiedName.
PS> Get-Module -ListAvailable PowerShellGet | Select-Object Name, Version
Name Version
---- -------
PowerShellGet 2.2.1
PowerShellGet 2.1.3
PowerShellGet 2.1.2
PowerShellGet 1.0.0.1
PS> Import-Module -FullyQualifiedName @{ModuleName = 'PowerShellGet'; ModuleVersion = '2.1.3' }
Contoh 12: Mengimpor menggunakan jalur yang sepenuhnya memenuhi syarat
Contoh ini mengimpor versi modul tertentu menggunakan jalur yang sepenuhnya memenuhi syarat.
PS> Get-Module -ListAvailable PowerShellGet | Select-Object Path
Path
----
C:\Program Files\PowerShell\Modules\PowerShellGet\2.2.1\PowerShellGet.psd1
C:\program files\powershell\6\Modules\PowerShellGet\PowerShellGet.psd1
C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\2.1.2\PowerShellGet.psd1
C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\1.0.0.1\PowerShellGet.psd1
PS> Import-Module -Name 'C:\Program Files\PowerShell\Modules\PowerShellGet\2.2.1\PowerShellGet.psd1'
Contoh 13: Mengimpor modul dari komputer jarak jauh
Contoh ini menunjukkan cara menggunakan Import-Module
cmdlet untuk mengimpor modul dari komputer jarak jauh.
Perintah ini menggunakan fitur Implisit Remoting PowerShell.
Saat mengimpor modul dari sesi lain, Anda dapat menggunakan cmdlet dalam sesi saat ini. Namun, perintah yang menggunakan cmdlet berjalan di sesi jarak jauh.
$s = New-PSSession -ComputerName Server01
Get-Module -PSSession $s -ListAvailable -Name NetSecurity
ModuleType Name ExportedCommands
---------- ---- ----------------
Manifest NetSecurity {New-NetIPsecAuthProposal, New-NetIPsecMainModeCryptoProposal, New-Ne...
Import-Module -PSSession $s -Name NetSecurity
Get-Command -Module NetSecurity -Name Get-*Firewall*
CommandType Name ModuleName
----------- ---- ----------
Function Get-NetFirewallAddressFilter NetSecurity
Function Get-NetFirewallApplicationFilter NetSecurity
Function Get-NetFirewallInterfaceFilter NetSecurity
Function Get-NetFirewallInterfaceTypeFilter NetSecurity
Function Get-NetFirewallPortFilter NetSecurity
Function Get-NetFirewallProfile NetSecurity
Function Get-NetFirewallRule NetSecurity
Function Get-NetFirewallSecurityFilter NetSecurity
Function Get-NetFirewallServiceFilter NetSecurity
Function Get-NetFirewallSetting NetSecurity
Get-NetFirewallRule -DisplayName "Windows Remote Management*" |
Format-Table -Property DisplayName, Name -AutoSize
DisplayName Name
----------- ----
Windows Remote Management (HTTP-In) WINRM-HTTP-In-TCP
Windows Remote Management (HTTP-In) WINRM-HTTP-In-TCP-PUBLIC
Windows Remote Management - Compatibility Mode (HTTP-In) WINRM-HTTP-Compat-In-TCP
New-PSSession
membuat sesi jarak jauh (PSSession) ke Server01
komputer. PSSession disimpan dalam $s
variabel .
Berjalan Get-Module
dengan parameter PSSession menunjukkan bahwa modul NetSecurity diinstal dan tersedia di komputer jarak jauh. Perintah ini setara dengan menggunakan Invoke-Command
cmdlet untuk menjalankan Get-Module
perintah dalam sesi jarak jauh. Contohnya:
Invoke-Command $s {Get-Module -ListAvailable -Name NetSecurity
Berjalan Import-Module
dengan parameter PSSession mengimpor modul NetSecurity dari komputer jarak jauh ke sesi saat ini. Get-Command
Cmdlet mengambil perintah yang dimulai dengan Get
dan disertakan Firewall
dari modul NetSecurity. Output mengonfirmasi bahwa modul dan cmdletnya diimpor ke sesi saat ini.
Selanjutnya, Get-NetFirewallRule
cmdlet mendapatkan Windows Remote Management aturan firewall di Server01
komputer. Ini setara dengan menggunakan Invoke-Command
cmdlet untuk berjalan Get-NetFirewallRule
pada sesi jarak jauh.
Contoh 14: Mengelola penyimpanan di komputer jarak jauh tanpa sistem operasi Windows
Dalam contoh ini, administrator komputer telah menginstal penyedia Module Discovery WMI, yang memungkinkan Anda menggunakan perintah CIM yang dirancang untuk penyedia.
New-CimSession
Cmdlet membuat sesi di komputer jarak jauh bernama RSDGF03. Sesi tersambung ke layanan WMI pada komputer jarak jauh. Sesi CIM disimpan dalam $cs
variabel.
Import-Module
menggunakan CimSession di $cs
untuk mengimpor modul CIM Penyimpanan dari RSDGF03
komputer.
Get-Command
Cmdlet menunjukkan Get-Disk
perintah dalam modul Penyimpanan. Saat Anda mengimpor modul CIM ke sesi lokal, PowerShell mengonversi file CDXML untuk setiap perintah menjadi skrip PowerShell, yang muncul sebagai fungsi dalam sesi lokal.
Meskipun Get-Disk
ditik dalam sesi lokal, cmdlet secara implisit berjalan pada komputer jarak jauh tempat cmdlet diimpor. Perintah mengembalikan objek dari komputer jarak jauh ke sesi lokal.
$cs = New-CimSession -ComputerName RSDGF03
Import-Module -CimSession $cs -Name Storage
# Importing a CIM module, converts the CDXML files for each command into
# PowerShell scripts. These appear as functions in the local session.
Get-Command Get-Disk
CommandType Name ModuleName
----------- ---- ----------
Function Get-Disk Storage
# Use implicit remoting to query disks on the remote computer from which the
# module was imported.
Get-Disk
Number Friendly Name OperationalStatus Total Size Partition Style
------ ------------- ----------------- ---------- ---------------
0 Virtual HD ATA Device Online 40 GB MBR
Parameter
-Alias
Menentukan alias yang diimpor cmdlet ini dari modul ke sesi saat ini. Masukkan daftar alias yang dipisahkan koma. Karakter kartubebas diizinkan.
Beberapa modul secara otomatis mengekspor alias yang dipilih ke sesi Anda saat Anda mengimpor modul. Parameter ini memungkinkan Anda memilih dari antara alias yang diekspor.
Jenis: | String[] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | True |
-ArgumentList
Menentukan array argumen, atau nilai parameter, yang diteruskan ke modul skrip selama Import-Module
perintah. Parameter ini hanya valid saat Anda mengimpor modul skrip.
Anda juga dapat merujuk ke parameter ArgumentList berdasarkan aliasnya, args. Untuk informasi selengkapnya tentang perilaku ArgumentList, lihat about_Splatting.
Jenis: | Object[] |
Alias: | Args |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-AsCustomObject
Menunjukkan bahwa cmdlet ini mengembalikan objek kustom dengan anggota yang mewakili anggota modul yang diimpor. Parameter ini hanya valid untuk modul skrip.
Saat Anda menggunakan parameter AsCustomObject , Import-Module
mengimpor anggota modul ke dalam sesi lalu mengembalikan objek PSCustomObject alih-alih objek PSModuleInfo . Anda dapat menyimpan objek kustom dalam variabel dan menggunakan enumerasi akses anggota untuk memanggil anggota.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Assembly
Menentukan array objek rakitan. Cmdlet ini mengimpor cmdlet dan penyedia yang diimplementasikan dalam objek rakitan yang ditentukan. Masukkan variabel yang berisi objek rakitan atau perintah yang membuat objek rakitan. Anda juga dapat menyalurkan objek rakitan ke Import-Module
.
Saat Anda menggunakan parameter ini, hanya cmdlet dan penyedia yang diimplementasikan oleh rakitan yang ditentukan yang diimpor. Jika modul berisi file lain, file tersebut tidak diimpor, dan Anda mungkin kehilangan anggota penting modul. Gunakan parameter ini untuk menelusuri kesalahan dan menguji modul, atau saat Anda diinstruksikan untuk menggunakannya oleh penulis modul.
Jenis: | Assembly[] |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-CimNamespace
Menentukan namespace penyedia CIM alternatif yang mengekspos modul CIM. Nilai default adalah namespace penyedia Module Discovery WMI.
Gunakan parameter ini untuk mengimpor modul CIM dari komputer dan perangkat yang tidak menjalankan sistem operasi Windows.
Parameter ini diperkenalkan di Windows PowerShell 3.0.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-CimResourceUri
Menentukan lokasi alternatif untuk modul CIM. Nilai default adalah URI sumber daya penyedia Module Discovery WMI di komputer jarak jauh.
Gunakan parameter ini untuk mengimpor modul CIM dari komputer dan perangkat yang tidak menjalankan sistem operasi Windows.
Parameter ini diperkenalkan di Windows PowerShell 3.0.
Jenis: | Uri |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-CimSession
Menentukan sesi CIM pada komputer jarak jauh. Masukkan variabel yang berisi sesi CIM atau perintah yang mendapatkan sesi CIM, seperti perintah Get-CimSession .
Import-Module
menggunakan koneksi sesi CIM untuk mengimpor modul dari komputer jarak jauh ke sesi saat ini. Saat Anda menggunakan perintah dari modul yang diimpor dalam sesi saat ini, perintah berjalan di komputer jarak jauh.
Anda dapat menggunakan parameter ini untuk mengimpor modul dari komputer dan perangkat yang tidak menjalankan sistem operasi Windows, dan komputer Windows yang memiliki PowerShell, tetapi tidak mengaktifkan jarak jauh PowerShell.
Parameter ini diperkenalkan di Windows PowerShell 3.0.
Jenis: | CimSession |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Cmdlet
Menentukan array cmdlet yang diimpor cmdlet ini dari modul ke dalam sesi saat ini. Karakter kartubebas diizinkan.
Beberapa modul secara otomatis mengekspor cmdlet yang dipilih ke sesi Anda saat Anda mengimpor modul. Parameter ini memungkinkan Anda memilih dari antara cmdlet yang diekspor.
Jenis: | String[] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | True |
-DisableNameChecking
Menunjukkan bahwa cmdlet ini menekan pesan yang memperingatkan Anda ketika Anda mengimpor cmdlet atau fungsi yang namanya menyertakan kata kerja yang tidak disetujui atau karakter yang dilarang.
Secara default, ketika modul yang Anda impor mengekspor cmdlet atau fungsi yang memiliki kata kerja yang tidak disetujui dalam namanya, PowerShell menampilkan pesan peringatan berikut:
PERINGATAN: Beberapa nama perintah yang diimpor mencakup kata kerja yang tidak disetujui yang mungkin membuatnya kurang dapat ditemukan. Gunakan parameter Verbose untuk detail selengkapnya atau ketik Get-Verb untuk melihat daftar kata kerja yang disetujui.
Pesan ini hanyalah peringatan. Modul lengkap masih diimpor, termasuk perintah yang tidak sesuai. Meskipun pesan ditampilkan kepada pengguna modul, masalah penamaan harus diperbaiki oleh penulis modul.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Force
Parameter ini menyebabkan modul dimuat, atau dimuat ulang, di atas modul saat ini. Beberapa modul memuat rakitan eksternal. Impor gagal jika Anda mengimpor modul yang memuat versi rakitan yang lebih baru. Parameter Force tidak dapat mengambil alih kesalahan. Anda harus memulai sesi baru untuk memuat versi baru.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-FullyQualifiedName
Nilainya dapat berupa nama modul, spesifikasi modul lengkap, atau jalur ke file modul.
Ketika nilai adalah jalur, jalur dapat sepenuhnya memenuhi syarat atau relatif. Jalur relatif diselesaikan relatif terhadap skrip yang berisi pernyataan penggunaan.
Saat nilainya adalah spesifikasi nama atau modul, PowerShell mencari PSModulePath untuk modul yang ditentukan.
Spesifikasi modul adalah hashtable yang memiliki kunci berikut.
ModuleName
- Diperlukan Menentukan nama modul.GUID
- Opsional Menentukan GUID modul.- Diperlukan juga untuk menentukan setidaknya salah satu dari tiga kunci di bawah ini.
ModuleVersion
- Menentukan versi minimum modul yang dapat diterima.MaximumVersion
- Menentukan versi maksimum modul yang dapat diterima.RequiredVersion
- Menentukan versi modul yang tepat dan diperlukan. Ini tidak dapat digunakan dengan kunci Versi lainnya.
Jenis: | ModuleSpecification[] |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Function
Menentukan array fungsi yang diimpor cmdlet ini dari modul ke sesi saat ini. Karakter kartubebas diizinkan. Beberapa modul secara otomatis mengekspor fungsi yang dipilih ke sesi Anda saat Anda mengimpor modul. Parameter ini memungkinkan Anda memilih dari antara fungsi yang diekspor.
Jenis: | String[] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | True |
-Global
Menunjukkan bahwa cmdlet ini mengimpor modul ke status sesi global sehingga tersedia untuk semua perintah dalam sesi.
Secara default, ketika Import-Module
cmdlet dipanggil dari prompt perintah, file skrip, atau blok skrip, semua perintah diimpor ke dalam status sesi global.
Saat dipanggil dari modul lain, Import-Module
cmdlet mengimpor perintah dalam modul, termasuk perintah dari modul berlapis, ke dalam status sesi modul panggilan.
Tip
Anda harus menghindari panggilan Import-Module
dari dalam modul. Sebagai gantinya, nyatakan modul target sebagai modul berlapis dalam manifes modul induk. Mendeklarasikan modul berlapis meningkatkan kemampuan penemuan dependensi.
Parameter Global setara dengan parameter Cakupan dengan nilai Global.
Untuk membatasi perintah yang diekspor modul, gunakan Export-ModuleMember
perintah dalam modul skrip.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-MaximumVersion
Menentukan versi maksimum. Cmdlet ini hanya mengimpor versi modul yang kurang dari atau sama dengan nilai yang ditentukan. Jika tidak ada versi yang memenuhi syarat, Import-Module
mengembalikan kesalahan.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-MinimumVersion
Menentukan versi minimum. Cmdlet ini hanya mengimpor versi modul yang lebih besar dari atau sama dengan nilai yang ditentukan. Gunakan nama parameter MinimumVersion atau aliasnya, Versi. Jika tidak ada versi yang memenuhi syarat, Import-Module
menghasilkan kesalahan.
Untuk menentukan versi yang tepat, gunakan parameter RequiredVersion . Anda juga dapat menggunakan parameter Modul dan Versi dari kata kunci #Requires untuk memerlukan versi modul tertentu dalam skrip.
Parameter ini diperkenalkan di Windows PowerShell 3.0.
Jenis: | Version |
Alias: | Version |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ModuleInfo
Menentukan array objek modul yang akan diimpor. Masukkan variabel yang berisi objek modul, atau perintah yang mendapatkan objek modul, seperti perintah berikut: Get-Module -ListAvailable
. Anda juga dapat menyalurkan objek modul ke Import-Module
.
Jenis: | PSModuleInfo[] |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Name
Menentukan nama modul yang akan diimpor. Masukkan nama modul atau nama file dalam modul, seperti .psd1
file , , .psm1
.dll
, atau .ps1
. Jalur file bersifat opsional. Karakter kartubebas tidak diizinkan. Anda juga dapat menyalurkan nama modul dan nama file ke Import-Module
.
Jika Anda menghilangkan jalur, Import-Module
cari modul di jalur yang disimpan dalam $env:PSModulePath
variabel lingkungan.
Tentukan hanya nama modul jika memungkinkan. Saat Anda menentukan nama file, hanya anggota yang diimplementasikan dalam file tersebut yang diimpor. Jika modul berisi file lain, file tersebut tidak diimpor, dan Anda mungkin kehilangan anggota penting modul.
Catatan
Meskipun dimungkinkan untuk mengimpor file skrip (.ps1
) sebagai modul, file skrip biasanya tidak terstruktur seperti file modul skrip (.psm1
). Mengimpor file skrip tidak menjamin bahwa file tersebut dapat digunakan sebagai modul. Untuk informasi selengkapnya, lihat about_Modules.
Jenis: | String[] |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | True |
-NoClobber
Mencegah impor perintah yang memiliki nama yang sama dengan perintah yang ada dalam sesi saat ini. Secara default, Import-Module
mengimpor semua perintah modul yang diekspor.
Perintah yang memiliki nama yang sama dapat menyembunyikan atau mengganti perintah dalam sesi. Untuk menghindari konflik nama perintah dalam sesi, gunakan parameter Awalan atau NoClobber . Untuk informasi selengkapnya tentang konflik nama dan prioritas perintah, lihat "Modul dan Konflik Nama" di about_Modules dan about_Command_Precedence.
Parameter ini diperkenalkan di Windows PowerShell 3.0.
Jenis: | SwitchParameter |
Alias: | NoOverwrite |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-PassThru
Mengembalikan objek yang mewakili modul yang diimpor. Secara default, cmdlet ini tidak menghasilkan output apa pun.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Prefix
Menentukan awalan yang ditambahkan cmdlet ini ke kata benda dalam nama anggota modul yang diimpor.
Gunakan parameter ini untuk menghindari konflik nama yang mungkin terjadi ketika anggota yang berbeda dalam sesi memiliki nama yang sama. Parameter ini tidak mengubah modul, dan tidak memengaruhi file yang diimpor modul untuk penggunaannya sendiri. Ini dikenal sebagai modul berlapis. Cmdlet ini hanya memengaruhi nama anggota dalam sesi saat ini.
Misalnya, jika Anda menentukan awalan UTC dan kemudian mengimpor Get-Date
cmdlet, cmdlet dikenal dalam sesi sebagai Get-UTCDate
, dan tidak bingung dengan cmdlet asli Get-Date
.
Nilai parameter ini lebih diutamakan daripada properti DefaultCommandPrefix modul, yang menentukan awalan default.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-PSSession
Menentukan sesi yang dikelola pengguna PowerShell (PSSession) tempat cmdlet ini mengimpor modul ke sesi saat ini. Masukkan variabel yang berisi PSSession atau perintah yang mendapatkan PSSession, seperti Get-PSSession
perintah.
Saat mengimpor modul dari sesi yang berbeda ke sesi saat ini, Anda dapat menggunakan cmdlet dari modul dalam sesi saat ini, sama seperti Anda akan menggunakan cmdlet dari modul lokal. Perintah yang menggunakan cmdlet jarak jauh berjalan di sesi jarak jauh, tetapi detail jarak jauh dikelola di latar belakang oleh PowerShell.
Parameter ini menggunakan fitur Implisit Remoting PowerShell. Setara dengan menggunakan Import-PSSession
cmdlet untuk mengimpor modul tertentu dari sesi.
Import-Module
tidak dapat mengimpor modul PowerShell inti dari sesi lain. Modul PowerShell inti memiliki nama yang dimulai dengan Microsoft.PowerShell.
Parameter ini diperkenalkan di Windows PowerShell 3.0.
Jenis: | PSSession |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-RequiredVersion
Menentukan versi modul yang diimpor cmdlet ini. Jika versi tidak diinstal, Import-Module
menghasilkan kesalahan.
Secara default, Import-Module
mengimpor modul tanpa memeriksa nomor versi.
Untuk menentukan versi minimum, gunakan parameter MinimumVersion . Anda juga dapat menggunakan parameter Modul dan Versi dari kata kunci #Requires untuk memerlukan versi modul tertentu dalam skrip.
Parameter ini diperkenalkan di Windows PowerShell 3.0.
Skrip yang menggunakan RequiredVersion untuk mengimpor modul yang disertakan dengan rilis sistem operasi Windows yang ada tidak berjalan secara otomatis dalam rilis sistem operasi Windows di masa mendatang. Ini karena nomor versi modul PowerShell dalam rilis sistem operasi Windows di masa mendatang lebih tinggi dari nomor versi modul dalam rilis sistem operasi Windows yang ada.
Jenis: | Version |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Scope
Menentukan cakupan untuk mengimpor modul.
Nilai yang dapat diterima untuk parameter ini adalah:
- Global. Tersedia untuk semua perintah dalam sesi. Setara dengan parameter Global .
- Lokal. Hanya tersedia dalam cakupan saat ini.
Secara default, ketika Import-Module
cmdlet dipanggil dari prompt perintah, file skrip, atau blok skrip, semua perintah diimpor ke dalam status sesi global. Anda dapat menggunakan -Scope Local
parameter untuk mengimpor konten modul ke dalam cakupan skrip atau blok skrip.
Saat dipanggil dari modul lain, Import-Module
cmdlet mengimpor perintah dalam modul, termasuk perintah dari modul berlapis, ke dalam status sesi pemanggil. -Scope Global
Menentukan atau -Global
menunjukkan bahwa cmdlet ini mengimpor modul ke dalam status sesi global sehingga tersedia untuk semua perintah dalam sesi.
Parameter Global setara dengan parameter Cakupan dengan nilai Global.
Parameter ini diperkenalkan di Windows PowerShell 3.0.
Jenis: | String |
Nilai yang diterima: | Local, Global |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-SkipEditionCheck
Lewati pemeriksaan di lapangan CompatiblePSEditions
.
Memungkinkan pemuatan modul dari "$($env:windir)\System32\WindowsPowerShell\v1.0\Modules"
direktori modul ke PowerShell Core saat modul tersebut CompatiblePSEditions
tidak ditentukan Core
di bidang manifes.
Saat mengimpor modul dari jalur lain, sakelar ini tidak melakukan apa pun, karena pemeriksaan tidak dilakukan. Di Linux dan macOS, sakelar ini tidak melakukan apa-apa.
Untuk informasi selengkapnya, lihat about_PowerShell_Editions.
Peringatan
Import-Module -SkipEditionCheck
masih cenderung gagal mengimpor modul. Bahkan jika berhasil, memanggil perintah dari modul nantinya mungkin gagal ketika mencoba menggunakan API yang tidak kompatibel.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-UseWindowsPowerShell
Memuat modul menggunakan fungsionalitas Kompatibilitas Windows PowerShell. Lihat about_Windows_PowerShell_Compatibility untuk informasi selengkapnya.
Jenis: | SwitchParameter |
Alias: | UseWinPS |
Position: | Named |
Nilai default: | False |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Variable
Menentukan array variabel yang diimpor cmdlet ini dari modul ke dalam sesi saat ini. Masukkan daftar variabel. Karakter kartubebas diizinkan.
Beberapa modul secara otomatis mengekspor variabel yang dipilih ke sesi Anda saat Anda mengimpor modul. Parameter ini memungkinkan Anda memilih dari antara variabel yang diekspor.
Jenis: | String[] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | True |
Input
Anda dapat menyalurkan nama modul ke cmdlet ini.
Anda dapat menyalurkan objek modul ke cmdlet ini.
Anda dapat menyalurkan objek rakitan ke cmdlet ini.
Output
None
Secara default, cmdlet ini tidak mengembalikan output.
Jika Anda menentukan parameter PassThru , cmdlet menghasilkan objek System.Management.Automation.PSModuleInfo yang mewakili modul yang diimpor.
Jika Anda menentukan parameter AsCustomObject dan PassThru bersama-sama, cmdlet menghasilkan objek PSCustomObject yang mewakili modul.
Catatan
PowerShell menyertakan alias berikut untuk Import-Module
:
Semua platform:
ipmo
Sebelum Anda dapat mengimpor modul, modul harus dapat diakses oleh komputer lokal Anda dan disertakan dalam
PSModulePath
variabel lingkungan. Untuk informasi selengkapnya, lihat about_Modules.Anda juga dapat menggunakan parameter PSSession dan CIMSession untuk mengimpor modul yang diinstal pada komputer jarak jauh. Namun, perintah yang menggunakan cmdlet dalam modul ini berjalan dalam sesi jarak jauh di komputer jarak jauh.
Jika Anda mengimpor anggota dengan nama yang sama dan jenis yang sama ke dalam sesi Anda, PowerShell menggunakan anggota yang diimpor terakhir secara default. Variabel dan alias diganti, dan aslinya tidak dapat diakses. Fungsi, cmdlet, dan penyedia hanya di bayangi oleh anggota baru. Mereka dapat diakses dengan memenuhi syarat nama perintah dengan nama snap-in, modul, atau jalur fungsinya.
Untuk memperbarui data pemformatan untuk perintah yang diimpor dari modul, gunakan
Update-FormatData
cmdlet . Jika file pemformatan untuk modul berubah, gunakanUpdate-FormatData
cmdlet untuk memperbarui data pemformatan untuk perintah yang diimpor. Anda tidak perlu mengimpor modul lagi.Dimulai di Windows PowerShell 3.0, perintah inti yang diinstal dengan PowerShell dimas dalam modul. Di Windows PowerShell 2.0, dan dalam program host yang membuat sesi gaya lama di versi PowerShell yang lebih baru, perintah inti dimas dalam snap-in (PSSnapins). Pengecualiannya adalah Microsoft.PowerShell.Core, yang selalu merupakan snap-in. Selain itu, sesi jarak jauh, seperti yang dimulai oleh
New-PSSession
cmdlet, adalah sesi gaya lama yang menyertakan snap-in inti.Untuk informasi tentang metode CreateDefault2 yang membuat sesi gaya yang lebih baru dengan modul inti, lihat Metode CreateDefault2.
Di Windows PowerShell 2.0, beberapa nilai properti objek modul, seperti nilai properti ExportedCmdlets dan NestedModules , tidak diisi hingga modul diimpor.
Jika Anda mencoba mengimpor modul yang berisi rakitan mode campuran yang tidak kompatibel dengan Windows PowerShell 3.0+,
Import-Module
mengembalikan pesan kesalahan seperti yang berikut ini.Import-Module : Rakitan mode campuran dibuat berdasarkan versi 'v2.0.50727' runtime dan tidak dapat dimuat dalam runtime 4.0 tanpa informasi konfigurasi tambahan.
Kesalahan ini terjadi ketika modul yang dirancang untuk Windows PowerShell 2.0 berisi setidaknya satu rakitan modul campuran. Rakitan modul campuran yang mencakup kode terkelola dan tidak terkelola, seperti C++ dan C#.
Untuk mengimpor modul yang berisi rakitan mode campuran, mulai Windows PowerShell 2.0 dengan menggunakan perintah berikut, lalu coba perintah lagi
Import-Module
.PowerShell.exe -Version 2.0
Untuk menggunakan fitur sesi CIM, komputer jarak jauh harus memiliki jarak jauh WS-Management dan Windows Management Instrumentation (WMI), yang merupakan implementasi Microsoft dari standar Common Information Model (CIM). Komputer juga harus memiliki penyedia Module Discovery WMI atau penyedia CIM alternatif yang memiliki fitur dasar yang sama.
Anda dapat menggunakan fitur sesi CIM di komputer yang tidak menjalankan sistem operasi Windows dan di komputer Windows yang memiliki PowerShell, tetapi tidak mengaktifkan jarak jauh PowerShell.
Anda juga dapat menggunakan parameter CIM untuk mendapatkan modul CIM dari komputer yang mengaktifkan jarak jauh PowerShell, termasuk komputer lokal. Saat Anda membuat sesi CIM di komputer lokal, PowerShell menggunakan DCOM, bukan WMI, untuk membuat sesi.
Secara default,
Import-Module
mengimpor modul dalam cakupan global bahkan ketika dipanggil dari cakupan turunan. Cakupan tingkat atas dan semua cakupan turunan memiliki akses ke elemen modul yang diekspor.Dalam cakupan turunan,
-Scope Local
membatasi impor ke cakupan tersebut dan semua cakupan turunannya. Cakupan induk kemudian tidak melihat anggota yang diimpor.Catatan
Get-Module
menunjukkan semua modul yang dimuat dalam sesi saat ini. Ini termasuk modul yang dimuat secara lokal dalam cakupan turunan. GunakanGet-Command -Module modulename
untuk melihat anggota mana yang dimuat dalam cakupan saat ini.Import-Module
tidak memuat definisi kelas dan enumerasi dalam modul.using module
Gunakan pernyataan di awal skrip Anda. Ini mengimpor modul, termasuk definisi kelas dan enumerasi. Untuk informasi selengkapnya, lihat about_Using.Selama pengembangan modul skrip, umumnya untuk membuat perubahan pada kode lalu memuat versi baru modul menggunakan
Import-Module
dengan parameter Force . Ini hanya berfungsi untuk perubahan pada fungsi dalam modul akar.Import-Module
tidak memuat ulang modul berlapis apa pun. Selain itu, tidak ada cara untuk memuat kelas atau enumerasi yang diperbarui.Untuk mendapatkan anggota modul yang diperbarui yang ditentukan dalam modul berlapis, hapus modul dengan
Remove-Module
, lalu impor modul lagi.Jika modul dimuat dengan
using
pernyataan, Anda harus memulai sesi baru untuk mengimpor definisi yang diperbarui untuk kelas dan enumerasi. Kelas dan enumerasi yang ditentukan di PowerShell dan diimpor denganusing
pernyataan tidak dapat dibongkar.