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     : {}

说明
-----------
此命令使用名为“Hello”的函数创建一个新的动态模块。此命令返回一个表示该新动态模块的模块对象。

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!"

说明
-----------
此示例演示动态模块不是由 Get-Module cmdlet 返回的，但它们导出的成员是由 Get-Command cmdlet 返回的。

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

说明
-----------
此命令使用 Export-ModuleMember cmdlet 将一个变量导出到当前会话中。如果不使用 Export-ModuleMember 命令，则仅导出函数。

输出显示出变量和函数均导出到会话中。

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!"

说明
-----------
此命令演示您可以通过将动态模块通过管道传送到 Import-Module cmdlet，使该动态模块可用于 Get-Module cmdlet。

第一个命令使用管道运算符 (|) 将 New-Module 生成的模块对象发送到 Import-Module cmdlet。该命令使用 New-Module 的 Name 参数为模块分配一个友好名称。由于 Import-Module 默认情况下不返回任何对象，因此该命令没有输出。

第二个命令使用 Get-Module cmdlet 获取会话中的模块。结果显示出 Get-Module 可以获取新动态模块。

第三个命令使用 Get-Command cmdlet 获取动态模块导出的 Hello 函数。

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

说明
-----------
此示例说明如何使用 New-Module 的 AsCustomObject 参数生成一个自定义对象，该对象带有表示导出的函数的脚本方法。

第一个命令使用 New-Module cmdlet 生成一个动态模块，该模块带有两个函数 Hello 和 Goodbye。此命令使用 AsCustomObject 参数生成自定义对象，而不是 New-Module 默认生成的 PSModuleInfo 对象。它将该自定义对象保存在 $m 变量中。

第二个命令尝试显示 $m 变量的值。未显示任何内容。

第三个命令使用管道运算符 (|) 将该自定义对象发送到 Get-Member cmdlet，后者显示该自定义对象中的属性和方法。输出显示出该对象具有表示 Hello 和 Goodbye 函数的脚本方法。

第四个和第五个命令使用该脚本方法格式调用 Hello 和 Goodbye 函数。
 
第六个和第七个命令通过指定函数名和参数值来调用这些函数。

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

Hello, World!

说明
-----------
此命令使用 ReturnResult 参数请求运行脚本块的结果，而不是请求模块对象。

新模块中的脚本块定义 SayHello 函数，然后调用该函数。