PowerShellでは、ファイルで関数を定義して、PowerShellコマンドラインから呼び出すにはどうすればよいですか？

カスタム関数を定義する.ps1ファイルがあります。

ファイルの名前がMyFunctions.ps1で、内容は次のとおりだとします。

Write-Host "Installing functions"
function A1
{
    Write-Host "A1 is running!"
}
Write-Host "Done"

このスクリプトを実行して理論的にはA1関数を登録するには、.ps1ファイルが存在するフォルダーに移動してファイルを実行します。

.\MyFunctions.ps1

これは出力します：

Installing functions
Done

それでも、A1を呼び出そうとすると、その名前のコマンド/関数がないというエラーが表示されます。

The term 'A1' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling
 of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:3
+ A1 <<<<
    + CategoryInfo          : ObjectNotFound: (A1:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

PowerShellのいくつかの概念を誤解する必要があります。スクリプトファイルで関数を定義できませんか？

実行ポリシーをすでに「RemoteSigned」に設定していることに注意してください。そして、ファイル名の前にドットを使用して.ps1ファイルを実行することを知っています：。\ myFile.ps1

PowerShellコマンドラインでこれを試してください：

. .\MyFunctions.ps1
A1

ドット演算子は、スクリプトインクルードに使用されます。

あなたが話していることは、ドットソーシングと呼ばれています。そしてそれは悪です。しかし、心配する必要はありません。モジュールを使用してやりたいことをより簡単に行う方法があります（実際よりも恐ろしいように聞こえます）。モジュールを使用する主な利点は、必要に応じてシェルからモジュールをアンロードできることです。これにより、関数内の変数がシェルに侵入しないようにします（関数ファイルをドットソース化したら、変数の1つをシェルで機能すると、私が何を意味するかがわかります）。

したがって、最初に、すべての関数が含まれている.ps1ファイルの名前をMyFunctions.psm1に変更します（モジュールを作成したところです）。モジュールが適切にロードされるようにするには、ファイルに対して特定のことを行う必要があります。最初にImport-Moduleがモジュールを表示するには（このコマンドレットを使用してモジュールをシェルにロードします）、特定の場所にある必要があります。モジュールフォルダーへのデフォルトのパスは$ home \ Documents \ WindowsPowerShell \ Modulesです。

そのフォルダーで、MyFunctionsという名前のフォルダーを作成し、MyFunctions.psm1ファイルをその中に配置します（モジュールファイルは、PSM1ファイルとまったく同じ名前のフォルダーに存在する必要があります）。

それが完了したら、PowerShellを開き、次のコマンドを実行します。

Get-Module -listavailable

MyFunctionsと呼ばれるものが表示された場合、それは正しく行われ、モジュールをロードする準備ができています（これは、これが正しくセットアップされていることを確認するためだけで、これを行う必要があるのは1回だけです）。

モジュールを使用するには、シェルに次のように入力します（または、この行を$ profileに入れるか、スクリプトの最初の行に入れます）。

Import-Module MyFunctions

これで関数を実行できます。これのクールな点は、10から15個の関数が入ったら、カップルの名前を忘れてしまうことです。モジュールにそれらがある場合、次のコマンドを実行して、モジュール内のすべての関数のリストを取得できます。

Get-Command -module MyFunctions

それはかなり甘いです、そして、それを前側に設置するために取るほんの少しの努力はそれだけの価値があります。

. "$PSScriptRoot\MyFunctions.ps1" MyA1Func

v3で使用可能になる前に、「PowerShellスクリプトのファイルシステムの場所を取得するにはどうすればよいですか？」を参照してください。。それは非常に一般的です。

PS私は「すべてがモジュールである」というルールに同意していません。私のスクリプトはGIT以外の他の開発者が使用しているため、スクリプトを実行する前に、特定の場所にデータを配置したり、システム環境変数を変更したりしたくありません。それは単なるスクリプト（または2つ、または3つ）です。

スクリプトファイルで関数を定義することは確かにできます（次に、ロード時にPowershellプロファイルを介して関数をロードする傾向があります）。

まず、次のコマンドを実行して、関数がロードされていることを確認する必要があります。

ls function:\ | where { $_.Name -eq "A1"  }

そして、それがリストに表示されていることを確認し（1のリストである必要があります！）、取得した出力をお知らせください。

次の機能を追加できます。

c:\Users\David\Documents\WindowsPowerShell\profile.ps1

機能が利用できるようになります。

ファイルに、呼び出し/公開するメイン関数が1つしかない場合は、次のコマンドでファイルを開始することもできます。

Param($Param1)

その後、たとえば次のように呼び出すことができます。

.\MyFunctions.ps1 -Param1 'value1'

これにより、関数をインポートせずに、その関数だけを簡単に呼び出す場合に非常に便利です。

Function-Dumb（）というメソッドを持つDummy-Name.psm1というモジュールファイルがあるとします。

Import-Module "Dummy-Name.psm1";
Get-Command -Module "Function-Dumb";
#
#
Function-Dumb;