Import-Module

Import-Module
    [-Name] <String[]>
    [-Global]
    [-Prefix <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
    [-Name] <String[]>
    -PSSession <PSSession>
    [-Global]
    [-Prefix <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
    [-Name] <String[]>
    -CimSession <CimSession>
    [-Global]
    [-Prefix <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>]
    [-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
    [-FullyQualifiedName] <ModuleSpecification[]>
    [-Global]
    [-Prefix <String>]
    [-Function <String[]>]
    [-Cmdlet <String[]>]
    [-Variable <String[]>]
    [-Alias <String[]>]
    [-Force]
    [-SkipEditionCheck]
    [-PassThru]
    [-AsCustomObject]
    [-ArgumentList <Object[]>]
    [-DisableNameChecking]
    [-NoClobber]
    [-Scope <String>]
    [<CommonParameters>]

Import-Module
    [-FullyQualifiedName] <ModuleSpecification[]>
    -PSSession <PSSession>
    [-Global]
    [-Prefix <String>]
    [-Function <String[]>]
    [-Cmdlet <String[]>]
    [-Variable <String[]>]
    [-Alias <String[]>]
    [-Force]
    [-SkipEditionCheck]
    [-PassThru]
    [-AsCustomObject]
    [-ArgumentList <Object[]>]
    [-DisableNameChecking]
    [-NoClobber]
    [-Scope <String>]
    [<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
    [-Assembly] <Assembly[]>
    [-Global]
    [-Prefix <String>]
    [-Function <String[]>]
    [-Cmdlet <String[]>]
    [-Variable <String[]>]
    [-Alias <String[]>]
    [-Force]
    [-SkipEditionCheck]
    [-PassThru]
    [-AsCustomObject]
    [-ArgumentList <Object[]>]
    [-DisableNameChecking]
    [-NoClobber]
    [-Scope <String>]
    [<CommonParameters>]

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

Das Cmdlet Import-Module fügt der aktuellen Sitzung mindestens ein Modul hinzu. Ab PowerShell 3.0 werden installierte Module automatisch in die Sitzung importiert, wenn Sie Befehle oder Anbieter im Modul verwenden. Sie können jedoch weiterhin den Befehl Import-Module verwenden, um ein Modul zu importieren. Sie können den automatischen Modulimport mithilfe der einstellungsvariablen $PSModuleAutoLoadingPreference deaktivieren. Weitere Informationen zur Variable $PSModuleAutoLoadingPreference finden Sie unter about_Preference_Variables.

Ein Modul ist ein Paket, das Elemente enthält, die in PowerShell verwendet werden können. Mitglieder umfassen Cmdlets, Anbieter, Skripts, Funktionen, Variablen und andere Tools und Dateien. Nachdem ein Modul importiert wurde, können Sie die Modulmitglieder in Ihrer Sitzung verwenden. Weitere Informationen zu Modulen finden Sie unter about_Modules.

Standardmäßig importiert Import-Module alle Elemente, die das Modul exportiert, aber Sie können die Parameter Alias, Function, Cmdletund Variable Parameter verwenden, um einzuschränken, welche Member importiert werden. Der NoClobber--Parameter verhindert, dass Import-Module Member importieren, die dieselben Namen wie Mitglieder in der aktuellen Sitzung haben.

Import-Module importiert ein Modul nur in die aktuelle Sitzung. Um das Modul in jede neue Sitzung zu importieren, fügen Sie Ihrem PowerShell-Profil einen Import-Module Befehl hinzu. Weitere Informationen zu Profilen finden Sie unter about_Profiles.

Sie können Remotecomputer mit aktiviertem PowerShell-Remoting verwalten, indem Sie eine PSSession- auf dem Remotecomputer erstellen. Verwenden Sie dann den PSSession Parameter von Import-Module, um die Module zu importieren, die auf dem Remotecomputer installiert sind. Wenn Sie die importierten Befehle in der aktuellen Sitzung verwenden, werden die Befehle implizit auf dem Remotecomputer ausgeführt.

Ab Windows PowerShell 3.0 können Sie Import-Module verwenden, um Common Information Model(CIM)-Module zu importieren. CIM-Module definieren Cmdlets in CDXML-Dateien (Cmdlet Definition XML). Mit diesem Feature können Sie Cmdlets verwenden, die in nicht verwalteten Codeassemblys implementiert sind, z. B. in C++ geschriebene.

Für Remotecomputer, auf denen PowerShell-Remoting nicht aktiviert ist, einschließlich Computern, die nicht das Windows-Betriebssystem ausführen, können Sie den parameter CimSession von Import-Module verwenden, um CIM-Module vom Remotecomputer zu importieren. Die importierten Befehle werden implizit auf dem Remotecomputer ausgeführt. Eine CIMSession- ist eine Verbindung mit der Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) auf dem Remotecomputer.

In diesem Beispiel werden die Member des PSDiagnostics Moduls in die aktuelle Sitzung importiert.

Import-Module -Name PSDiagnostics

In diesem Beispiel werden alle verfügbaren Module im Pfad importiert, der durch die $Env:PSModulePath Umgebungsvariable in die aktuelle Sitzung angegeben wird.

Get-Module -ListAvailable | Import-Module

In diesem Beispiel werden die Member der PSDiagnostics und Dism Module in die aktuelle Sitzung importiert.

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

Das cmdlet Get-Module ruft die PSDiagnostics und Dism Module ab und speichert die Objekte in der variablen $m. Der parameter ListAvailable ist erforderlich, wenn Sie Module abrufen, die noch nicht in die Sitzung importiert werden.

Der ModuleInfo Parameter von Import-Module wird verwendet, um die Module in die aktuelle Sitzung zu importieren.

In diesem Beispiel wird ein expliziter Pfad verwendet, um das zu importierende Modul zu identifizieren.

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

Die Verwendung des Verbose--Parameters bewirkt, dass Import-Module den Fortschritt beim Laden des Moduls melden. Ohne den Verbose, PassThruoder AsCustomObject Parameter generiert Import-Module keine Ausgabe, wenn ein Modul importiert wird.

In diesem Beispiel wird gezeigt, wie Sie einschränken, welche Modulmitglieder in die Sitzung importiert werden, und wie sich dieser Befehl auf die Sitzung auswirkt. Der parameter Function beschränkt die Elemente, die aus dem Modul importiert werden. Sie können auch die Parameter Alias, Variableund Cmdlet Parameter verwenden, um andere Elemente einzuschränken, die ein Modul importiert.

Das cmdlet Get-Module ruft das Objekt ab, das das PSDiagnostics Modul darstellt. Die ExportedCmdlets-Eigenschaft listet alle Cmdlets auf, die das Modul exportiert, auch wenn sie nicht alle importiert wurden.

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

Mit dem parameter Module des Cmdlets Get-Command werden die Befehle angezeigt, die aus dem PSDiagnostics Modul importiert wurden. Die Ergebnisse bestätigen, dass nur die cmdlets Disable-PSTrace und Enable-PSTrace importiert wurden.

In diesem Beispiel wird das PSDiagnostics Modul in die aktuelle Sitzung importiert, der Elementnamen ein Präfix hinzugefügt und dann die präfixierten Membernamen angezeigt. Der parameter Prefix von Import-Module fügt das präfix x allen Elementen hinzu, die aus dem Modul importiert werden. Das Präfix gilt nur für die Mitglieder in der aktuellen Sitzung. Das Modul wird nicht geändert. Der PassThru Parameter gibt ein Modulobjekt zurück, das das importierte Modul darstellt.

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 ruft die Elemente ab, die aus dem Modul importiert wurden. Die Ausgabe zeigt, dass die Modulmmber richtig vorangestellt wurden.

In diesem Beispiel wird veranschaulicht, wie das von Import-Modulezurückgegebene benutzerdefinierte Objekt abgerufen und verwendet wird.

Benutzerdefinierte Objekte enthalten synthetische Member, die jedes der importierten Modulelemente darstellen. Beispielsweise werden die Cmdlets und Funktionen in einem Modul in Skriptmethoden des benutzerdefinierten Objekts konvertiert.

Benutzerdefinierte Objekte sind bei der Skripterstellung nützlich. Sie sind auch hilfreich, wenn mehrere importierte Objekte dieselben Namen haben. Die Verwendung der Skriptmethode eines Objekts entspricht dem Angeben des vollqualifizierten Namens eines importierten Elements, einschließlich des Modulnamens.

Der AsCustomObject Parameter kann nur beim Importieren eines Skriptmoduls verwendet werden. Verwenden Sie Get-Module, um zu bestimmen, welche der verfügbaren Module ein Skriptmodul ist.

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

Das skriptmodul Show-Calendar wird mithilfe des parameters AsCustomObject importiert, um ein benutzerdefiniertes Objekt anzufordern, und der PassThru Parameter, um das Objekt zurückzugeben. Das resultierende benutzerdefinierte Objekt wird in der variablen $a gespeichert.

Die $a Variable wird an das cmdlet Get-Member weitergeleitet, um die Eigenschaften und Methoden des gespeicherten Objekts anzuzeigen. Die Ausgabe zeigt eine Show-Calendar Skriptmethode an.

Um die Show-Calendar Skriptmethode aufzurufen, muss der Methodenname in Anführungszeichen eingeschlossen werden, da der Name einen Bindestrich enthält.

In diesem Beispiel wird gezeigt, wie Sie den parameter Force von Import-Module verwenden, wenn Sie ein Modul in dieselbe Sitzung importieren. Der parameter Force entfernt das geladene Modul und importiert es dann erneut.

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

Der erste Befehl importiert das PSDiagnostics Modul. Der zweite Befehl importiert das Modul erneut, diesmal mit dem parameter Prefix.

Ohne den Parameter "Force" enthält die Sitzung zwei Kopien jedes PSDiagnostics Cmdlet, eines mit dem Standardnamen und eines mit dem präfixierten Namen.

In diesem Beispiel wird gezeigt, wie Befehle ausgeführt werden, die von importierten Befehlen ausgeblendet wurden. Das TestModule Modul enthält eine Funktion namens Get-Date, die das Jahr und den Tag des Jahres zurückgibt.

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

Das erste cmdlet Get-Date gibt ein DateTime-Objekt mit dem aktuellen Datum zurück. Nach dem Importieren des TestModule- Moduls gibt Get-Date das Jahr und den Tag des Jahres zurück.

Mithilfe des All-Parameters von Get-Command alle Get-Date Befehle in der Sitzung anzeigen. Die Ergebnisse zeigen, dass es zwei Get-Date Befehle in der Sitzung gibt, eine Funktion aus dem TestModule Modul und ein Cmdlet aus dem Microsoft.PowerShell.Utility Modul.

Da Funktionen Vorrang vor Cmdlets haben, wird die Get-Date-Funktion aus dem TestModule Modul ausgeführt, anstelle des cmdlets Get-Date. Um die ursprüngliche Version von Get-Dateauszuführen, müssen Sie den Befehlsnamen mit dem Modulnamen qualifizieren.

Weitere Informationen zur Rangfolge von Befehlen in PowerShell finden Sie unter about_Command_Precedence.

In diesem Beispiel wird das PowerShellGet Modul importiert. Es verwendet den MinimumVersion Parameter von Import-Module, um nur Version 2.0.0 oder höher des Moduls zu importieren.

Import-Module -Name PowerShellGet -MinimumVersion 2.0.0

Sie können auch den parameter RequiredVersion verwenden, um eine bestimmte Version eines Moduls zu importieren, oder die parameter Module und Version Parameter des schlüsselworts #Requires verwenden, um eine bestimmte Version eines Moduls in einem Skript zu erfordern.

In diesem Beispiel wird eine bestimmte Version eines Moduls mithilfe der FullyQualifiedNameimportiert.

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

In diesem Beispiel wird eine bestimmte Version eines Moduls mithilfe des vollqualifizierten Pfads importiert.

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'

In diesem Beispiel wird gezeigt, wie Sie das cmdlet Import-Module verwenden, um ein Modul von einem Remotecomputer zu importieren. Dieser Befehl verwendet das Feature "Implizites Remoting" von PowerShell.

Wenn Sie Module aus einer anderen Sitzung importieren, können Sie die Cmdlets in der aktuellen Sitzung verwenden. Befehle, die die Cmdlets verwenden, werden jedoch in der Remotesitzung ausgeführt.

$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 erstellt eine Remotesitzung (PSSession) auf dem Server01 Computer. Die PSSession- wird in der variablen $s gespeichert.

Das Ausführen Get-Module mit dem parameter PSSession zeigt an, dass das NetSecurity Modul installiert und auf dem Remotecomputer verfügbar ist. Dieser Befehl entspricht der Verwendung des cmdlets Invoke-Command zum Ausführen Get-Module Befehls in der Remotesitzung. Beispiel:

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

Wenn Sie Import-Module mit dem PSSession Parameter ausführen, wird das NetSecurity Modul vom Remotecomputer in die aktuelle Sitzung importiert. Das cmdlet Get-Command ruft Befehle ab, die mit Get beginnen und Firewall aus dem modul NetSecurity einschließen. Die Ausgabe bestätigt, dass das Modul und die zugehörigen Cmdlets in die aktuelle Sitzung importiert wurden.

Als Nächstes ruft das Cmdlet Get-NetFirewallRule Die Firewallregeln der Windows-Remoteverwaltung auf dem computer Server01 ab. Dies entspricht der Verwendung des cmdlets Invoke-Command zum Ausführen von Get-NetFirewallRule in der Remotesitzung.

In diesem Beispiel hat der Administrator des Computers den Modulermittlungs-WMI-Anbieter installiert, mit dem Sie CIM-Befehle verwenden können, die für den Anbieter entwickelt wurden.

Das Cmdlet New-CimSession erstellt eine Sitzung auf dem Remotecomputer mit dem Namen RSDGF03. Die Sitzung stellt eine Verbindung mit dem WMI-Dienst auf dem Remotecomputer bereit. Die CIM-Sitzung wird in der variablen $cs gespeichert. Import-Module verwendet die CimSession- in $cs, um das Storage CIM-Modul vom computer RSDGF03 zu importieren.

Das cmdlet Get-Command zeigt den befehl Get-Disk im modul Storage an. Wenn Sie ein CIM-Modul in die lokale Sitzung importieren, konvertiert PowerShell die CDXML-Dateien für jeden Befehl in PowerShell-Skripts, die als Funktionen in der lokalen Sitzung angezeigt werden.

Obwohl Get-Disk in die lokale Sitzung eingegeben wird, wird das Cmdlet implizit auf dem Remotecomputer ausgeführt, von dem es importiert wurde. Der Befehl gibt Objekte vom Remotecomputer an die lokale Sitzung zurück.

$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

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können einen Modulnamen an dieses Cmdlet weiterleiten.

Sie können ein Modulobjekt an dieses Cmdlet weiterleiten.

Sie können ein Assemblyobjekt an dieses Cmdlet weiterleiten.

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

Wenn Sie den PassThru--Parameter angeben, generiert das Cmdlet ein System.Management.Automation.PSModuleInfo-Objekt, das das importierte Modul darstellt.

Wenn Sie die AsCustomObject- und PassThru Parameter zusammen angeben, generiert das Cmdlet ein PSCustomObject-Objekt, das das Modul darstellt.

PowerShell enthält die folgenden Aliase für Import-Module:

• Alle Plattformen:

  • ipmo

• Bevor Sie ein Modul importieren können, muss das Modul auf Ihren lokalen Computer zugreifen und in die Umgebungsvariable PSModulePath eingeschlossen werden. Weitere Informationen finden Sie unter about_Modules.

  Sie können auch die parameter PSSession und CimSession verwenden, um Module zu importieren, die auf Remotecomputern installiert sind. Befehle, die die Cmdlets in diesen Modulen verwenden, werden jedoch in der Remotesitzung auf dem Remotecomputer ausgeführt.

• Wenn Sie Mitglieder mit demselben Namen und demselben Typ in Ihre Sitzung importieren, verwendet PowerShell standardmäßig das zuletzt importierte Element. Variablen und Aliase werden ersetzt, und auf die Originale kann nicht zugegriffen werden. Funktionen, Cmdlets und Anbieter werden lediglich von den neuen Membern schattiert. Auf sie kann zugegriffen werden, indem sie den Befehlsnamen mit dem Namen des Snap-Ins, Moduls oder Funktionspfads qualifizieren.

• Verwenden Sie das cmdlet Update-FormatData, um die Formatierungsdaten für Befehle zu aktualisieren, die aus einem Modul importiert wurden. Wenn sich die Formatierungsdatei für ein Modul ändert, verwenden Sie das Cmdlet Update-FormatData, um die Formatierungsdaten für importierte Befehle zu aktualisieren. Sie müssen das Modul nicht erneut importieren.

• Ab Windows PowerShell 3.0 werden die mit PowerShell installierten Kernbefehle in Modulen verpackt. In Windows PowerShell 2.0 und in Hostprogrammen, die ältere Sitzungen in späteren Versionen von PowerShell erstellen, werden die Kernbefehle in Snap-Ins (PSSnapins) verpackt. Die Ausnahme ist Microsoft.PowerShell.Core, die immer ein Snap-In ist. Außerdem sind Remotesitzungen, z. B. die vom Cmdlet New-PSSession gestarteten Sitzungen, ältere Sitzungen, die Kern-Snap-Ins enthalten.

  Informationen zur CreateDefault2--Methode, die neuere Sitzungen mit Kernmodulen erstellt, finden Sie in der CreateDefault2-Methode.

• In Windows PowerShell 2.0 wurden einige Eigenschaftswerte des Modulobjekts, z. B. die ExportCmdlets und NestedModules Eigenschaftswerte, erst aufgefüllt, nachdem das Modul importiert wurde.

• Wenn Sie versuchen, ein Modul zu importieren, das Assemblys mit gemischtem Modus enthält, die nicht mit Windows PowerShell 3.0+ kompatibel sind, gibt Import-Module eine Fehlermeldung wie die folgende zurück.

  Import-Module : Gemischte Modusassembly basiert auf Version 'v2.0.50727' der Laufzeit und kann nicht in der 4.0-Laufzeit ohne zusätzliche Konfigurationsinformationen geladen werden.

  Dieser Fehler tritt auf, wenn ein Modul, das für Windows PowerShell 2.0 entwickelt wurde, mindestens eine Gemischtmodulassembly enthält. Eine gemischte Modulassembly, die verwalteten und nicht verwalteten Code enthält, z. B. C++ und C#.

  Um ein Modul zu importieren, das Assemblys mit gemischtem Modus enthält, starten Sie Windows PowerShell 2.0 mit dem folgenden Befehl, und versuchen Sie dann den Befehl Import-Module erneut.

  powershell.exe -Version 2.0

• Um das CIM-Sitzungsfeature zu verwenden, muss der Remotecomputer über WS-Management Remoting und die Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) verfügen, was die Microsoft-Implementierung des Standards Common Information Model (CIM) ist. Der Computer muss auch über den WMI-Anbieter für Module Discovery oder einen alternativen CIM-Anbieter verfügen, der über die gleichen grundlegenden Features verfügt.

  Sie können das CIM-Sitzungsfeature auf Computern verwenden, auf denen kein Windows-Betriebssystem und auf Windows-Computern mit PowerShell ausgeführt werden, aber keine PowerShell-Remoting aktiviert ist.

  Sie können auch die CIM-Parameter verwenden, um CIM-Module von Computern abzurufen, auf denen PowerShell-Remoting aktiviert ist, einschließlich des lokalen Computers. Wenn Sie eine CIM-Sitzung auf dem lokalen Computer erstellen, verwendet PowerShell DCOM anstelle von WMI, um die Sitzung zu erstellen.

• Standardmäßig importiert Import-Module Module im globalen Bereich, auch wenn sie von einem untergeordneten Bereich aufgerufen werden. Der Bereich der obersten Ebene und alle untergeordneten Bereiche haben Zugriff auf die exportierten Elemente des Moduls.

  In einem untergeordneten Bereich schränkt -Scope Local den Import auf diesen Bereich und alle untergeordneten Bereiche ein. Übergeordnete Bereiche sehen dann die importierten Member nicht.

  Hinweis

  Get-Module zeigt alle Module an, die in der aktuellen Sitzung geladen wurden. Dies schließt Module ein, die lokal in einem untergeordneten Bereich geladen wurden. Verwenden Sie Get-Command -Module modulename, um zu sehen, welche Member im aktuellen Bereich geladen werden.

• Import-Module lädt keine Klassen- und Enumerationsdefinitionen im Modul. Verwenden Sie die using module-Anweisung am Anfang Ihres Skripts. Dadurch wird das Modul importiert, einschließlich der Klassen- und Enumerationsdefinitionen. Weitere Informationen finden Sie unter about_Using.

• Bei der Entwicklung eines Skriptmoduls ist es üblich, Änderungen am Code vorzunehmen und dann die neue Version des Moduls mithilfe von Import-Module mit dem Parameter "Force" zu laden. Dies funktioniert nur für Änderungen an Funktionen im Stammmodul. Import-Module lädt keine geschachtelten Module neu. Außerdem gibt es keine Möglichkeit, aktualisierte Klassen oder Enumerationen zu laden.

  Um aktualisierte Modulmmber zu erhalten, die in geschachtelten Modulen definiert sind, entfernen Sie das Modul mit Remove-Module, und importieren Sie das Modul erneut.

  Wenn das Modul mit einer using-Anweisung geladen wurde, müssen Sie eine neue Sitzung starten, um aktualisierte Definitionen für die Klassen und Enumerationen zu importieren. Klassen und Enumerationen, die in PowerShell definiert und mit einer using-Anweisung importiert wurden, können nicht entladen werden.