about_Command_Precedence

项目
05/09/2024

简短说明

介绍 PowerShell 如何确定要运行的命令。

长说明

命令优先级描述当会话包含多个同名命令时，PowerShell 如何确定要运行的命令。会话中的命令可以隐藏或替换为同名的命令。本文介绍如何运行隐藏的命令以及如何避免命令名称冲突。

命令优先级

当 PowerShell 会话包含多个具有相同名称的命令时，PowerShell 将使用以下规则确定要运行的命令。

如果指定命令的路径，PowerShell 将在路径指定的位置运行该命令。

例如，以下命令在目录中运行 FindDocs.ps1 脚本 C:\TechDocs ：

C:\TechDocs\FindDocs.ps1

可以使用其完整路径运行任何可执行命令。作为一项安全功能，PowerShell 不会运行可执行命令，包括 PowerShell 脚本和本机命令，除非命令位于环境变量中列出的路径中 $env:Path 。

若要运行当前目录中的可执行文件，请指定完整路径或使用相对路径 .\ 来表示当前目录。

例如，若要在当前目录中运行 FindDocs.ps1 文件，请键入：

.\FindDocs.ps1

如果未指定路径，PowerShell 在运行命令时将使用以下优先顺序。

Alias
函数
cmdlet (请参阅 cmdlet 名称解析)
外部可执行文件 (包括 PowerShell 脚本文件)

因此，如果键入 help，PowerShell 首先查找名为的 help别名，然后查找名为的 Help函数，最后查找名为的 Helpcmdlet。它运行找到的第一 help 项。

例如，如果会话包含一个 cmdlet 和一个名为的函数， Get-Map则当你键入 Get-Map时，PowerShell 将运行该函数。

注意

这仅适用于已加载的命令。如果在未加载到当前会话中的模块内存在build名为的函数的Invoke-Build可执行文件和别名build，则 PowerShell 将改为运行可执行文件build。如果找到外部可执行文件，则它不会自动加载模块。仅当找不到外部可执行文件时，才会调用具有给定名称的别名、函数或 cmdlet。

解析具有相同名称的项

由于这些规则，项目可以替换为同名的项或将其隐藏。

如果仍可访问原始项（例如，使用模块名称限定项名称），则会隐藏或隐藏项。

例如，如果导入的函数与会话中的 cmdlet 同名，该 cmdlet 将被隐藏，但不会被替换。可以通过指定 cmdlet 的模块限定名称来运行该 cmdlet。

替换或覆盖项时，无法再访问原始项。

例如，如果导入的变量与会话中的变量同名，则会替换原始变量。不能使用模块名称限定变量。

如果在命令行中创建一个函数，然后导入同名的函数，则会替换原始函数。

查找隐藏的命令

Get-Command cmdlet 的 All 参数获取具有指定名称的所有命令，即使它们已被隐藏或替换也是如此。从 PowerShell 3.0 开始，默认情况下， Get-Command 仅获取键入命令名称时运行的命令。

在以下示例中，会话包括函数 Get-Date 和 Get-Date cmdlet。可以使用 Get-Command 来确定首先选择哪个命令。

Get-Command Get-Date

CommandType     Name                      ModuleName
-----------     ----                      ----------
Function        Get-Date

使用 All 参数列出可用的 Get-Date 命令。

Get-Command Get-Date -All

CommandType     Name                 Version    Source
-----------     ----                 -------    ------
Function        Get-Date
Cmdlet          Get-Date             7.0.0.0    Microsoft.PowerShell.Utility

Get-Command where -All

CommandType Name                     Version      Source
----------- ----                     -------      ------
Alias       where -> Where-Object
Application where.exe                10.0.22621.1 C:\Windows\system32\where.exe

可以通过包含将命令与可能具有相同名称的其他命令区分开的合格信息来运行特定命令。对于 cmdlet，可以使用模块限定的名称。对于可执行文件，可以包含文件扩展名。例如，若要运行的可执行版本 where ，请使用 where.exe。

使用模块限定的名称

使用 cmdlet 的模块限定名称，可以运行同名项隐藏的命令。例如，可以通过使用模块名称 Microsoft.PowerShell.Utility 或其路径来运行 Get-Date cmdlet。使用模块限定名称时，可以根据的值 $PSModuleAutoLoadingPreference自动将模块导入会话。

注意

不能使用模块名称来限定变量或别名。

使用模块限定名称可确保运行要运行的命令。这是编写要分发的脚本时调用 cmdlet 的建议方法。

下面的示例演示如何通过包括命令的模块名称来限定命令。

重要

模块限定使用反斜杠字符 (\) 将模块名称和命令名称分开，而不考虑平台。

New-Alias -Name "Get-Date" -Value "Get-ChildItem"
Microsoft.PowerShell.Utility\Get-Date

Tuesday, May 16, 2023 1:32:51 PM

若要从MapFunctions模块运行New-Map命令，请使用其模块限定名称：

MapFunctions\New-Map

若要查找从中导入命令的模块，请使用命令的 ModuleName 属性。

(Get-Command <command-name>).ModuleName

例如，若要查找 cmdlet 的 Get-Date 源，请键入：

(Get-Command Get-Date).ModuleName

Microsoft.PowerShell.Utility

如果要使用模块的路径限定命令的名称，则必须使用正斜杠 () / 作为路径分隔符，反斜杠字符 (\ 命令名称前) 。使用以下示例运行 Get-Date cmdlet：

//localhost/c$/Progra~1/PowerShell/7-preview/Modules/Microsoft.PowerShell.Utility\Get-Date

路径可以是完整路径，也可以是相对于当前位置的路径。在 Windows 上，不能使用驱动器限定的路径。必须使用 UNC 路径（如前面的示例所示）或相对于当前驱动器的路径。以下示例假定当前位置位于驱动器中 C: 。

/Progra~1/PowerShell/7-preview/Modules/Microsoft.PowerShell.Utility\Get-Date

使用呼叫运算符

还可以使用 call 运算符 (&) 来运行隐藏命令，方法是将其与对 Get-ChildItem 的调用（ (别名) dirGet-Command 或 Get-Module）结合使用。

调用运算符在子作用域中执行字符串和脚本块。有关详细信息，请参阅 about_Operators。

例如，使用以下命令运行名为 Map 的函数，该函数由名为 Map的别名隐藏。

& (Get-Command -Name Map -CommandType Function)

或

& (dir Function:\map)

还可以将隐藏的命令保存在变量中，使其更易于运行。

例如，以下命令将 Map 函数保存在变量中， $myMap 然后使用 Call 运算符来运行它。

$myMap = (Get-Command -Name map -CommandType function)
& ($myMap)

替换的项目

已替换的项是不能再访问的项。可以通过从模块导入同名项来替换项。

例如，如果在会话中键入函数 Get-Map ，并导入名为的 Get-Map函数，它将替换原始函数。无法在当前会话中检索它。

不能隐藏变量和别名，因为不能使用调用运算符或限定名称来运行它们。从模块导入变量和别名时，它们会用同名替换会话中的变量。

Cmdlet 名称解析

如果不使用 cmdlet 的限定名称，PowerShell 会检查该 cmdlet 是否已加载到当前会话中。如果加载的多个模块包含同一个 cmdlet 名称，PowerShell 将使用按字母顺序找到的第一个模块中的 cmdlet。

如果未加载 cmdlet，PowerShell 将搜索已安装的模块，并自动加载包含 cmdlet 的第一个模块并运行该 cmdlet。 PowerShell 在环境变量中定义的每个路径中 $env:PSModulePath 搜索模块。路径按变量中的列出顺序进行搜索。在每个路径中，按字母顺序搜索模块。 PowerShell 使用它找到的第一个匹配项中的 cmdlet。

避免名称冲突

管理命令名称冲突的最佳方法是防止冲突。命名命令时，请使用唯一名称。例如，将缩写或公司名称首字母缩略词添加到命令中的名词。

从 PowerShell 模块或其他会话将命令导入会话时，可以使用 PrefixImport-Module 或 Import-PSSession cmdlet 的参数向命令名称中的名词添加前缀。

例如，以下命令可避免在导入DateFunctions模块时与 Get-Date PowerShell 附带的和 Set-Date cmdlet 发生任何冲突。

Import-Module -Name DateFunctions -Prefix ZZ

运行外部可执行文件

在 Windows 上。 PowerShell 将环境变量中列出的 $env:PATHEXT 文件扩展名视为可执行文件。非 Windows 可执行文件的文件将交给 Windows 进行处理。 Windows 查找文件关联并执行扩展名的默认 Windows Shell 谓词。要使 Windows 支持按文件扩展名执行，必须将关联注册到系统。

可以使用 CMD 命令 shell 的和 assoc 命令为文件扩展名ftype注册可执行引擎。 PowerShell 没有用于注册文件处理程序的直接方法。有关详细信息，请参阅 ftype 命令的文档。

要使 PowerShell 在当前会话中将文件扩展名视为可执行文件，必须将该扩展添加到 $env:PATHEXT 环境变量中。

通过