PowerShell：检查文件是否存在

要求：检查 PowerShell 中是否存在文件。

如何在PowerShell中检查文件是否存在？

PowerShell 是一个令人惊叹的工具，可让您自动执行任务并管理 Windows 操作系统。在 PowerShell 文件管理中可以执行的最基本任务之一是检查文件是否存在。此步骤对于避免错误并防止脚本意外失败至关重要。通过在对文件执行任何操作之前检查文件是否存在，您可以实现正确的错误处理逻辑并提供更流畅的用户体验。在这篇博文中，我们将讨论如何使用 PowerShell 检查文件是否存在，以便您可以继续下一步操作，例如创建新文件、删除、复制、重命名等。

使用测试路径 Cmdlet

Test-Path cmdlet 是 PowerShell 中的一个强大工具，用于确定给定路径中是否存在文件或目录。它返回一个布尔值，指示路径是否存在（True）或不存在（False）。 Test-Path cmdlet 用途广泛，可用于检查文件和目录，使其成为脚本库中的便捷工具。此 cmdlet 返回一个布尔值（$true 或 $false），指示文件是否存在。基本语法和参数如下：

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

以下是使用 Test-Path 使用 if-else 语句检查文件是否存在的示例：

$FilePath = "C:\temp\Report.txt"

#Check if file exists in given path
If (Test-Path -path $FilePath -PathType Leaf) {
    Write-Host "The file exists" -f Green
} Else {
    Write-Host "The file does not exist"  -f Yellow
}

在此示例中，我们首先定义一个变量 $FilePath，其中包含我们要检查的文件的路径。然后，我们使用 if 语句来检查 Test-Path 的结果。如果结果为 $true，则该文件存在，我们将向控制台打印一条消息。如果结果为 $false，则该文件不存在，并且我们打印一条不同的消息。我们使用 -PathType Leaf 参数来确保路径是一个文件。您还可以使用 -PathType Container 参数来检查路径是否是文件夹。

如果需要检查是否存在多个文件，可以使用循环来迭代文件路径列表。例如：

#Files Array
$Files = "C:\temp\File1.txt", "C:\temp\File2.txt", "C:\temp\File3.txt"

#Check Files exists
ForEach ($File in $Files) {
    #Check if file exists in given path
    If (Test-Path $File -PathType Leaf) {
        Write-Host "The file '$File' exists" -f Green
    } Else {
        Write-Host "The file '$File' does not exist"  -f Yellow
    }
}

Pathtype 参数指定路径中最终元素的类型（Any、Container 或 Leaf）。

检查相对路径中是否存在文件

在此示例中，假设您的 PowerShell 脚本位于同一目录中，有一个名为“script.ps1”的文件。您可以使用带有相对路径的 Test-Path cmdlet 检查文件是否存在：

Test-Path -Path .\script.ps1 -PathType Leaf

该命令将检查当前目录中是否存在“script.ps1”文件。如果是，cmdlet 将返回“True”。

执行复制前检查文件是否存在

下面是一个简单的 PowerShell 脚本，它使用 Test-Path 检查文件是否存在，然后使用 if 语句将其复制到目标：

#Parameters
$SourceFile = "C:\Logs\AppLog.txt"
$DestinationFile = "C:\Archives\AppLog.txt"

#Check if the source file exists
If (Test-Path $SourceFile) {
    Copy-Item -Path $sourceFile -Destination $destinationFile
    Write-Host "File copied successfully!"
} else {
    Write-Host "Source file does not exist!"
}

使用 Get-ChildItem Cmdlet 检查文件是否存在

Get-ChildItem cmdlet 是 PowerShell 中的多功能工具，用于检索指定位置中的文件和目录列表。它可用于通过在特定目录或其子目录中搜索文件来检查文件是否存在。 Get-ChildItem cmdlet 提供了一种灵活的方法来执行文件存在检查并同时收集有关多个文件的信息。

让我们深入研究一些示例，了解如何使用 Get-ChildItem cmdlet 检查 PowerShell 中是否存在文件。

Get-ChildItem -Path C:\temp\ -Filter Notes.txt

如果该文件存在，cmdlet 将返回有关该文件的信息，例如其属性和属性。如果该文件不存在，cmdlet 将不会返回任何输出。因此，您可以将其与 IF 条件结合起来检查特定文件是否存在：

If(Get-ChildItem -Path C:\temp\ -Filter Notes.txt)
{
    Write-host "File Exists!"
}
Else
{
   Write-host "File doesn't Exist!"
}

检查子目录中是否存在文件

Get-ChildItem cmdlet 还可以搜索子目录中的文件。假设您要检查“C:\temp”目录及其子目录中是否存在名为“Notes.txt”的文件。您可以使用以下命令：

Get-ChildItem -Path C:\temp\ -Filter Notes.txt -Recurse

如果该文件存在，cmdlet 将返回有关该文件的信息，包括其位置。如果该文件不存在，cmdlet 将不会返回任何输出。

检查特定扩展名的文件是否存在

Get-ChildItem cmdlet 允许您搜索具有特定扩展名的文件。例如，假设您要检查“C:\temp”目录中是否有任何 .txt 文件。您可以使用以下带有通配符的命令：

Get-ChildItem -Path C:\temp\ -Filter *.txt

如果目录中有 .txt 文件，cmdlet 将返回有关每个文件的信息，包括其属性。如果没有 .txt 文件，cmdlet 将不会返回任何输出。您还可以从搜索中排除某些文件类型。

利用 System.IO.File 类

除了 PowerShell 提供的内置 cmdlet 之外，您还可以利用 .NET 框架中的 System.IO.File 类来检查文件是否存在。此类提供了广泛的与文件相关的功能，包括文件存在检查的方法。

要使用 System.IO.File 类检查文件是否存在，可以使用 Exists() 方法。基本语法如下：

[System.IO.File]::Exists(<FilePath>)

假设您要检查“C:\temp”目录中是否存在名为“Notes.txt”的文件。您可以通过以下命令使用 System.IO.File 类：

[System.IO.File]::Exists("C:\Temp\Notes.txt")

如果文件存在，该命令将返回“True”。否则，它将返回“False”。

使用try-catch语句检查文件是否存在

我们可以使用 try-catch 块来创建文件。 try 块包含 New-Item 或 Out-File cmdlet，catch 块在文件已存在时处理错误。这是一个示例代码片段：

Try {
    New-Item -ItemType File -Path "C:\Temp\Notes.txt" -Value "File content" -ErrorAction Stop
}
Catch [System.IO.IOException] {
    Write-Host -F Yellow "File already exists!"
}

这是如何使用 Try-Catch 块处理文件不存在场景的另一个示例：

$FilePath = "C:\Temp\AppLog.txt"

Try {
    $FileItem = Get-Item -Path $filePath

    # If the script reaches this line, the file exists
    Write-Host "File exists!"
    Write-Host "File Properties:"
    $fileItem | Format-List *   # Display all properties of the file

} Catch {
    # If an error occurs in the try block, this catch block will execute
    Write-Host "File does not exist!"
}

PowerShell 创建文件（如果不存在）

要在 PowerShell 中创建文件（如果该文件尚不存在），您可以使用 New-Item cmdlet。此 cmdlet 允许您在文件系统中创建新文件、目录或其他类型的项目。以下是使用 New-Item 创建文件（如果文件尚不存在）的示例：

$FilePath = "C:\temp\report.txt"

if (!(Test-Path $FilePath)) {
    New-Item -Path $FilePath -ItemType File
}

在此示例中，我们首先使用 Test-Path cmdlet 来检查文件是否已存在。如果该文件不存在，我们使用 New-Item 来创建它。您还可以使用 New-Item 的 -Force 参数覆盖该文件（如果该文件已存在）。如果文件不存在，我们就创建一个新文件。如果文件已经存在，让我们向其中添加内容。

#File Path
$FilePath = "C:\temp\Report.txt"

#Check if file exists
If (Test-Path $FilePath){
    #Add Content to the existing File
    Add-Content -path $FilePath -Value "Storage Report"
    Write-Host "File already exists and content added" -f Yellow
} Else {
    #Create a new file if it doesn't exists
    New-Item -path $FilePath -ItemType File -Value "Storage Report`n" -Force
    Write-Host "Created new file and content added!" -f Green
}

我们使用 -Value 参数将文件的初始内容指定为字符串。

PowerShell 删除文件（如果存在）

要删除文件（如果存在），我们可以使用 Remove-Item cmdlet。此 cmdlet 允许我们删除指定路径中的文件。通过将 Test-Path cmdlet 与 Remove-Item cmdlet 结合使用，我们可以首先检查文件是否存在，如果存在则将其删除。

以下是使用 Remove-Item 删除文件（如果存在）的示例：在此示例中，我们首先使用 Test-Path cmdlet 来检查文件是否存在。如果文件存在，我们使用 Remove-Item 继续删除。

#File Path
$FilePath = "C:\temp\Report.txt"

If (Test-Path $FilePath) {
    Remove-Item $FilePath
}

您可以使用 Remove-Item 的 -WhatIf 参数来查看如果运行命令而不实际删除文件会发生什么。如果您想在运行命令之前测试该命令，这会很有用。例如：

#File Path
$FilePath = "C:\temp\Report.txt"

If (Test-Path $FilePath) {
    Remove-Item $FilePath -WhatIf
}
else {
    Write-Host "File does not exist!"
}

用于检查文件是否存在的其他 cmdlet

PowerShell 提供了几个其他内置 cmdlet 和方法来检查文件是否存在。我们可以将 if 语句中的 PowerShell Test-Path cmdlet 替换为其他 cmdlet，例如 Get-Item、Get-ItemProperty。以下是使用 Get-Item cmdlet 的示例代码片段：

$FilePath = "C:\Temp\Notes.txt"
If (!(Get-Item -path $FilePath -ErrorAction Ignore)) {
    New-Item -ItemType File -Path $FilePath -Value "File content"
}
Else {
    Write-Host "File already exists."
}

使用 PowerShell 检查远程计算机中是否存在文件

要使用 PowerShell 检查远程计算机上是否存在文件，您可以利用“Invoke-Command”cmdlet。下面是一个演示这一点的示例：

#Parameters
$RemoteComputer = "RemoteComputerName"
$FilePath = "C:\Logs\AppLog.txt"

# Script block to execute on the remote machine
$scriptBlock = {
    param ($filePath)

    # Check if the file exists and return the result
    Test-Path $filePath
}

# Invoke the command on the remote computer
$fileExists = Invoke-Command -ComputerName $remoteComputer -ScriptBlock $scriptBlock -ArgumentList $filePath

if ($fileExists) {
    Write-Host "The file exists on the remote computer."
} else {
    Write-Host "The file does not exist on the remote computer."
}

将“RemoteComputerName”替换为远程计算机的名称，将“C:\Logs\AppLog.txt”替换为要检查的文件的路径。

确保： 您拥有该计算机的必要权限。此外，必须在远程计算机上启用 PowerShell 远程处理（WS-Management 服务）。您可以在远程计算机上使用“Enable-PSRemoting”cmdlet 启用它。

包起来

总之，Test-Path cmdlet 是 PowerShell 中用于检查文件是否存在的有用 cmdlet。在处理文件时，确保我们尝试访问或操作的文件确实存在至关重要。通过在执行任何操作之前检查文件是否存在，我们可以避免错误、防止数据丢失并提高脚本的整体效率。无论您是编写脚本来自动进行文件备份、执行数据分析还是管理系统配置，检查文件是否存在都是确保脚本顺利运行的基本步骤。无论您是检查单个文件还是多个文件，Test-Path 都可以轻松检查文件和目录是否存在，并提供一种简单的方法来继续下一步的潜在操作，例如创建、删除、复制、 ETC。

经常问的问题：

如何在 PowerShell 中搜索目录中的文件？

要使用 PowerShell 搜索目录中的文件，可以使用带有 -Recurse 参数的 Get-ChildItem cmdlet。这将搜索指定目录及其所有子目录中的文件。您还可以使用过滤器根据文件名、扩展名、大小等缩小搜索结果范围。

$DirPath = "C:\temp"
$FileName = "MyFile.txt"
$File = Get-ChildItem -Path $DirPath -Recurse | Where-Object { $_.Name -eq $FileName }
If ($File) {
Write-Output "The file was found at $($File.FullName)."
} Else {
Write-Output "The file was not found."
}

如何检查 PowerShell 中是否存在目录？

要检查 PowerShell 中是否存在目录，可以使用 Test-Path cmdlet。以下是如何使用它的示例：

$DirPath = "C:\temp"
If (Test-Path $DirPath -PathType Container)
{
Write-Output "The directory exists."
}
Else
{
Write-Output "The directory does not exist."
}
Here is my related post: PowerShell to Check if a Folder Exists  
How to check file size in the PowerShell command? 
To check the file size in PowerShell, you can use the Get-Item cmdlet followed by the file path. This will display the file size in bytes. 
$FilePath = "C:\Temp\Notes.txt"
$File = Get-Item $FilePath
Write-host $File.Length
Related Post: How to Get the File Size in PowerShell?
  
How to check if a file exists and is not empty in PowerShell? 
In PowerShell, you can use the Test-Path cmdlet to check if a file exists. To also check if the file is not empty, you can use the Get-Item cmdlet to read the file and then check if the content is not null or empty. Here’s an example:
$file_path = "C:\temp\myfile.txt"
$file = Get-Item $file_path -ErrorAction SilentlyContinue
if ($file -and $file.Length -gt 0) {
Write-Output "The file exists and is not empty."
} elseif ($file) {
Write-Output "The file exists but it is empty."
} else {
Write-Output "The file does not exist."
}

如何在 PowerShell 中检查文件路径是否有效？

在 PowerShell 中，您可以使用 Test-Path cmdlet 检查文件路径是否有效。只需将文件路径作为参数提供给 Test-Path cmdlet，它将返回 True 或 False，指示文件路径是否存在。

Test-Path "C:\temp\myfile.txt"