Update-Module

Update-Module
    [[-Name] <String[]>]
    [-RequiredVersion <String>]
    [-MaximumVersion <String>]
    [-Credential <PSCredential>]
    [-Scope <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Update-Module cmdlet 从联机库安装模块的最新版本。 在安装更新之前，系统会提示你确认更新。 仅针对本地计算机上安装的模块安装了 Install-Module更新。 Update-Module 搜索已安装模块的 $env:PSModulePath。

这是 Update-PSResource 中 cmdlet 的代理 cmdlet。 有关详细信息，请参阅 Update-PSResource。

此示例将所有已安装的模块更新到联机库中的最新版本。

Update-Module

此示例将特定模块更新到联机库中的最新版本。

Update-Module -Name SpeculationControl

Update-Module 使用 Name 参数更新特定模块，SpeculationControl。

此示例执行模拟方案，以显示运行 Update-Module 时会发生什么情况。 该命令未运行。

Update-Module -WhatIf

What if: Performing the operation "Update-Module" on target "Version '2.8.0' of module
  'Carbon', updating to version '2.8.1'".
What if: Performing the operation "Update-Module" on target "Version '1.0.10' of module
  'SpeculationControl', updating to version '1.0.14'".

Update-Module 使用 WhatIf 参数显示运行 Update-Module 时会发生什么情况。

在此示例中，模块将更新为特定版本。 该版本必须存在于联机库中，否则将显示错误。

Update-Module -Name SpeculationControl -RequiredVersion 1.0.14

Update-Module 使用 Name 参数指定模块，SpeculationControl。 RequiredVersion 参数指定版本 1.0.14。

此示例不请求确认将模块从联机库更新到最新版本。 如果模块已安装，Force 参数将重新安装该模块。

Update-Module -Name SpeculationControl -Force

Update-Module 使用 Name 参数指定模块，SpeculationControl。 Force 参数在不请求用户确认的情况下更新模块。

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

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

• 所有平台：
  • upmo

对于 PowerShell 6.0 及更高版本，默认安装范围始终为 CurrentUser。 CurrentUser模块更新（$HOME\Documents\PowerShell\Modules）不需要提升的权限。 AllUsers的模块更新（$env:ProgramFiles\PowerShell\Modules）需要提升的权限。

PowerShell 库不再支持传输层安全性（TLS）版本 1.0 和 1.1。 必须使用 TLS 1.2 或更高版本。 使用以下命令确保使用的是 TLS 1.2：

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

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

如果未使用 Install-Module 参数指定模块，则会发生错误。

只能通过运行 Update-Module，在从联机库安装的模块上运行 Install-Module。

如果 Update-Module 尝试更新正在使用的二进制文件，Update-Module 将返回一个标识问题进程的错误。 在停止进程后，系统会通知用户重试 Update-Module。