使用 PowerShell Get-Help 命令发现未知事物

对于新手和专家来说，没有什么 cmdlet 比 PowerShell 帮助命令 Get-Help 更熟悉了。由于 PowerShell 具有集成且可更新的帮助系统，您可以通过 PowerShell Get-Help 命令来了解命令的用途、其参数，甚至（希望）有许多有关如何使用该命令的有用示例。

您遇到的每个 cmdlet 和函数都应该具有使用其构建的帮助内容，以便 PowerShell Get-Help cmdlet 可以读取。我说“应该”是因为不幸的是，一些作者不包含帮助内容。

可以通过运行 Get-Help 找到与命令关联的帮助内容。此命令读取由 cmdlet 或函数作者构建的基于注释和基于 XML 的帮助。

Get-Help cmdlet 最常见的用途是使用它来查找特定命令的帮助内容。例如，您可能通过 Get-Command cmdlet 发现了一个名为 Get-Content 的新命令，并且想了解有关它的更多信息。您可以在 Get-Help 上使用 Name 参数。这将返回有关该命令的一组基本信息，如下所示。

您会注意到，虽然返回了很多信息，但这只是您可以执行的操作的摘要。而且您永远不会知道 Get-Help 也可以返回其他类型的帮助内容，例如示例。

查找参数信息

您可以通过几种不同的方式深入了解帮助内容。其中一种方法是查找有关命令的单个参数的信息。也许在我在这里使用的示例中，我看到对 Raw 参数的引用，但不太确定该参数的作用。我可以将 Get-Help 上的 Parameter 参数与 Name 参数结合使用，以仅返回有关该特定命令参数的信息。

PowerShell 获取帮助和示例

PowerShell 帮助系统的优点之一是它对示例具有本机支持。示例是结合上下文了解如何使用特定命令的绝佳方式。如果命令作者在其帮助内容中添加了示例，您可以使用 Examples 参数查看这些示例。当您使用此参数时，Get-Help 将返回一个或多个示例，说明如何在不同情况下使用该命令。

获取详细帮助

摘要、参数信息和示例并不是 PowerShell Get-Help 命令返回的唯一信息。有时，您需要查看 cmdlet 的所有可用信息。在这种情况下，您始终可以使用 Detailed 和 Full 参数。这些参数中的每一个都显示越来越多的信息。

Detailed 参数将参数描述和示例添加到主要帮助显示中。本质上，它们使用 Examples 参数进行组合，并将显示所有参数的信息，就像您在所有命令参数上使用 Parameter 参数一样。

如果 Detailed 参数不够；您始终可以采用核心方法并使用 Full 参数返回所有帮助内容。该参数根本不过滤信息。 Full 参数读取为特定命令定义的所有帮助内容。

图形化

如果您想要更图形化的帮助表示，您还可以使用 ShowWindow 参数。此参数会打开一个窗口，允许您轻松搜索帮助内容，并通过“设置”按钮仅显示某些区域。如果您确实想帮助内容调查，此视图会很有帮助。

概括

还有一些其他不太常见的参数可以与 PowerShell Get-Help 命令一起使用。如果您有兴趣了解更多信息，您知道如何查找有关这些附加参数的信息，对吧？是的，Get-Help 可以自行查找帮助内容。

查找有关 PowerShell 命令的更多信息时，请认真使用 Get-Help 命令。当您拥有强大的帮助系统和帮助您利用它的命令时，就几乎没有必要去谷歌了。