about_Modules
简短说明
介绍如何安装、导入和使用 PowerShell 模块。
长说明
PowerShell 是一种脚本语言和命令 shell。 该语言由提供处理结构和逻辑的 关键字以及执行工作的命令组成。 PowerShell 中的命令作为脚本、函数或 cmdlet 实现。
模块是一个自包含的可重用单元，可以包含 cmdlet、提供程序、函数、变量和可作为单个单元导入的其他类型的资源。
PowerShell 附带一组基本模块。 还可以根据需要安装更多模块。 默认情况下，首次使用模块中的命令时，将自动加载已安装的模块。 $PSModuleAutoloadingPreference使用 变量启用、禁用和配置模块的自动加载。 有关详细信息，请参阅 about_Preference_Variables。
可以在会话期间卸载或重新加载。 Remove-Module使用 cmdlet 从会话中卸载模块。 Import-Module使用 cmdlet 加载模块。
可以将模块创建为用 C# 编写的已编译的 .NET 程序集，也可以创建在 PowerShell 中编写的基于脚本的模块。 本主题说明如何使用 PowerShell 模块。 有关如何编写 PowerShell 模块的信息，请参阅 编写 PowerShell 模块。
注意
在 PowerShell 3.0 之前，cmdlet 和提供程序打包在 PowerShell 管理单元中。从 PowerShell 3.0 开始， Microsoft.PowerShell.Core 管理单元默认添加到每个会话。 这是 PowerShell 中唯一剩余的管理单元。 所有其他管理单元已转换为模块。 不再支持创建新管理单元。
安装已发布的模块
已发布的模块是从已注册的存储库（例如PowerShell 库）提供的模块。 PowerShellGet 和 Microsoft.PowerShell.PSResourceGet 模块提供用于查找、安装和将 PowerShell 模块发布到已注册存储库的 cmdlet。
PowerShellGet 模块包含在 PowerShell 5.0 及更高版本中。 Microsoft.PowerShell.PSResourceGet 模块包含在 PowerShell 7.4 及更高版本中。 Microsoft.PowerShell.PSResourceGet 是 PowerShell 的新首选包管理器，可以安装在以前版本的 PowerShell 上。 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 概述。
手动安装模块
如果收到一个模块作为包含文件的文件夹，则需要先将其安装在计算机上，然后才能在 PowerShell 中使用它。
PowerShell 附带多个预安装的模块。 在基于 Windows 的计算机上，许多 Windows 功能包括用于管理该功能的模块。 安装该功能后，将安装这些模块。 其他模块可能位于安装该模块的安装程序或安装程序中。
默认情况下， Modules 当前用户的文件夹不存在。 如果使用 或 在CurrentUser作用域Install-Module中安装了模块，则这些 cmdlet 会为当前用户创建 Modules 文件夹。Install-PSResource 如果该文件夹不存在，可以手动创建它。
使用以下命令为当前用户创建 Modules 文件夹：
$folder = New-Item -Type Directory -Path $HOME\Documents\PowerShell\Modules
将整个模块文件夹复制到新创建的文件夹中。 在 PowerShell 中， Copy-Item 使用 cmdlet。 例如，运行以下命令，将 MyModule 文件夹从 C:\PSTest 复制到刚刚创建的文件夹：
Copy-Item -Path C:\PSTest\MyModule -Destination $folder
你可以在任何位置上安装模块，但在默认模块位置中安装模块可使其更易于管理。 有关默认模块位置的详细信息，请参阅 about_PSModulePath。
模块自动加载
首次从已安装的模块运行命令时，PowerShell 会自动导入 (加载) 该模块。 模块必须存储在环境变量中指定的位置中 $env:PSModulePath 。 必须使用 cmdlet 导入其他位置中的 Import-Module 模块。
模块自动加载允许在模块中使用命令，而无需进行任何设置或配置文件配置。 在计算机上安装模块后，无需对其进行管理。
以下每个示例都会导致将包含 Get-CimInstance的 CimCmdlet 模块导入到会话中。
运行命令
Get-CimInstance Win32_OperatingSystem获取命令
Get-Command Get-CimInstance获取命令的帮助
Get-Help Get-CimInstance
可以使用 Get-Command cmdlet 列出所有已安装模块中的命令，即使它们尚未在会话中。 Get-Command使用通配符 () * 时，PowerShell 不会导入任何模块。 可以使用通配符来发现命令，而无需加载会话中可能不需要的模块。
此外，使用 PowerShell 提供程序的命令不会自动导入模块。 例如，如果使用需要驱动器的WSMan:命令（如 Get-PSSessionConfiguration cmdlet），则可能需要运行 Import-Module cmdlet 来导入包含该驱动器的 WSMan:Microsoft.WSMan.Management 模块。
手动导入模块
如果模块未安装在环境变量指定 $env:PSModulePath 的位置中，或者模块作为独立 .dll 或 .psm1 文件（而不是打包的模块）提供，则需要手动导入模块。
你可能还需要更改模块在会话中的导入方式。 例如，的 Import-ModulePrefix 参数向从模块导入的 cmdlet 的名词部分添加一个独特的前缀。 NoClobber 参数可防止模块添加隐藏或替换会话中的现有命令的命令。 有关详细信息，请参阅 管理名称冲突。
可以通过指定模块名称导入已安装的 $env:PSModulePath 模块。 例如，以下命令将 BitsTransfer 模块导入当前会话。
Import-Module BitsTransfer
若要导入不在 中的 $env:PSModulePath模块，请使用模块文件夹的完全限定路径。 例如，若要将目录中的 TestCmdlets 模块 C:\ps-test 添加到会话，请键入：
Import-Module C:\ps-test\TestCmdlets
若要导入模块文件夹中不包含的模块文件，请在 命令中使用模块文件的完全限定路径。 例如，若要将目录中的 TestCmdlets.dll 模块 C:\ps-test 添加到会话，请键入：
Import-Module C:\ps-test\TestCmdlets.dll
有关将模块添加到会话的详细信息，请参阅 Import-Module。
在每个会话开始时导入模块
命令 Import-Module 将模块导入当前 PowerShell 会话。 若要将模块导入到启动的每个 PowerShell 会话中，请将 Import-Module 命令添加到 PowerShell 配置文件。
有关配置文件的详细信息，请参阅 about_Profiles。
查找已安装的模块
cmdlet Get-Module 获取已在会话中导入的 PowerShell 模块。
Get-Module
列出的模块可以包括从任何位置导入的模块，而不仅仅是从 $env:PSModulePath导入。
使用以下命令列出 中 $env:PSModulePath安装的模块：
Get-Module -ListAvailable
此命令获取中 $env:PSModulePath安装的所有模块，而不仅仅是导入到当前会话中的模块。 此命令不会列出安装在其他位置的模块。
有关详细信息，请参阅 Get-Module。
列出模块中的命令
Get-Command使用 cmdlet 查找所有可用的命令。 可以使用 cmdlet 的参数 Get-Command 按模块、名称和名词筛选命令。
若要查找模块中的所有命令，请键入：
Get-Command -Module <module-name>
例如，若要在 BitsTransfer 模块中查找命令，请键入：
Get-Command -Module BitsTransfer
有关 cmdlet 的详细信息 Get-Command ，请参阅 Get-Command。
删除模块
当你删除模块时，该模块所添加的命令将从会话中删除。 例如，以下命令从当前会话中删除 BitsTransfer 模块。
Remove-Module BitsTransfer
删除模块与导入模块的操作相反。 删除模块不会卸载该模块。 有关详细信息，请参阅 Remove-Module。
可以从模块和管理单元将命令添加到会话。模块可以添加所有类型的命令，包括 cmdlet、提供程序和函数，以及变量、别名和 PowerShell 驱动器等项。 管理单元只可以添加 cmdlet 和提供程序。
从会话中删除模块之前，请使用以下命令确定要删除的模块。
例如，使用以下命令查找 和 Get-Help cmdlet 的Get-Date源：
Get-Command Get-Date, Get-Help -All |
Select-Object -Property Name, CommandType, Module ,PSSnapIn
以下输出显示 cmdlet Get-Help 位于 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-CommandAll 参数。 默认情况下， Get-Command 仅获取键入命令名称时运行的命令。 All 参数获取会话中具有特定名称的所有命令。
若要防止名称冲突，请使用 cmdlet 的 Import-ModuleNoClobber 或 Prefix 参数。 Prefix 参数向导入的命令的名称添加前缀，以便它们在会话中是唯一的。 NoClobber 参数不会导入任何隐藏或替换会话中现有命令的命令。
还可以使用 的 Alias、 Cmdlet、 Function 和 Variable 参数 Import-Module 来仅选择要导入的命令，并且可以排除导致会话中名称冲突的命令。
模块作者可以使用模块清单的 DefaultCommandPrefix 属性为所有命令名称添加默认前缀，从而防止名称冲突。 Prefix 参数的值优先于 DefaultCommandPrefix 的值。