Uninstall-PSResource
卸載使用 PowerShellGet安裝的資源。
Syntax
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-Module
和 Uninstall-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 前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
用於管線輸入。
Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
要移除的資源或資源名稱。 支援萬用字元,但 NuGet 只接受 *
字元。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Prerelease
表示只應移除發行前版本資源。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
指定要卸載的資源範圍。
Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipDependencyCheck
根據預設,Cmdlet 會檢查要移除的資源是否為另一個資源的相依性。 使用此參數會略過相依性測試。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Version
指定要移除的資源版本。 此值可以是使用 NuGet 版本設定語法的確切版本或版本範圍。
如需 NuGet 版本範圍的詳細資訊,請參閱 套件版本控制。
PowerShellGet 支援 NuGet 版本範圍檔中所列的所有包含版本,但包含 最低 版本。 1.0.0.0
使用 做為 版本不會產生 1.0.0.0 版和更新版本, (最小內含範圍) 。 相反地,此值會被視為必要的版本。 若要搜尋包含範圍下限,請使用 [1.0.0.0, ]
作為版本範圍。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 不會執行此 Cmdlet。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
String[]
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]