powershell - 下载 Powershell 文档

Question

https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/?view=powershell-6

在该网站中，左侧导航栏有一个称为“引用”的部分，其中包含每个 Powershell 命令，每个命令都有解释和示例。我想打印它以便离线阅读，但我需要数周时间才能将所有内容复制并粘贴到文档中。是否没有我可以下载包含引用部分内容的 PDF 或某些文档？我找不到这样的东西。我对想法持开放态度，例如编写一个 Powershell 脚本来将所有命令、它们的描述和示例存储到一个文件中。除了手动复制和粘贴之外，我对任何事情都持开放态度。 Microsoft 有可下载的版本吗？如果没有，你会怎么做？

我找到了这个:https://github.com/MicrosoftDocs/PowerShell-Docs/tree/staging/reference/6

这是一个好的开始，但打印所有内容似乎仍然需要大量工作。如果不打印，也许将所有 md 文件放入一个可以用电子书阅读的文件中？

Answer 1

学生/任何脚本编写者都应该运行 Get-Help help，然后运行 ​​Get-Help $TopicsYouCareAbout。您偶尔会需要Update-Help，但对于您安装的任何模块，您始终可以轻松获得有关 MS 文档的大量有值(value)的文档。

您还可以使用 platyPS 从这个生成的文档生成 Markdown 文档模块。您需要先安装要为其生成文档的模块。

Install-Module -Name platyPS 
Import-Module platyPS

$modules = @('platyPS','Microsoft.PowerShell.Management')
foreach($module in $modules){
    New-MarkdownHelp -OutputFolder "C:\PSGeneratedDocs" -Module $module
}

这会将一堆 markdown 文件输出到 C:\PSGeneratedDocs 中。您可以更进一步，使用 pandoc 发布 pdf/epub/其他格式(您需要确保为这一步安装了 pdf 引擎，但是根据您的平台/完成书的需求，有很多资源可以提供帮助。

foreach($mdFile in (Get-ChildItem "C:\PGGeneratedDocs" | where {$_.Extension -eq ".md"})){
    pandoc -s $mdFile -o "C:\PGGeneratedDocs\$($mdFile.BaseName).pdf"
}

监控他们的 git 存储库在本质上是相同的，但更复杂，对您来说几乎没有额外的好处。