Install-Module

该 Install-Module cmdlet 从联机存储库获取一个或多个满足指定条件的模块。 该 cmdlet 验证搜索结果是否为有效的模块，并将模块文件夹复制到安装位置。 安装后不会自动导入已安装的模块。 可以根据指定模块的最低版本、最大版本和确切版本筛选已安装的模块。

如果安装的模块具有相同的名称或版本，或包含现有模块中的命令，则会显示警告消息。 确认要安装模块并重写警告后，请使用 -Force 和 -AllowClobber 参数。 根据存储库设置，可能需要回答模块安装提示才能继续。

采用模块版本号的参数需要格式化为版本号的字符串。

• 标准版本号的格式为 x.y.z x、y 和 z 是数字
• 预发行版版本的格式是x.y.z-<prerelease_label><prerelease_label>分配给该版本的任意字符串。

这些示例使用 PowerShell 库 作为唯一注册的存储库。 Get-PSRepository 显示已注册的存储库。 如果有多个已注册的存储库，请使用 -Repository 参数指定存储库的名称。

本示例在存储库中查找模块并安装该模块。

Find-Module -Name PowerShellGet | Install-Module

使用 Find-ModuleName 参数指定 PowerShellGet 模块。 默认情况下，从存储库下载模块的最新版本。 该对象将管道向下发送到 Install-Module cmdlet。 Install-Module 为所有用户 $env:ProgramFiles\PowerShell\Modules安装该模块。

在此示例中，安装了最新版本的 PowerShellGet 模块。

Install-Module -Name PowerShellGet

使用 Install-ModuleName 参数指定 PowerShellGet 模块。 默认情况下，从存储库下载并安装模块的最新版本。

在此示例中，已安装 PowerShellGet 模块的最低版本。 MinimumVersion 参数指定应安装的模块的最低版本。 如果模块的较新版本可用，则会为所有用户下载并安装该版本。

Install-Module -Name PowerShellGet -MinimumVersion 2.0.1

使用 Install-ModuleName 参数指定 PowerShellGet 模块。 MinimumVersion 参数指定从存储库下载并安装版本 2.0.1。 由于版本 2.0.4 可用，因此为所有用户下载并安装该版本。

在此示例中，安装了 PowerShellGet 模块的特定版本。

Install-Module -Name PowerShellGet -RequiredVersion 2.0.0

使用 Install-ModuleName 参数指定 PowerShellGet 模块。 RequiredVersion 参数指定为所有用户下载并安装版本 2.0.0。

此示例仅下载并安装最新版本的模块，仅适用于当前用户。

Install-Module -Name PowerShellGet -Scope CurrentUser

使用 Install-ModuleName 参数指定 PowerShellGet 模块。 Install-Module 将最新版本的 PowerShellGet 下载并安装到当前用户的目录中 $HOME\Documents\PowerShell\Modules。

此示例演示如何在该版本是预发行版本时安装模块的最新版本。 安装预发行版需要 AllowPrerelease 参数。

Install-Module -Name Microsoft.PowerShell.Crescendo -AllowPrerelease

使用此方法可以获得可用的最新版本。 如果最新版本不是预发行版，则获取模块的最新稳定版本。

此示例演示如何安装模块的特定预发行版。 该 Find-Module cmdlet 可用于在 PowerShell 库中查找模块的预发行版。

预发行版本的格式为 <version_number>-<prerelease_label>.

Find-Module PSReadLine -AllVersions -AllowPrerelease | Select-Object -First 5

Version        Name             Repository       Description
-------        ----             ----------       -----------
2.2.6          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.5          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.4-beta1    PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.3          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.2          PSReadLine       PSGallery        Great command line editing in the PowerS…

Install-Module -Name PSReadLine -RequiredVersion 2.2.4-beta1 -AllowPrerelease

使用 PowerShell 库中所示的版本获取 RequiredVersion 参数的值。

PSRepositoryItemInfo

Find-Module创建可将管道Install-Module发送到的 PSRepositoryItemInfo 对象。

String[]

PSObject[]

String

PSCredential

Uri

Microsoft.PowerShell.Commands.PSRepositoryItemInfo

使用 PassThru 参数时， Install-Module 输出模块的 PSRepositoryItemInfo 对象。 这是从 cmdlet 获取 Find-Module 的相同信息。

PowerShell 包含以下与 Install-Module相关的别名：

• 所有平台：
  • inmo

Install-Module 在 PowerShell 5.0 或更高版本、Windows 7 或 Windows 2008 R2 及更高版本的 Windows 上运行。

作为安全最佳做法，在首次运行任何 cmdlet 或函数之前评估模块的代码。 为了防止运行包含恶意代码的模块，安装后的模块不会自动导入。

如果存储库中不存在 Name 参数指定的 模块名称， Install-Module 则返回错误。

若要安装多个模块，请使用 Name 参数并指定以逗号分隔的模块名称数组。 如果指定多个模块名称，则无法使用 MinimumVersion、 MaximumVersion 或 RequiredVersion。 Find-Module创建可将管道Install-Module发送到的 PSRepositoryItemInfo 对象。 管道是指定要在单个命令中安装的多个模块的另一种方法。

默认情况下， AllUsers 作用域的模块安装在其中 $env:ProgramFiles\PowerShell\Modules。 安装 PowerShell Desired State Configuration （DSC） 资源时，默认值可防止混淆。

模块安装失败，如果模块安装没有 .psm1或 .psd1文件夹中的名称相同， .dll 则无法导入。 使用 Force 参数安装模块。

如果现有模块的版本与 Name 参数指定的名称匹配，并且未使用 MinimumVersion 或 RequiredVersion 参数，则以无提示方式继续， Install-Module 但不安装该模块。

如果现有模块的版本大于 MinimumVersion 参数的值，或等于 RequiredVersion 参数的值，则以无提示方式继续， Install-Module 但不安装该模块。

如果现有模块与 MinimumVersion 或 RequiredVersion 参数指定的值不匹配，则 Install-Module 命令中会出现错误。 例如，如果现有已安装模块的版本低于 MinimumVersion 值或不等于 RequiredVersion 值。

Install-Module 还安装模块发布者指定的任何依赖模块。 发布者在模块清单中列出了所需的模块及其版本。