自定义PowerShell函数注释后Get-Help无法显示别名求助

给自定义函数写了基于注释的帮助后，Get-Help里原本自动显示的别名会消失——这是因为自定义注释会完全覆盖PowerShell自动生成的帮助内容，包括别名提取逻辑。以下两种方法能让别名重新出现在帮助里：

方法1：手动在注释里加别名信息（最可靠） #

直接在注释的.NOTES段里列出函数的别名，简单直接：

function Get-MyData {
    <#
    .SYNOPSIS
    获取自定义数据集
    .DESCRIPTION
    从指定数据源提取格式化后的数据集
    .NOTES
    别名: gmd, Get-Data
    .EXAMPLE
    Get-MyData -Source Local
    从本地数据源获取数据
    #>
    [Alias('gmd', 'Get-Data')]
    param(
        [string]$Source
    )
    # 函数逻辑代码
}

执行Get-Help Get-MyData后，别名会显示在NOTES区域，用户能一眼看到。

方法2：让帮助系统自动关联别名（进阶） #

通过注释里的.FORWARDHELPTARGETNAME和.FORWARDHELPCATEGORY，让帮助系统重新读取函数本身的元数据，从而自动提取别名：

function Get-MyData {
    <#
    .SYNOPSIS
    获取自定义数据集
    .DESCRIPTION
    从指定数据源提取格式化后的数据集
    .FORWARDHELPTARGETNAME Get-MyData
    .FORWARDHELPCATEGORY Function
    .EXAMPLE
    Get-MyData -Source Local
    从本地数据源获取数据
    #>
    [Alias('gmd', 'Get-Data')]
    param(
        [string]$Source
    )
    # 函数逻辑代码
}

这种方式能让别名像原生命令一样出现在Get-Help的ALIASES区块，但注意部分PowerShell版本可能对该特性支持有限，要是没用就换回方法1。

内容的提问来源于stack exchange，提问作者Carson