Powershell 脚本退出时返回错误代码205

在编写 PowerShell 脚本时，您可能需要指定脚本退出时的错误代码。这对于指示脚本是否成功运行以及可能出现的任何错误非常有用。通过使用 `exit` 命令，您可以指定退出代码并向 PowerShell 返回错误消息。

使用 `exit` 命令

`exit` 命令用于在 PowerShell 脚本中中止执行并返回指定错误代码。其语法为：```powershell
exit [ErrorCode] [Message]
```
* `ErrorCode`：指定退出代码。它应该是一个介于 0 到 255 之间的整数。
* `Message`：可选的错误消息，将在脚本退出时显示。

例如，以下脚本将在运行时显示错误消息并退出代码 1：```powershell
Write-Error "An error occurred."
exit 1
```

预定义的错误代码

PowerShell 为某些常见错误提供了预定义的错误代码。这些代码可以在 `` 模块中找到。使用这些预定义的代码可以帮助您使脚本更具一致性和可读性。以下是一些常见的预定义错误代码：* `0`：没有错误。
* `1`：一般错误。
* `2`：参数格式不正确。
* `3`：文件或目录不存在。
* `4`：访问被拒绝。
* `5`：找不到命令。
* `6`：磁盘空间不足。
* `7`：文件或目录已损坏。
* `8`：网络连接丢失。
* `9`：超时。

要使用预定义错误代码，请使用 `throw` 命令。`throw` 命令用于在脚本中引发异常。语法如下：```powershell
throw [New-Object ]([]::[ErrorCode], "Error Message")
```
* `ErrorCode`：预定义的错误代码。
* `Message`：错误消息。

例如，以下脚本将引发 `FileNotFoundException` 异常并退出代码 3：```powershell
try {
Get-Item "C:
} catch {
throw [New-Object ]([]::FileNotFound, "File not found.")
}
```

获取退出代码

可以通过 `$LastExitCode` 自动变量获取脚本的退出代码。该变量在脚本执行后包含最后一个执行命令的退出代码。例如：```powershell
$result = Get-ChildItem "C:onexistentfolder"
$exitCode = $LastExitCode
```

最佳实践* 使用预定义的错误代码：使用预定义的错误代码可以使您的脚本更具一致性和可读性。
* 指定错误消息：在 `exit` 命令中提供错误消息可以帮助调试和故障排除。
* 处理异常：使用 `try/catch` 块来处理脚本中的异常，并根据需要指定退出代码。
* 测试退出代码：使用 `$LastExitCode` 自动变量来测试脚本的退出代码，并根据需要采取相应措施。

2024-12-05

上一篇：防止 PowerShell 脚本启动多个副本

下一篇：直接运行的 PowerShell 脚本：快速入门指南