PowerShell LinkChecker函数参数歧义问题及修改方案咨询

执行LinkChecker -Url https://stackoverflow.com/时出现以下错误：

LinkChecker: Parameter cannot be processed because the parameter name 't' is ambiguous. Possible matches include: -Threads -Timeout.

问题根源是函数默认给$Threads设置了值10，会自动生成-t $Threads参数传递给linkchecker，但linkchecker的短参数-t同时对应--threads和--timeout，导致参数歧义。结合你不想使用-Threads和-Timeout参数的需求，修改函数如下：

function LinkChecker {
    param (
        [string]$Url,
        [string]$ConfigFile,
        [int]$Threads,  # 移除默认值，仅在用户显式指定时生效
        [switch]$ListPlugins,
        [string]$Debug,
        [string]$FileOutput,
        [switch]$NoStatus,
        [switch]$NoWarnings,
        [string]$Output = "text",
        [string]$CookieFile,
        [switch]$NoRobots,
        [switch]$CheckExtern,
        [string[]]$IgnoreUrl,
        [string[]]$NoFollowUrl,
        [switch]$Password,
        [int]$RecursionLevel = -1,
        [int]$Timeout,  # 移除默认值，仅在用户显式指定时生效
        [string]$User,
        [string]$UserAgent = "LinkChecker/X.Y"
    )

    $linkCheckerCmd = "linkchecker"

    $args = @()
    if ($Url) { $args += $Url }
    if ($ConfigFile) { $args += "-f $ConfigFile" }
    # 仅当用户显式传递了-Threads参数时，才添加对应的命令行参数
    if ($PSBoundParameters.ContainsKey('Threads')) { $args += "-t $Threads" }
    if ($ListPlugins) { $args += "--list-plugins" }
    if ($Debug) { $args += "-D $Debug" }
    if ($FileOutput) { $args += "-F $FileOutput" }
    if ($NoStatus) { $args += "--no-status" }
    if ($NoWarnings) { $args += "--no-warnings" }
    if ($Output) { $args += "-o $Output" }
    if ($CookieFile) { $args += "--cookiefile $CookieFile" }
    if ($NoRobots) { $args += "--no-robots" }
    if ($CheckExtern) { $args += "--check-extern" }
    if ($IgnoreUrl) { $args += $IgnoreUrl | ForEach-Object { "--ignore-url $_" } }
    if ($NoFollowUrl) { $args += $NoFollowUrl | ForEach-Object { "--no-follow-url $_" } }
    if ($Password) { $args += "-p" }
    if ($RecursionLevel -ge 0) { $args += "-r $RecursionLevel" }
    # 仅当用户显式传递了-Timeout参数时，才添加对应的命令行参数
    if ($PSBoundParameters.ContainsKey('Timeout')) { $args += "--timeout $Timeout" }
    if ($User) { $args += "-u $User" }
    if ($UserAgent) { $args += "--user-agent $UserAgent" }

    Invoke-Expression "$linkCheckerCmd $($args -join ' ')"
}

修改说明： #

1. 移除$Threads和$Timeout的默认值，用户不指定时这两个变量不会有默认值。
2. 将这两个参数的判断逻辑改为$PSBoundParameters.ContainsKey('参数名')，只有当用户显式通过命令行传递该参数时，才会向linkchecker添加对应的命令行参数。
3. 这样默认调用LinkChecker -Url https://stackoverflow.com/时，不会传递-t和--timeout参数，彻底避免参数歧义问题。

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