通过

about_Modules

简短说明

介绍如何安装、导入和使用 PowerShell 模块。

详细说明

PowerShell 既是命令行界面，也是脚本语言。 PowerShell 中的命令作为脚本、函数或 cmdlet 实现。 该语言包括 关键字，这些关键字提供处理的结构和逻辑，以及其他资源，例如变量、提供程序、别名。

模块是一个自包含的可重用单元，可以包含 cmdlet、提供程序、函数、变量和其他资源。 默认情况下，PowerShell 会在首次使用模块中的命令时自动加载已安装的模块。 可以使用变量 $PSModuleAutoLoadingPreference配置自动模块加载行为。 有关详细信息，请参阅 about_Preference_Variables。

也可以在 PowerShell 会话期间手动加载或卸载模块。 若要加载或重新加载模块，请使用 Import-Module。 若要卸载模块，请使用 Remove-Module cmdlet。

PowerShell 包含一组基本模块。 任何人都可以使用 C# 或 PowerShell 脚本语言本身创建新模块。 使用 C# 编写并已编译为 .NET 程序集的模块被称为本机模块。 在 PowerShell 中编写的模块称为脚本模块。

本文介绍如何使用 PowerShell 模块。 有关如何创建 PowerShell 模块的信息，请参阅 编写 PowerShell 模块。

注意

在 PowerShell 3.0 之前，命令和提供程序被打包在 PowerShell 管理单元中。从 PowerShell 3.0 开始，默认会将 Microsoft.PowerShell.Core 管理单元添加到每个会话。 这是 PowerShell 中仅存的一个快速插件。 所有其他快件都已转换为模块。 不再支持创建新的快显。

默认模块位置

PowerShell 将模块存储在以下默认位置：

  • 在 Windows 上
    • 所有用户范围 - $Env:ProgramFiles\PowerShell\Modules
    • 当前用户范围 - $HOME\Documents\PowerShell\Modules
    • 随 PowerShell 一起提供的模块 - $PSHOME\Modules
  • 在 Linux 和 macOS 上
    • 所有用户范围 - /usr/local/share/powershell/Modules
    • 当前用户范围 - $HOME/.local/share/powershell/Modules
    • 随 PowerShell 一起提供的模块 - $PSHOME/Modules

默认情况下，当前用户的 Modules 文件夹不存在。 如果使用 CurrentUser 或 Install-Module在 Install-PSResource 范围内安装了模块，则这些 cmdlet 将为当前用户创建 Modules 文件夹。 如果文件夹不存在，可以手动创建它。

使用以下命令为当前用户创建 Modules 文件夹：

$folder = New-Item -Type Directory -Path $HOME\Documents\PowerShell\Modules

这些位置自动包含在 $Env:PSModulePath 环境变量中。 有关默认模块位置的详细信息，请参阅 about_PSModulePath。

模块自动加载

首次从已安装的模块运行命令时，PowerShell 会自动导入该模块（加载）。 模块必须存储在 $Env:PSModulePath 环境变量中指定的位置。

模块自动加载允许您在模块中使用命令，而无需任何预先设置或配置文件。 以下示例中的每个示例都会导致 CimCmdlet 模块（其中包含 Get-CimInstance）导入到会话中。

  • 运行命令

    Get-CimInstance Win32_OperatingSystem

  • 获取命令

    Get-Command Get-CimInstance

  • 获取命令的帮助

    Get-Help Get-CimInstance

将 Get-Command 与通配符（*）一起使用时，PowerShell 不会导入任何模块。 可以将通配符用于命令发现，而无需加载会话中可能不需要的模块。

手动导入模块

当模块未安装在由 $Env:PSModulePath 环境变量指定的位置，或者当模块作为独立 .dll 或 .psm1 文件提供（而不是打包模块）时，需要手动导入模块。

此外，使用 PowerShell 提供程序的命令不会自动导入模块。 例如，如果使用需要 WSMan: 驱动器（如 Get-PSSessionConfiguration cmdlet）的命令，则可能需要运行 Import-Module cmdlet 来导入包含 驱动器的 WSMan: 模块。

你可能还想要更改模块在会话中导入的方式。 例如， 的 Import-Module 参数向从模块导入的 cmdlet 的名词部分添加一个独特的前缀。 NoClobber 参数可防止模块添加命令，这些命令将隐藏或替换会话中的现有命令。 有关详细信息，请参阅 管理名称冲突。

以下示例将 BitsTransfer 模块导入当前会话。

Import-Module BitsTransfer

若要导入不在 $Env:PSModulePath中的模块，请使用模块文件夹的完全限定路径。 例如，若要将 目录中的 C:\ps-test 模块添加到会话，请键入：

Import-Module C:\ps-test\TestCmdlets

若要导入模块文件夹中不包含的模块文件，请使用命令中模块文件的完全限定路径。 例如，若要将 C:\ps-test 目录中的 TestCmdlets.dll 模块添加到会话，请键入：

Import-Module C:\ps-test\TestCmdlets.dll

有关将模块添加到会话的详细信息，请参阅 Import-Module。

在每个会话开始时导入模块

Import-Module 命令将模块导入到当前的 PowerShell 会话中。 若要将模块导入到启动的每个 PowerShell 会话中，请将 Import-Module 命令添加到 PowerShell 配置文件。

有关配置文件的详细信息，请参阅 about_Profiles。

安装已发布的模块

发布的模块是从注册的资源库如 PowerShell 库中提供的模块。 PowerShellGet 和 Microsoft.PowerShell.PSResourceGet 模块提供了用于查找、安装和发布 PowerShell 模块到已注册存储库的 cmdlet。

PowerShell 5.0 及更高版本随附了 PowerShellGet 模块。 Microsoft.PowerShell.PSResourceGet 模块包含在 PowerShell 7.4 及更高版本中，是 PowerShell 的首选包管理器。 Microsoft.PowerShell.PSResourceGet 可与旧版 PowerShell 上的 PowerShellGet并排安装。 使用 Install-Module 或 Install-PSResource cmdlet 从 PowerShell 库安装模块。

 Get-Command Install-Module, Install-PSResource

CommandType  Name                Version    Source
-----------  ----                -------    ------
Function     Install-Module      2.9.0      PowerShellGet
Cmdlet       Install-PSResource  1.0.0      Microsoft.PowerShell.PSResourceGet

有关详细信息，请参阅 PowerShellGet 概述。

手动安装模块

可以通过从另一个文件夹中复制模块内容来手动安装模块。 该文件夹可以位于本地计算机上的另一个位置，也可以安装在另一台计算机上。 若要手动安装模块，请将整个模块文件夹复制到 $Env:PSModulePath中包含的新位置。

在 PowerShell 中使用 Copy-Item cmdlet。 例如，运行以下命令，从 MyModule复制 C:\PSTest 文件夹：

$modulePath = $HOME\Documents\PowerShell\Modules\MyModule
Copy-Item -Path C:\PSTest\MyModule\* -Destination $modulePath -Recurse

可以在任何位置安装模块，但在默认模块位置安装模块可以更轻松地管理模块。

查找已安装的模块

Get-Module cmdlet 获取当前 PowerShell 会话中加载的 PowerShell 模块。

Get-Module

列出的模块可以包括从任何位置导入的模块，而不仅仅是从 $Env:PSModulePath导入的模块。

使用以下命令列出安装在 $Env:PSModulePath中的模块：

Get-Module -ListAvailable

此命令获取安装在 $Env:PSModulePath中的所有模块，而不仅仅是导入到当前会话中的模块。 此命令不会列出在其他位置安装的模块。

更多信息, 看看 获取模块.

列出模块中的命令

使用 Get-Command cmdlet 查找所有可用的命令。 可以使用 Get-Command cmdlet 的参数按模块、名称和名词等筛选命令。

若要查找模块中的所有命令，请键入：

Get-Command -Module <module-name>

例如，若要在 BitsTransfer 模块中找到命令，请键入：

Get-Command -Module BitsTransfer

有关 Get-Command cmdlet 的详细信息，请参阅 Get-Command。

删除模块

删除模块时，模块添加的命令将从会话中删除。 例如，以下命令从当前会话中删除 BitsTransfer 模块。

Remove-Module BitsTransfer

删除模块会逆转导入模块的过程。 删除模块不会卸载该模块。 有关详细信息，请参阅 Remove-Module。

可以通过模块和快显将命令添加到会话中。模块可以添加所有类型的命令，包括 cmdlets、提供程序和函数，以及变量、别名和 PowerShell 驱动器等项目。 管理单元只可以添加 cmdlet 和提供程序。

在从会话中删除模块之前，请使用以下命令确定要删除的模块。

例如，使用以下命令查找 Get-Date 和 Get-Help cmdlet 的源：

Get-Command Get-Date, Get-Help -All |
    Select-Object -Property Name, CommandType, Module ,PSSnapIn

以下输出表明 Get-Help cmdlet 位于 Microsoft.PowerShell.Core 插件中。 无法从会话中移除此快件。

Name     CommandType Module                       PSSnapIn
----     ----------- ------                       --------
Get-Date    Function
Get-Date      Cmdlet Microsoft.PowerShell.Utility
Get-Help      Cmdlet                              Microsoft.PowerShell.Core

有两个来源 Get-Date. 一个是函数，另一个是 Microsoft.PowerShell.Utility 模块中的 cmdlet。 可以使用 Remove-Module删除模块。 若要删除函数，可以从 Function: 驱动器中删除它。

Remove-Item Function:Get-Date

有关 Function: 驱动器的详细信息，请参阅 about_Function_Provider。

管理名称冲突

当会话中的多个命令具有相同名称时，会发生名称冲突。 当模块中的命令与会话中的命令或项具有相同的名称时，导入模块会导致名称冲突。

Import-Module 可能会添加命令来隐藏和替换当前会话中的命令。 名称冲突可能会导致命令被隐藏或替换。 当导入的模块包含与会话中的现有命令同名的命令时，会发生命令替换。 新导入的命令优先于现有命令。

例如，当会话包含具有相同名称的函数和 cmdlet 时，PowerShell 默认运行该函数。 默认情况下，当会话包含具有相同名称的相同类型的命令（例如两个具有相同名称的 cmdlet）时，它将运行最近添加的命令。

有关详细信息，包括优先规则的说明以及运行隐藏命令的指示，请参阅 about_Command_Precedence。

可以通过限定命令名称来运行隐藏或替换的命令。 若要限定命令名称，请添加包含所需命令版本的模块的名称。 例如：

Microsoft.PowerShell.Utility\Get-Date

使用带有模块名称前缀的 Get-Date 可确保运行来自 Microsoft.PowerShell.Utility 模块的版本。

若要检测名称冲突，请使用 cmdlet 的 Get-Command 参数。 默认情况下，Get-Command 仅获取键入命令名称时运行的命令。 All 参数获取会话中具有特定名称的所有命令。

若要防止名称冲突，请使用 cmdlet 的 NoClobber 或 Import-Module 参数。 Prefix 参数将前缀添加到导入的命令的名称中，以便它们在会话中是唯一的。 NoClobber 参数不会导入那些可能会隐藏或替换当前会话中现有命令的命令。

还可以使用 别名、Cmdlet、函数和 Import-Module 参数来仅选择要导入的命令，并且可以排除导致会话中名称冲突的命令。

模块作者可以使用模块清单的 DefaultCommandPrefix 属性来阻止名称冲突，从而将所有命令名称添加默认前缀。 Prefix 参数的值优先于 DefaultCommandPrefix的值。

另请参阅

  • Last updated on