关于命令优先级

简短描述

描述 PowerShell 如何确定要运行的命令。

详细描述

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

命令优先级

当 PowerShell 会话包含多个同名命令时，PowerShell 将使用以下规则确定运行哪一个命令。

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

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

C:\TechDocs\FindDocs.ps1

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

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

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

.\FindDocs.ps1

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

1. 别名
2. 功能
3. Cmdlet（请参阅 Cmdlet 名称解析）
4. 外部可执行文件（包括PowerShell脚本文件）

因此，如果您输入 help，PowerShell 首先查找名为 help 的别名，然后查找名为 Help 的函数，最后查找名为 help 的 cmdlet >帮助。它运行找到的第一个 help 项。

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

笔记

这仅适用于加载的命令。如果在未加载到模块中的模块中有一个 build 可执行文件和一个名为 Invoke-Build 的函数的别名 build当前会话中，PowerShell 改为运行 build 可执行文件。如果找到外部可执行文件，它不会自动加载模块。仅当未找到外部可执行文件时，才会调用具有给定名称的别名、函数或 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

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

(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

使用呼叫接线员

您还可以使用调用运算符 (&) 来运行隐藏命令，方法是将其与对 Get-ChildItem 的调用相结合（别名为 dir）、Get-命令 或 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 模块或其他会话将命令导入会话时，可以使用 Import-Module 或 Import-PSSession cmdlet 的 Prefix 参数向以下名称中的名词添加前缀命令。

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

Import-Module -Name DateFunctions -Prefix ZZ

运行外部可执行文件

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

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

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

参见

• about_别名
• about_函数
• about_Path_Syntax
• Alias-Provider
• Function-Provider
• Get-Command
• Import-Module
• 导入-PSSession