Uninstall-PSResource
Odinstaluje prostředek nainstalovaný pomocí rutiny PowerShellGet.
Syntaxe
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
Tato rutina kombinuje funkce Uninstall-Module
rutin a Uninstall-Script
z PowerShellGet v2. Rutina vyhledá instalační cesty balíčku pro prostředky, které mají soubor metadat XML PowerShellGet . Odpovídající prostředky se odinstalují ze systému.
Ve výchozím nastavení rutina zkontroluje, jestli je odebraný prostředek závislostí pro jiný prostředek.
Příklady
Příklad 1
Odinstalujte nejnovější verzi modulu Az .
Uninstall-PSResource Az
Příklad 2
Odinstalujte konkrétní verzi modulu Az .
Uninstall-PSResource -name Az -version "5.0.0"
Příklad 3
Odinstaluje všechny verze modulu Az v zadaném rozsahu verzí.
Uninstall-PSResource -name Az -version "(5.0.0, 7.5.0)"
Příklad 4
V tomto příkladu se předpokládá, že následující verze modulu Az jsou již nainstalovány:
- 4.0.1-preview
- 4.1.0
- 4.0.2-preview
Rutina Uninstall-PSResource
odebere stabilní a předběžnou verzi, která spadá do zadaného rozsahu verzí. Podle pravidel NuGetVersion je předběžná verze menší než stabilní verze, takže verze 4.0.1-Preview je ve skutečnosti menší než verze 4.0.1 v zadaném rozsahu. Proto se verze 4.0.1 preview neodebere. Verze 4.1.0 a 4.0.2-preview se odeberou, protože spadají do rozsahu.
Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]"
Příklad 5
V tomto příkladu se předpokládá, že následující verze modulu Az jsou již nainstalovány:
- 4.0.1-preview
- 4.1.0
- 4.0.2-preview
To je stejné jako v předchozím příkladu s tím rozdílem, že parametr Prerelease znamená, že se odeberou jenom předběžné verze. Odebere se jenom verze 4.0.2-preview, protože verze 4.0.1-preview je mimo rozsah a verze 4.1.0 není předběžná verze.
Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]" -Prerelease
Parametry
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-InputObject
Používá se pro vstup kanálu.
Typ: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Name
Název prostředku nebo prostředků, které chcete odebrat. Zástupné znaky jsou podporované, ale NuGet přijímá *
pouze znak.
Typ: | String[] |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | True |
-Prerelease
Označuje, že by měly být odebrány pouze prostředky předběžné verze.
Typ: | SwitchParameter |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Scope
Určuje rozsah prostředku, který se má odinstalovat.
Typ: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
Přípustné hodnoty: | CurrentUser, AllUsers |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-SkipDependencyCheck
Ve výchozím nastavení rutina zkontroluje, jestli je odebraný prostředek závislostí pro jiný prostředek. Použití tohoto parametru přeskočí test závislostí.
Typ: | SwitchParameter |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Version
Určuje verzi prostředku, který se má odebrat. Hodnota může být přesná verze nebo rozsah verzí pomocí syntaxe správy verzí NuGet.
Další informace o rozsahech verzí NuGet najdete v tématu Správa verzí balíčků.
PowerShellGet podporuje všechny kromě minimální inkluzivní verze uvedené v dokumentaci k rozsahu verzí NuGet. Použití 1.0.0.0
jako verze nedává verze 1.0.0.0 a vyšší (minimální rozsah včetně). Místo toho se hodnota považuje za požadovanou verzi. Pokud chcete vyhledat minimální inkluzivní rozsah, použijte [1.0.0.0, ]
jako rozsah verzí.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | True |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
String[]
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]