Uninstall-PSResource
卸载使用 PowerShellGet 安装的资源。
语法
Uninstall-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Uninstall-PSResource
[-Prerelease]
[-InputObject] <PSResourceInfo[]>
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]说明
此 cmdlet 结合了 PowerShellGet v2 中的 和 Uninstall-Script cmdlet 的功能Uninstall-Module。 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 - 预览版
- 4.1.0
- 4.0.2-preview
cmdlet Uninstall-PSResource 删除位于指定版本范围内的稳定版本和预发行版本。 根据 NuGetVersion 规则，预发行版本小于稳定版本，因此 4.0.1-preview 实际上小于指定范围内的 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 - 预览版
- 4.1.0
- 4.0.2-preview
这与前面的示例相同，但 Prerelease 参数意味着仅删除预发行版。 仅删除版本 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 |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InputObject
用于管道输入。
| 类型: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Name
要删除的资源的名称。 支持通配符，但 NuGet 仅接受 * 字符。
| 类型: | String[] |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | True |
-Prerelease
指示仅应删除预发行版资源。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Scope
指定要卸载的资源的范围。
| 类型: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
| 接受的值: | CurrentUser, AllUsers |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SkipDependencyCheck
默认情况下，cmdlet 会检查要删除的资源是否是另一个资源的依赖项。 使用此参数会跳过依赖项测试。
| 类型: | 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[]
