如何像老板一样导入PowerShell模块

PowerShell 是一种非常强大的脚本语言。但要释放其潜力，您必须知道如何导入正确的模块。

在本教程中，您将学习像专业人士一样导入 PowerShell 模块所需的一切知识。通过对 cmdlet、参数和模块的深入了解，您可以创建比以往更快、更高效、更有效的脚本。

继续阅读以增强您的 PowerShell 技能并将您的脚本编写游戏提升到新的高度！

先决条件

本教程将是一个实践演示。要继续操作，请确保您的系统安装了 PowerShell。本教程使用 Windows 10 和 PowerShell 5.1 作为示例，但相同的命令应该适用于大多数版本的 Windows 和 PowerShell。

导入单个模块

PowerShell 模块包含可在 PowerShell 脚本中使用的预构建代码，从而节省您的时间和精力。导入 PowerShell 模块时，您可以利用预先构建的代码，而不是从头开始。

但是如何导入 PowerShell 模块呢？ Import-Module cmdlet 是在 PowerShell 中导入模块的主要方式。导入单个模块是 Import-Module cmdlet 最基本的用途之一，这是您将在本教程中学习的第一件事。

以管理员身份打开 PowerShell，然后运行以下 Import-Module 命令来搜索 PSDiagnostics 模块并将其加载到内存中。如果成功，模块将被导入，但该命令不会产生输出。

Import-Module PSDiagnostics

强烈建议尽可能通过 Install-Module cmdlet 从在线存储库导入模块。此 cmdlet 会为您处理依赖项和版本管理。

导入模块后，您可以使用该模块的任何 cmdlet 或函数来帮助您诊断和解决问题。 Enable-PSTrace cmdlet 只是 PSDiagnostics 模块提供的 cmdlet 的示例之一，该模块可在 PowerShell 中启用诊断跟踪。

现在，运行以下 Enable-PSTrace 命令来执行诊断跟踪，并将结果保存到指定的 -TraceFilePath (C:\MyTrace.log）。此命令不会向控制台提供输出，因为结果会提交到文件中。

Enable-PSTrace -TraceLevel 1 -TraceFilePath C:\MyTrace.log

某些模块可能需要额外的配置或设置才能使用它们。请务必阅读模块随附的文档，以了解任何先决条件或要求。

一次导入多个模块

导入单个模块效果很好。但是，当您经常需要一次性导入多个模块时，该任务也在 Import-Module cmdlet 的权限范围内。

在 PowerShell 中导入多个模块是节省时间和精力的好方法。但具体如何呢？您将指定以逗号分隔的模块名称。

运行以下命令搜索多个模块（Dism、PowerShellGet、PSReadline）并将它们加载到内存中。与导入单个模块一样，此命令不提供输出。

Import-Module Dism, PowerShellGet, PSReadline

显示模块导入详细信息

如前所述，成功的模块导入不提供输出。但承认吧。您会怀疑该模块是否确实被导入。

-Verbose 参数是一个有用的选项，可以与许多 PowerShell cmdlet 和函数一起使用，包括 Import-Module cmdlet。此参数告诉 PowerShell 在执行命令时显示有关该命令的详细信息。反过来，您可以获得可用于故障排除和调试的宝贵反馈。

运行以下命令导入 SmbShare 模块，附加 -Verbose 参数以打印模块导入详细信息。

Import-Module SmbShare -Verbose

如下所示，-Verbose 参数提供了有关正在加载的模块文件以及从模块导入的各种函数的详细信息。这些信息可以帮助理解模块的内部工作原理。

在这种情况下，SmbShare 模块提供用于管理 Windows 计算机上的 SMB 共享的 cmdlet。这些 cmdlet 包括但不限于 New-SmbShare（创建新共享）和 Remove-SmbShare（删除现有共享）。

将模块重新导入到同一会话中

无论您的模块正在运行，还是只是想确保使用的是最新版本的模块，重新导入 PowerShell 都是有益的。如何？通过将 -Force 参数附加到 Import-Module 命令。

此 -Force 参数允许您继续使用模块提供的 cmdlet 和函数，而无需关闭并重新打开 PowerShell 会话。

重新导入模块的一个常见用例是当您开发和更改模块时。您可以将模块重新导入到当前会话中，以在最终确定之前测试这些更改。

运行以下命令以 -Force PowerShell 删除并从其原始位置重新导入 SmbShare 模块。

-Prefix 参数允许您为从模块导入的 cmdlet 和函数指定前缀。在这种情况下，所有导入的 cmdlet 和函数都将以 New 开头。此参数对于避免与会话中现有 cmdlet 或函数发生冲突非常有用。

例如，原始模块中的 Get-SmbShare cmdlet 将在重新导入的模块中变为 Get-NewSmbShare。

Import-Module SmbShare -Force -Prefix New

现在，运行下面的 Get-Command 以检索按名称选择 (Select-Object) 的 SmbShare 模块提供的所有 cmdlet 和函数的列表。

Get-Command -Module SmbShare | Select-Object Name

在下面，您可以看到 SmbShare 模块的 cmdlet 现在在其名称中添加了前缀 New。此输出确认模块已成功重新导入。

使用 NuGet 包手动导入 PowerShell 模块

到目前为止，您已成功从 PowerShell 库导入模块。但是如果您正在寻找的模块不存在怎么办？

您可以从 NuGet 包手动安装和导入 PowerShell 模块。在 PowerShell 上下文中，NuGet 包是文件的集合，其中包含 PowerShell 模块以及该模块工作所需的任何依赖模块或库。

要从 NuGet 包导入模块，您需要按照以下步骤手动下载、解压并安装 NuGet 包：

1. 导航到 Az.Automation 模块的 Azure PowerShell 库页面。

2. 接下来，单击手动下载选项卡→下载原始nupkg文件下载软件包。本教程使用 Azure PowerShell 库中的 Az.Automation 1.9.1 模块作为示例。但相同的步骤适用于其他 NuGet 包。

3. 下载后，运行以下 Unblock-File 命令，该命令不提供输出，但会解锁下载的 .nupkg 文件。请务必将文件路径更改为您下载软件包的路径。

解锁该包是必要的。为什么？ PowerShell 可能不允许执行从 Internet 下载的文件，作为防止执行潜在有害脚本的安全措施

Unblock-File -Path C:\PSModules\az.automation.1.9.1.nupkg

4. 现在，将下载的 .nupkg 文件解压缩到本地计算机上的文件夹中。您可能需要7-zip或WinRAR等压缩/解压工具来解压缩包。 NuGet 包是一个 ZIP 存档，其中包含组成模块的文件集合。

5. 从解压的文件夹中删除以下内容。

NuGet 包的提取内容包括手动模块安装不需要的一些元数据和文件。

文件夹

文件夹

XML文件

XML 清单文件

6. 使用更具描述性的名称（如 az.automation）重命名提取的文件夹，以避免可能出现的任何错误。请记住将所有字母保持小写，并避免在名称中使用特殊字符。

7. 接下来，运行下面的 $env:PSModulePath 命令查找当前 shell 模块的路径。此命令返回系统上所有默认模块路径的列表。当在脚本或命令中指定模块名称时，PowerShell 会搜索这些路径以自动加载模块。

$env:PSModulePath

记下路径，因为您在下一步中将需要它们。

8. 将新命名的文件夹 (az.automation) 复制到您在第七步中记下的目录之一。这样做定义了模块的范围（特定或所有用户）。

使该模块可用于特定用户帐户（管理员）。本教程使用此位置作为示例。

使该模块可用于本地计算机上的所有用户帐户。

9. 现在，运行以下命令来安装模块 (az.automation) 并将其导入到 PowerShell 会话中。请务必将 az.automation 替换为模块的实际名称。

Import-Module -Name az.automation -Verbose

10. 最后，运行以下 Get-Module 命令来验证模块 (az.automation) 是否已成功导入。

Get-Module -Name az.automation

也许您不想依赖自动发现。如果是这样，请在导入模块时指定确切的文件位置 (C:\az.automation)。

Import-Module -Name C:\az.automation -Verbose

结论

通过联合函数或分组代码，PowerShell 模块改变了游戏规则。在本教程中，您学习了将 PowerShell 模块导入会话的多种方法，包括从 NuGet 包手动导入模块。您还涉及了控制导入过程的不同参数。

通过掌握这些技术，您可以轻松导入和使用模块来增强您的自动化脚本。但学习并不仅限于此。为什么不通过学习导出模块成员来将您的 PowerShell 模块管理技能提升到一个新的水平呢？