Freigeben über


Uninstall-Module

Deinstalliert ein Modul.

Syntax

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

Beschreibung

Das Uninstall-Module Cmdlet deinstalliert ein angegebenes Modul vom lokalen Computer. Sie können ein Modul nicht deinstallieren, wenn andere Module davon abhängen oder das Modul nicht mit dem Install-Module Cmdlet installiert wurde.

Dies ist ein Proxy-Cmdlet für das Uninstall-PSResource Cmdlet in microsoft.PowerShell.PSResourceGet. Weitere Informationen finden Sie unter Uninstall-PSResource.

Beispiele

Beispiel 1: Deinstallieren eines Moduls

In diesem Beispiel wird ein Modul deinstalliert.

Uninstall-Module -Name SpeculationControl

Uninstall-Module verwendet den Parameter Name , um das Modul anzugeben, das vom lokalen Computer deinstalliert werden soll.

Beispiel 2: Verwenden der Pipeline zum Deinstallieren eines Moduls

In diesem Beispiel wird die Pipeline zum Deinstallieren eines Moduls verwendet.

Get-InstalledModule -Name SpeculationControl | Uninstall-Module

Get-InstalledModule verwendet den Parameter Name , um das Modul anzugeben. Das Objekt wird an die Pipeline Uninstall-Module gesendet und deinstalliert.

Parameter

-AllowPrerelease

Ermöglicht es Ihnen, ein Modul zu deinstallieren, das als Vorabversion gekennzeichnet ist.

Das Proxy-Cmdlet ordnet diesen Parameter dem Parameter "Prerelease " zu. Uninstall-PSResource

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

-AllVersions

Gibt an, dass Sie alle verfügbaren Versionen eines Moduls einschließen möchten. Sie können den Parameter "AllVersions" nicht mit den Parametern "MinimumVersion", "MaximumVersion" oder "RequiredVersion " verwenden.

Das Proxy-Cmdlet wandelt diesen Parameter vor dem Aufrufen Uninstall-PSResourcein -Version * .

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

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie die Uninstall-ModuleDatei ausführen.

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

-Force

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Uninstall-PSResource.

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

-InputObject

Akzeptiert ein PSRepositoryItemInfo - Objekt. Geben Get-InstalledModule Sie beispielsweise eine Variable aus, und verwenden Sie diese Variable als InputObject-Argument .

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

-MaximumVersion

Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge für die Verwendung mit dem Parameter "Version " Uninstall-PSResourcezu erstellen.

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

-MinimumVersion

Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge für die Verwendung mit dem Parameter "Version " Uninstall-PSResourcezu erstellen.

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

-Name

Gibt ein Array von Modulnamen an, die deinstalliert werden sollen.

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

-RequiredVersion

Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge für die Verwendung mit dem Parameter "Version " Uninstall-PSResourcezu erstellen.

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

-WhatIf

Zeigt, was passiert, wenn Uninstall-Module 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

String[]

PSObject[]

String

Ausgaben

Object