Uninstall-Module

解除安裝模組。

Syntax

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

Description

Cmdlet Uninstall-Module 會從本機電腦卸載指定的模組。 如果其他模組相依于模組,或模組未隨 Cmdlet 一起 Install-Module 安裝,則您無法卸載模組。

這是Microsoft.PowerShell.PSResourceGet中 Cmdlet 的 Proxy Cmdlet Uninstall-PSResource 。 如需詳細資訊,請參閱 Uninstall-PSResource

範例

範例 1:卸載模組

此範例會卸載模組。

Uninstall-Module -Name SpeculationControl

Uninstall-Module 會使用 Name 參數指定要從本機電腦卸載的模組。

範例 2:使用管線卸載模組

在此範例中,管線是用來卸載模組。

Get-InstalledModule -Name SpeculationControl | Uninstall-Module

Get-InstalledModule 會使用 Name 參數來指定模組。 物件會向下傳送至 Uninstall-Module 管線,並卸載。

參數

-AllowPrerelease

可讓您卸載標示為發行前版本的模組。

Proxy Cmdlet 會將此參數對應至 的 發行前版本 參數 Uninstall-PSResource

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllVersions

指定您想要包含模組的所有可用版本。 您無法搭配MinimumVersionMaximumVersionRequiredVersion參數使用AllVersions參數。

Proxy Cmdlet 會先將此參數 -Version * 轉換成 ,然後再呼叫 Uninstall-PSResource

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

在執行 之前 Uninstall-Module ,提示您進行確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Proxy Cmdlet 會忽略此參數,因為它不受 支援 Uninstall-PSResource

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

接受 PSRepositoryItemInfo 物件。 例如,輸出 Get-InstalledModule 至變數,並使用該變數作為 InputObject 引數。

Type:PSObject[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaximumVersion

Proxy Cmdlet 會使用此參數的值來建立 NuGet 版本搜尋字串,以搭配 的 Uninstall-PSResourceVersion參數使用。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MinimumVersion

Proxy Cmdlet 會使用此參數的值來建立 NuGet 版本搜尋字串,以搭配 的 Uninstall-PSResourceVersion參數使用。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

指定要卸載的模組名稱陣列。

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RequiredVersion

Proxy Cmdlet 會使用此參數的值來建立 NuGet 版本搜尋字串,以搭配 的 Uninstall-PSResourceVersion參數使用。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

顯示執行時 Uninstall-Module 會發生什麼情況。 不會執行此 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String[]

PSObject[]

String

輸出

Object