Get-Module

Modul:
Microsoft.PowerShell.Core Module

Auflisten der in der aktuellen Sitzung importierten Module oder die aus psModulePath importiert werden können.

Syntax

Loaded (Standard) 

Get-Module
    [[-Name] <String[]>]
    [-FullyQualifiedName <ModuleSpecification[]>]
    [-All]
    [<CommonParameters>]

Available 

Get-Module
    [[-Name] <String[]>]
    [-FullyQualifiedName <ModuleSpecification[]>]
    [-All]
    [-ListAvailable]
    [-PSEdition <String>]
    [-SkipEditionCheck]
    [-Refresh]
    [<CommonParameters>]

PsSession 

Get-Module
    [[-Name] <String[]>]
    -PSSession <PSSession>
    [-FullyQualifiedName <ModuleSpecification[]>]
    [-ListAvailable]
    [-PSEdition <String>]
    [-SkipEditionCheck]
    [-Refresh]
    [<CommonParameters>]

CimSession 

Get-Module
    [[-Name] <String[]>]
    -CimSession <CimSession>
    [-FullyQualifiedName <ModuleSpecification[]>]
    [-ListAvailable]
    [-SkipEditionCheck]
    [-Refresh]
    [-CimResourceUri <Uri>]
    [-CimNamespace <String>]
    [<CommonParameters>]

Beschreibung

Das Get-Module Cmdlet listet die PowerShell-Module auf, die in eine PowerShell-Sitzung importiert oder importiert werden können. Ohne Parameter werden Module abgerufen, Get-Module die in die aktuelle Sitzung importiert wurden. Der Parameter ListAvailable wird verwendet, um die Module auflisten, die aus den pfaden importiert werden können, die in der PSModulePath-Umgebungsvariable ($Env:PSModulePath) angegeben sind.

Das zurückgegebene Modulobjekt Get-Module enthält wertvolle Informationen zum Modul. Sie können die Modulobjekte auch an andere Cmdlets weiterleiten, z. B. an die Import-Module Cmdlets und Remove-Module die Cmdlets.

Get-Module listet Module auf, importiert sie jedoch nicht. Ab Windows PowerShell 3.0 werden Module automatisch importiert, wenn Sie einen Befehl im Modul verwenden, aber ein befehl Get-Module löst keinen automatischen Import aus. Sie können die Module auch mithilfe des Import-Module Cmdlets in Ihre Sitzung importieren.

Ab Windows PowerShell 3.0 können Sie Module aus Remotesitzungen in die lokale Sitzung abrufen und importieren. Diese Strategie verwendet das Feature "Implizites Remoting" von PowerShell und entspricht der Verwendung des Import-PSSession Cmdlets. Wenn Sie Befehle in Modulen verwenden, die aus einer anderen Sitzung importiert wurden, werden die Befehle implizit in der Remotesitzung ausgeführt. Mit diesem Feature können Sie den Remotecomputer über die lokale Sitzung verwalten.

Ab Windows PowerShell 3.0 können Sie außerdem Get-Module und Import-Module verwenden, um Common Information Model (CIM)-Module abzurufen und 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.

Implizites Remoting kann zum Verwalten von Remotecomputern verwendet werden, auf denen PowerShell-Remoting aktiviert ist. Erstellen Sie eine PSSession auf dem Remotecomputer, und verwenden Sie dann den PSSession-ParameterGet-Module, um die PowerShell-Module in der Remotesitzung abzurufen. Wenn Sie ein Modul aus der Remotesitzung importieren, werden die importierten Befehle in der Sitzung auf dem Remotecomputer ausgeführt.

Sie können eine ähnliche Strategie verwenden, um Computer zu verwalten, die keine PowerShell-Remoting aktiviert haben. Dazu gehören Computer, auf denen das Windows Betriebssystem nicht ausgeführt wird, und Computer, auf denen PowerShell ausgeführt wird, aber keine PowerShell-Remoting aktiviert ist.

Erstellen Sie zunächst eine CIM-Sitzung auf dem Remotecomputer. Eine CIM-Sitzung ist eine Verbindung mit Windows Management Instrumentation (WMI) auf dem Remotecomputer. Verwenden Sie dann den CimSession-Parameter , Get-Module um CIM-Module aus der CIM-Sitzung abzurufen. Wenn Sie ein CIM-Modul mithilfe des Import-Module Cmdlets importieren und dann die importierten Befehle ausführen, werden die Befehle implizit auf dem Remotecomputer ausgeführt. Sie können diese WMI- und CIM-Strategie verwenden, um den Remotecomputer zu verwalten.

Beispiele

Beispiel 1: Importieren von Modulen in die aktuelle Sitzung

Get-Module

Dieser Befehl ruft Module ab, die in die aktuelle Sitzung importiert wurden.

Beispiel 2: Abrufen von installierten Modulen und verfügbaren Modulen

Get-Module -ListAvailable

Dieser Befehl ruft die Module ab, die auf dem Computer installiert sind und in die aktuelle Sitzung importiert werden können.

Get-Module Sucht nach verfügbaren Modulen im Pfad, der durch die Umgebungsvariable $Env:PSModulePath angegeben wird. Weitere Informationen zu PSModulePath finden Sie unter about_Modules und about_Environment_Variables.

Beispiel 3: Abrufen aller exportierten Dateien

Get-Module -ListAvailable -All

Dieser Befehl ruft alle exportierten Dateien für alle verfügbaren Module ab.

Beispiel 4: Abrufen eines Moduls anhand seines vollqualifizierten Namens

$FullyQualifiedName = @{ModuleName="Microsoft.PowerShell.Management";ModuleVersion="3.1.0.0"}
Get-Module -FullyQualifiedName $FullyQualifiedName | Format-Table -Property Name,Version

Name                             Version
----                             -------
Microsoft.PowerShell.Management  3.1.0.0

In diesem Beispiel wird die Microsoft ab. PowerShell.Management Modul durch Angeben des vollqualifizierten Namens des Moduls mithilfe des Parameters FullyQualifiedName. Der Befehl leitet dann die Ergebnisse in das Format-Table Cmdlet, um die Ergebnisse als Tabelle mit Name und Version als Spaltenüberschriften zu formatieren.

In einem vollqualifizierten Namen für ein Modul fungiert der Wert ModuleVersion als Mindestversion. In diesem Beispiel entspricht es also allen Microsoft. PowerShell.Management Modul, das Version 3.1.0.0 oder höher ist.

Beispiel 5: Abrufen von Eigenschaften eines Moduls

Get-Module | Get-Member -MemberType Property | Format-Table Name

Name
----
AccessMode
Author
ClrVersion
CompanyName
Copyright
Definition
Description
DotNetFrameworkVersion
ExportedAliases
ExportedCmdlets
ExportedCommands
ExportedFormatFiles
ExportedFunctions
ExportedTypeFiles
ExportedVariables
ExportedWorkflows
FileList
Guid
HelpInfoUri
LogPipelineExecutionDetails
ModuleBase
ModuleList
ModuleType
Name
NestedModules
OnRemove
Path
PowerShellHostName
PowerShellHostVersion
PowerShellVersion
PrivateData
ProcessorArchitecture
RequiredAssemblies
RequiredModules
RootModule
Scripts
SessionState
Version

Dieser Befehl ruft die Eigenschaften des zurückgegebenen PSModuleInfo-ObjektsGet-Module ab. Es gibt ein Objekt für jede Moduldatei.

Sie können die Eigenschaften verwenden, um die Modulobjekte zu formatieren und zu filtern. Weitere Informationen zu den Eigenschaften finden Sie unter PSModuleInfo-Eigenschaften.

Die Ausgabe enthält die neuen Eigenschaften wie Author und CompanyName, die in Windows PowerShell 3.0 eingeführt wurden.

Beispiel 6: Gruppieren aller Module nach Name

Get-Module -ListAvailable -All | Format-Table -Property Name, ModuleType, Path -GroupBy Name

Name: AppLocker

Name      ModuleType Path
----      ---------- ----
AppLocker   Manifest C:\Windows\system32\WindowsPowerShell\v1.0\Modules\AppLocker\AppLocker.psd1


   Name: Appx

Name ModuleType Path
---- ---------- ----
Appx   Manifest C:\Windows\system32\WindowsPowerShell\v1.0\Modules\Appx\en-US\Appx.psd1
Appx   Manifest C:\Windows\system32\WindowsPowerShell\v1.0\Modules\Appx\Appx.psd1
Appx     Script C:\Windows\system32\WindowsPowerShell\v1.0\Modules\Appx\Appx.psm1


   Name: BestPractices

Name          ModuleType Path
----          ---------- ----
BestPractices   Manifest C:\Windows\system32\WindowsPowerShell\v1.0\Modules\BestPractices\BestPractices.psd1


   Name: BitsTransfer

Name         ModuleType Path
----         ---------- ----
BitsTransfer   Manifest C:\Windows\system32\WindowsPowerShell\v1.0\Modules\BitsTransfer\BitsTransfer.psd1

Dieser Befehl ruft alle Moduldateien ab, sowohl importiert als auch verfügbar, und gruppiert sie dann nach Modulname. Auf diese Weise können Sie die Moduldateien sehen, die jedes Skript exportiert.

Beispiel 7: Anzeigen des Inhalts eines Modulmanifests

Diese Befehle zeigen den Inhalt des Modulmanifests für das Windows PowerShell BitsTransfer Modul an.

Module müssen nicht über Manifestdateien verfügen. Wenn sie über eine Manifestdatei verfügen, ist die Manifestdatei nur erforderlich, um eine Versionsnummer einzuschließen. Manifestdateien stellen jedoch häufig nützliche Informationen zu einem Modul, seinen Anforderungen und seinem Inhalt bereit.

# First command
$m = Get-Module -List -Name BitsTransfer

# Second command
Get-Content $m.Path

@ {
    GUID               = "{8FA5064B-8479-4c5c-86EA-0D311FE48875}"
    Author             = "Microsoft Corporation"
    CompanyName        = "Microsoft Corporation"
    Copyright          = "Microsoft Corporation. All rights reserved."
    ModuleVersion      = "1.0.0.0"
    Description        = "Windows PowerShell File Transfer Module"
    PowerShellVersion  = "2.0"
    CLRVersion         = "2.0"
    NestedModules      = "Microsoft.BackgroundIntelligentTransfer.Management"
    FormatsToProcess   = "FileTransfer.Format.ps1xml"
    RequiredAssemblies = Join-Path $PSScriptRoot "Microsoft.BackgroundIntelligentTransfer.Management.Interop.dll"
}

Der erste Befehl ruft das PSModuleInfo -Objekt ab, das BitsTransfer-Modul darstellt. Das Objekt wird in der $m Variablen gespeichert.

Der zweite Befehl verwendet das Get-Content Cmdlet, um den Inhalt der Manifestdatei im angegebenen Pfad abzurufen. Es verwendet punktierte Schreibweise, um den Pfad zur Manifestdatei abzurufen, die in der Path-Eigenschaft des Objekts gespeichert ist. Die Ausgabe zeigt den Inhalt des Modulmanifests an.

Beispiel 8: Auflisten von Dateien im Modulverzeichnis

dir (Get-Module -ListAvailable FileTransfer).ModuleBase

Directory: C:\Windows\system32\WindowsPowerShell\v1.0\Modules\FileTransfer
Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----        12/16/2008  12:36 PM            en-US
-a---        11/19/2008  11:30 PM      16184 FileTransfer.Format.ps1xml
-a---        11/20/2008  11:30 PM       1044 FileTransfer.psd1
-a---        12/16/2008  12:20 AM     108544 Microsoft.BackgroundIntelligentTransfer.Management.Interop.dll

Dieser Befehl listet die Dateien im Verzeichnis des Moduls auf. Dies ist eine weitere Möglichkeit, um zu bestimmen, was sich in einem Modul befindet, bevor Sie es importieren. Einige Module verfügen möglicherweise über Hilfedateien oder ReadMe-Dateien, die das Modul beschreiben.

Beispiel 9: Installieren von Modulen auf einem Computer

$s = New-PSSession -ComputerName Server01

Get-Module -PSSession $s -ListAvailable

Mit diesen Befehlen werden die Module abgerufen, die auf dem Server01-Computer installiert sind.

Der erste Befehl verwendet das New-PSSession Cmdlet zum Erstellen einer PSSession auf dem Server01-Computer. Der Befehl speichert die PSSession in der $s Variablen.

Der zweite Befehl verwendet die Parameter "PSSession " und " ListAvailable " Get-Module , um die Module in der PSSession in der $s Variablen abzurufen.

Wenn Sie Module aus anderen Sitzungen an das Import-Module Cmdlet weiterleiten, Import-Module importiert das Modul mithilfe des impliziten Remotingfeatures in die aktuelle Sitzung. Dies entspricht der Verwendung des Import-PSSession Cmdlets. Sie können die Cmdlets aus dem Modul in der aktuellen Sitzung verwenden, aber Befehle, die diese Cmdlets verwenden, führen tatsächlich die Remotesitzung aus. Weitere Informationen finden Sie unter Import-Module und Import-PSSession.

Beispiel 10: Verwalten eines Computers, auf dem das Windows Betriebssystem nicht ausgeführt wird

Mit den Befehlen in diesem Beispiel können Sie die Speichersysteme eines Remotecomputers verwalten, auf dem das Windows Betriebssystem nicht ausgeführt wird. Da in diesem Beispiel der Administrator des Computers den Modulermittlungs-WMI-Anbieter installiert hat, können die CIM-Befehle die Standardwerte verwenden, die für den Anbieter entwickelt wurden.

$cs = New-CimSession -ComputerName RSDGF03
Get-Module -CimSession $cs -Name Storage | Import-Module
Get-Command Get-Disk

CommandType     Name                  ModuleName
-----------     ----                  ----------
Function        Get-Disk              Storage

Get-Disk

Number Friendly Name              OperationalStatus          Total Size Partition Style
------ -------------              -----------------          ---------- ---------------
0      Virtual HD ATA Device      Online                          40 GB MBR

Der erste Befehl verwendet das New-CimSession Cmdlet, um eine Sitzung auf dem RSDGF03 Remotecomputer zu erstellen. Die Sitzung stellt eine Verbindung mit WMI auf dem Remotecomputer hergestellt. Der Befehl speichert die CIM-Sitzung in der $cs Variablen.

Der zweite Befehl verwendet die CIM-Sitzung in der $cs Variablen, um einen Get-Module Befehl auf dem RSDGF03 Computer auszuführen. Der Befehl verwendet den Parameter Name , um das Speichermodul anzugeben. Der Befehl verwendet einen Pipelineoperator (|), um das Speichermodul an das Import-Module Cmdlet zu senden, das es in die lokale Sitzung importiert.

Der dritte Befehl führt das Get-Command Cmdlet im Get-Disk Befehl im Speichermodul aus. Wenn Sie ein CIM-Modul in die lokale Sitzung importieren, konvertiert PowerShell die CDXML-Dateien, die das CIM-Modul darstellen, in PowerShell-Skripts, die als Funktionen in der lokalen Sitzung angezeigt werden.

Der vierte Befehl führt den Get-Disk Befehl aus. Obwohl der Befehl in die lokale Sitzung eingegeben wird, wird er implizit auf dem Remotecomputer ausgeführt, von dem er importiert wurde. Der Befehl ruft Objekte vom Remotecomputer ab und gibt sie an die lokale Sitzung zurück.

Parameter

-All

Gibt an, dass dieses Cmdlet alle Module in jedem Modulordner abruft, einschließlich geschachtelter Module, Manifestdateien (.psd1) Dateien, Skriptmoduldateien (.psm1) und Binärmoduldateien (.dll). Ohne diesen Parameter Get-Module wird nur das Standardmodul in jedem Modulordner abgerufen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Loaded
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Available
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CimNamespace

Gibt den Namespace eines alternativen CIM-Anbieters an, der CIM-Module verfügbar macht. Der Standardwert ist der Namespace des WMI-Anbieters für Modulermittlung.

Verwenden Sie diesen Parameter, um CIM-Module von Computern und Geräten abzurufen, auf denen das Windows Betriebssystem nicht ausgeführt wird.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

CimSession
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CimResourceUri

Gibt einen alternativen Speicherort für CIM-Module an. Der Standardwert ist der Ressourcen-URI des WMI-Anbieters der Modulermittlung auf dem Remotecomputer.

Verwenden Sie diesen Parameter, um CIM-Module von Computern und Geräten abzurufen, auf denen das Windows Betriebssystem nicht ausgeführt wird.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Typ:Uri
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

CimSession
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CimSession

Gibt eine CIM-Sitzung auf dem Remotecomputer an. Geben Sie eine Variable ein, die die CIM-Sitzung oder einen Befehl enthält, der die CIM-Sitzung abruft, z. B. einen Get-CimSession-Befehl .

Get-Module verwendet die CIM-Sitzungsverbindung, um Module vom Remotecomputer abzurufen. Wenn Sie das Modul mithilfe des Import-Module Cmdlets importieren und die Befehle aus dem importierten Modul in der aktuellen Sitzung verwenden, werden die Befehle tatsächlich auf dem Remotecomputer ausgeführt.

Sie können diesen Parameter verwenden, um Module von Computern und Geräten abzurufen, die das Windows Betriebssystem nicht ausführen, und Computer mit PowerShell, aber keine PowerShell-Remoting aktiviert haben.

Der CimSession-Parameter ruft alle Module in der CIMSession ab. Sie können jedoch nur CIM-basierte und Cmdlet Definition XML (CDXML)-basierte Module importieren.

Parametereigenschaften

Typ:CimSession
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

CimSession
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FullyQualifiedName

Der Wert kann ein Modulname, eine vollständige Modulspezifikation oder ein Pfad zu einer Moduldatei sein.

Wenn der Wert ein Pfad ist, kann der Pfad vollqualifizierte oder relativ sein. Ein relativer Pfad wird relativ zum Skript aufgelöst, das die using-Anweisung enthält.

Wenn es sich bei dem Wert um einen Namen oder eine Modulspezifikation handelt, durchsucht PowerShell den PSModulePath nach dem angegebenen Modul.

Eine Modulspezifikation ist eine Hashtabelle mit den folgenden Schlüsseln.

  • ModuleName - Erforderlich . Gibt den Modulnamen an.
  • GUID - Optional Gibt die GUID des Moduls an.
  • Es ist auch erforderlich , mindestens eine der drei folgenden Tasten anzugeben.
    • ModuleVersion - Gibt eine mindestens akzeptable Version des Moduls an.
    • MaximumVersion - Gibt die maximal zulässige Version des Moduls an.
    • RequiredVersion - Gibt eine genaue, erforderliche Version des Moduls an. Dies kann nicht mit den anderen Versionsschlüsseln verwendet werden.

Sie können den Parameter "FullyQualifiedName" nicht im selben Befehl wie einen Name-Parameter angeben.

Parametereigenschaften

Typ:

ModuleSpecification[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ListAvailable

Gibt standardmäßig nur die Module zurück, Get-Module die in die aktuelle Sitzung importiert wurden. Mit diesem Parameter listet der Befehl Module auf, die in einem beliebigen Pfad in der $env:PSModulePath Umgebungsvariable enthalten sind.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Available
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
PsSession
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
CimSession
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt Namen oder Namensmuster von Modulen an, die dieses Cmdlet abruft. Platzhalterzeichen sind zulässig. Sie können die Namen auch an Get-Module. Sie können den Parameter "FullyQualifiedName" nicht im selben Befehl wie einen Name-Parameter angeben.

Name kann keine Modul-GUID als Wert akzeptieren. Um Module zurückzugeben, indem Sie eine GUID angeben, verwenden Sie stattdessen FullyQualifiedName .

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PSEdition

Ruft die Module ab, die die angegebene Edition von PowerShell unterstützen.

Die zulässigen Werte für diesen Parameter sind:

  • Desktop
  • Core

Das Get-Module Cmdlet überprüft die CompatiblePSEditions-Eigenschaft des PSModuleInfo-Objekts auf den angegebenen Wert und gibt nur die Module zurück, die sie festgelegt haben.

Note

  • Desktop Edition: Basiert auf .NET Framework und bietet Kompatibilität mit Skripts und Modulen für Versionen von PowerShell, die auf vollständigen Fußabdruckeditionen von Windows wie Server Core und Windows Desktop ausgeführt werden.
  • Core Edition: Basiert auf .NET Core und bietet Kompatibilität mit Skripts und Modulen für Versionen von PowerShell, die auf reduzierten Speicherbedarfseditionen von Windows wie Nano Server und Windows IoT ausgeführt werden.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PsSession
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Available
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PSSession

Ruft die Module in der angegebenen vom Benutzer verwalteten PowerShell-Sitzung (PSSession) ab. Geben Sie eine Variable ein, die die Sitzung enthält, einen Befehl, der die Sitzung abruft, z. B. einen Get-PSSession Befehl oder einen Befehl, der die Sitzung erstellt, z. B. einen New-PSSession Befehl.

Wenn die Sitzung mit einem Remotecomputer verbunden ist, müssen Sie den Parameter ListAvailable angeben.

Ein Get-Module Befehl, der den PSSession-Parameter verwendet, entspricht der Verwendung des Invoke-Command Cmdlets zum Ausführen eines Get-Module -ListAvailable Befehls in einer PSSession.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Typ:PSSession
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PsSession
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Refresh

Gibt an, dass dieses Cmdlet den Cache der installierten Befehle aktualisiert. Der Befehlscache wird erstellt, wenn die Sitzung gestartet wird. Das Cmdlet ermöglicht Get-Command das Abrufen von Befehlen aus Modulen, die nicht in die Sitzung importiert werden.

Dieser Parameter wurde für Entwicklungs- und Testszenarien entwickelt, in denen sich der Inhalt von Modulen seit beginn der Sitzung geändert hat.

Wenn Sie den Refresh-Parameter in einem Befehl angeben, müssen Sie ListAvailable angeben.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Available
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
PsSession
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
CimSession
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SkipEditionCheck

Überspringt die Überprüfung des Felds "CompatiblePSEditions ".

Lässt standardmäßig Module im %windir%\System32\WindowsPowerShell\v1.0\Modules Verzeichnis aus, Get-Module die nicht im Feld "CompatiblePSEditions" angegeben Core sind. Wenn dieser Switch festgelegt ist, sind Module ohne Core enthalten, sodass Module unter dem Windows PowerShell-Modulpfad, die mit PowerShell v6 und höher nicht kompatibel sind, zurückgegeben werden.

Unter macOS und Linux führt dieser Parameter nichts aus.

Weitere Informationen finden Sie unter about_PowerShell_Editions .

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Available
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
PsSession
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
CimSession
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

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.

Eingaben

String

Sie können Modulnamen an dieses Cmdlet weiterleiten.

Ausgaben

PSModuleInfo

Dieses Cmdlet gibt Objekte zurück, die Module darstellen. Wenn Sie den ListAvailable-Parameter angeben, Get-Module wird ein ModuleInfoGrouping-Objekt zurückgegeben, bei dem es sich um einen Typ von PSModuleInfo-Objekt handelt, das die gleichen Eigenschaften und Methoden aufweist.

Hinweise

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

  • Alle Plattformen:

    • gmo

  • Ab Windows PowerShell 3.0 werden die Kernbefehle, die in PowerShell enthalten sind, in Module verpackt. Die Ausnahme ist Microsoft. PowerShell.Core, ein Snap-In (PSSnapin). Standardmäßig nur die Microsoft. PowerShell.Core Snap-In wird der Sitzung hinzugefügt. Module werden bei der ersten Verwendung automatisch importiert, und Sie können das Import-Module Cmdlet verwenden, um sie zu importieren.

  • 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 gestarteten New-PSSession Sitzungen, ältere Sitzungen, die Kern-Snap-Ins enthalten.

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

  • Get-Module ruft nur Module an Speicherorten ab, die im Wert der PSModulePath-Umgebungsvariable ($Env:PSModulePath) gespeichert sind. Das Import-Module Cmdlet kann Module an anderen Speicherorten importieren, aber Sie können das Get-Module Cmdlet nicht verwenden, um sie abzurufen.

  • Ab PowerShell 3.0 wurden dem Objekt neue Eigenschaften hinzugefügt, die Get-Module das Erlernen von Modulen erleichtern, bevor sie importiert werden. Alle Eigenschaften werden vor dem Importieren aufgefüllt. Dazu gehören die Eigenschaften "ExportedCommands", " ExportsCmdlets " und "ExportedFunctions ", die die Befehle auflisten, die das Modul exportiert.

  • Der Parameter ListAvailable ruft nur wohlgeformte Module ab, d. h. Ordner, die mindestens eine Datei enthalten, deren Basisname dem Namen des Modulordners entspricht. Der Basisname ist der Name ohne dateinamenerweiterung. Ordner, die Dateien mit unterschiedlichen Namen enthalten, gelten als Container, aber nicht als Module.

    Um Module abzurufen, die als DLL-Dateien implementiert werden, aber nicht in einen Modulordner eingeschlossen sind, geben Sie sowohl die Parameter ListAvailable als auch alle Parameter an.

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

    Sie können das CIM-Sitzungsfeature auf Computern verwenden, auf denen das Windows Betriebssystem nicht ausgeführt wird, und auf Windows Computern mit PowerShell, 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. Dies schließt den lokalen Computer ein. Wenn Sie eine CIM-Sitzung auf dem lokalen Computer erstellen, verwendet PowerShell DCOM anstelle von WMI, um die Sitzung zu erstellen.