Partager via


Uninstall-PSResource

Désinstalle une ressource qui a été installée à l’aide de PowerShellGet.

Syntaxe

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

Description

Cette applet de commande combine les fonctionnalités des applets de Uninstall-Module commande et Uninstall-Script de PowerShellGet v2. L’applet de commande recherche les ressources qui ont le fichier de métadonnées XML PowerShellGet dans les chemins d’installation du package. Les ressources correspondantes sont désinstallées du système.

Par défaut, l’applet de commande vérifie si la ressource supprimée est une dépendance pour une autre ressource.

Exemples

Exemple 1

Désinstallez la dernière version du module Az .

Uninstall-PSResource Az

Exemple 2

Désinstallez une version spécifique du module Az .

Uninstall-PSResource -name Az -version "5.0.0"

Exemple 3

Désinstalle toutes les versions du module Az dans la plage de versions spécifiée.

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

Exemple 4

Cet exemple suppose que les versions suivantes du module Az sont déjà installées :

  • 4.0.1-preview
  • 4.1.0
  • 4.0.2-preview

L’applet Uninstall-PSResource de commande supprime la version stable et de préversion qui s’inscrit dans la plage de versions spécifiée. Selon les règles NuGetVersion, une version préliminaire étant inférieure à une version stable, 4.0.1-preview est en fait inférieure à la version 4.0.1 dans la plage spécifiée. Par conséquent, la version 4.0.1-preview n’est pas supprimée. Les versions 4.1.0 et 4.0.2-preview sont supprimées, car elles se trouvent dans la plage.

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

Exemple 5

Cet exemple suppose que les versions suivantes du module Az sont déjà installées :

  • 4.0.1-preview
  • 4.1.0
  • 4.0.2-preview

Il s’agit de la même chose que l’exemple précédent, sauf que le paramètre Prerelease signifie que seules les versions de préversion sont supprimées. Seule la version 4.0.2-preview est supprimée, car la version 4.0.1-preview est en dehors de la plage et la version 4.1.0 n’est pas une version préliminaire.

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

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Utilisé pour l’entrée de pipeline.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Nom d’une ressource ou de ressources à supprimer. Les caractères génériques sont pris en charge, mais NuGet accepte uniquement le * caractère.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Prerelease

Indique que seules les ressources de version préliminaire doivent être supprimées.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Scope

Spécifie l’étendue de la ressource à désinstaller.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valeurs acceptées:CurrentUser, AllUsers
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SkipDependencyCheck

Par défaut, l’applet de commande vérifie si la ressource supprimée est une dépendance pour une autre ressource. L’utilisation de ce paramètre ignore le test de dépendance.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Version

Spécifie la version de la ressource à supprimer. La valeur peut être une version exacte ou une plage de versions à l’aide de la syntaxe de contrôle de version NuGet.

Pour plus d’informations sur les plages de versions NuGet, consultez Gestion des versions de package.

PowerShellGet prend en charge tout sauf la version inclusive minimale répertoriée dans la documentation de la plage de versions NuGet. L’utilisation 1.0.0.0 en tant que version ne génère pas les versions 1.0.0.0 et ultérieures (plage inclusive minimale). Au lieu de cela, la valeur est considérée comme la version requise. Pour rechercher une plage inclusive minimale, utilisez [1.0.0.0, ] comme plage de versions.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Sorties

Object