PowerShellコマンドレット虎の巻

New-Module

New-Moduleは、モジュールを作成するコマンドです。

解説

メモリ内にのみ存在する新しい動的モジュールを作成します。
モジュールの内容は、スクリプトブロックとして定義します。

構文

(構文)
New-Module [-ScriptBlock] <scriptblock> [<CommonParameters>] New-Module [-Name] <string> [-ScriptBlock] <scriptblock> [<CommonParameters>]
【主要パラメータ】
パラメータ説明
-Name 名前新しいモジュールの名前を指定する
-ScriptBlock スクリプトブロックスクリプトブロックを定義する
(必須パラメータ)
(例)New-Module -ScriptBlock { function Hello {"Hello!"} }
-Function 関数名エクスポートする関数名を指定する
-Cmdlet コマンドレット名エクスポートするコマンドレット名を指定する
-ReturnResultスクリプトブロックの実行結果を返す
-AsCustomObjectモジュールをカスタムオブジェクトとして返す
-ArgumentList 引数スクリプトブロックに渡す引数を指定する

共通的なパラメータは「共通パラメータ」をご覧ください。

サンプル

モジュールを作成する

$m = { function Say-Hello { param($Name) Write-Output "Hello, $Name!" } } New-Module -Name "HelloModule" -ScriptBlock $m

(実行例)

PS C:\>Say-Hello taro Hello, taro!

コマンドのヘルプを表示する

Get-Help New-Module

備考

  • 動的モジュールはセッションを終了するまで使用できます。

関連項目