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, но их экспортируемые элементы возвращаются командлетом Get-Command.

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 для экспорта переменной в текущий сеанс. Если команда 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!"

Описание
-----------
Эта команда демонстрирует, как сделать динамический модуль доступным для командлета Get-Module, передав динамический модуль по конвейеру командлету Import-Module.

Первая команда использует оператор конвейера (|) для отправки объекта модуля, созданного командлетом New-Module, командлету Import-Module. Команда использует параметр Name командлета New-Module для назначения модулю понятного имени. Поскольку по умолчанию командлет Import-Module не возвращает никаких объектов, у этой команды нет выходных данных.

Вторая команда получает все модули в рамках сеанса с помощью командлета Get-Module. В результатах показано, что командлет Get-Module может получить новый динамический модуль.

Третья команда использует командлет Get-Command для получения экспортируемой динамическим модулем функции 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

Описание
-----------
В этом примере показано, как использовать параметр AsCustomObject командлета New-Module для создания пользовательского объекта с методами-скриптами, отражающими экспортированные функции.

Первая команда использует командлет New-Module для создания динамического модуля с двумя функциями, Hello и Goodbye. Команда использует параметр AsCustomObject для создания пользовательского объекта, а не объекта PSModuleInfo, который создается командлетом New-Module по умолчанию. Полученный пользовательский объект сохраняется в переменной $m.

Вторая команда пытается отобразить значение переменной $m. На экране не отображается ничего.

Третья команда использует оператор конвейера (|) для отправки пользовательского объекта командлету Get-Member, который отображает свойства и методы пользовательского объекта. В выходных данных показано, что у объекта есть методы-скрипты, представляющие функции Hello и Goodbye.

Четвертая и пятая команды используют формат метода-скрипта для вызова функций Hello и Goodbye. 
 
Шестая и седьмая команды вызывают функции с указанием имени функции и значения параметра.

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

Hello, World!

Описание
-----------
Эта команда использует параметр ReturnResult, чтобы запросить результаты выполнения блока скрипта вместо запроса объекта модуля. 

Блок скрипта в новом модуле определяет функцию SayHello, а затем вызывает ее.