Install-Module

Install-Module
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-Scope <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllowClobber]
    [-SkipPublisherCheck]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Install-Module
    [-InputObject] <PSObject[]>
    [-Credential <PSCredential>]
    [-Scope <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllowClobber]
    [-SkipPublisherCheck]
    [-Force]
    [-AcceptLicense]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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

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

这些示例使用 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。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

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

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

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

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

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

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

默认情况下， 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 值。

模块安装还将安装模块发布者根据需要指定的任何依赖模块。 发布者将在模块清单中指定所需的模块及其版本。