为什么 PowerShell 的 `Get-ChildItem` 命令将参数 `d` 解析为 `Depth`？

Question

鉴于Get-ChildItem 具有三个以字符D 开头的参数...

❯ (gcm Get-ChildItem).Parameters.Values |? Name -like 'd*' | select name, aliases

Name      Aliases
----      -------
Depth     {}
Debug     {db}
Directory {ad, d}

...而且Directory 参数有明确的别名ad 和d，为什么Get-ChildItem -d 解析为Get-ChildItem -Depth？

❯ Get-ChildItem -d
Get-ChildItem: Missing an argument for parameter 'Depth'. Specify a parameter of type 'System.UInt32' and try again.

Answer 1

评论太长，不是完整的答案。

很遗憾，我找不到具体的术语（可能是制表符补全？），但这似乎是 PowerShell 尝试提供帮助的一部分。所经历的行为似乎是“当您使用 -d 时，它会尝试为您扩展命令”。当运行Get-ChildItem -d 并按 TAB 时，它会自动扩展为“深度”，即使有别名。

这也适用于没有特定别名的项目 - 如果您使用 -r，-recurse 切换（别名 's'）可以工作，尽管它没有指定。

预期的行为，我希望在键入时将作品的分页扩展到“深度”作为第一个首选单词，但只需使用别名就应该充当“-目录”。如果他们这样做了，这可能需要 Microsoft 进行更改才能更正，因为它可能会破坏多年的现有脚本。

Answer 2

这是因为其他参数是在调用时添加的动态参数，具体取决于您询问的路径。

• -Directory 仅在 Path 在文件系统提供程序中时有效
• -DnsName 和 -DocumentEncryptionCert 仅在证书提供程序中有效

-re 与 -Recurse 相同，而不是与 -ReadOnly 模棱两可...

-e 也是 -Exclude 而不是 -Eku 或 -ExpiriringInDays ...

您会注意到，如果您运行 Get-ChildItem -f 并且它告诉您 f 不明确，那么它建议的唯一选项是 -Filter 和 -Force，而不是 -File 或 -FollowSymlink文件系统提供程序独有...

---

您可以使用Get-Parameter 查看所有内容，您可以通过Install-Script Get-Parameter 从 PowerShell 库中获取这些信息

---

我最终找到了一种方法来通过实验证明非动态参数将总是首先得到解决，并且参数绑定器甚至从不查看动态参数以查找没有它们可以绑定的任何东西。因此，参数选择器甚至不知道动态参数的名称或别名是什么除非它无法在非动态参数上找到匹配项。所以 d 别名只会引起混淆，除非它的生成方式也显示在其他命令中......

试试这个：

using namespace System.Management.Automation
function Test-Alias {
    [CmdletBinding()]
    param(
        [switch]$Awful
    )

    dynamicparam {
        $paramDictionary = [RuntimeDefinedParameterDictionary]::new()
        $attribs = [System.Collections.ObjectModel.Collection[System.Attribute]]::new()
        $attribs.Add([ParameterAttribute]@{ParameterSetName = "_AllParameterSets" })

        $paramdictionary.Add("Automation", [RuntimeDefinedParameter]::new( "Automation", [switch], $attribs))

        $attribs += [AliasAttribute]::new("A", "C")
        $paramdictionary.Add("Architecture", [RuntimeDefinedParameter]::new( "Architecture", [switch], $attribs))
        $paramdictionary
    }
    end {
        $PSBoundParameters
    }
}

如果您在控制台中运行它，您不仅可以看到Test-Alias -A 使用Awful，而且Test-Alias -C 确实有效！ A 别名从来没有机会，但这并不是因为动态参数上的别名被完全忽略，而是因为有一个以那个字母开头的参数不是动态的。

现在试试这个：

Trace-Command -Name ParameterBinding { Test-Alias -A } -PSHost

并将其与使用 Test-Alias -C 或 Test-Alias -A -C 时的输出进行比较...

您可以看到，只有在所有非动态可以绑定的东西都已经完成之后，才考虑动态参数。

Answer 3

延伸我的评论。

您看到的-d 到Depth 的分辨率是 IntelliSense 默认提供的。因此，控制台主机等也会发生同样的事情。

跟踪你的命令，如果你想看看调用堆栈是什么：

Trace-Command -Name metadata,parameterbinding,cmdlet -Expression {Get-ChildItem -d} -PSHost

正如 PowerShell 中存在命令首选项一样，...

about_Command_Precedence

...这同样适用于调用期间的参数、开关。查看 MS PowerShell 源代码，该 cmdlet 也应该为您澄清一些事情：

sn-p

...
dynamicparam
{
    try {
        $targetCmd = $ExecutionContext.InvokeCommand.GetCommand('Microsoft.PowerShell.Management\Get-ChildItem', [System.Management.Automation.CommandTypes]::Cmdlet, $PSBoundParameters)
        $dynamicParams = @($targetCmd.Parameters.GetEnumerator() | Microsoft.PowerShell.Core\Where-Object { $_.Value.IsDynamic })
        if ($dynamicParams.Length -gt 0)
        {
            $paramDictionary = [Management.Automation.RuntimeDefinedParameterDictionary]::new()
            foreach ($param in $dynamicParams)
            {
                $param = $param.Value

                if(-not $MyInvocation.MyCommand.Parameters.ContainsKey($param.Name))
                {
                    $dynParam = [Management.Automation.RuntimeDefinedParameter]::new($param.Name, $param.ParameterType, $param.Attributes)
                    $paramDictionary.Add($param.Name, $dynParam)
                }
            }
            return $paramDictionary
        }
    } catch {
        throw
    }
}
...