Freigeben über

Uninstall-PSResource

  • Referenz
Modul:
Microsoft.PowerShell.PSResourceGet

Deinstalliert eine Ressource, die mithilfe von PowerShellGet installiert wurde.

Syntax

Uninstall-PSResource
         [-Name] <String[]>
         [-Version <String>]
         [-Prerelease]
         [-SkipDependencyCheck]
         [-Scope <ScopeType>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Uninstall-PSResource
         [-Prerelease]
         [-InputObject] <PSResourceInfo[]>
         [-SkipDependencyCheck]
         [-Scope <ScopeType>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Beschreibung

Dieses Cmdlet kombiniert die Funktionalität der Uninstall-Module Cmdlets und Uninstall-Script von PowerShellGet v2. Das Cmdlet durchsucht die Installationspfade des Pakets nach Ressourcen, die über die PowerShellGet XML-Metadatendatei verfügen. Übereinstimmende Ressourcen werden vom System deinstalliert.

Standardmäßig überprüft das Cmdlet, ob die zu entfernende Ressource eine Abhängigkeit für eine andere Ressource ist.

Beispiele

Beispiel 1

Deinstallieren Sie die neueste Version des Az-Moduls .

Uninstall-PSResource Az

Beispiel 2

Deinstallieren Sie eine bestimmte Version des Az-Moduls .

Uninstall-PSResource -name Az -version "5.0.0"

Beispiel 3

Deinstalliert alle Versionen des Az-Moduls innerhalb des angegebenen Versionsbereichs.

Uninstall-PSResource -name Az -version "(5.0.0, 7.5.0)"

Beispiel 4

In diesem Beispiel wird davon ausgegangen, dass die folgenden Versionen des Az-Moduls bereits installiert sind:

  • 4.0.1-preview
  • 4.1.0
  • 4.0.2-preview

Das Uninstall-PSResource Cmdlet entfernt stabile Und Vorabversion, die innerhalb des angegebenen Versionsbereichs liegen. Gemäß NuGetVersion-Regeln ist eine Vorabversion kleiner als eine stabile Version, sodass 4.0.1-preview tatsächlich kleiner als die Version 4.0.1 im angegebenen Bereich ist. Daher wird 4.0.1-preview nicht entfernt. Die Versionen 4.1.0 und 4.0.2-preview werden entfernt, da sie innerhalb des Bereichs liegen.

Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]"

Beispiel 5

In diesem Beispiel wird davon ausgegangen, dass die folgenden Versionen des Az-Moduls bereits installiert sind:

  • 4.0.1-preview
  • 4.1.0
  • 4.0.2-preview

Dies ist identisch mit dem vorherigen Beispiel, mit ausnahme des Prerelease-Parameters , das bedeutet, dass nur Vorabversionen entfernt werden. Nur Version 4.0.2-preview wird entfernt, da Version 4.0.1-preview außerhalb des Bereichs liegt und Version 4.1.0 keine Vorabversion ist.

Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]" -Prerelease

Parameter

-Confirm

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

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

-InputObject

Wird für die Pipelineeingabe verwendet.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Name einer ressource oder ressourcen, die entfernt werden sollen. Feldhalter werden unterstützt, aber NuGet akzeptiert nur das * Zeichen.

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

-Prerelease

Gibt an, dass nur Vorabversionsressourcen entfernt werden sollen.

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

-Scope

Gibt den Bereich der zu deinstallierenden Ressource an.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Zulässige Werte:CurrentUser, AllUsers
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkipDependencyCheck

Standardmäßig überprüft das Cmdlet, ob die zu entfernende Ressource eine Abhängigkeit für eine andere Ressource ist. Die Verwendung dieses Parameters überspringt den Abhängigkeitstest.

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

-Version

Gibt die Version der zu entfernenden Ressource an. Der Wert kann eine exakte Version oder ein Versionsbereich mit der NuGet-Versionssyntax sein.

Weitere Informationen zu NuGet-Versionsbereichen finden Sie unter Paketversionsverwaltung.

PowerShellGet unterstützt alle Versionen bis auf die mindeste inklusive Version , die in der Dokumentation zum NuGet-Versionsbereich aufgeführt ist. Die Verwendung 1.0.0.0 als Version ergibt keine Versionen 1.0.0.0 und höher (mindestumfang). Stattdessen wird der Wert als die erforderliche Version betrachtet. Verwenden Sie [1.0.0.0, ] als Versionsbereich, um nach einem inklusiven Mindestbereich zu suchen.

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

-WhatIf

Zeigt, was geschieht, wenn das 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

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Ausgaben

Object