Import-Module

Sözdizimi

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>]

Description

Import-Module Cmdlet geçerli oturuma bir veya daha fazla modül ekler. PowerShell 3.0'dan başlayarak, modülde herhangi bir komut veya sağlayıcı kullandığınızda yüklü modüller otomatik olarak oturuma aktarılır. Ancak, modülü içeri aktarmak için komutunu kullanmaya Import-Module devam edebilirsiniz. Tercih değişkenini kullanarak otomatik modül içeri aktarmayı $PSModuleAutoloadingPreference devre dışı bırakabilirsiniz. Değişken hakkında $PSModuleAutoloadingPreference daha fazla bilgi için bkz . about_Preference_Variables.

Modül, PowerShell'de kullanılabilecek üyeleri içeren bir pakettir. Üyeler cmdlet'leri, sağlayıcıları, betikleri, işlevleri, değişkenleri ve diğer araçları ve dosyaları içerir. Bir modül içeri aktarıldıktan sonra, oturumunuzda modül üyelerini kullanabilirsiniz. Modüller hakkında daha fazla bilgi için bkz . about_Modules.

Varsayılan olarak, Import-Module modülün dışarı aktardığı tüm üyeleri içeri aktarır, ancak hangi üyelerin içeri aktarılacağını kısıtlamak için Diğer Ad, İşlev, Cmdlet ve Değişken parametrelerini kullanabilirsiniz. NoClobber parametresi, geçerli oturumdaki üyelerle aynı adlara sahip üyeleri içeri aktarmayı engellerImport-Module.

Import-Module bir modülü yalnızca geçerli oturuma aktarır. Modülü her yeni oturuma aktarmak için PowerShell profilinize bir Import-Module komut ekleyin. Profiller hakkında daha fazla bilgi için bkz . about_Profiles.

Uzak bilgisayarda bir PSSession oluşturarak PowerShell uzaktan iletişiminin etkinleştirildiği uzak Windows bilgisayarlarını yönetebilirsiniz. Ardından uzak bilgisayarda yüklü modülleri içeri aktarmak için PSSession parametresini Import-Module kullanın. Geçerli oturumda içeri aktarılan komutları kullandığınızda, komutlar uzak bilgisayarda örtük olarak çalıştırılır.

Windows PowerShell 3.0'dan başlayarak, Ortak Bilgi Modeli (CIM) modüllerini içeri aktarmak için kullanabilirsiniz Import-Module . CIM modülleri Cmdlet Tanım XML (CDXML) dosyalarında cmdlet'leri tanımlar. Bu özellik, C++ dilinde yazılanlar gibi, yönetilmeyen kod derlemelerinde uygulanan cmdlet'leri kullanmanıza olanak tanır.

Windows işletim sistemini çalıştırmayan bilgisayarlar da dahil olmak üzere PowerShell uzaktan iletişimini etkinleştirmemiş uzak bilgisayarlarda CIM modüllerini uzak bilgisayardan içeri aktarmak için CIMSession parametresini Import-Module kullanabilirsiniz. İçeri aktarılan komutlar uzak bilgisayarda örtük olarak çalışır. CIMSession, uzak bilgisayardaki Windows Yönetim Araçları'na (WMI) yönelik bir bağlantıdır.

Örnekler

Örnek 1: Modülün üyelerini geçerli oturuma aktarma

Bu örnek, PSDiagnostics modülünün üyelerini geçerli oturuma aktarır.

Import-Module -Name PSDiagnostics

Örnek 2: Modül yolu tarafından belirtilen tüm modülleri içeri aktarma

Bu örnek, ortam değişkeni tarafından $env:PSModulePath belirtilen yolda bulunan tüm kullanılabilir modülleri geçerli oturuma aktarır.

Get-Module -ListAvailable | Import-Module

Örnek 3: Birkaç modülün üyelerini geçerli oturuma aktarma

Bu örnek, PSDiagnostics ve Dism modüllerinin üyelerini geçerli oturuma aktarır.

$m = Get-Module -ListAvailable PSDiagnostics, Dism
Import-Module -ModuleInfo $m

cmdlet'i Get-Module PSDiagnostics ve Dism modüllerini alır ve nesneleri değişkene $m kaydeder. Henüz oturuma aktarılmayan modülleri alırken ListAvailable parametresi gereklidir.

ModuleInfo parametresiImport-Module, modülleri geçerli oturuma aktarmak için kullanılır.

Örnek 4: Bir yol tarafından belirtilen tüm modülleri içeri aktarma

Bu örnek, içeri aktaracak modülü tanımlamak için açık bir yol kullanır.

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'.

Ayrıntılı parametresinin kullanılması, modülü yüklerken ilerleme durumunu bildirmeye neden olurImport-Module. Verbose, PassThru veya AsCustomObject parametresi olmadan, Import-Module bir modülü içeri aktarırken herhangi bir çıkış oluşturmaz.

Örnek 5: Oturuma aktarılan modül üyelerini kısıtlama

Bu örnekte, hangi modül üyelerinin oturuma aktarılacağının nasıl kısıtlandığı ve bu komutun oturum üzerindeki etkisi gösterilmektedir. İşlev parametresi modülden içeri aktarılan üyeleri sınırlar. Bir modülün içeri aktarabileceği diğer üyeleri kısıtlamak için Diğer Ad, Değişken ve Cmdlet parametrelerini de kullanabilirsiniz.

cmdlet'i Get-Module PSDiagnostics modülünü temsil eden nesneyi alır. ExportedCmdlets özelliği, hepsi içeri aktarılmasa bile modülün dışarı aktardığı tüm cmdlet'leri listeler.

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

cmdlet'in Module parametresi kullanıldığında Get-Command PSDiagnostics modülünden içeri aktarılan komutlar gösterilir. Sonuçlar yalnızca Disable-PSTrace ve Enable-PSTrace cmdlet'lerinin içeri aktarıldığını onaylar.

Örnek 6: Modülün üyelerini içeri aktarma ve ön ek ekleme

Bu örnek, PSDiagnostics modülünü geçerli oturuma aktarır, üye adlarına bir ön ek ekler ve ardından ön ekli üye adlarını görüntüler. ön ek parametresi Import-Module , ön eki modülden içeri aktarılan tüm üyelere ekler x . Ön ek yalnızca geçerli oturumdaki üyeler için geçerlidir. Modülü değiştirmez. PassThru parametresi, içeri aktarılan modülü temsil eden bir modül nesnesi döndürür.

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 modülden içeri aktarılan üyeleri alır. Çıkış, modül üyelerinin doğru ön eke sahip olduğunu gösterir.

Örnek 7: Özel nesne alma ve kullanma

Bu örnekte tarafından Import-Moduledöndürülen özel nesnenin nasıl alınıp kullanılacağı gösterilmektedir.

Özel nesneler, içeri aktarılan modül üyelerinin her birini temsil eden yapay üyeler içerir. Örneğin, bir modüldeki cmdlet'ler ve işlevler özel nesnenin betik yöntemlerine dönüştürülür.

Özel nesneler betik oluşturmada kullanışlıdır. Ayrıca, içeri aktarılan birkaç nesne aynı adlara sahip olduğunda da kullanışlıdır. Bir nesnenin betik yöntemini kullanmak, modül adı da dahil olmak üzere içeri aktarılan bir üyenin tam adını belirtmekle eşdeğerdir.

AsCustomObject parametresi yalnızca bir betik modülü içeri aktarılırken kullanılabilir. Kullanılabilir modüllerden hangisinin betik modülü olduğunu belirlemek için kullanın Get-Module .

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"()

Betik Show-Calendar modülü, özel bir nesne istemek için AsCustomObject parametresi ve nesneyi döndürmek için PassThru parametresi kullanılarak içeri aktarılır. Sonuçta elde edilen özel nesne değişkene $a kaydedilir.

Değişkeni $a , kaydedilen nesnenin Get-Member özelliklerini ve yöntemlerini göstermek için cmdlet'ine kanalı oluşturulur. Çıktıda bir Show-Calendar betik yöntemi gösterilir.

Betik yöntemini çağırmak Show-Calendar için, yöntem adı kısa çizgi içerdiğinden tırnak içine alınmalıdır.

Örnek 8: Bir modülü aynı oturuma yeniden aktarma

Bu örnekte, bir modülü aynı oturuma yeniden aktarırken force parametresinin Import-Module nasıl kullanılacağı gösterilmektedir. Force parametresi yüklenen modülü kaldırır ve yeniden içeri aktarır.

Import-Module PSDiagnostics
Import-Module PSDiagnostics -Force -Prefix PS

İlk komut PSDiagnostics modülünü içeri aktarır. İkinci komut bu kez Prefix parametresini kullanarak modülü yeniden içeri aktarır.

Force parametresi olmadan oturumda her PSDiagnostics cmdlet'inin biri standart ada, diğeri ön ekli ada sahip olmak üzere iki kopyası yer alır.

Örnek 9: İçeri aktarılan komutlar tarafından gizlenmiş komutları çalıştırma

Bu örnekte, içeri aktarılan komutlar tarafından gizlenen komutların nasıl çalıştırıldığı gösterilmektedir. TestModule modülü, yıl ve yılın gününü döndüren adlı Get-Date bir işlev içerir.

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

İlk Get-Date cmdlet geçerli tarihe sahip bir DateTime nesnesi döndürür. TestModule modülünü içeri aktardıktan sonra, Get-Date yılın yılını ve gününü döndürür.

öğesinin All parametresini Get-Command kullanarak oturumdaki Get-Date tüm komutları gösterin. Sonuçlar oturumda iki Get-Date komut olduğunu gösterir: TestModule modülünden bir işlev ve Microsoft.PowerShell.Utility modülünden bir cmdlet.

İşlevler cmdlet'lerden öncelikli olduğundan, Get-Date TestModule modülündeki işlev cmdlet yerine Get-Date çalışır. özgün sürümünü Get-Dateçalıştırmak için komut adını modül adıyla nitelemeniz gerekir.

PowerShell'de komut önceliği hakkında daha fazla bilgi için bkz . about_Command_Precedence.

Örnek 10: Modülün en düşük sürümünü içeri aktarma

Bu örnek PowerShellGet modülünü içeri aktarır. Modülün yalnızca sürümünü 2.0.0 veya üstünü içeri aktarmak için minimumversion parametresini Import-Module kullanır.

Import-Module -Name PowerShellGet -MinimumVersion 2.0.0

Ayrıca, bir modülün belirli bir sürümünü içeri aktarmak için RequiredVersion parametresini kullanabilir veya bir betikteki modülün belirli bir sürümünü istemek için anahtar sözcüğün Module ve Version parametrelerini #Requires kullanabilirsiniz.

Örnek 11: Tam ad kullanarak içeri aktarma

Bu örnek, FullyQualifiedName kullanarak modülün belirli bir sürümünü içeri aktarır.

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' }

Örnek 12: Tam yol kullanarak içeri aktarma

Bu örnek, tam yolu kullanarak modülün belirli bir sürümünü içeri aktarır.

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'

Örnek 13: Uzak bilgisayardan bir modülü içeri aktarma

Bu örnekte, uzak bir bilgisayardan bir modülü içeri aktarmak için cmdlet'in nasıl kullanılacağı Import-Module gösterilmektedir. Bu komut PowerShell'in Örtük Uzaktan İletişim özelliğini kullanır.

Modülleri başka bir oturumdan içeri aktardığınızda, geçerli oturumdaki cmdlet'leri kullanabilirsiniz. Ancak, cmdlet'lerini kullanan komutlar uzak oturumda çalışır.

$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 bilgisayara bir uzak oturum (PSSession) Server01 oluşturur. PSSession değişkenine $s kaydedilir.

PSSession parametresiyle çalıştırmakGet-Module, NetSecurity modülünün uzak bilgisayarda yüklü ve kullanılabilir olduğunu gösterir. Bu komut, uzak oturumda Invoke-Command komutu çalıştırmak Get-Module için cmdlet'ini kullanmaya eşdeğerdir. Örneğin:

Invoke-Command $s {Get-Module -ListAvailable -Name NetSecurity

PSSession parametresiyle çalıştırılırsa Import-Module NetSecurity modülü uzak bilgisayardan geçerli oturuma aktarılır. cmdlet ile Get-Command başlayan Get ve NetSecurity modülünden dahil Firewall edilen komutları alır. Çıkış, modülün ve cmdlet'lerinin geçerli oturuma aktarıldığını onaylar.

Get-NetFirewallRule Ardından, cmdlet bilgisayarda Windows Uzaktan Yönetim güvenlik duvarı kurallarını Server01 alır. Bu, uzak oturumda Invoke-Command çalıştırmak Get-NetFirewallRule için cmdlet'ini kullanmaya eşdeğerdir.

Örnek 14: Windows işletim sistemi olmadan uzak bir bilgisayarda depolamayı yönetme

Bu örnekte, bilgisayarın yöneticisi sağlayıcı için tasarlanmış CIM komutlarını kullanmanıza olanak tanıyan Modül Bulma WMI sağlayıcısını yüklemiştir.

Cmdlet, New-CimSession uzak bilgisayarda RSDGF03 adlı bir oturum oluşturur. Oturum, uzak bilgisayardaki WMI hizmetine bağlanır. CIM oturumu değişkene $cs kaydedilir. Import-Module, Depolama CIM modülünü bilgisayardan içeri aktarmak için içindeki $cs CimSession'ı RSDGF03 kullanır.

cmdlet'i Depolama modülündeki komutu gösterirGet-Disk. Get-Command Bir CIM modülünü yerel oturuma aktardığınızda, PowerShell her komut için CDXML dosyalarını yerel oturumda işlev olarak görünen PowerShell betiklerine dönüştürür.

Yerel oturumda yazılsa Get-Disk da, cmdlet örtük olarak içeri aktarıldığı uzak bilgisayarda çalışır. Komut, uzak bilgisayardan yerel oturuma nesneleri döndürür.

$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

Parametreler

-Alias

-ArgumentList

-AsCustomObject

-Assembly

-CimNamespace

-CimResourceUri

-CimSession

-Cmdlet

-DisableNameChecking

-Force

-FullyQualifiedName

-Function

-Global

-MaximumVersion

-MinimumVersion

-ModuleInfo

-Name

-NoClobber

-PassThru

-Prefix

-PSSession

-RequiredVersion

-Scope

-SkipEditionCheck

-UseWindowsPowerShell

-Variable

Girişler

String

Modül adını bu cmdlet'e aktarabilirsiniz.

PSModuleInfo

Bir modül nesnesini bu cmdlet'e aktarabilirsiniz.

Assembly

Bir derleme nesnesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

PSModuleInfo

PassThru parametresini belirtirseniz, cmdlet içeri aktarılan modülü temsil eden bir System.Management.Automation.PSModuleInfo nesnesi oluşturur.

PSCustomObject

AsCustomObject ve PassThru parametrelerini birlikte belirtirseniz, cmdlet modülü temsil eden bir PSCustomObject nesnesi oluşturur.

Notlar

PowerShell için aşağıdaki diğer adları Import-Moduleiçerir:

• Tüm platformlar:

  • ipmo

• Modülü içeri aktarabilmeniz için önce modülün yerel bilgisayarınız tarafından erişilebilir olması ve ortam değişkenine PSModulePath dahil edilmesi gerekir. Daha fazla bilgi için bkz . about_Modules.

  Uzak bilgisayarlarda yüklü modülleri içeri aktarmak için PSSession ve CIMSession parametrelerini de kullanabilirsiniz. Ancak, bu modüllerdeki cmdlet'leri kullanan komutlar uzak bilgisayardaki uzak oturumda çalıştırılır.

• Oturumunuza aynı ada ve aynı türe sahip üyeleri içeri aktarırsanız, PowerShell varsayılan olarak en son içeri aktarılan üyeyi kullanır. Değişkenler ve diğer adlar değiştirilir ve özgün öğelere erişilemez. İşlevler, cmdlet'ler ve sağlayıcılar yalnızca yeni üyeler tarafından gölgelenir. Bunlara, komut adı ek bileşeni, modül veya işlev yolu adıyla nitelenerek erişilebilir.

• Bir modülden içeri aktarılan komutların biçimlendirme verilerini güncelleştirmek için cmdlet'ini Update-FormatData kullanın. Bir modülün biçimlendirme dosyası değişirse, içeri aktarılan komutların Update-FormatData biçimlendirme verilerini güncelleştirmek için cmdlet'ini kullanın. Modülü yeniden içeri aktarmanız gerekmez.

• Windows PowerShell 3.0'dan başlayarak, PowerShell ile yüklenen temel komutlar modüller halinde paketlenir. Windows PowerShell 2.0'da ve PowerShell'in sonraki sürümlerinde eski stilde oturumlar oluşturan konak programlarında, temel komutlar ek bileşenlerde (PSSnapins) paketlenir. Özel durum, her zaman ek bileşen olan Microsoft.PowerShell.Core'dur. Ayrıca, cmdlet tarafından New-PSSession başlatılanlar gibi uzak oturumlar, çekirdek ek bileşenleri içeren eski stildeki oturumlardır.

  Çekirdek modüllerle daha yeni stil oturumları oluşturan CreateDefault2 yöntemi hakkında bilgi için bkz. CreateDefault2 Yöntemi.

• Windows PowerShell 2.0'da, modül nesnesinin ExportedCmdlets ve NestedModules özellik değerleri gibi bazı özellik değerleri modül içeri aktarılana kadar doldurulmadı.

• Windows PowerShell 3.0+ ile uyumlu olmayan karma mod derlemeleri içeren bir modülü içeri aktarmaya çalışırsanız, Import-Module aşağıdakine benzer bir hata iletisi döndürür.

  İçeri Aktarma Modülü: Karma mod derlemesi, çalışma zamanının 'v2.0.50727' sürümüne göre oluşturulur ve ek yapılandırma bilgileri olmadan 4.0 çalışma zamanına yüklenemez.

  Bu hata, Windows PowerShell 2.0 için tasarlanmış bir modül en az bir karma modül derlemesi içerdiğinde oluşur. C++ ve C# gibi hem yönetilen hem de yönetilmeyen kodu içeren karma modül derlemesi.

  Karma mod derlemeleri içeren bir modülü içeri aktarmak için aşağıdaki komutu kullanarak Windows PowerShell 2.0'ı başlatın ve komutu yeniden deneyin Import-Module .

  PowerShell.exe -Version 2.0

• CIM oturum özelliğini kullanmak için, uzak bilgisayarda Ortak Bilgi Modeli (CIM) standardının Microsoft uygulaması olan WS-Management uzaktan iletişim ve Windows Yönetim Araçları (WMI) olmalıdır. Bilgisayarda ayrıca Modül Bulma WMI sağlayıcısı veya aynı temel özelliklere sahip alternatif bir CIM sağlayıcısı olmalıdır.

  CIM oturum özelliğini Windows işletim sistemi çalıştırmayan bilgisayarlarda ve PowerShell'i olan ancak PowerShell uzaktan iletişiminin etkin olmadığı Windows bilgisayarlarda kullanabilirsiniz.

  CiM parametrelerini, yerel bilgisayar da dahil olmak üzere PowerShell uzaktan iletişiminin etkinleştirildiği bilgisayarlardan CIM modüllerini almak için de kullanabilirsiniz. Yerel bilgisayarda cim oturumu oluşturduğunuzda PowerShell oturumu oluşturmak için WMI yerine DCOM kullanır.

• Varsayılan olarak, Import-Module alt kapsamdan çağrıldığında bile modülleri genel kapsamda içeri aktarır. En üst düzey kapsam ve tüm alt kapsamlar modülün dışarı aktarılan öğelerine erişebilir.

  Alt kapsamda, -Scope Local içeri aktarmayı bu kapsama ve tüm alt kapsamlarına sınırlar. Ardından üst kapsamlar içeri aktarılan üyeleri görmez.

  Not

  Get-Module geçerli oturumda yüklenen tüm modülleri gösterir. Buna, alt kapsamda yerel olarak yüklenen modüller dahildir. Geçerli kapsamda hangi üyelerin yüklendiğini görmek için kullanın Get-Command -Module modulename .

• Import-Module modülde sınıf ve numaralandırma tanımlarını yüklemez. using module Betiğinizin başındaki deyimini kullanın. Bu, sınıfı ve numaralandırma tanımları dahil olmak üzere modülü içeri aktarır. Daha fazla bilgi için bkz . about_Using.

• Bir betik modülünün geliştirilmesi sırasında kodda değişiklik yapmak ve ardından Force parametresini kullanarak Import-Module modülün yeni sürümünü yüklemek yaygın bir işlemdir. Bu, yalnızca kök modüldeki işlevlerde yapılan değişiklikler için çalışır. Import-Module iç içe modülleri yeniden yüklemez. Ayrıca, güncelleştirilmiş sınıfları veya numaralandırmaları yüklemenin hiçbir yolu yoktur.

  İç içe modüllerde tanımlanan güncelleştirilmiş modül üyelerini almak için ile Remove-Modulemodülü kaldırın ve modülü yeniden içeri aktarın.

  Modül bir using deyimle yüklendiyse, sınıflar ve numaralandırmalar için güncelleştirilmiş tanımları içeri aktarmak için yeni bir oturum başlatmanız gerekir. PowerShell'de tanımlanan ve bir using deyimle içeri aktarılan sınıflar ve numaralandırmalar kaldırılamaz.

İlişkili Bağlantılar

• about_Modules
• Export-ModuleMember
• Get-Module
• New-Module
• Remove-Module
• about_PowerShell_Editions