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 替换 Update-Module v2 中的 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
指定后，绕过检查 TrustRepository，AcceptLicense 并更新包。
| 类型: | 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
指定安装范围。 接受的值包括：
CurrentUserAllUsers
默认作用域为 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的别名。
