Uninstall-Module
Odinstaluje modul.
Syntaxe
NameParameterSet (Výchozí)
Uninstall-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-RequiredVersion <String>]
[-MaximumVersion <String>]
[-AllVersions]
[-Force]
[-AllowPrerelease]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Uninstall-Module
[-InputObject] <PSObject[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Uninstall-Module odinstaluje zadaný modul z místního počítače. Modul nejde odinstalovat, pokud na něm závisejí jiné moduly nebo se modul nenainstaloval s rutinou Install-Module .
Soubory modulů můžete odstranit ručně, ale to může narušit všechny moduly, které závisí na odstraněného modulu.
Parametry, které přebírají čísla verzí modulu, očekávají řetězce formátované jako čísla verzí.
- Standardní čísla verzí mají formát, kde
x.y.zx, y a z jsou čísla. - Předběžné verze mají formát, ve
x.y.z-<prerelease_label><prerelease_label>kterém je libovolný řetězec přiřazený k této verzi.
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 k zadání modulu používá parametr Name. Objekt se odešle do kanálu do Uninstall-Module a odinstaluje se.
Parametry
-AllowPrerelease
Umožňuje odinstalovat modul označený jako předběžná verze.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-AllVersions
Určuje, že chcete zahrnout všechny dostupné verze modulu. Parametr
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním Uninstall-Modulevás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Vynutí Uninstall-Module spuštění bez žádosti o potvrzení uživatele.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InputObject
Přijímá objekt PSRepositoryItemInfo. Například výstup Get-InstalledModule do proměnné a tuto proměnnou použijte jako argument InputObject.
Vlastnosti parametru
| Typ: | PSObject[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
InputObject
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-MaximumVersion
Určuje maximální nebo nejnovější verzi modulu, která se má odinstalovat. Parametry MaximumVersion a RequiredVersion nelze použít ve stejném příkazu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-MinimumVersion
Určuje minimální verzi modulu, která se má odinstalovat. Parametry MinimumVersion a RequiredVersion nelze použít ve stejném příkazu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje pole názvů modulů, které se mají odinstalovat.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-RequiredVersion
Určuje přesný počet verzí modulu, který se má odinstalovat.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co by se stalo, když se Uninstall-Module spustí. Cmdlet se nespustil.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.