about_Command_Precedence

项目
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

运行外部可执行文件

PowerShell 将环境变量中列出的 $env:PATHEXT 文件扩展名视为可执行文件。 Windows 可执行文件是具有 .COM、 .CPL或 .EXE 文件扩展名的文件。 Windows 可执行文件和具有中列出的 $env:PATHEXT 扩展名的任何其他文件在当前控制台会话中执行。

非 Windows 可执行文件的文件将交给 Windows 进行处理。 Windows 查找文件关联并执行扩展的默认 Windows Shell 谓词。若要使 Windows 支持按文件扩展名执行，必须向系统注册关联。

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

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

通过