Teilen über

Uninstall-Package

  • Referenz
Modul:
PackageManagement

Deinstalliert ein oder mehrere Softwarepakete.

Syntax

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

Beschreibung

Das Uninstall-Package Cmdlet deinstalliert ein oder mehrere Softwarepakete vom lokalen Computer. Verwenden Sie das Get-Package Cmdlet, um installierte Pakete zu finden.

Wichtig

Die im PackageManagement-Modul enthaltenen Befehle unterscheiden sich von den Befehlen, die vom NuGet-Modul in der Paket-Manager-Konsole von Visual Studio bereitgestellt werden. Jedes Modul verfügt über Befehle, die in der anderen Nicht verfügbar sind. Befehle mit demselben Namen unterscheiden sich in ihren spezifischen Argumenten. Weitere Informationen finden Sie in der PowerShell-Referenzdokumentation für die Paket-Manager-Konsole von Visual Studio.

Beispiele

Beispiel 1: Deinstallieren eines Pakets

Das Uninstall-Package Cmdlet deinstalliert Pakete. Der Parameter Name gibt das zu deinstallierende Paket an. Wenn mehrere Versionen eines Pakets installiert sind, wird die neueste Version deinstalliert.

PS> Uninstall-Package -Name NuGet.Core

Beispiel 2: Verwenden der Pipeline zum Deinstallieren eines Pakets

Get-Package sucht ein bestimmtes Paket und sendet das SoftwareIdentity -Objekt an das Uninstall-Package Cmdlet.

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

Das Get-Package Cmdlet verwendet die Parameter Name und RequiredVersion , um ein Paket anzugeben. Ein SoftwareIdentity-Objekt wird an die Pipeline gesendet. Das Uninstall-Package Cmdlet empfängt das Objekt als InputObject und entfernt das Paket.

Alternativ kann das Uninstall-Package Cmdlet einen Wert für den InputObject-Parameter angeben:

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

Parameter

-AllowClobber

Überschreibt Warnmeldungen zu Konflikten mit vorhandenen Befehlen. Überschreibt vorhandene Befehle, die denselben Namen haben wie befehle, die installiert werden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllowPrereleaseVersions

Ermöglicht die Deinstallation von Paketen, die als Vorabversion gekennzeichnet sind.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllVersions

Gibt an, dass dieses Cmdlet alle Versionen des Pakets deinstalliert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Destination

Gibt eine Zeichenfolge des Pfads zum Eingabeobjekt an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExcludeVersion

Wechseln Sie, um die Versionsnummer im Ordnerpfad auszuschließen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceBootstrap

Erzwingt PackageManagement die automatische Installation des Paketanbieters für das angegebene Paket.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Akzeptiert Pipelineeingaben, die das SoftwareIdentity-Objekt des Pakets aus dem Get-Package Cmdlet angibt. InputObject akzeptiert das SoftwareIdentity-Objekt als Get-Package Wert oder eine Variable, die das Objekt enthält.

Typ:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-InstallUpdate

Gibt an, dass Uninstall-Package Updates deinstalliert werden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaximumVersion

Gibt die maximal zulässige Paketversion an, die Sie deinstallieren möchten. Wenn Sie diesen Parameter nicht angeben, Uninstall-Package wird die neueste Version des Pakets deinstalliert.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MinimumVersion

Gibt die mindestens zulässige Paketversion an, die Sie deinstallieren möchten. Wenn Sie diesen Parameter nicht hinzufügen, wird die neueste Version des Pakets deinstalliert, Uninstall-Package die alle vom MaximumVersion-Parameter angegebenen Versionen erfüllt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen oder mehrere Paketnamen an. Mehrere Paketnamen müssen durch Kommas getrennt werden.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoPathUpdate

NoPathUpdate gilt nur für das Install-Script Cmdlet. NoPathUpdate ist ein dynamischer Parameter, der vom Anbieter hinzugefügt wird und von Uninstall-Packagediesem nicht unterstützt wird.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PackageManagementProvider

Gibt den PackageManagement-Anbieter an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProviderName

Gibt einen oder mehrere Paketanbieternamen an, die nach Paketen gesucht werden sollen. Sie können Paketanbieternamen abrufen, indem Sie das Get-PackageProvider Cmdlet ausführen.

Typ:String[]
Aliase:Provider
Zulässige Werte:Bootstrap, NuGet, PowerShellGet
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RequiredVersion

Gibt die genaue zulässige Version des Pakets an, die Sie deinstallieren möchten. Wenn Sie diesen Parameter nicht hinzufügen, wird die neueste Version des Pakets deinstalliert, Uninstall-Package die alle vom MaximumVersion-Parameter angegebenen Versionen erfüllt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Scope

Gibt den Bereich an, für den das Paket deinstalliert werden soll. Die zulässigen Werte für diesen Parameter sind wie folgt:

  • Aktueller Benutzer
  • AllUsers
Typ:String
Zulässige Werte:CurrentUser, AllUsers
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkipDependencies

Überspringt die Deinstallation von Softwareabhängigkeiten.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkipPublisherCheck

Ermöglicht es Ihnen, eine Paketversion zu erhalten, die neuer als Ihre installierte Version ist. Ein installiertes Paket, das von einem vertrauenswürdigen Herausgeber digital signiert ist, aber keine neue Version digital signiert ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Type

Gibt an, ob nach Paketen mit einem Modul, einem Skript oder beidem gesucht werden soll. Die zulässigen Werte für diesen Parameter sind wie folgt:

  • Modul
  • Skript
  • Alle
Typ:String
Zulässige Werte:Module, Script, All
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn Uninstall-Package cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Sie können SoftwareIdentity-Objekte an dieses Cmdlet weiterleiten.

Ausgaben

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Dieses Cmdlet gibt ein SoftwareIdentity-Objekt für jedes deinstallierte Paket zurück.

Hinweise

Das Einschließen eines Paketanbieters in einen Befehl kann dynamische Parameter für ein Cmdlet verfügbar machen. Dynamische Parameter sind spezifisch für einen Paketanbieter. Das Get-Help Cmdlet listet die Parametersätze eines Cmdlets auf und enthält den Parametersatz des Anbieters. Verfügt beispielsweise über den PowerShellGet-Parametersatz, -NoPathUpdateUninstall-Package der , , AllowClobberund SkipPublisherCheck.