Condividi tramite


Uninstall-Package

Disinstalla uno o più pacchetti software.

Sintassi

Uninstall-Package
         [-InputObject] <SoftwareIdentity[]>
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Uninstall-Package
         [-Name] <String[]>
         [-RequiredVersion <String>]
         [-MinimumVersion <String>]
         [-MaximumVersion <String>]
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-ProviderName <String[]>]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Destination <String>]
         [-ExcludeVersion]
         [-Scope <String>]
         [-SkipDependencies]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Destination <String>]
         [-ExcludeVersion]
         [-Scope <String>]
         [-SkipDependencies]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Scope <String>]
         [-PackageManagementProvider <String>]
         [-Type <String>]
         [-AllowClobber]
         [-SkipPublisherCheck]
         [-InstallUpdate]
         [-NoPathUpdate]
         [-AllowPrereleaseVersions]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Scope <String>]
         [-PackageManagementProvider <String>]
         [-Type <String>]
         [-AllowClobber]
         [-SkipPublisherCheck]
         [-InstallUpdate]
         [-NoPathUpdate]
         [-AllowPrereleaseVersions]
         [<CommonParameters>]

Descrizione

Il Uninstall-Package cmdlet disinstalla uno o più pacchetti software dal computer locale. Per trovare i pacchetti installati, usare il Get-Package cmdlet.

Importante

I comandi contenuti nel modulo PackageManagement sono diversi dai comandi forniti dal modulo NuGet nella console di Gestione pacchetti di Visual Studio. Ogni modulo ha comandi che non sono disponibili nell'altro. I comandi con lo stesso nome differiscono nei relativi argomenti specifici. Per altre informazioni, vedere la documentazione di riferimento di PowerShell per la console di Gestione pacchetti di Visual Studio.

Esempio

Esempio 1: Disinstallare un pacchetto

Il Uninstall-Package cmdlet disinstalla i pacchetti. Il parametro Name specifica il pacchetto da disinstallare. Se vengono installate più versioni di un pacchetto, la versione più recente viene disinstallata.

PS> Uninstall-Package -Name NuGet.Core

Esempio 2: Usare la pipeline per disinstallare un pacchetto

Get-Package individua un pacchetto specifico e invia l'oggetto SoftwareIdentity nella pipeline al Uninstall-Package cmdlet.

PS> Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 | Uninstall-Package

Il Get-Package cmdlet usa i parametri Name e RequiredVersion per specificare un pacchetto. Un oggetto SoftwareIdentity viene inviato alla pipeline. Il Uninstall-Package cmdlet riceve l'oggetto come InputObject e rimuove il pacchetto.

In alternativa, il Uninstall-Package cmdlet può specificare un valore per il parametro InputObject :

Uninstall-Package -InputObject ( Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 )

Parametri

-AllowClobber

Esegue l'override dei messaggi di avviso relativi ai conflitti con i comandi esistenti. Sovrascrive i comandi esistenti con lo stesso nome dei comandi installati.

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

-AllowPrereleaseVersions

Consente la disinstallazione dei pacchetti contrassegnati come versione preliminare.

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

-AllVersions

Indica che questo cmdlet disinstalla tutte le versioni del pacchetto.

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

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Destination

Specifica una stringa del percorso dell'oggetto di input.

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

-ExcludeVersion

Passare all'esclusione del numero di versione nel percorso della cartella.

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

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

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

-ForceBootstrap

Forza PackageManagement per installare automaticamente il provider di pacchetti per il pacchetto specificato.

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

-InputObject

Accetta l'input della pipeline che specifica l'oggetto SoftwareIdentity del pacchetto dal Get-Package cmdlet. InputObject accetta l'oggetto SoftwareIdentity come Get-Package valore o una variabile che contiene l'oggetto .

Type:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstallUpdate

Indica che Uninstall-Package disinstalla gli aggiornamenti.

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

-MaximumVersion

Specifica la versione massima consentita del pacchetto da disinstallare. Se non si specifica questo parametro, Uninstall-Package disinstalla la versione più recente del pacchetto.

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

-MinimumVersion

Specifica la versione minima consentita del pacchetto da disinstallare. Se non si aggiunge questo parametro, Uninstall-Package disinstalla la versione più recente del pacchetto che soddisfa qualsiasi versione specificata dal parametro MaximumVersion .

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

-Name

Specifica uno o più nomi di pacchetto. È necessario separare più nomi di pacchetti in base alle virgole.

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

-NoPathUpdate

NoPathUpdate si applica solo al Install-Script cmdlet. NoPathUpdate è un parametro dinamico aggiunto dal provider e non è supportato da Uninstall-Package.

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

-PackageManagementProvider

Specifica il provider PackageManagement .

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

-ProviderName

Specifica uno o più nomi del provider di pacchetti per cercare pacchetti. Per ottenere i nomi di provider di pacchetti, è possibile eseguire il cmdlet Get-PackageProvider.

Type:String[]
Aliases:Provider
Accepted values:Bootstrap, NuGet, PowerShellGet
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RequiredVersion

Specifica la versione esatta consentita del pacchetto da disinstallare. Se non si aggiunge questo parametro, Uninstall-Package disinstalla la versione più recente del pacchetto che soddisfa qualsiasi versione specificata dal parametro MaximumVersion .

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

-Scope

Specifica l'ambito per cui disinstallare il pacchetto. I valori accettabili per questo parametro sono i seguenti:

  • CurrentUser
  • AllUsers
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencies

Ignora la disinstallazione delle dipendenze software.

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

-SkipPublisherCheck

Consente di ottenere una versione del pacchetto più recente rispetto alla versione installata. Ad esempio, un pacchetto installato firmato digitalmente da un editore attendibile, ma una nuova versione non è firmata digitalmente.

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

-Type

Specifica se cercare pacchetti con un modulo, uno script o entrambi. I valori accettabili per questo parametro sono i seguenti:

  • Modulo
  • Script
  • Tutti
Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra cosa succede se Uninstall-Package viene eseguito il cmdlet. 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

Microsoft.PackageManagement.Packaging.SoftwareIdentity

È possibile inviare tramite pipe oggetti SoftwareIdentity a questo cmdlet.

Output

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Questo cmdlet restituisce un oggetto SoftwareIdentity per ogni pacchetto disinstallato.

Note

L'inclusione di un provider di pacchetti in un comando può rendere disponibili parametri dinamici a un cmdlet. I parametri dinamici sono specifici di un provider di pacchetti. Il Get-Help cmdlet elenca i set di parametri di un cmdlet e include il set di parametri del provider. Ad esempio, Uninstall-Package è impostato il parametro PowerShellGet che include -NoPathUpdate, AllowClobbere SkipPublisherCheck.