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[]

输出

Object