如何使用模块清单导出 PowerShell 模块别名？

Question

我有一个具有多种功能的模块。

由于我以非 PowerShell 方式命名它们，所以我想重命名它们。但由于该模块已经在使用中，我想保留旧的函数名称。

实现此目的的最佳方法似乎是使用别名。我已经有一个模块清单，其中指出：

AliasesToExport = '*'

因此我使用 New-Alias -Name test -Value oldFunctionName 在模块中创建了一个别名。

函数像往常一样导入，但别名不存在。

我知道我可以在模块中使用 Export-ModuleMember 。但我有一个清单已经应该解决这个问题了。

所以最后我的问题是：

为什么别名不通过清单导出？

函数本身是否有一个特殊的地方，我可以或必须在其中定义别名？或者我是否必须在特殊的地方使用 New-Alias cmdlet？

我正在考虑类似参数别名的东西：

[parameter(Mandatory=$true, Position=0)][Alias("name","path")][String]$filename

但是对于函数来说。

Answer 1

似乎没有我正在寻找的解决方案。

所以我必须使用 Export-ModuleMember

Export-ModuleMember -Function * -Alias *

起初我只使用参数“Alias”，因为函数应该由清单导出（FunctionsToExport =“*”），但实际上只导出了别名。

因此，请确保使用 Export-ModuleMember cmdlet 导出要导出的所有内容。

Answer 2

将 -Scope Global 添加到 New-Alias 命令似乎可以解决问题。

New-Alias -Name test -Value oldFunctionName -Scope Global

当我尝试这样做时，我注意到一些令我惊讶的事情。我的模块中有一个函数，其目的是创建别名。我惊讶地发现，当我使用此函数时（导入模块后），它创建的别名与该模块关联。如果我删除该模块，我用此函数创建的所有别名也会消失。

Answer 3

如果您查看：

get-help New-ModuleManifest -full

对于 -AliasesToExport 您可以看到以下内容：

-AliasesToExport <string[]>
Specifies the aliases that the module exports. Wildcards are permitted.

You can use this parameter to restrict the aliases that are exported by the module. It can remove aliases from the list of exported aliases, but it cannot add aliases to the list.

If you omit this parameter, New-ModuleManifest creates an AliasesToExport key with a value of * (all), meaning that all aliases that are exported by the module are exported by the manifest.

我可能是错的，但根据我的理解 -AliasesToExport 可能用于限制导出的别名，但句子“New-ModuleManifest 创建一个值为 *（全部）的 AliasesToExport 键，这意味着模块导出的所有别名都由清单导出” 对我来说意味着您必须导出模块中的别名。