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에 보냅니다. 이 cmdlet은 사용자 지정 개체의 속성과 메서드를 표시합니다. 출력에는 개체에 Hello 및 Goodbye 함수를 나타내는 스크립트 메서드가 있다고 나와 있습니다.

네 번째 명령과 다섯 번째 명령은 스크립트 메서드 형식을 사용하여 Hello 및 Goodbye 함수를 호출합니다. 
 
여섯 번째 명령과 일곱 번째 명령은 함수 이름과 매개 변수 값을 지정하여 함수를 호출합니다.

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

Hello, World!

설명
-----------
이 명령은 ReturnResult 매개 변수를 사용하여 모듈 개체를 요청하는 대신 스크립트 블록의 실행 결과를 요청합니다. 

새 모듈의 스크립트 블록은 SayHello 함수를 정의한 다음 함수를 호출합니다.