关于命令优先级

项目
05/09/2024

简短说明

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

长说明

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

命令优先级

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

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

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

C:\TechDocs\FindDocs.ps1

作为一项安全功能，PowerShell 不会 (本机) 命令（包括 PowerShell 脚本）运行可执行文件，除非命令位于 Path 环境变量 $env:path 中列出的路径中，或者除非指定脚本文件的路径。

若要运行当前目录中的脚本，请指定完整路径，或键入一个表示当前目录的点 .\ 。

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

.\FindDocs.ps1

在执行中使用通配符

可以在命令执行中使用通配符。使用通配符也称为通配符。

PowerShell 在文本匹配之前执行具有通配符匹配的文件。

例如，请考虑具有以下文件的目录：

Get-ChildItem C:\temp\test


    Directory: C:\temp\test


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        5/20/2019   2:29 PM             28 a.ps1
-a----        5/20/2019   2:29 PM             28 [a1].ps1

这两个脚本文件具有相同的内容： $MyInvocation.MyCommand.Path。此命令显示调用的脚本的名称。

运行 [a1].ps1时，即使文件 a.ps1 是文本匹配项，也会执行该文件 [a1].ps1 。

C:\temp\test\[a1].ps1

C:\temp\test\a.ps1

现在，让我们删除该文件并 a.ps1 尝试再次运行它。

Remove-Item C:\temp\test\a.ps1
C:\temp\test\[a1].ps1

C:\temp\test\[a1].ps1

可以从这次运行的输出中看到， [a1].ps1 因为文本匹配是该通配符模式的唯一文件匹配项。

有关 PowerShell 如何使用通配符的详细信息，请参阅 about_Wildcards。

注意

若要将搜索限制为相对路径，必须将脚本名称作为 .\ 路径前缀。这会将命令的搜索限制为该相对路径中的文件。如果没有此前缀，其他 PowerShell 语法可能会发生冲突，并且几乎没有找到该文件的保证。

如果未指定路径，PowerShell 在对当前会话中加载的所有项运行命令时会使用以下优先顺序：

Alias
函数
Cmdlet
(程序和非 PowerShell 脚本的外部可执行文件)

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

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

注意

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

当会话包含具有相同名称的相同类型的项时，PowerShell 将运行较新的项。

例如，如果从模块导入另一个 Get-Date cmdlet，则键入 Get-Date时，PowerShell 会通过本机版本运行导入的版本。

隐藏项和替换项

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

如果仍可访问原始项（例如使用模块或管理单元名称限定项名称），则项是“隐藏”或“隐藏的”。

例如，如果导入的函数与会话中的 cmdlet 同名，则 cmdlet 会隐藏 (但不) 替换，因为它是从管理单元或模块导入的。

如果无法再访问原始项，则项目将被“替换”或“覆盖”。

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

此外，如果在命令行中键入函数，然后导入具有相同名称的函数，则原始函数将被替换并且不再可访问。

查找隐藏的命令

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

在以下示例中，会话包括一个 Get-Date 函数和一个 Get-Date cmdlet。

以下命令获取键入 Get-Date 时 Get-Date运行的命令。

Get-Command Get-Date

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

以下命令使用 All 参数获取所有 Get-Date 命令。

Get-Command Get-Date -All

CommandType     Name                      ModuleName
-----------     ----                      ----------
Function        Get-Date
Cmdlet          Get-Date                  Microsoft.PowerShell.Utility

运行隐藏的命令

可以通过指定项属性来运行特定命令，这些属性将命令与可能具有相同名称的其他命令区分开来。可以使用此方法运行任何命令，但它对于运行隐藏命令特别有用。

限定名称

使用 cmdlet 的模块限定名称可以运行由同名项隐藏的命令。例如，可以通过使用其模块名称 Microsoft.PowerShell.Utility 来运行 Get-Date cmdlet。

编写要分发的脚本时，请使用此首选方法。无法预测运行脚本的会话中可能存在哪些命令。

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

Tuesday, September 4, 2018 8:17:25 AM

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

MapFunctions\New-Map

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

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

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

(Get-Command Get-Date).ModuleName

Microsoft.PowerShell.Utility

注意

不能限定变量或别名。

呼叫运算符

还可以使用 Call 运算符 & 运行隐藏命令，方法是将其与对 Get-ChildItem 的调用相结合， (别名为“dir”) Get-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函数，它将替换原始函数。无法在当前会话中检索它。

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

避免名称冲突

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

此外，从 PowerShell 模块或其他会话将命令导入会话时，请使用 PrefixImport-Module 的参数或

Import-PSSession cmdlet 用于向命令名称中的名词添加前缀。

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

Import-Module -Name DateFunctions -Prefix ZZ

有关详细信息，请参阅 Import-Module 和 Import-PSSession 下文。

通过