Condividi tramite


Uninstall-Module

Disinstalla un modulo.

Sintassi

Uninstall-Module
         [-Name] <String[]>
         [-MinimumVersion <String>]
         [-RequiredVersion <String>]
         [-MaximumVersion <String>]
         [-AllVersions]
         [-Force]
         [-AllowPrerelease]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Uninstall-Module
         [-InputObject] <PSObject[]>
         [-Force]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Descrizione

Il Uninstall-Module cmdlet disinstalla un modulo specificato dal computer locale. Non è possibile disinstallare un modulo se altri moduli dipendono da esso o il modulo non è stato installato con il Install-Module cmdlet.

È possibile eliminare manualmente i file di modulo, ma in questo modo è possibile interrompere tutti i moduli che dipendono dal modulo eliminato.

I parametri che accettano numeri di versione del modulo prevedono stringhe formattate come numeri di versione.

  • I numeri di versione standard hanno un formato di x.y.z dove x, y e z sono numeri
  • Le versioni non definitive dispongono di un formato in x.y.z-<prerelease_label> cui la <prerelease_label> stringa arbitraria assegnata a tale versione.

Esempio

Esempio 1: Disinstallare un modulo

In questo esempio viene disinstallato un modulo.

Uninstall-Module -Name SpeculationControl

Uninstall-Module usa il parametro Name per specificare il modulo da disinstallare dal computer locale.

Esempio 2: Usare la pipeline per disinstallare un modulo

In questo esempio la pipeline viene usata per disinstallare un modulo.

Get-InstalledModule -Name SpeculationControl | Uninstall-Module

Get-InstalledModule usa il parametro Name per specificare il modulo. L'oggetto viene inviato alla pipeline Uninstall-Module e viene disinstallato.

Parametri

-AllowPrerelease

Consente di disinstallare un modulo contrassegnato come versione preliminare.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllVersions

Specifica che si desidera includere tutte le versioni disponibili di un modulo. Non è possibile usare il parametro AllVersions con i parametri MinimumVersion, MaximumVersion o RequiredVersion .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma prima di eseguire .Uninstall-Module

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Forza Uninstall-Module l'esecuzione senza chiedere conferma dell'utente.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Accetta un oggetto PSRepositoryItemInfo . Ad esempio, l'output Get-InstalledModule in una variabile e l'uso di tale variabile come argomento InputObject .

Type:PSObject[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaximumVersion

Specifica la versione massima o più recente del modulo da disinstallare. I parametri MaximumVersion e RequiredVersion non possono essere usati nello stesso comando.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MinimumVersion

Specifica la versione minima del modulo da disinstallare. I parametri MinimumVersion e RequiredVersion non possono essere usati nello stesso comando.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifica una matrice di nomi di moduli da disinstallare.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RequiredVersion

Specifica il numero di versione esatto del modulo da disinstallare.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra cosa succederebbe se Uninstall-Module viene eseguita. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String[]

PSObject[]

String

Output

Object