New-Module

New-Module [-Name] <string> [-ScriptBlock] <scriptblock> [-ArgumentList <Object[]>] [-AsCustomObject] [-Cmdlet <string[]>] [-Function <string[]>] [-ReturnResult] [<CommonParameters>]

New-Module [-ScriptBlock] <scriptblock> [-ArgumentList <Object[]>] [-AsCustomObject] [-Cmdlet <string[]>] [-Function <string[]>] [-ReturnResult] [<CommonParameters>]

C:\PS>new-module -scriptblock {function Hello {"Hello!"}}

Name              : __DynamicModule_2ceb1d0a-990f-45e4-9fe4-89f0f6ead0e5
Path              : 2ceb1d0a-990f-45e4-9fe4-89f0f6ead0e5
Description       :
Guid              : 00000000-0000-0000-0000-000000000000
Version           : 0.0
ModuleBase        :
ModuleType        : Script
PrivateData       :
AccessMode        : ReadWrite
ExportedAliases   : {}
ExportedCmdlets   : {}
ExportedFunctions : {[Hello, Hello]}
ExportedVariables : {}
NestedModules     : {}

Beschreibung
-----------
Dieser Befehl erstellt ein neues dynamisches Modul mit der Funktion "Hallo". Der Befehl gibt ein Modulobjekt zurück, das das neue dynamische Modul darstellt.

C:\PS>new-module -scriptblock {function Hello {"Hello!"}}

Name              : __DynamicModule_2ceb1d0a-990f-45e4-9fe4-89f0f6ead0e5
Path              : 2ceb1d0a-990f-45e4-9fe4-89f0f6ead0e5
Description       :
Guid              : 00000000-0000-0000-0000-000000000000
Version           : 0.0
ModuleBase        :
ModuleType        : Script
PrivateData       :
AccessMode        : ReadWrite
ExportedAliases   : {}
ExportedCmdlets   : {}
ExportedFunctions : {[Hello, Hello]}
ExportedVariables : {}
NestedModules     : {}

C:\PS> get-module
C:\PS>

C:\PS> get-command Hello

CommandType     Name   Definition
-----------     ----   ----------
Function        Hello  "Hello!"

Beschreibung
-----------
In diesem Beispiel wird gezeigt, dass dynamische Module nicht vom Cmdlet "Get-Module" zurückgegeben werden. Stattdessen werden die von ihnen exportierten Elemente vom Cmdlet "Get-Command" zurückgegeben.

C:\PS>New-Module -scriptblock {$SayHelloHelp="Type 'SayHello', a space, and a name."; function SayHello ($name) { "Hello, $name" }; Export-ModuleMember -function SayHello -Variable SayHelloHelp}

C:\PS> $SayHelloHelp
Type 'SayHello', a space, and a name.

C:\PS> SayHello Jeffrey
Hello, Jeffrey

Beschreibung
-----------
In diesem Befehl wird eine Variable mit dem Cmdlet "Export-ModuleMember" in die aktuelle Sitzung exportiert. Ohne den Befehl "Export-ModuleMember" wird nur die Funktion exportiert.

Die Ausgabe zeigt an, dass sowohl die Variable als auch die Funktion in die Sitzung exportiert wurden.

C:\PS>new-module -scriptblock {function Hello {"Hello!"}} -name GreetingModule | import-module

C:\PS> get-module


Name              : GreetingModule
Path              : d54dfdac-4531-4db2-9dec-0b4b9c57a1e5
Description       :
Guid              : 00000000-0000-0000-0000-000000000000
Version           : 0.0
ModuleBase        :
ModuleType        : Script
PrivateData       :
AccessMode        : ReadWrite
ExportedAliases   : {}
ExportedCmdlets   : {}
ExportedFunctions : {[Hello, Hello]}
ExportedVariables : {}
NestedModules     : {}


C:\PS> get-command hello

CommandType     Name                                                               Definition
-----------     ----                                                               ----------
Function        Hello                                                              "Hello!"

Beschreibung
-----------
Dieser Befehl zeigt, dass ein dynamisches Modul durch Übergeben des Moduls über die Pipeline an das Cmdlet "Import-Module" für das Cmdlet "Get-Module" verfügbar gemacht werden kann.

Mit dem ersten Befehl wird das Modulobjekt, das von "New-Module" generiert wird, mit einem Pipelineoperator (|) an das Cmdlet "Import-Module" übergeben. Mit dem Name-Parameter von New-Module wird dem Modul im Befehl ein Anzeigename zugewiesen. Da von Import-Module standardmäßig keine Objekte zurückgegeben werden, wird von diesem Befehl keine Ausgabe generiert.

Im zweiten Befehl werden die Module in der Sitzung mit dem Cmdlet "Get-Module" abgerufen. Das Ergebnis zeigt an, dass die neuen dynamischen Module mit Get-Module abgerufen werden können.

Im dritten Befehl wird die Funktion "Hello", die vom dynamischen Modul exportiert wird, mit dem Cmdlet "Get-Command" abgerufen.

C:\PS>$m = new-module -scriptblock {function Hello ($name) {"Hello, $name"}; function Goodbye ($name) {"Goodbye, $name"}} -AsCustomObject

C:\PS> $m

C:\PS> $m | 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()
Goodbye     ScriptMethod System.Object Goodbye();
Hello       ScriptMethod System.Object Hello();

PS C:\ps-test> $m.goodbye("Jane")
Goodbye, Jane

PS C:\ps-test> $m.hello("Manoj")
Hello, Manoj

PS C:\ps-test> goodbye Jane
Goodbye, Jane

PS C:\ps-test> hello Manoj
Hello, Manoj

Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie mit dem AsCustomObject-Parameter von New-Module ein benutzerdefiniertes Objekt mit Skriptmethoden generiert wird, die die exportierten Funktionen darstellen.

Im ersten Befehl wird mit dem Cmdlet "New-Module" ein dynamisches Modul mit den Funktionen "Hello" und "Goodbye" generiert. Mit dem AsCustomObject-Parameter wird von dem Befehl ein benutzerdefiniertes Objekt anstelle des PSModuleInfo-Objekts generiert, das standardmäßig von New-Module generiert wird. Das benutzerdefinierte Objekt wird vom Befehl in der Variablen "$m" gespeichert.

Im zweiten Befehl wird versucht, den Wert der Variablen "$m" anzuzeigen. Es wird kein Inhalt angezeigt.

Im dritten Befehl wird das benutzerdefinierte Objekt mit einem Pipelineoperator (|) an das Cmdlet "Get-Member" gesendet, das die Eigenschaften und Methoden des benutzerdefinierten Objekts anzeigt. Die Ausgabe zeigt, dass das Objekt über zwei Skriptmethoden verfügt, die die Funktionen "Hello" und "Goodbye" darstellen.

Im vierten und fünften Befehl werden mit dem Skriptmethodenformat die Funktionen "Hello" und "Goodbye" aufgerufen. 
 
Mit dem sechsten und siebten Befehl werden die Funktionen anhand des Funktionsnamens und des Parameterwerts aufgerufen.

C:\PS>new-module -scriptblock {function SayHello {"Hello, World!"}; SayHello} -returnResult

Hello, World!

Beschreibung
-----------
Dieser Befehl verwendet den ReturnResult-Parameter, um die Ergebnisse der Skriptblockausführung anstelle eines Modulobjekts anzufordern. 

Durch den Skriptblock im neuen Modul wird die SayHello-Funktion definiert und dann die Funktion aufgerufen.