New-ModuleManifest

モジュールがエクスポートするエイリアスを指定します。ワイルドカードを使用できます。

このパラメーターを使用すると、モジュールによってエクスポートされるエイリアスを制限できます。エクスポートされるエイリアスの一覧からエイリアスを削除することはできますが、一覧にエイリアスを追加することはできません。

このパラメーターを省略した場合、New-ModuleManifest は値 * (すべて) を含む AliasesToExport キーを作成します。したがって、モジュールによってエクスポートされるすべてのエイリアスが、マニフェストによってエクスポートされます。

モジュール作成者を指定します。

このパラメーターはコマンドレットには必要ですが、Author キーはマニフェストでは必要ありません。このパラメーターを省略し、要求されても値を入力しなかった場合、New-ModuleManifest は現在のユーザー名を含む Author キーを作成します。

モジュールに必要な Microsoft .NET Framework の共通言語ランタイム (CLR) のバージョンを指定します。

このパラメーターを省略した場合、New-ModuleManifest は空の文字列値を持つ CLRVersion キーを作成します。

モジュールがエクスポートするコマンドレットを指定します。ワイルドカードを使用できます。

このパラメーターを使用すると、モジュールによってエクスポートされるコマンドレットを制限できます。エクスポートされるコマンドレットの一覧からコマンドレットを削除することはできますが、一覧にコマンドレットを追加することはできません。

このパラメーターを省略した場合、New-ModuleManifest は値 * (すべて) を含む CmdletsToExport キーを作成します。したがって、モジュールによってエクスポートされるすべてのコマンドレットが、マニフェストによってエクスポートされます。

モジュールを作成した会社または製造元を識別します。

このパラメーターはコマンドレットには必要ですが、CompanyName キーはマニフェストでは必要ありません。このパラメーターを省略し、要求されても値を入力しなかった場合、New-ModuleManifest は値 "Unknown" を含む CompanyName キーを作成します。

モジュールの著作権ステートメントを指定します。

このパラメーターはコマンドレットには必要ですが、Copyright キーはマニフェストでは必要ありません。このパラメーターを省略し、要求されても値を入力しなかった場合、New-ModuleManifest は値 "(c) <year> <username>" を含む Copyright キーを作成します。All rights reserved."ここで <year> は現在の年を表し、<username> は Author キーの値 (指定されている場合) または現在のユーザー名を表します。

モジュールの内容を記述します。

このパラメーターはコマンドレットには必要ですが、Description キーはマニフェストでは必要ありません。このパラメーターを省略し、要求されても値を入力しなかった場合、New-ModuleManifest は空の文字列値を持つ Description キーを作成します。

モジュールに必要な Microsoft .NET Framework のバージョンを指定します。

このパラメーターを省略した場合、New-ModuleManifest は空の文字列値を持つ DotNetFrameWorkVersion キーを作成します。

モジュールに含まれているすべての項目を指定します。

このキーは、モジュールのインベントリとして機能することを目的としています。これらのファイルは、モジュールと共に自動的にエクスポートされることはありません。

このパラメーターはコマンドレットには必要ですが、FileList キーはマニフェストでは必要ありません。このパラメーターを省略し、要求されても値を入力しなかった場合、New-ModuleManifest は空の配列値の FileList キーを作成します。

モジュールをインポートする際に実行する書式設定ファイル (.ps1xml) を指定します。

モジュールをインポートする場合、Windows PowerShell は指定されたファイルで Update-FormatData コマンドレットを実行します。書式設定ファイルはスコープ指定されないため、セッションのすべてのセッション状態に影響します。

このパラメーターはコマンドレットには必要ですが、FormatsToProcess キーはマニフェストでは必要ありません。このパラメーターを省略し、要求されても値を入力しなかった場合、New-ModuleManifest は空の配列値の FormatsToProcess キーを作成します。

モジュールがエクスポートする関数を指定します。ワイルドカードを使用できます。

このパラメーターを使用すると、モジュールによってエクスポートされる関数を制限できます。エクスポートされる関数の一覧から関数を削除することはできますが、一覧に関数を追加することはできません。

このパラメーターを省略した場合、New-ModuleManifest は値 * (すべて) を含む FunctionsToExport キーを作成します。したがって、モジュールによってエクスポートされるすべての関数が、マニフェストによってエクスポートされます。

モジュールの一意識別子を指定します。GUID は、同じ名前を持つモジュールを区別するために使用できます。

このパラメーターを省略した場合、New-ModuleManifest はマニフェストに GUID キーを作成し、値に GUID を生成します。

Windows PowerShell で新しい GUID を作成するには、「[guid]::NewGuid()」と入力します。

このモジュールと共にパッケージされるすべてのモジュールを一覧表示します。

各モジュール名を文字列として入力するか、ModuleName および GUID キーを含むハッシュ テーブルを入力します。ハッシュ テーブルにはオプションの ModuleVersion キーも作成できます。

このキーは、モジュールのインベントリとして機能することを目的としています。これらのモジュールは、自動的に処理されることはありません。

このパラメーターを省略した場合、New-ModuleManifest は空の配列値のマニフェストに ModuleList キーを作成します。

モジュールのプライマリ ファイルまたは "ルート" ファイルを指定します。モジュールがインポートされると、ルート モジュール ファイルからエクスポートされたメンバーが呼び出し元のセッション状態にインポートされます。1 つのスクリプト モジュール (.psm1) またはバイナリ モジュール (.dll) のファイル名を入力します。

モジュールにマニフェスト ファイルが含まれていて、ルート ファイルが ModuleToProcess キーで指定されていない場合は、マニフェストがモジュールのプライマリ ファイルになり、モジュールは "マニフェスト モジュール" (ModuleType = Manifest) になります。

マニフェストを含むモジュールのファイル .psm1 または .dll からメンバーをエクスポートするには、マニフェストの ModuleToProcess キーまたは NestedModules キーの値に、これらのファイル名を指定する必要があります。そうしないと、メンバーはエクスポートされません。

このパラメーターはコマンドレットには必要ですが、ModuleToProcess キーはマニフェストでは必要ありません。このパラメーターを省略し、要求されても値を入力しなかった場合、New-ModuleManifest は空の文字列値を持つ ModuleToProcess キーを作成します。

モジュールのバージョンを指定します。

このパラメーターはコマンドレットには必要ありませんが、ModuleVersion キーはマニフェストで必要です。このパラメーターを省略した場合、New-ModuleManifest は値 "1.0" を含む ModuleVersion キーを作成します。

モジュールのセッション状態にインポートされるスクリプト モジュール (.psm1) およびバイナリ モジュール (.dll) を指定します。NestedModules キーのファイルは、値に示されている順序で実行されます。

通常、入れ子のモジュールには、内部処理のためにルート モジュールが必要とするコマンドが含まれています。既定では、入れ子のモジュールのコマンドは、モジュールのセッション状態から呼び出し元のセッション状態にエクスポートされますが、ルート モジュールはエクスポートするコマンドを制限できます (たとえば Export-Module コマンドを使用するなど)。

モジュール セッション状態の入れ子のモジュールはルート モジュールで使用できますが、呼び出し元のセッション状態の Get-Module コマンドからは返されません。

NestedModules キーに表示されるスクリプト (.ps1) は、モジュールのセッション状態では実行されますが、呼び出し元のセッション状態では実行されません。呼び出し元のセッション状態でスクリプトを実行するには、マニフェストの ScriptsToProcess キーの値にスクリプト ファイル名を示します。

このパラメーターはコマンドレットには必要ですが、NestedModules キーはマニフェストでは必要ありません。このパラメーターを省略し、要求されても値を入力しなかった場合、New-ModuleManifest は空の配列値の NestedModules キーを作成します。

.psd1 ファイルの作成に加えて、結果のモジュール マニフェストをコンソールに書き込みます。既定では、このコマンドレットによる出力はありません。

新しいモジュール マニフェストのパスとファイル名を指定します。$pshome\Modules\MyModule\MyModule.psd1 など、.psd1 ファイル名拡張子を含めたパスとファイル名を入力します。このパラメーターは必須です。

既存のファイルへのパスが指定されている場合、ファイルに読み取り専用属性が設定されていない限り、New-ModuleManifest は警告なしにファイルを置き換えます。

マニフェストはモジュール ディレクトリにあり、マニフェスト ファイル名はモジュール ディレクトリ名と同じ (ただし、.psc1 ファイル名拡張子を含む) である必要があります。

注: Path パラメーターの値に関するプロンプトへの応答として、$pshome や $home などの変数を使用することはできません。変数を使用するには、コマンドに Path パラメーターを含めてください。

モジュールが必要とする Windows PowerShell のホスト プログラムの名前を指定します。"Windows PowerShell ISE Host"、"ConsoleHost" など、ホスト プログラムの名前を入力します。ワイルドカードは使用できません。

ホスト プログラムの名前を確認するには、プログラムで「$host.name」と入力します。

このパラメーターを省略した場合、New-ModuleManifest は空の文字列値を持つ PowerShellHostName キーを作成します。

このモジュールで機能する Windows PowerShell のホスト プログラムの最も古いバージョンを指定します。1.1 などのバージョン番号を入力します。

このパラメーターを省略した場合、New-ModuleManifest は空の文字列値を持つ PowerShellHostName キーを作成します。

このモジュールで機能する Windows PowerShell の最も古いバージョンを指定します。1.0 または 2.0 を入力します。2.0 以降のバージョン要件は強制されません。

このパラメーターを省略した場合、New-ModuleManifest は空の文字列値を持つ PowerShellVersion キーを作成します。

インポート時にモジュールに渡されるデータを指定します。

このパラメーターを省略した場合、New-ModuleManifest は空の文字列値を持つ PrivateData キーを作成します。

モジュールが必要とするプロセッサ アーキテクチャを指定します。有効な値は x86、AMD64、IA64、および None (未知または指定なし) です。

このパラメーターを省略した場合、New-ModuleManifest は空の文字列値を持つ ProcessorArchitecture キーを作成します。

モジュールに必要なアセンブリ (.dll) ファイルを指定します。Windows PowerShell は、型または書式設定の更新、入れ子のモジュールのインポート、または ModulesToProcess キーの値で指定されているモジュール ファイルのインポートを実行する前に、指定されたアセンブリを読み込みます。

NestedModules キーでバイナリ モジュールとして一覧表示されるアセンブリの場合についても、FormatsToProcess キーまたは TypesToProcess キーで一覧表示される書式設定ファイルまたは型ファイルの更新のために読み込みが必要なアセンブリなど、モジュールが必要とするすべてのアセンブリを一覧表示するにはこのパラメーターを使用します。

このパラメーターはコマンドレットには必要ですが、RequiredAssemblies キーはマニフェストでは必要ありません。このパラメーターを省略し、要求されても値を入力しなかった場合、New-ModuleManifest は空の配列値の RequiredAssemblies キーを作成します。

グローバル セッション状態であることが必要なモジュールを指定します。必要なモジュールがグローバル セッション状態でない場合は、モジュールのインポートは失敗します。

各モジュール名を文字列として入力するか、ModuleName および GUID キーを含むハッシュ テーブルを入力します。ハッシュ テーブルにはオプションの ModuleVersion キーも作成できます。詳細については、例を参照してください。

Windows PowerShell では必要なモジュールが自動的にはインポートされず、必要なモジュールが存在することの確認のみが行われます。ただし、必要なモジュールをグローバル セッション状態にインポートするスクリプト (.ps1) はモジュールに含めることができます。

このパラメーターを省略した場合、New-ModuleManifest は空の配列値の RequiredModules キーを作成します。

モジュールをインポートする際に呼び出し元のセッション状態で実行するスクリプト (.ps1) ファイルを指定します。ログイン スクリプトを使用するのと同様に、環境を準備するためにこれらのスクリプトを使用することができます。

モジュール セッション状態で実行されるスクリプトを指定するには、NestedModules キーを使用します。

このパラメーターを省略した場合、New-ModuleManifest は空の配列値の ScriptsToProcess キーを作成します。

モジュールをインポートする際に実行する型ファイル (.ps1xml) を指定します。

モジュールをインポートする場合、Windows PowerShell は指定されたファイルで Update-TypeData コマンドレットを実行します。型ファイルはスコープ指定されないため、セッションのすべてのセッション状態に影響します。

このパラメーターはコマンドレットには必要ですが、TypesToProcess キーはマニフェストでは必要ありません。このパラメーターを省略し、要求されても値を入力しなかった場合、New-ModuleManifest は空の配列値の TypesToProcess キーを作成します。

モジュールがエクスポートする変数を指定します。ワイルドカードを使用できます。

このパラメーターを使用すると、モジュールによってエクスポートされる変数を制限できます。エクスポートされる変数の一覧から変数を削除することはできますが、一覧に変数を追加することはできません。

このパラメーターを省略した場合、New-ModuleManifest は値 * (すべて) を含む VariablesToExport キーを作成します。したがって、モジュールによってエクスポートされるすべての変数が、マニフェストによってエクスポートされます。

コマンドを実行する前に確認メッセージを表示します。

実際にコマンドを実行せずに、コマンドを実行すると何が起きるかを出力します。

このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。Ô”¼š¤Ë¤Ä¤¤¤Æ¤Ï¡¢次を参照してください: about_Commonparameters.