在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

点运算符用于脚本包含。

您所说的就是点采购。这是邪恶的。但是不用担心，有一种更好，更轻松的方法可以用模块来完成您想要的事情（听起来比现在更可怕）。使用模块的主要好处是，您可以根据需要从外壳程序中卸载它们，并且可以防止函数中的变量爬入外壳程序中（一旦您点了源代码功能文件，请尝试从模块中调用其中一个变量）在外壳中运行，您会明白我的意思）。

因此，首先，将包含所有功能的.ps1文件重命名为MyFunctions.psm1（您刚刚创建了一个模块！）。现在，要使模块正确加载，您必须对文件进行一些特定的操作。首先，Import-Module要查看模块（使用此cmdlet将模块加载到外壳中），它必须位于特定位置。modules文件夹的默认路径是$ home \ Documents \ WindowsPowerShell \ Modules。

在该文件夹中，创建一个名为MyFunctions的文件夹，并将MyFunctions.psm1文件放入其中（模块文件必须位于与PSM1文件名称完全相同的文件夹中）。

完成后，打开PowerShell，然后运行以下命令：

Get-Module -listavailable

如果看到一个名为MyFunctions的文件，则说明操作正确，并且可以加载模块（这只是为了确保正确设置，您只需执行一次）。

要使用该模块，请在外壳程序中键入以下内容（或将此行放入$ profile中，或将此行作为脚本的第一行）：

Import-Module MyFunctions

现在可以运行您的功能。有趣的是，一旦您拥有10-15个功能，就将忘记一对夫妇的名字。如果它们在模块中，则可以运行以下命令以获取模块中所有功能的列表：

Get-Command -module MyFunctions

这非常好，而且在正面安装时只需付出一点点努力就值得。

. "$PSScriptRoot\MyFunctions.ps1" MyA1Func

Availalbe从v3开始，在此之前请参阅如何获取PowerShell脚本的文件系统位置？。这很常见。

PS：我不赞成“一切都是模块”规则。我的脚本供GIT之外的其他开发人员使用，因此我不希望在脚本运行之前将内容放到特定的位置或修改系统环境变量。这只是一个脚本（或两个或三个）。

您当然可以在脚本文件中定义函数（然后，我倾向于在加载时通​​过我的Powershell配置文件加载它们）。

首先，您需要检查以确保通过运行以下命令加载了该函数：

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

并检查它是否出现在列表中（应该是1！），然后让我们知道您将获得什么输出！

您可以将功能添加到：

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

该功能将可用。

如果您的文件只有一个要调用/公开的主要功能，那么您也可以使用以下命令启动文件：

Param($Param1)

然后可以按如下方式调用它：

.\MyFunctions.ps1 -Param1 'value1'

如果您想轻松地仅调用该函数而不必导入该函数，则将更加方便。

假设您有一个名为Dummy-Name.psm1的模块文件，该文件具有一个称为Function-Dumb（）的方法。

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