共用方式為

Uninstall-Module

  • 參考
模組:
PowerShellGet

解除安裝模組。

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 安裝，則您無法卸載模組。

您可以手動刪除模組檔案，但這麼做可能會中斷任何相依于已刪除模組的模組。

採用模組版本號碼的參數需要格式化為版本號碼的字串。

  • 標準版本號碼的格式 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

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

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

-AllVersions

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

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

Uninstall-Module強制執行而不要求使用者確認。

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

指定要解除安裝之模組的最高或最新版本。 MaximumVersion和RequiredVersion參數不能用在相同的命令中。

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

-MinimumVersion

指定要卸載的模組最低版本。 MinimumVersion和RequiredVersion參數不能用於相同的命令。

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

指定要解除安裝的模組的確切版本號碼。

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