Condividi tramite

Uninstall-Package

  • Riferimento
Modulo:
PackageManagement

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 include 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.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowPrereleaseVersions

Consente la disinstallazione dei pacchetti contrassegnati come versione non definitiva.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllVersions

Indica che questo cmdlet disinstalla tutte le versioni del pacchetto.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Destination

Specifica una stringa del percorso dell'oggetto di input.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExcludeVersion

Passare a per escludere il numero di versione nel percorso della cartella.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceBootstrap

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 .

Tipo:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-InstallUpdate

Indica che Uninstall-Package disinstalla gli aggiornamenti.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica uno o più nomi di pacchetto. I nomi di più pacchetti devono essere separati da virgole.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NoPathUpdate

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PackageManagementProvider

Specifica il provider PackageManagement .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProviderName

Specifica uno o più nomi di provider di pacchetti da cercare nei pacchetti. È possibile ottenere i nomi dei provider di pacchetti eseguendo il Get-PackageProvider cmdlet .

Tipo:String[]
Alias:Provider
Valori accettati:Bootstrap, NuGet, PowerShellGet
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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 .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Scope

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

  • CurrentUser
  • AllUsers
Tipo:String
Valori accettati:CurrentUser, AllUsers
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SkipDependencies

Ignora la disinstallazione delle dipendenze software.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SkipPublisherCheck

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Type

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

  • Modulo
  • Sceneggiatura
  • Tutti
Tipo:String
Valori accettati:Module, Script, All
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se viene eseguito il Uninstall-Package cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 per 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 ha il set di parametri PowerShellGet che include -NoPathUpdate, AllowClobbere SkipPublisherCheck.