PowerShell 初学者（第 4 部分）：PowerShell 帮助 (Get-Help)

现在，在第三部分 PowerShell 初学者（第 3 部分）：参数之后，我们将重点关注 PowerShell 帮助。但在我们开始第三个练习的答案之前。我们还将快速回顾一下迄今为止所学到的知识。

该系列的所有部分都可以在这里找到：PowerShell 初学者（系列）

回顾（第 3 部分）

锻炼

在第三部分我问为什么这个命令不起作用：

为什么这个命令不起作用？

第一个任务是找出过滤器 *.txt 和路径 C:\Temp 的参数。

Get-Help Get-ChildItem -Parameter *

一旦我们找到路径和过滤器参数，我们就可以看到它们是位置性的。

这意味着 Path 不需要参数名称（否则必须命名位置值），但它的参数值必须是命令中的第一个或唯一未命名参数值。这也意味着调用的第一个参数将自动绑定到路径参数。但我们的第一个参数定义了过滤器（*.txt），而不是路径。这个是有效的，因为路径的值位于第一个位置，过滤器的值位于第二个位置：

Get-ChildItem C:\Temp\ *.txt

概括

参数不同。有必需的、位置的、切换的、强制的和非强制的参数。 Get-Help 可以帮助您探索命令的所有参数。为此，请运行 Get-Help Your-Command -Parameter *。尽可能使用 TAB。

首先简单介绍一下 PowerShell 帮助

我们已经学习了如何使用帮助来探索参数。现在我们向前迈出了一大步。这部分是关于帮助和使用帮助的。 PowerShell 帮助是学习和发现新事物的绝佳来源。我坚信，如果您不熟悉这些帮助，您将永远无法成为一名优秀的 PowerShell 用户。

《Learn PowerShell in a Month of Lunches》一书的作者、PowerShell MVP 资深人士 Don Jones 表示：

“准备好阅读帮助，否则你将无法使用 PowerShell。 ”

您可以使用 cmdlet Get-Help 调用帮助。这通知您该帮助的详细版本只能在线获取。但好消息是：您可以下载它。

网上帮助

我们稍后会下载帮助文件。有一个解决方法。要使用命令 Get-ChildItem 的完整帮助，请运行

Get-Help Get-ChildItem -Online

执行后，将出现一个浏览器窗口，将您重定向至 Microsoft PowerShell 在线帮助。

下面的例子值得一看。他们都是伟大的。

默认情况下，运行 Windows 的计算机上不存储示例和详细帮助。我们现在要从在线存储库下载帮助文件。

审查

PowerShell 附带精简的帮助。有广泛的在线帮助。这些例子是帮助的核心。 Get-Help Your-Command -Online 在网络浏览器中打开在线帮助。

下载完整帮助

使用 Update-Help 下载帮助。这是如何下载 en-US（英语）文化帮助文件的示例。打开 Windows PowerShell。跑步

Update-Help -UICulture 'en-US' -Force

请注意，每个 IP 地址每天只能运行一次不带 -Force 的命令。因此，如果您位于配置为以过载模式 (PAT) 转换地址的 NAT 设备后面，那么请注意，您必须提供 Force 参数，因为所有客户端都使用相同的公共 IP 地址访问互联网并下载该公共 IP 地址每天允许使用一次。

现在完整的帮助范围已安装。是时候玩玩它了。

使用帮助

Get-Help 提供了广泛的参数。输入 Get-Help，然后输入 - 并按住 CTRL +按下空格键即可查看所有内容。

获取Get-ChildItem类型的帮助内容

Get-Help Get-ChildItem

或者

Help Get-ChildItem

注意：Help 是 Get-Help 的别名。

这显示了帮助的小版本。对于初学者来说，以这种方式阅读帮助可能会令人沮丧。它没有提供示例，也没有有关该命令使用的详细信息。让我们继续使用示例参数，它对于“边做边学”更有用。

到目前为止我们学到了什么？

使用命令 Update-Help 下载完整帮助。 Help 是 Get-Help 的别名。运行不带任何参数的 Get-Help 将显示帮助的小版本。

一个有用的参数：ShowWindow

如果您喜欢弹出窗口，请使用参数 ShowWindow。

Get-Help Get-ChildItem -ShowWindow

例子

PowerShell 帮助示例是一个非常好的资源，非常适合您使用 PowerShell 进行第一步操作。要获取 Get-ChildItem 示例，请键入

Get-Help Get-ChildItem -Examples

另一个示例演示如何将 Powershell 属性与 Get-Date 结合使用。我们还没有了解到这一点。但这不是断腿，我们可以尝尝。

Help Get-Date -Examples

向下滚动查找示例 4。

现在你可以开始玩了。例如，您可以修改命令并填写您的出生日期。

提示：输入 (Get-Date).，然后按 CTRL + 空格键。探索 Get-Date 的特性，享受乐趣。

我们现在无意中得到了对象和属性。这不是这篇文章的一部分，它会在稍后阶段出现，但为什么不使用它呢？我答应从一开始就开始。但现在我想给你一个小小的预告，在本系列接下来的部分中等待着你的是：

例子：

(Get-Date -Year 1976 -Month 03 -Date 23).IsDaylightSavingTime()

(Get-Date).AddDays(300)

审查

这些示例是通过实践学习 PowerShell 的绝佳来源。可以通过使用在线帮助或使用示例参数来显示它们。为此，请运行 Get-Help Your-Command -Examples

完整的帮助

获得完整的帮助运行

Get-Help Get-Date -Full

完整帮助显示整个帮助主题。这包括参数、属性以及最后但并非最不重要的示例。

详细帮助

Get-Help 参数详细显示参数说明和示例。

Get-Help Get-Date -Detailed

到目前为止我们学到了什么？

完整帮助显示整个帮助主题。详细帮助显示了详细的参数说明和示例。 再次强调：例子是最重要的。

帮助文件位置

下载的帮助文件可以在以下位置找到

C:\Windows\System32\WindowsPowerShell\v1.0\en-US\

文件名为 Microsoft.PowerShell.Commands.Management.dll-Help.xml。

此帮助文件也可以在 PowerShell 中显示：

(Get-Command Get-ChildItem).Helpfile

或者使用 Get-Help 显示帮助文件。我们在第三部分中处理了参数。这是有关参数的文件（位于 C:\Windows\System32\WindowsPowerShell\v1.0\en-US\ 中）

Get-Help about_Parameters

审查

帮助文件位于特定的 Windows 文件夹 C:\Windows\System32\WindowsPowerShell\v1.0\en-US

有关 Microsoft 文档中的 PowerShell 帮助的更多信息：https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/get-help?view=powershell-5.1

今天就这样。希望你喜欢它！这是下次练习。

锻炼

请记住我们的行为准则：

自己动手。任何你自己不做的事情很快就会被遗忘。

命令start-process的第四个帮助示例是什么？找到它后，请在计算机上运行它！

解决方案可以在下一部分中找到。

下一篇文章见 PowerShell 初学者（第 5 部分）：执行策略（ps1 文件）

Patrick Gruenauer，PowerShell MVP