Sdílet prostřednictvím


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-Modulepotvrzení.

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

String

Výstupy

Object