Freigeben über

Uninstall-Module

  • Referenz
Modul:
PowerShellGet

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ängig sind oder das Modul nicht mit dem Install-Module Cmdlet installiert wurde.

Sie können Moduldateien manuell löschen, aber dadurch können alle Module unterbrochen werden, die vom gelöschten Modul abhängen.

Die Parameter, die Modulversionsnummern annehmen, erwarten Zeichenfolgen, die als Versionsnummern formatiert sind.

  • Standardversionsnummern haben ein Format, x.y.z wobei x, y und z Zahlen sind.
  • Vorabversionen weisen das Format x.y.z-<prerelease_label> auf, in dem der <prerelease_label> dieser Version eine beliebige Zeichenfolge zugewiesen ist.

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 auf dem lokalen Computer deinstalliert werden soll.

Beispiel 2: Verwenden der Pipeline zum Deinstallieren eines Moduls

In diesem Beispiel wird die Pipeline verwendet, um ein Modul zu deinstallieren.

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 das Deinstallieren eines Moduls, das als Vorabversion gekennzeichnet ist.

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

-AllVersions

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

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

-Confirm

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

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

-Force

Erzwingt Uninstall-Module die Ausführung ohne Benutzerbestätigung.

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

-InputObject

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

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

-MaximumVersion

Gibt die maximale oder neueste Version des zu deinstallierenden Moduls an. Die Parameter MaximumVersion und RequiredVersion können nicht im gleichen Befehl verwendet werden.

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

-MinimumVersion

Gibt die Mindestversion des zu deinstallierenden Moduls an. Die Parameter MinimumVersion und RequiredVersion können nicht im gleichen Befehl verwendet werden.

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

-Name

Gibt ein Array von zu deinstallierenden Modulnamen an.

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

-RequiredVersion

Gibt die genaue Versionsnummer des zu deinstallierenden Moduls an.

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

-WhatIf

Zeigt an, was bei Uninstall-Module Ausführungen passieren würde. 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

String[]

PSObject[]

String

Ausgaben

Object