Uninstall-Module
卸载模块。
语法
NameParameterSet （默认值）
Uninstall-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-RequiredVersion <String>]
[-MaximumVersion <String>]
[-AllVersions]
[-Force]
[-AllowPrerelease]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Uninstall-Module
[-InputObject] <PSObject[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Uninstall-Module cmdlet 从本地计算机卸载指定的模块。 如果其他模块依赖于模块或未随 cmdlet 一起 Install-Module 安装模块，则无法卸载该模块。
可以手动删除模块文件，但这样做可能会中断依赖于已删除模块的任何模块。
采用模块版本号的参数需要格式化为版本号的字符串。
- 标准版本号的格式为
x.y.zx、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 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
NameParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-AllVersions
指定要包括模块的所有可用版本。 不能将 AllVersions 参数与 MinimumVersion、MaximumVersion或 RequiredVersion 参数一起使用。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
NameParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
在运行 Uninstall-Module之前，提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Force
Uninstall-Module强制运行而不要求用户确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-InputObject
接受 PSRepositoryItemInfo 对象。 例如，输出 Get-InstalledModule 变量，并将该变量用作 InputObject 参数。
参数属性
| 类型: | PSObject[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InputObject
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-MaximumVersion
指定要卸载的模块的最大版本或最新版本。 不能在同一命令中使用 MaximumVersion 和 RequiredVersion 参数。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
NameParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-MinimumVersion
指定要卸载的模块的最低版本。 MinimumVersion 和 RequiredVersion 参数不能在同一命令中使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
NameParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Name
指定要卸载的模块名称数组。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
NameParameterSet
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-RequiredVersion
指定要卸载的模块的确切版本号。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
NameParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-WhatIf
显示 Uninstall-Module 运行时会发生什么情况。 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。
