Uninstall-Module
Odinstaluje modul.
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
Rutina Uninstall-Module
odinstaluje zadaný modul z místního počítače. Modul se nedá odinstalovat, pokud na něm závisejí jiné moduly nebo pokud se modul nenainstaloval s rutinou Install-Module
.
Soubory modulů můžete odstranit ručně, ale může dojít k narušení všech modulů, které na odstraněných modulech závisejí.
Parametry, které přebírají čísla verzí modulu, očekávají řetězce formátované jako čísla verzí.
- Standardní čísla verzí mají formát
x.y.z
, kde x, y a z jsou čísla. - Předběžné verze mají formát
x.y.z-<prerelease_label>
, ve kterém<prerelease_label>
je k dané verzi přiřazen libovolný řetězec.
Příklady
Příklad 1: Odinstalace modulu
Tento příklad odinstaluje modul.
Uninstall-Module -Name SpeculationControl
Uninstall-Module
používá parametr Name k určení modulu, který se má odinstalovat z místního počítače.
Příklad 2: Odinstalace modulu pomocí kanálu
V tomto příkladu se kanál používá k odinstalaci modulu.
Get-InstalledModule -Name SpeculationControl | Uninstall-Module
Get-InstalledModule
používá parametr Name k určení modulu. Objekt se odešle kanálem do Uninstall-Module
a odinstaluje se.
Parametry
-AllowPrerelease
Umožňuje odinstalovat modul označený jako předběžná verze.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllVersions
Určuje, že chcete zahrnout všechny dostupné verze modulu. Nemůžete použít parametr AllVersions s parametry MinimumVersion, MaximumVersion nebo RequiredVersion .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Před spuštěním nástroje zobrazí výzvu k Uninstall-Module
potvrzení.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Vynutí Uninstall-Module
spuštění bez žádosti o potvrzení uživatele.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Přijímá PSRepositoryItemInfo objekt. Například výstup Get-InstalledModule
do proměnné a tuto proměnnou použijte jako argument InputObject .
Type: | PSObject[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MaximumVersion
Určuje maximální (nejnovější) verzi modulu, která se má odinstalovat. Parametry MaximumVersion a RequiredVersion nelze použít ve stejném příkazu.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MinimumVersion
Určuje minimální verzi modulu, která se má odinstalovat. Parametry MinimumVersion a RequiredVersion nelze použít ve stejném příkazu.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Určuje pole názvů modulů, které se mají odinstalovat.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RequiredVersion
Určuje přesné číslo verze modulu, který se má odinstalovat.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Ukazuje, co by se stalo při Uninstall-Module
spuštění. Rutina se nespustí.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
String[]
PSObject[]