Uninstall-PSResource
Deinstalliert eine Ressource, die mit PowerShellGet-installiert wurde.
Syntax
NameParameterSet (Standardwert)
Uninstall-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObjectParameterSet
Uninstall-PSResource
[-InputObject] <PSResourceInfo[]>
[-Prerelease]
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet kombiniert die Funktionalität der cmdlets Uninstall-Module und Uninstall-Script cmdlets aus PowerShellGet- v2. Das Cmdlet durchsucht die Paketinstallationspfade nach Ressourcen mit der PowerShellGet- XML-Metadatendatei. Übereinstimmende Ressourcen werden vom System deinstalliert.
Standardmäßig überprüft das Cmdlet, ob die entfernte Ressource eine Abhängigkeit für eine andere Ressource ist.
Beispiele
Beispiel 1
Deinstallieren Sie die neueste Version des Moduls Az.
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 von Az Modul bereits installiert sind:
- 4.0.1-Vorschau
- 4.1.0
- 4.0.2-Vorschau
Das cmdlet Uninstall-PSResource entfernt stabile und vorabversion, die in den angegebenen Versionsbereich fällt. Per 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 die Vorschau von 4.0.1 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 von Az Modul bereits installiert sind:
- 4.0.1-Vorschau
- 4.1.0
- 4.0.2-Vorschau
Dies ist mit dem vorherigen Beispiel identisch, mit Ausnahme des Prerelease Parameter bedeutet, dass nur Vorabversionen entfernt werden. Nur Version 4.0.2-Preview wird entfernt, da Version 4.0.1-Vorschau 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
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-InputObject
Wird für Pipelineeingaben verwendet.
Parametereigenschaften
| Typ: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
InputObjectParameterSet
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Name einer zu entfernenden Ressource oder Ressource. Wildcards werden unterstützt, nuGet akzeptiert jedoch nur das * Zeichen.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
NameParameterSet
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Prerelease
Gibt an, dass nur Vorabversionsressourcen entfernt werden sollen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Scope
Gibt den Bereich der zu deinstallierenden Ressource an.
Parametereigenschaften
| Typ: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
| Standardwert: | None |
| Zulässige Werte: | CurrentUser, AllUsers |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SkipDependencyCheck
Standardmäßig überprüft das Cmdlet, ob die entfernte Ressource eine Abhängigkeit für eine andere Ressource ist. Mit diesem Parameter wird der Abhängigkeitstest übersprungen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Version
Gibt die Version der zu entfernenden Ressource an. Der Wert kann eine genaue Version oder ein Versionsbereich mit der NuGet-Versionsverwaltungssyntax sein.
Weitere Informationen zu NuGet-Versionsbereichen finden Sie unter Paketversionsverwaltung.
PowerShellGet unterstützt alle mindestens inklusive Version in der NuGet-Versionsbereichsdokumentation aufgeführt. Die Verwendung von 1.0.0.0, da die Version die Versionen 1.0.0.0.0 und höher (minimaler inklusiver Bereich) nicht liefert. Stattdessen wird der Wert als erforderliche Version betrachtet. Verwenden Sie [1.0.0.0, ] als Versionsbereich, um nach einem minimal inklusiven Bereich zu suchen.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
NameParameterSet
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
