Export-CrescendoModule

  • リファレンス
モジュール:
Microsoft.PowerShell.Crescendo

PowerShell Crescendo JSON 構成ファイルからモジュールを作成します

構文

Export-CrescendoModule
      [-ConfigurationFile] <String[]>
      [-ModuleName] <String>
      [-Force]
      [-NoClobberManifest]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

このコマンドレットは、プラットフォーム固有のコマンドのプロキシとして機能する関数に変換できるオブジェクトをエクスポートします。 結果として得られるモジュール ファイルは、PowerShell のバージョン 5.1 まで実行可能である必要があります。

コマンドレットは、モジュールマニフェストファイルとモジュール .psm1 マニフェスト .psd1 ファイルの両方を作成します。 これにより、Crescendo のスコープを超えてモジュール マニフェストをカスタマイズしたときに問題が発生する可能性があります。 マニフェストの上書きを防ぐには、 NoClobberManifest パラメーターを使用します。

例

例 1

Export-CrescendoModule -ModuleName netsh -ConfigurationFile netsh*.json
Import-Module ./netsh.psm1

例 2

Export-CrescendoModule netsh netsh*.json -force

パラメーター

-ConfigurationFile

これは、モジュールのプロキシを表す JSON ファイルの一覧です。

Type:String[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

既定では、 が既存のモジュールを上書きしない場合 Export-CrescendoModule 。 Force パラメーターを使用して既存のファイルを上書きするか、 を実行Export-CrescendoModuleする前に削除します。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

作成するモジュール ファイルの名前。 末尾 .psm1の を省略できます。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoClobberManifest

モジュール マニフェストの上書きを防止します。

新しいコマンドレットと設定を使用してマニフェストを手動で更新する必要があります。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

.psm1 へのパスと引数を持つオブジェクトを New-ModuleManifest に出力します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 コマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String[]

出力

Object

メモ

内部的には、この関数はコマンド オブジェクトを Import-CommandConfiguration 返すコマンドレットを呼び出します。 その後、 ConfigurationFile パラメーターで指定されたすべてのファイルを使用して、個々の関数を作成します。 最後に、すべてのプロキシを使用してコマンド呼び出しが Export-ModuleMember 作成されるため、結果のモジュールがインポートされると、モジュールにはすべてのコマンド プロキシが使用可能になります。

Export-CrescendoModule は、モジュール マニフェストに CrescendoBuilt タグを追加します。 このタグを使用して、Crescendo を使用して作成されたPowerShell ギャラリー内のモジュールを検索できます。 詳細については、次を参照してください。