Update-PSResource

下载并安装本地计算机上安装的包的最新版本。

语法

Update-PSResource
      [[-Name] <String[]>]
      [-Version <String>]
      [-Prerelease]
      [-Repository <String[]>]
      [-Scope <ScopeType>]
      [-TemporaryPath <String>]
      [-TrustRepository]
      [-Credential <PSCredential>]
      [-Quiet]
      [-AcceptLicense]
      [-Force]
      [-PassThru]
      [-SkipDependencyCheck]
      [-AuthenticodeCheck]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Update-PSResource 下载并安装本地计算机上安装的包的最新版本。 此 cmdlet 替换 PowerShellGet v2 中的 Update-Module cmdlet 和 Update-Script cmdlet。 新版本的资源与新版本的文件夹中的早期版本并排安装。

默认情况下, Update-PSResource 安装包的最新版本及其任何依赖项,而无需删除已安装的旧版本。 没有用于卸载旧版本的包的命令。 必须手动删除旧版本的文件和文件夹。

Update-PSResource 不会将更新的模块加载到当前会话中。 必须导入新版本或启动新会话才能使用更新的模块。 有关详细信息,请参阅 Import-Module

示例

示例 1

在此示例中,用户已安装 TestModule 包,并更新包。

Get-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.2.0                                        test

Update-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.3.0                                        test
TestModule                              1.2.0                                        test

参数

-AcceptLicense

对于需要许可证的资源, AcceptLicense 会在更新过程中自动接受许可协议。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-AuthenticodeCheck

验证 Windows 上已签名的文件和目录文件。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Credential

指定访问专用存储库时使用的可选凭据。

类型:PSCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Force

指定后,绕过对 TrustRepositoryAcceptLicense 的检查并更新包。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Name

指定要更新的一个或多个资源的名称。 支持通配符,但 NuGet 仅接受字符 * 。 NuGet 不支持本地(基于文件的)存储库的通配符搜索。

类型:String[]
Position:0
默认值:"*"
必需:False
接受管道输入:True
接受通配符:True

-PassThru

指定后,输出 已保存资源的 PSResourceInfo 对象。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Prerelease

指定后,允许更新到预发行版本。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Quiet

取消进度信息。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Repository

指定要搜索的一个或多个存储库名称。 如果未指定,搜索将按优先级顺序(最高第一个)包括所有已注册的存储库,直到找到包含包的存储库。 存储库按优先级排序,然后按名称排序。 优先级较低的值具有更高的优先级。

跨多个存储库搜索资源时, PSResourceGet cmdlet 会使用此排序顺序搜索存储库。 Update-PSResource 从存储库的排序列表中更新第一个匹配包。

此参数支持 * 通配符。 如果指定多个存储库,则所有名称都必须包含或省略通配符。 不能使用通配符和不使用通配符指定名称的组合。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:True

-Scope

指定安装范围。 接受的值为:

  • CurrentUser
  • AllUsers

默认范围是 CurrentUser不需要提升。

类型:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
接受的值:CurrentUser, AllUsers
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SkipDependencyCheck

跳过资源依赖项的检查。 这意味着仅更新命名资源。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-TemporaryPath

指定在实际 installatoin 之前临时安装资源的路径。 如果未提供临时路径,资源将临时安装在当前用户的临时文件夹中。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TrustRepository

禁止提示信任存储库。 仅当存储库未配置为受信任时,才会出现信任存储库提示。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Version

指定要返回的资源的版本。 该值可以是使用 NuGet 版本控制语法的确切版本或版本范围。

有关 NuGet 版本范围的详细信息,请参阅 包版本控制

PowerShellGet 支持 NuGet 版本范围文档中列出的所有非独占版本 。 用作 1.0.0.0 版本不会生成版本 1.0.0.0 及更高版本(最低非独占范围)。 相反,该值被视为所需的版本。 若要搜索最小非独占范围,请 [1.0.0.0, ] 将其用作版本范围。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:True

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

String[]

输出

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

默认情况下,cmdlet 不返回任何对象。 使用 PassThru 参数时,该 cmdlet 会输出已保存资源的 PSResourceInfo 对象。

备注

该模块定义为 udres 别名 Update-PSResource