Import-Module

Modul:

Microsoft.PowerShell.Core Module

Modulok hozzáadása az aktuális munkamenethez.

Syntax

Name (Alapértelmezett)

Import-Module
    [-Name] <String[]>
    [-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>]

PSSession

Import-Module
    [-Name] <String[]>
    -PSSession <PSSession>
    [-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>]

CimSession

Import-Module
    [-Name] <String[]>
    -CimSession <CimSession>
    [-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>]
    [-CimResourceUri <Uri>]
    [-CimNamespace <String>]
    [<CommonParameters>]

FullyQualifiedName

Import-Module
    [-FullyQualifiedName] <ModuleSpecification[]>
    [-Global]
    [-Prefix <String>]
    [-Function <String[]>]
    [-Cmdlet <String[]>]
    [-Variable <String[]>]
    [-Alias <String[]>]
    [-Force]
    [-PassThru]
    [-AsCustomObject]
    [-ArgumentList <Object[]>]
    [-DisableNameChecking]
    [-NoClobber]
    [-Scope <String>]
    [<CommonParameters>]

FullyQualifiedNameAndPSSession

Import-Module
    [-FullyQualifiedName] <ModuleSpecification[]>
    -PSSession <PSSession>
    [-Global]
    [-Prefix <String>]
    [-Function <String[]>]
    [-Cmdlet <String[]>]
    [-Variable <String[]>]
    [-Alias <String[]>]
    [-Force]
    [-PassThru]
    [-AsCustomObject]
    [-ArgumentList <Object[]>]
    [-DisableNameChecking]
    [-NoClobber]
    [-Scope <String>]
    [<CommonParameters>]

Assembly

Import-Module
    [-Assembly] <Assembly[]>
    [-Global]
    [-Prefix <String>]
    [-Function <String[]>]
    [-Cmdlet <String[]>]
    [-Variable <String[]>]
    [-Alias <String[]>]
    [-Force]
    [-PassThru]
    [-AsCustomObject]
    [-ArgumentList <Object[]>]
    [-DisableNameChecking]
    [-NoClobber]
    [-Scope <String>]
    [<CommonParameters>]

ModuleInfo

Import-Module
    [-ModuleInfo] <PSModuleInfo[]>
    [-Global]
    [-Prefix <String>]
    [-Function <String[]>]
    [-Cmdlet <String[]>]
    [-Variable <String[]>]
    [-Alias <String[]>]
    [-Force]
    [-PassThru]
    [-AsCustomObject]
    [-ArgumentList <Object[]>]
    [-DisableNameChecking]
    [-NoClobber]
    [-Scope <String>]
    [<CommonParameters>]

Description

A Import-Module parancsmag hozzáad egy vagy több modult az aktuális munkamenethez. Az importált modulokat a helyi számítógépre vagy egy távoli számítógépre kell telepíteni.

A PowerShell 3.0-tól kezdve a rendszer automatikusan importálja a telepített modulokat a munkamenetbe, amikor a modul bármely parancsát vagy szolgáltatót használ. A Import-Module paranccsal azonban továbbra is importálhat egy modult, és engedélyezheti és letilthatja az automatikus modulimportálást a $PSModuleAutoloadingPreference beállításváltozó használatával. A modulokkal kapcsolatos további információkért lásd: about_Modules. A $PSModuleAutoloadingPreference változóval kapcsolatos további információkért lásd: about_Preference_Variables.

A modul olyan csomag, amely a PowerShellben használható tagokat tartalmazza. A tagok közé tartoznak a parancsmagok, a szolgáltatók, a szkriptek, a függvények, a változók és más eszközök és fájlok. A modul importálása után használhatja a modul tagjait a munkamenetben.

Modul importálásához használja a Name, Assembly, ModuleInfo, MinimumVersion és RequiredVersion paramétereket az importálni kívánt modul azonosításához. Alapértelmezés szerint Import-Module importálja a modul által exportált összes tagot, de használhatja a Alias, Függvény, Parancsmagés változó paramétereket az importált tagok korlátozásához. A NoClobber paraméter használatával is megakadályozhatja, hogy Import-Module az aktuális munkamenet tagjaival azonos nevű tagokat importáljon.

Import-Module csak az aktuális munkamenetbe importál egy modult. A modul minden munkamenetbe való importálásához adjon hozzá egy Import-Module parancsot a PowerShell-profiljához. További információ a profilokról: about_Profiles.

A Windows PowerShell 3.0-tól kezdve a Import-Module használatával importálhatja a Common Information Model (CIM) modulokat, amelyekben a parancsmagok a Parancsmagdefiníció XML -fájljaiban vannak definiálva. Ez a funkció lehetővé teszi a nem felügyelt kódszerelvényekben implementált parancsmagok használatát, például a C++-ban írt parancsmagokat.

Ezekkel az új funkciókkal Import-Module parancsmag elsődleges eszközévé válik a heterogén nagyvállalatok kezeléséhez, amelyek közé tartoznak a Windows operációs rendszert futtató számítógépek és a más operációs rendszereket futtató számítógépek.

A Windows operációs rendszert futtató távoli számítógépek kezeléséhez, amelyeken engedélyezve van a PowerShell és a PowerShell-remoting, hozzon létre egy PSSession a távoli számítógépen, majd a Get-Module paraméterével kérje le a PowerShell-modulokat a PSSession. Amikor importálja a modulokat, majd az importált parancsokat az aktuális munkamenetben használja, a parancsok implicit módon futnak a távoli számítógépen található PSSession. Ezzel a stratégiával kezelheti a távoli számítógépet.

Hasonló stratégiával kezelheti azokat a számítógépeket, amelyeken nincs engedélyezve a PowerShell-remoting, beleértve a Windows operációs rendszert nem futtató számítógépeket, valamint a PowerShell-lel rendelkező Windows-számítógépeket, de nincs engedélyezve a PowerShell-remoting.

Először hozzon létre egy CIM-munkamenetet a távoli számítógépen, amely a távoli számítógépen található Windows Management Instrumentation (WMI) kapcsolat. Ezután a Import-Module paraméterével importálja a CIM-modulokat a távoli számítógépről. Amikor importál egy CIM-modult, majd futtatja az importált parancsokat, a parancsok implicit módon futnak a távoli számítógépen. Ezzel a WMI- és CIM-stratégiával kezelheti a távoli számítógépet.

Példák

1. példa: Modul tagjainak importálása az aktuális munkamenetbe

Ez a példa importálja a PSDiagnostics modul tagjait az aktuális munkamenetbe. A Név paraméter neve nem kötelező, és kihagyható.

Import-Module -Name PSDiagnostics

Alapértelmezés szerint Import-Module nem hoz létre kimenetet, amikor importál egy modult. A kimenet kéréséhez használja a PassThru vagy AsCustomObject paramétert, vagy a Részletes gyakori paramétert.

2. példa: A modul elérési útja által megadott összes modul importálása

Ez a példa az $env:PSModulePath környezeti változó által megadott elérési úton található összes elérhető modult importálja az aktuális munkamenetbe.

Get-Module -ListAvailable | Import-Module

3. példa: Több modul tagjainak importálása az aktuális munkamenetbe

Ez a példa importálja a PSDiagnostics és Dism modulokat az aktuális munkamenetbe.

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

A Get-Module parancsmag lekéri a PSDiagnostics és Dism modulokat, és menti az objektumokat a $m változóban. A ListAvailable paraméterre akkor van szükség, ha olyan modulokat kap, amelyek még nincsenek importálva a munkamenetbe.

A Import-Module paramétere a modulok importálására szolgál az aktuális munkamenetbe.

Ezek a parancsok egyenértékűek egy folyamatkezelő (|) használatával egy Get-Module parancs kimenetének Import-Module.

4. példa: Az elérési út által megadott összes modul importálása

Ez a példa egy explicit elérési utat használ az importálni kívánt modul azonosításához.

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

A Részletes paraméter használatával Import-Module jelentést készít a folyamat előrehaladásáról, miközben betölti a modult. A Részletes, PassThruvagy AsCustomObject paraméter nélkül Import-Module nem hoz létre kimenetet a modul importálásakor.

5. példa: Munkamenetbe importált modultagok korlátozása

Ez a példa bemutatja, hogyan korlátozhatja, hogy mely modultagok legyenek importálva a munkamenetbe, és hogy a parancs milyen hatással van a munkamenetre.

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

Az első parancs csak a Disable-PSTrace és Enable-PSTrace parancsmagokat importálja a PSDiagnostics modulból. A függvény paraméter korlátozza a modulból importált tagokat. Az Alias, Változóés parancsmag paraméterekkel is korlátozhatja a modul által importált többi tagot.

A Get-Module parancsmag lekéri az PSDiagnostics modult képviselő objektumot. Az ExportedCmdlets tulajdonság felsorolja a modul által exportált összes parancsmagot, még akkor is, ha nem minden importált parancsmagot.

A harmadik parancsban a parancsmag Get-Command paramétere lekéri az PSDiagnostics modulból importált parancsokat. Az eredmények megerősítik, hogy csak a Disable-PSTrace és Enable-PSTrace parancsmagok lettek importálva.

6. példa: Egy modul tagjainak importálása és előtag hozzáadása

Ez a példa importálja a PSDiagnostics modult az aktuális munkamenetbe, hozzáad egy előtagot a tagnevekhez, majd megjeleníti az előtagneveket. Az előtag csak az aktuális munkamenet tagjaira vonatkozik. Ez nem módosítja a modult.

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

A Import-Module paraméterét használja, és hozzáadja a x előtagot a modulból importált összes taghoz, a PassThru paraméterrel pedig egy olyan modulobjektumot ad vissza, amely az importált modult jelöli.

A Get-Command parancsmag a modulból importált tagok lekéréséhez. A kimenet azt mutatja, hogy a modultagok megfelelően lettek előtaggal elnevezettek.

7. példa: Egyéni objektum lekérése és használata

Ezek a parancsok bemutatják, hogyan szerezheti be és használhatja az importálási modul által visszaadott egyéni objektumot.

Az egyéni objektumok olyan szintetikus tagokat tartalmaznak, amelyek az importált modultagokat képviselik. A modul parancsmagjai és függvényei például az egyéni objektum szkriptmetódusává alakulnak.

Az egyéni objektumok nagyon hasznosak a szkriptelésben. Akkor is hasznosak, ha több importált objektum neve azonos. Egy objektum szkriptmetódusának használata egyenértékű az importált tag teljes nevének megadásával, beleértve annak modulnevét is.

Az AsCustomObject paraméter csak szkriptmodul importálásakor használható, ezért az első feladat annak meghatározása, hogy az elérhető modulok közül melyik szkriptmodul.

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

Az első parancs a Get-Module parancsmaggal szerzi be az elérhető modulokat. A parancs folyamatkezelővel továbbítja a modulobjektumokat a Format-Table parancsmagnak, amely felsorolja a Név és ModuleType a táblák egyes moduljainak.

A második parancs a Import-Module parancsmaggal importálja a Naptár megjelenítése szkriptmodult. A parancs az AsCustomObject paraméterrel kér egy egyéni objektumot, a PassThru paraméter pedig az objektum visszaadásához. A parancs menti az eredményként kapott egyéni objektumot a $a változóba.

A harmadik parancs egy folyamatkezelővel küldi el a $a változót a Get-Member parancsmagba, amely lekéri a PSCustomObject tulajdonságait és metódusait $a. A kimenet egy Naptár() megjelenítése szkriptmetódust jelenít meg.

Az utolsó parancs a Naptár megjelenítése szkriptmetódust használja. A metódus nevét idézőjelek közé kell foglalni, mert kötőjelet tartalmaz.

8. példa: Modul ismételt importálása ugyanabba a munkamenetbe

Ez a példa bemutatja, hogyan használhatja a Import-Module paraméterét, amikor újra importál egy modult ugyanabba a munkamenetbe.

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

Az első parancs importálja a PSDiagnostics modult. A második parancs ismét importálja a modult, ezúttal a előtag paraméter használatával.

A Force paraméterrel Import-Module eltávolítja a modult, majd újra importálja. E paraméter nélkül a munkamenet minden PSDiagnostics parancsmag két példányát tartalmazza, egyet a standard névvel, egyet pedig az előtaggal.

9. példa: Importált parancsok által elrejtett parancsok futtatása

Ez a példa bemutatja, hogyan futtathatók az importált parancsok által elrejtett parancsok. A TestModule modul. tartalmaz egy Get-Date nevű függvényt, amely az év és a nap értékét adja vissza.

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:26:12 PM

Az első Get-Datecmdlet returns a **DateTime** object with the current date. After importing the **TestModule** module,Get-Date" az év évét és napját adja vissza.

A összes paraméterének használatával megkapjuk a munkamenet összes parancsát. Az eredmények azt mutatják, hogy két Get-Date parancs található a munkamenetben, egy függvény a TestModule modulból és egy parancsmag a Microsoft.PowerShell.Utility modulból.

Mivel a függvények elsőbbséget élveznek a parancsmagokkal szemben, a Get-Date modul függvénye fut a Get-Date parancsmag helyett. A Get-Date eredeti verziójának futtatásához a parancsnevet a modul nevével kell minősíteni.

A powershell-parancsok elsőbbségéről további információt a about_Command_Precedencecímű témakörben talál.

10. példa: Modul minimális verziójának importálása

Import-Module -Name PSWorkflow -MinimumVersion 3.0.0.0

Ez a parancs importálja a PSWorkflow modult. A MinimumVersion paramétert használja Import-Module csak a modul 3.0.0.0-s vagy újabb verziójának importálásához.

A RequiredVersion paraméterrel importálhat egy modul egy adott verzióját, vagy használhatja a Modul és verzióparamétereket a #Requires kulcsszóhoz, hogy egy adott modul egy adott verzióját megkövetelje egy szkriptben.

11. példa: Modul importálása távoli számítógépről

Ez a példa bemutatja, hogyan importálhat modult távoli számítógépről a Import-Module parancsmaggal. Ez a parancs a PowerShell Implicit Remoting funkcióját használja.

Amikor modulokat importál egy másik munkamenetből, az aktuális munkamenet parancsmagjait használhatja. A parancsmagokat használó parancsok azonban ténylegesen a távoli munkamenetben futnak.

$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

Az első parancs a New-PSSession parancsmaggal hoz létre egy távoli munkamenetet (PSSession) a Server01 számítógépen. A parancs menti a PSSession a $s változóban.

A második parancs a parancsmag Get-Module paraméterét használja a NetSecurity modul lekéréséhez a $s változó munkamenetében. Ez a parancs egyenértékű a Invoke-Command parancsmag használatával egy Get-Module parancs futtatásához a $s (Invoke-Command $s {Get-Module -ListAvailable -Name NetSecurity) munkamenetében. A kimenet azt mutatja, hogy a NetSecurity modul telepítve van a számítógépre, és elérhető a munkamenet számára a $s változóban.

A harmadik parancs a parancsmag Import-Module paraméterével importálja a NetSecurity modult a $s változó munkamenetéből az aktuális munkamenetbe.

A negyedik parancs a Get-Command parancsmagot használja a Get kezdetű parancsok lekéréséhez, és tartalmazza Tűzfal a NetSecurity modulból. A kimenet lekéri a parancsokat, és megerősíti, hogy a modul és parancsmagjai importálva lettek az aktuális munkamenetbe.

Az ötödik parancs a Get-NetFirewallRule parancsmaggal szerzi be a Windows Remote Management tűzfalszabályokat a Server01 számítógépen. Ez a parancs egyenértékű azzal, ha a Invoke-Command parancsmaggal futtat egy Get-NetFirewallRule parancsot a munkameneten a $s változóban.

12. példa: Tároló kezelése távoli számítógépen Windows operációs rendszer nélkül

Ebben a példában, mivel a számítógép rendszergazdája telepítette a Modulfelderítési WMI-szolgáltatót, a CIM-parancsok használhatják a szolgáltató számára tervezett alapértelmezett értékeket.

A példában szereplő parancsok lehetővé teszik a Windows operációs rendszert nem futtató távoli számítógépek tárolórendszereinek kezelését.

Az első parancs a New-CimSession parancsmaggal hoz létre munkamenetet a RSDGF03 távoli számítógépen. A munkamenet csatlakozik a WMI-hez a távoli számítógépen. A parancs menti a CIM-munkamenetet a $cs változóban.

A második parancs a $cs változó CIM-munkamenetét használja egy Import-Module parancs futtatásához a RSDGF03 számítógépen. A parancs a Name paramétert használja a Storage CIM-modul megadásához.

A harmadik parancs a Get-Command parancsot futtatja a Get-Disk modul parancsán. Amikor importál egy CIM-modult a helyi munkamenetbe, a PowerShell az egyes parancsok CDXML-fájljait PowerShell-szkriptekké alakítja, amelyek függvényként jelennek meg a helyi munkamenetben.

A negyedik parancs futtatja a Get-Disk parancsot. Bár a parancs be van állítva a helyi munkamenetbe, implicit módon fut azon a távoli számítógépen, ahonnan importálták. A parancs lekéri az objektumokat a távoli számítógépről, és visszaküldi őket a helyi munkamenetbe.

$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

Paraméterek

-Alias

Megadja azokat az aliasokat, amelyeket ez a parancsmag importál a modulból az aktuális munkamenetbe. Adja meg az aliasok vesszővel tagolt listáját. A helyettesítő karakterek használata engedélyezett.

Egyes modulok automatikusan exportálják a kijelölt aliasokat a munkamenetbe a modul importálásakor. Ez a paraméter lehetővé teszi, hogy válasszon az exportált aliasok közül.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ArgumentList

Olyan argumentumokat vagy paraméterértékeket tartalmazó tömböt ad meg, amelyeket a szkriptmodul a Import-Module parancs során ad át. Ez a paraméter csak szkriptmodul importálásakor érvényes.

Az ArgumentList paraméterre is hivatkozhat az aliasa, args. További információ: about_Aliases.

Paramétertulajdonságok

Típus:	Object[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Argumentumok

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-AsCustomObject

Azt jelzi, hogy ez a parancsmag egy egyéni objektumot ad vissza az importált modultagokat képviselő tagokkal. Ez a paraméter csak szkriptmodulokra érvényes.

Az AsCustomObject paraméter használatakor Import-Module importálja a modultagokat a munkamenetbe, majd egy PSCustomObject objektumot ad vissza PSModuleInfo objektum helyett. Az egyéni objektumot mentheti egy változóban, és pont jelöléssel meghívhatja a tagokat.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Assembly

Szerelvényobjektumok tömbjének megadása. Ez a parancsmag importálja a megadott szerelvényobjektumokban implementált parancsmagokat és szolgáltatókat. Adjon meg egy változót, amely szerelvényobjektumokat vagy szerelvényobjektumokat létrehozó parancsot tartalmaz. Szerelvényobjektumot is becsúszthat Import-Module.

Ha ezt a paramétert használja, a rendszer csak a megadott szerelvények által implementált parancsmagokat és szolgáltatókat importálja. Ha a modul más fájlokat tartalmaz, azok nem lesznek importálva, és előfordulhat, hogy hiányoznak a modul fontos tagjai. Használja ezt a paramétert a modul hibakereséséhez és teszteléséhez, vagy ha a modul szerzője arra utasítja, hogy használja.

Paramétertulajdonságok

Típus:	Assembly[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

Assembly

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-CimNamespace

A CIM-modulokat elérhetővé tevő alternatív CIM-szolgáltató névterét adja meg. Az alapértelmezett érték a Modulfelderítési WMI-szolgáltató névtere.

Ezzel a paraméterrel CIM-modulokat importálhat windowsos operációs rendszert nem futtató számítógépekről és eszközökről.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

CimSession

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-CimResourceUri

A CIM-modulok alternatív helyét adja meg. Az alapértelmezett érték a modulfelderítési WMI-szolgáltató erőforrás-URI-ja a távoli számítógépen.

Ezzel a paraméterrel CIM-modulokat importálhat windowsos operációs rendszert nem futtató számítógépekről és eszközökről.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	Uri
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

CimSession

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-CimSession

CiM-munkamenetet ad meg a távoli számítógépen. Adjon meg egy változót, amely tartalmazza a CIM-munkamenetet vagy a CIM-munkamenetet lekérő parancsot, például egy Get-CimSession parancsot.

Import-Module a CIM-munkamenet-kapcsolat használatával importálja a modulokat a távoli számítógépről az aktuális munkamenetbe. Ha az importált modulból származó parancsokat használja az aktuális munkamenetben, a parancsok ténylegesen a távoli számítógépen futnak.

Ez a paraméter modulokat importálhat a Windows operációs rendszert nem futtató számítógépekről és eszközökről, valamint a PowerShell-lel rendelkező Windows rendszerű számítógépekről, de nincs engedélyezve a PowerShell-remoting.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	CimSession
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

CimSession

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Cmdlet

A parancsmagok tömbjének megadása, amelyeket ez a parancsmag importál a modulból az aktuális munkamenetbe. A helyettesítő karakterek használata engedélyezett.

Egyes modulok automatikusan exportálják a kijelölt parancsmagokat a munkamenetbe a modul importálásakor. Ez a paraméter lehetővé teszi, hogy válasszon az exportált parancsmagok közül.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-DisableNameChecking

Azt jelzi, hogy ez a parancsmag letiltja azt az üzenetet, amely figyelmeztetést küld, amikor olyan parancsmagot vagy függvényt importál, amelynek neve nem jóváhagyott igét vagy tiltott karaktert tartalmaz.

Alapértelmezés szerint, amikor egy importált modul exportálja azokat a parancsmagokat vagy függvényeket, amelyek neve nem jóváhagyott igéket tartalmaz, a PowerShell a következő figyelmeztető üzenetet jeleníti meg:

FIGYELMEZTETÉS: Egyes importált parancsnevek nem jóváhagyott parancsokat tartalmaznak, amelyek kevésbé felderíthetők. A jóváhagyott igék listájának megtekintéséhez használja a Részletes paramétert, vagy írja be a Get-Verb.

Ez az üzenet csak figyelmeztetés. A teljes modul továbbra is importálva van, beleértve a nem megfelelő parancsokat is. Bár az üzenet megjelenik a modul felhasználói számára, az elnevezési problémát a modul szerzőjének kell kijavítani.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Force

Ez a paraméter egy modul betöltését vagy újratöltését okozza az aktuális felett

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-FullyQualifiedName

Megadja a modul specifikációjának teljes nevét.

Paramétertulajdonságok

Típus:	ModuleSpecification[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

FullyQualifiedName

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

FullyQualifiedNameAndPSSession

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Function

Olyan függvénytömböt határoz meg, amelyet ez a parancsmag importál a modulból az aktuális munkamenetbe. A helyettesítő karakterek használata engedélyezett.

Egyes modulok automatikusan exportálják a kiválasztott függvényeket a munkamenetbe a modul importálásakor. Ez a paraméter lehetővé teszi, hogy válasszon az exportált függvények közül.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Global

Azt jelzi, hogy ez a parancsmag importálja a modulokat a globális munkamenet állapotába, hogy azok elérhetők legyenek a munkamenet összes parancsa számára.

Alapértelmezés szerint, ha Import-Module parancsmag a parancssorból, a szkriptfájlból vagy a szkriptblokkból van meghívva, a rendszer az összes parancsot a globális munkamenet állapotába importálja.

Egy másik modulból való meghíváskor Import-Module parancsmag importálja a modulban lévő parancsokat, beleértve a beágyazott modulokból származó parancsokat is, a hívó munkamenet-állapotába.

Jótanács

Ne hívjon Import-Module egy modulon belülről. Ehelyett deklarálja a célmodult beágyazott modulként a szülőmodul jegyzékében. A beágyazott modulok deklarálása javítja a függőségek felderíthetőségét.

A Globális paraméter megegyezik a Hatókör paraméterrel globális értékkel.

A modul által exportált parancsok korlátozásához használjon egy Export-ModuleMember parancsot a szkriptmodulban.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-MaximumVersion

A maximális verziót adja meg. Ez a parancsmag csak a modul azon verzióját importálja, amely kisebb vagy egyenlő a megadott értékkel. Ha nincs megfelelő verzió, Import-Module hibát generál.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

Name

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

PSSession

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CimSession

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-MinimumVersion

A minimális verziót adja meg. Ez a parancsmag csak a modul azon verzióját importálja, amely nagyobb vagy egyenlő a megadott értékkel. Ha nincs megfelelő verzió, Import-Module hibát generál.

Alapértelmezés szerint Import-Module importálja a modult a verziószám ellenőrzése nélkül.

Használja a MinimumVersion paraméter nevét vagy aliasát, a Verziót.

A pontos verzió megadásához használja a RequiredVersion paramétert. A #Requires kulcsszó modul és Verzió paramétereit is használhatja a modul adott verziójának megköveteléséhez egy szkriptben.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	Version
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	verzió

Paraméterkészletek

Name

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

PSSession

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CimSession

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ModuleInfo

Az importálandó modulobjektumok tömbjének megadása. Adjon meg egy változót, amely tartalmazza a modulobjektumokat, vagy egy olyan parancsot, amely lekéri a modulobjektumokat, például a következő parancsot: Get-Module -ListAvailable. A modulobjektumokat Import-Moduleis be lehet csövezni.

Paramétertulajdonságok

Típus:	PSModuleInfo[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ModuleInfo

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Name

Megadja az importálni kívánt modulok nevét. Adja meg a modul nevét vagy egy fájl nevét a modulban, például .psd1, .psm1, .dllvagy ps1 fájlt. A fájl elérési útja nem kötelező. A helyettesítő karakterek nem engedélyezettek. A modulneveket és a fájlneveket a Import-Moduleis beszűkítheti.

Ha kihagy egy útvonalat, Import-Module megkeresi a modult a $env:PSModulePath környezeti változóban mentett útvonalakban.

Lehetőség szerint csak a modul nevét adja meg. Fájlnév megadásakor csak az abban a fájlban implementált tagok lesznek importálva. Ha a modul más fájlokat tartalmaz, azok nem lesznek importálva, és előfordulhat, hogy hiányoznak a modul fontos tagjai.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

Name

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

PSSession

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CimSession

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-NoClobber

Azt jelzi, hogy ez a parancsmag nem importál olyan parancsokat, amelyek neve megegyezik az aktuális munkamenetben meglévő parancsokkal. Alapértelmezés szerint Import-Module importálja az összes exportált modulparancsot.

Az azonos nevű parancsok elrejthetik vagy lecserélhetik a parancsokat a munkamenetben. A parancsok névütközésének elkerülése érdekében használja a Előtag vagy NoClobber paramétereket. A névütközésekről és a parancsok elsőbbségéről további információt a "Modulok és névütközések" című témakörben talál about_Modules és about_Command_Precedence.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	NoOverwrite

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PassThru

Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Prefix

Megadja azt az előtagot, amelyet ez a parancsmag hozzáad a főnevekhez az importált modultagok nevében.

Ezzel a paraméterel elkerülheti azokat a névütközéseket, amelyek akkor fordulhatnak elő, ha a munkamenet különböző tagjai azonos nevűek. Ez a paraméter nem módosítja a modult, és nem befolyásolja azokat a fájlokat, amelyeket a modul saját használatra importál. Ezeket beágyazott moduloknak nevezzük. Ez a parancsmag csak az aktuális munkamenetben lévő tagok nevét érinti.

Ha például az UTC előtagot adja meg, majd importál egy Get-Date parancsmagot, a parancsmag a munkamenetben Get-UTCDatenéven ismert, és nem tévesztendő össze az eredeti Get-Date parancsmaggal.

A paraméter értéke elsőbbséget élvez a modul DefaultCommandPrefix tulajdonságával szemben, amely megadja az alapértelmezett előtagot.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PSSession

Megadja a Felhasználó által felügyelt PowerShell-munkamenetet (PSSession), amelyből ez a parancsmag modulokat importál az aktuális munkamenetbe. Adjon meg egy olyan változót, amely egy PSSession vagy egy PSSessionlekérő parancsot tartalmaz , például egy Get-PSSession parancsot.

Ha egy modult egy másik munkamenetből importál az aktuális munkamenetbe, az aktuális munkamenetben a modul parancsmagjait is használhatja, ugyanúgy, mint egy helyi modul parancsmagjait. A távoli parancsmagokat használó parancsok valójában a távoli munkamenetben futnak, de az újraegyezés részleteit a PowerShell kezeli a háttérben.

Ez a paraméter a PowerShell Implicit Remoting funkcióját használja. Ez egyenértékű a Import-PSSession parancsmaggal, hogy bizonyos modulokat importáljon egy munkamenetből.

Import-Module nem lehet importálni a PowerShell Core-modulokat egy másik munkamenetből. A PowerShell Core-modulok nevei a Microsoft.PowerShell-lel kezdődnek.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	PSSession
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

PSSession

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

FullyQualifiedNameAndPSSession

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-RequiredVersion

Megadja a modul azon verzióját, amelyet ez a parancsmag importál. Ha a verzió nincs telepítve, Import-Module hibát generál.

Alapértelmezés szerint Import-Module importálja a modult a verziószám ellenőrzése nélkül.

A minimális verzió megadásához használja a MinimumVersion paramétert. A #Requires kulcsszó modul és Verzió paramétereit is használhatja a modul adott verziójának megköveteléséhez egy szkriptben.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Azok a szkriptek, amelyek RequiredVersion használnak a Windows operációs rendszer meglévő kiadásainak részét képező modulok importálására, nem futnak automatikusan a Windows operációs rendszer későbbi kiadásaiban. Ennek az az oka, hogy a Windows operációs rendszer jövőbeli kiadásaiban a PowerShell-modul verziószámai magasabbak, mint a Windows operációs rendszer meglévő kiadásainak modulverziószámai.

Paramétertulajdonságok

Típus:	Version
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

Name

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

PSSession

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CimSession

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Scope

Meghatározza azt a hatókört, amelybe ez a parancsmag importálja a modult.

A paraméter elfogadható értékei a következők:

• Globális. A munkamenet összes parancsa számára elérhető. Egyenértékű a globális paraméterével.
• Helyi. Csak az aktuális hatókörben érhető el.

Alapértelmezés szerint, ha Import-Module parancsmag a parancssorból, a szkriptfájlból vagy a szkriptblokkból van meghívva, a rendszer az összes parancsot a globális munkamenet állapotába importálja. A -Scope paraméterrel Helyi értékével importálhat modultartalmat a szkriptbe vagy a szkriptblokk hatókörébe.

Egy másik modulból való meghíváskor Import-Module parancsmag importálja a modulban lévő parancsokat, beleértve a beágyazott modulokból származó parancsokat is, a hívó munkamenet-állapotába. A -Scope Global vagy -Global megadása azt jelzi, hogy ez a parancsmag importálja a modulokat a globális munkamenet állapotába, hogy azok elérhetők legyenek a munkamenet összes parancsa számára.

A Globális paraméter megegyezik a Hatókör paraméterrel globális értékkel.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	Current scope
Elfogadott értékek:	Local, Global
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Variable

Olyan változók tömbje, amelyeket ez a parancsmag importál a modulból az aktuális munkamenetbe. Adja meg a változók listáját. A helyettesítő karakterek használata engedélyezett.

Egyes modulok automatikusan exportálják a kiválasztott változókat a munkamenetbe a modul importálásakor. Ez a paraméter lehetővé teszi, hogy válasszon az exportált változók közül.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

System.String, System.Management.Automation.PSModuleInfo, System.Reflection.Assembly

Erre a parancsmagra modulnevet, modulobjektumot vagy szerelvényobjektumot helyezhet el.

Kimenetek

None, System.Management.Automation.PSModuleInfo, or System.Management.Automation.PSCustomObject

Ez a parancsmag egy PSModuleInfo vagy PSCustomObjectad vissza. Alapértelmezés szerint Import-Module nem hoz létre kimenetet. Ha megadja a PassThru paramétert, a parancsmag létrehoz egy System.Management.Automation.PSModuleInfo objektumot, amely a modult jelöli. Ha megadja az AsCustomObject paramétert, az létrehoz egy PSCustomObject objektumot.

Jegyzetek

• A modul importálása előtt telepíteni kell a modult a helyi számítógépre. Vagyis a modulkönyvtárat át kell másolni egy olyan könyvtárba, amely elérhető a helyi számítógép számára. További információ: about_Modules.

  A PSSession és CIMSession paramétereket is használhatja a távoli számítógépekre telepített modulok importálásához. Az ezekben a modulokban található parancsmagokat használó parancsok azonban ténylegesen a távoli munkamenetben futnak a távoli számítógépen.

• Ha azonos nevű és azonos típusú tagokat importál a munkamenetbe, a PowerShell alapértelmezés szerint az utolsóként importált tagot használja. A változók és aliasok lecserélődnek, és az eredetiek nem érhetők el. A függvényeket, parancsmagokat és szolgáltatókat az új tagok csupán árnyékba szorítják. Ezek a parancsok úgy érhetők el, hogy a parancs nevét a beépülő modul, a modul vagy a függvény elérési útjának nevével minősítik.

• A modulból importált parancsok formázási adatainak frissítéséhez használja a Update-FormatData parancsmagot. Update-FormatData a modulokból importált munkamenet parancsainak formázási adatait is frissíti. Ha egy modul formázási fájlja megváltozik, futtathat egy Update-FormatData parancsot az importált parancsok formázási adatainak frissítéséhez. Nem kell újra importálnia a modult.

• A Windows PowerShell 3.0-tól kezdve a PowerShell-lel telepített alapvető parancsok modulokba vannak csomagolva. A Windows PowerShell 2.0-ban és a PowerShell későbbi verzióiban régebbi stílusú munkameneteket létrehozó gazdagépprogramokban az alapvető parancsok beépülő modulokba vannak csomagolva (PSSnapins). A kivétel a Microsoft.PowerShell.Core , amely mindig beépülő modul. A távoli munkamenetek, például a New-PSSession parancsmag által indítottak is régebbi stílusú munkamenetek, amelyek alapvető beépülő modulokat tartalmaznak.

  A CreateDefault2 metódusról, amely alapmodulokkal hoz létre újabb stílusú munkameneteket, tekintse meg a CreateDefault2 metódus.

• Import-Module nem lehet importálni a PowerShell Core-modulokat egy másik munkamenetből. A PowerShell Core-modulok nevei a Microsoft.PowerShell-lel kezdődnek.

• A Windows PowerShell 2.0-ban a modulobjektum néhány tulajdonságértékét, például az ExportáltCmdlets és beágyazottmodulok tulajdonságértékeket nem tölti ki a modul importálásáig, és nem voltak elérhetők azon a modulobjektumon, amelyet a PassThru paraméter visszaad. A Windows PowerShell 3.0-ban minden modultulajdonság-érték ki van töltve.

• Ha olyan modult próbál importálni, amely olyan vegyes módú szerelvényeket tartalmaz, amelyek nem kompatibilisek a Windows PowerShell 3.0-val, Import-Module az alábbihoz hasonló hibaüzenetet ad vissza.

  Import-Module: A vegyes módú szerelvény a futtatókörnyezet "v2.0.50727" verziójára épül, és további konfigurációs információk nélkül nem tölthető be a 4.0-s futtatókörnyezetbe.

  Ez a hiba akkor fordul elő, ha egy Windows PowerShell 2.0-hoz tervezett modul legalább egy vegyes modulból álló szerelvényt tartalmaz, azaz egy olyan szerelvényt, amely felügyelt és nem felügyelt kódot is tartalmaz, például C++ és C#.

  Vegyes módú szerelvényeket tartalmazó modul importálásához indítsa el a Windows PowerShell 2.0-t a következő paranccsal, majd próbálkozzon újra a Import-Module paranccsal.

  PowerShell.exe -Version 2.0

• A CIM-munkamenet funkció használatához a távoli számítógépnek WS-Management újraírással és a Windows Management Instrumentation (WMI) szolgáltatással kell rendelkeznie, amely a Common Information Model (CIM) szabvány Microsoft-implementációja. A számítógépnek rendelkeznie kell a modulfelderítési WMI-szolgáltatóval vagy egy másik CIM-szolgáltatóval is, amely ugyanazokat az alapvető funkciókat tartalmazza.

  A CIM-munkamenet funkciót olyan számítógépeken is használhatja, amelyek nem windowsos operációs rendszert futtatnak, és olyan Windows rendszerű számítógépeken, amelyek rendelkeznek PowerShell-lel, de nincs engedélyezve a PowerShell-újraírás.

  A CIM-paraméterekkel a CIM-modulokat olyan számítógépekről is lekérheti, amelyeken engedélyezve van a PowerShell-újraírás, beleértve a helyi számítógépet is. Amikor CIM-munkamenetet hoz létre a helyi számítógépen, a PowerShell a WMI helyett a DCOM-t használja a munkamenet létrehozásához.

Kapcsolódó hivatkozások

• Modultag exportálása
• Get-Module
• Új-Modul
• Remove-Module (Modul Eltávolítása)