Uninstall-Package

  • Referenz
Modul:
PackageManagement

Deinstalliert mindestens ein Softwarepaket.

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 mindestens ein Softwarepaket vom lokalen Computer. Verwenden Sie das Get-Package Cmdlet, um nach installierten Paketen zu suchen.

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 dem 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 in der Pipeline 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 wie die installierten Befehle haben.

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

-AllowPrereleaseVersions

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

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

-AllVersions

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

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Destination

Gibt eine Zeichenfolge des Pfads zum Eingabeobjekt an.

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

-ExcludeVersion

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

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-ForceBootstrap

Erzwingt , dass PackageManagement den Paketanbieter für das angegebene Paket automatisch installiert.

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

-InputObject

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

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

-InstallUpdate

Gibt an, dass Uninstall-Package Updates deinstalliert.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-MinimumVersion

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

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

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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-Packagenicht unterstützt wird.

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

-PackageManagementProvider

Gibt den PackageManagement-Anbieter an.

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

-ProviderName

Gibt einen oder mehrere Paketanbieternamen an, die nach Paketen gesucht werden sollen. Paketanbieternamen können Sie durch Ausführen des Cmdlets Get-PackageProvider abrufen.

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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:

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

-SkipDependencies

Überspringt die Deinstallation von Softwareabhängigkeiten.

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

-SkipPublisherCheck

Ermöglicht ihnen das Abrufen einer Paketversion, die neuer als Ihre installierte Version ist. Beispielsweise ein installiertes Paket, das von einem vertrauenswürdigen Herausgeber digital signiert wird, aber eine neue Version nicht digital signiert wird.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was passieren würde, wenn Uninstall-Package das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Sie können SoftwareIdentity-Objekte an dieses Cmdlet übergeben.

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. Hat beispielsweise den PowerShellGet-Parameter festgelegt, Uninstall-Package der , AllowClobberund SkipPublisherCheckenthält-NoPathUpdate.