Uninstall-Module

参考

模块:: PowerShellGet

卸载模块。

语法

Uninstall-Module
         [-Name] <String[]>
         [-MinimumVersion <String>]
         [-RequiredVersion <String>]
         [-MaximumVersion <String>]
         [-AllVersions]
         [-Force]
         [-AllowPrerelease]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Uninstall-Module
         [-InputObject] <PSObject[]>
         [-Force]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

说明

该 Uninstall-Module cmdlet 从本地计算机卸载指定的模块。如果其他模块依赖于模块或未随 cmdlet 一起 Install-Module 安装模块，则无法卸载该模块。

可以手动删除模块文件，但这样做可能会中断依赖于已删除模块的任何模块。

采用模块版本号的参数需要格式化为版本号的字符串。

标准版本号的格式为 x.y.z x、y 和 z 是数字
预发行版版本的格式是x.y.z-<prerelease_label><prerelease_label>分配给该版本的任意字符串。

示例

示例 1：卸载模块

此示例卸载模块。

Uninstall-Module -Name SpeculationControl

Uninstall-Module 使用 Name 参数指定要从本地计算机中卸载的模块。

示例 2：使用管道卸载模块

在此示例中，管道用于卸载模块。

Get-InstalledModule -Name SpeculationControl | Uninstall-Module

Get-InstalledModule 使用 Name 参数指定模块。对象将发送到管道 Uninstall-Module 并卸载。

参数

-AllowPrerelease

允许卸载标记为预发行版的模块。

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

-AllVersions

指定要包括模块的所有可用版本。不能将 AllVersions 参数与 MinimumVersion、 MaximumVersion 或 RequiredVersion 参数一起使用。

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

-Confirm

在运行 .Uninstall-Module

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

-Force

Uninstall-Module强制运行而不要求用户确认。

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

-InputObject

接受 PSRepositoryItemInfo 对象。例如，输出 Get-InstalledModule 到变量，并将该变量用作 InputObject 参数。

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

-MaximumVersion

指定要卸载的模块的最大版本或最新版本。不能在同一命令中使用 MaximumVersion 和 RequiredVersion 参数。

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

-MinimumVersion

指定要卸载的模块的最低版本。 MinimumVersion 和 RequiredVersion 参数不能在同一命令中使用。

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

-Name

指定要卸载的模块名称数组。

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

-RequiredVersion

指定要卸载的模块的确切版本号。

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

-WhatIf

显示 Uninstall-Module 运行时会发生什么情况。 cmdlet 未能运行。

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

输入

String[]

PSObject[]

String

输出

Object

通过