共用方式為


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

Description

此 Cmdlet 結合了PowerShellGet v2 中 Uninstall-ModuleUninstall-Script Cmdlet 的功能。 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-preview
  • 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-preview
  • 4.1.0
  • 4.0.2-preview

這與上一個範例相同,但 發行前版本 參數除外,表示只會移除發行前版本。 只會移除 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