Uninstall-PSResource
卸载使用 PowerShellGet安装的资源。
语法
NameParameterSet （默认值）
Uninstall-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObjectParameterSet
Uninstall-PSResource
[-InputObject] <PSResourceInfo[]>
[-Prerelease]
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
此 cmdlet 结合了 Uninstall-Module v2 中 Uninstall-Script 和 cmdlet 的功能。 该 cmdlet 在包安装路径中搜索具有 PowerShellGet XML 元数据文件的资源。 将从系统卸载匹配的资源。
默认情况下，cmdlet 会检查要删除的资源是否为另一资源的依赖项。
示例
示例 1
卸载最新版本的 Az 模块。
Uninstall-PSResource Az
示例 2
卸载 Az 模块的特定版本。
Uninstall-PSResource -name Az -version "5.0.0"
示例 3
卸载指定版本范围内 Az 模块的所有版本。
Uninstall-PSResource -name Az -version "(5.0.0, 7.5.0)"
示例 4
此示例假定已安装以下版本的 Az 模块：
- 4.0.1-preview
- 4.1.0
- 4.0.2-preview
Uninstall-PSResource cmdlet 删除属于指定版本范围的稳定和预发行版版本。 根据 NuGetVersion 规则，预发行版版本小于稳定版本，因此 4.0.1 预览版实际上小于指定范围内的 4.0.1 版本。 因此，不会删除 4.0.1-preview。 版本 4.1.0 和 4.0.2-preview 被删除，因为它们属于该范围。
Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]"
示例 5
此示例假定已安装以下版本的 Az 模块：
- 4.0.1-preview
- 4.1.0
- 4.0.2-preview
这与上一个示例相同，预发行版 参数除外，这意味着仅删除预发行版版本。 仅删除版本 4.0.2-preview，因为版本 4.0.1-preview 不在范围内，版本 4.1.0 不是预发行版。
Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]" -Prerelease
参数
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-InputObject
用于管道输入。
参数属性
| 类型: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InputObjectParameterSet
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
要删除的资源或资源的名称。 支持通配符，但 NuGet 仅接受 * 字符。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
NameParameterSet
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Prerelease
指示应仅删除预发行版版本资源。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Scope
指定要卸载的资源的范围。
参数属性
| 类型: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
| 默认值: | None |
| 接受的值: | CurrentUser, AllUsers |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SkipDependencyCheck
默认情况下，cmdlet 会检查要删除的资源是否为另一资源的依赖项。 使用此参数会跳过依赖项测试。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Version
指定要删除的资源的版本。 该值可以是使用 NuGet 版本控制语法的确切版本或版本范围。
有关 NuGet 版本范围的详细信息，请参阅 包版本控制。
PowerShellGet 支持 NuGet 版本范围文档中列出的所有 最低非独占版本。 使用 1.0.0.0，因为版本不会生成版本 1.0.0.0 及更高版本（最低非独占范围）。 相反，该值被视为所需的版本。 若要搜索最小非独占范围，请使用 [1.0.0.0, ] 作为版本范围。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
NameParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未能运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
