New-Module

구문

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

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

Description

cmdlet은 New-Module 스크립트 블록에서 동적 모듈을 만듭니다. 함수 및 변수와 같은 동적 모듈의 멤버는 세션에서 즉시 사용할 수 있으며 세션을 닫을 때까지 계속 사용할 수 있습니다.

정적 모듈과 마찬가지로 동적 모듈의 cmdlet과 함수는 기본적으로 내보내고 변수와 별칭은 내보내지 않습니다. 그러나 Export-ModuleMember cmdlet 및 매개 변수를 사용하여 기본값을 재정의 New-Module 할 수 있습니다.

AsCustomObject 매개 변수 New-Module 를 사용하여 동적 모듈을 사용자 지정 개체로 반환할 수도 있습니다. 함수와 같은 모듈의 멤버는 세션으로 가져오는 대신 사용자 지정 개체의 스크립트 메서드로 구현됩니다.

동적 모듈은 디스크가 아닌 메모리에만 존재합니다. 모든 모듈과 마찬가지로 동적 모듈의 멤버는 전역 범위의 자식인 프라이빗 모듈 범위에서 실행됩니다. Get-Module은 동적 모듈을 가져올 수 없지만 Get-Command는 내보낸 멤버를 가져올 수 있습니다.

동적 모듈을 Get-Module사용할 수 있도록 하려면 명령을 Import-Module로 파이프 New-Module 하거나 반환되는 New-Module 모듈 개체를 파이프합니다 Import-Module. 이 작업은 동적 모듈을 Get-Module 목록에 추가하지만 모듈을 디스크에 저장하거나 영구적으로 만들지는 않습니다.

예제

예제 1: 동적 모듈 만들기

이 예제에서는 함수가 호출 Hello된 새 동적 모듈을 만듭니다. 이 명령은 새 동적 모듈을 나타내는 모듈 개체를 반환합니다.

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

예제 2: 동적 모듈 및 Get-Module 및 Get-Command 작업

이 예제에서는 동적 모듈이 cmdlet에서 반환되지 않음을 Get-Module 보여 줍니다. 내보내는 멤버는 cmdlet에서 Get-Command 반환됩니다.

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

Get-Module

Get-Command Hello

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

예제 3: 현재 세션으로 변수 내보내기

이 예제에서는 cmdlet을 Export-ModuleMember 사용하여 변수를 현재 세션으로 내보냅니다. 명령이 Export-ModuleMember 없으면 함수만 내보냅니다.

New-Module -ScriptBlock {$SayHelloHelp="Type 'SayHello', a space, and a name."; function SayHello ($name) { "Hello, $name" }; Export-ModuleMember -function SayHello -Variable SayHelloHelp}
$SayHelloHelp

Type 'SayHello', a space, and a name.

SayHello Jeffrey

Hello, Jeffrey

출력은 변수와 함수를 모두 세션으로 내보낸 것을 보여줍니다.

예제 4: Get-Module에서 동적 모듈을 사용할 수 있도록 설정

이 예제에서는 동적 모듈을 파이핑하여 동적 모듈Import-Module을 Get-Module 사용할 수 있도록 할 수 있음을 보여 줍니다.

New-Module 는 cmdlet에 파이프되는 모듈 개체를 Import-Module 만듭니다. Name New-Module 매개 변수는 모듈에 친숙한 이름을 할당합니다. Import-Module 기본적으로 개체를 반환하지 않으므로 이 명령의 출력은 없습니다. Get-ModuleGreetingModule을 현재 세션으로 가져왔습니다.

New-Module -ScriptBlock {function Hello {"Hello!"}} -name GreetingModule | Import-Module
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     : {}

Get-Command hello

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

cmdlet은 Get-Command 동적 모듈이 내보내는 함수를 보여 Hello 줍니다.

예제 5: 함수를 내보낸 사용자 지정 개체 생성

이 예제에서는 AsCustomObject 매개 변수 New-Module 를 사용하여 내보낸 함수를 나타내는 스크립트 메서드가 있는 사용자 지정 개체를 생성하는 방법을 보여 줍니다.

cmdlet은 New-Module 두 개의 함수를 사용하여 동적 모듈을 만들고 . Hello Goodbye AsCustomObject 매개 변수는 기본적으로 생성하는 PSModuleInfo 개체 대신 사용자 지정 개체 New-Module 를 만듭니다. 이 사용자 지정 개체는 변수에 $m 저장됩니다. 변수에 $m 할당된 값이 없는 것으로 보입니다.

$m = New-Module -ScriptBlock {
  function Hello ($name) {"Hello, $name"}
  function Goodbye ($name) {"Goodbye, $name"}
} -AsCustomObject
$m
$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();

$m.goodbye("Jane")

Goodbye, Jane

$m.hello("Manoj")

Hello, Manoj

cmdlet으로 Get-Member 파이핑 $m 하면 사용자 지정 개체의 속성과 메서드가 표시됩니다. 출력은 개체에 및 Goodbye 함수를 나타내는 스크립트 메서드가 Hello 있음을 보여 줍니다. 마지막으로 이러한 스크립트 메서드를 호출하고 결과를 표시합니다.

예제 6: 스크립트 블록의 결과 가져오기

이 예제에서는 ReturnResult 매개 변수를 사용하여 모듈 개체를 요청하는 대신 스크립트 블록 실행 결과를 요청합니다. 새 모듈의 스크립트 블록은 함수를 정의한 SayHello 다음 함수를 호출합니다.

New-Module -ScriptBlock {function SayHello {"Hello, World!"}; SayHello} -ReturnResult

Hello, World!

매개 변수

-ArgumentList

-AsCustomObject

-Cmdlet

-Function

-Name

-ReturnResult

-ScriptBlock

입력

String

모듈 이름을 이 cmdlet으로 파이프할 수 있습니다.

출력

PSModuleInfo

이 cmdlet은 기본적으로 PSModuleInfo 개체를 생성합니다.

PSCustomObject

AsCustomObject 매개 변수를 사용하면 PSCustomObject 개체가 생성됩니다.

Object

ReturnResult 매개 변수를 사용하는 경우 이 cmdlet은 동적 모듈에서 스크립트 블록을 평가한 결과를 반환합니다.

참고

PowerShell에는 다음 별칭이 포함됩니다.New-Module

• 모든 플랫폼:
  • nmo

관련 링크

• Export-ModuleMember
• Get-Module
• Import-Module
• 모듈 제거