Test-Path

Test-Path
    [-Path] <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PathType <TestPathType>]
    [-IsValid]
    [-Credential <PSCredential>]
    [-OlderThan <DateTime>]
    [-NewerThan <DateTime>]
    [<CommonParameters>]

Test-Path
    -LiteralPath <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PathType <TestPathType>]
    [-IsValid]
    [-Credential <PSCredential>]
    [-OlderThan <DateTime>]
    [-NewerThan <DateTime>]
    [<CommonParameters>]

Test-Path
    [-Path] <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-PathType <TestPathType>]
    [-IsValid]
    [-Credential <pscredential>]
    [<CommonParameters>]

Test-Path
    -LiteralPath <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-PathType <TestPathType>]
    [-IsValid]
    [-Credential <pscredential>]
    [<CommonParameters>]

该 Test-Path cmdlet 确定路径的所有元素是否存在。 如果所有元素都存在并且$true缺少任何元素，则返回$false它。 它还可以判断路径语法是否有效，以及路径是否导致容器或终端或叶元素。 如果 Path 是空格或空字符串，则 cmdlet 返回 $false。 如果 Path 为 $null、数组 $null 或空数组，则 cmdlet 将返回非终止错误。

Test-Path -Path "C:\Documents and Settings\DavidC"

True

此命令检查路径中的所有元素是否存在，包括 C: 目录、 Documents and Settings 目录和 DavidC 目录。 如果缺少任何内容，则 cmdlet 返回 $false。 否则，它将返回 $true。

Test-Path -Path $PROFILE

False

Test-Path -Path $PROFILE -IsValid

True

这些命令测试 PowerShell 配置文件的路径。

第一个命令确定路径中的所有元素是否存在。 第二个命令确定路径的语法是否正确。 在这种情况下，路径是 $false，但语法正确 $true。 这些命令使用 $PROFILE，即指向配置文件位置的自动变量，即使配置文件不存在也是如此。

有关自动变量的详细信息，请参阅 about_Automatic_Variables。

Test-Path -Path "C:\CAD\Commercial Buildings\*" -Exclude *.dwg

False

此命令检查商业建筑目录中是否有除.dwg文件以外的任何文件。

该命令使用 Path 参数指定路径。 由于路径包含空格，因此路径用引号引起来。 路径末尾的星号指示商业建筑目录的内容。 使用长路径（如此路径）键入路径的前几个字母，然后使用 TAB 键完成路径。

该命令指定要从计算中省略的文件的 Exclude 参数。

在这种情况下，由于目录仅包含.dwg文件，因此结果是 $false。

Test-Path -Path $PROFILE -PathType Leaf

True

此命令检查变量中 $PROFILE 存储的路径是否会导致文件。 在这种情况下，由于 PowerShell 配置文件是一个 .ps1 文件，因此 cmdlet 返回 $true。

这些命令与 PowerShell 注册表提供程序一起使用 Test-Path 。

第一个命令测试 Microsoft 的注册表路径。PowerShell 系统上的注册表项正确。 如果正确安装了 PowerShell，则 cmdlet 将 $true返回 。

Test-Path -Path "HKLM:\Software\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell"

True

Test-Path -Path "HKLM:\Software\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell\ExecutionPolicy"

False

此命令使用 NewerThan 动态参数来确定计算机上的文件是否 pwsh.exe 大于 July 13, 2009。

NewerThan 参数仅适用于文件系统驱动器。

Test-Path $PSHOME\pwsh.exe -NewerThan "July 13, 2009"

True

为 null、数组或空数组 null 返回的错误是非终止错误。 它可以通过使用 -ErrorAction SilentlyContinue. 以下示例显示了返回 NullPathNotPermitted 错误的所有情况。

Test-Path $null
Test-Path $null, $null
Test-Path @()

Test-Path : Cannot bind argument to parameter 'Path' because it is null.
At line:1 char:11
+ Test-Path $null
+           ~~~~~
    + CategoryInfo          : InvalidData: (:) [Test-Path], ParameterBindingValidationException
    + FullyQualifiedErrorId : ParameterArgumentValidationErrorNullNotAllowed,Microsoft.PowerShell.Commands.TestPathCommand

为 Path 参数提供空格字符串时，它将返回 $false。 这是Windows PowerShell 5.1 的更改。 提供空字符串时， Test-Path 返回错误。 以下示例显示空格和空字符串。

Test-Path ' '
Test-Path ''

False
False

测试包含驱动器规范的路径时，如果驱动器不存在，测试路径的有效性将失败。 可以使用提供程序名称为驱动器添加前缀，以解决此问题。

Test-Path -IsValid Z:\abc.txt
Test-Path -IsValid FileSystem::Z:\abc.txt

False
True

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将包含路径（但不是文本路径）的字符串传递给此 cmdlet。

该 cmdlet 返回 布尔 值。

包含 Path 名词（ Path cmdlet）的 cmdlet 使用路径，并返回所有 PowerShell 提供程序可以解释的简洁格式的名称。 它们旨在用于要以特定格式显示路径的所有或部分的程序和脚本。 像使用 Dirname、 Normpath、 Realpath、 Join 或其他路径操控器一样使用它们。

设计 Test-Path 用于处理任何提供程序公开的数据。 若要列出会话中可用的提供程序，请键入 Get-PSProvider。 有关详细信息，请参阅 about_Providers。