Uninstall-PSResource

  • Referencia
Módulo:
Microsoft.PowerShell.PSResourceGet

Desinstala un recurso que se instaló mediante PowerShellGet.

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>]

Description

Este cmdlet combina la funcionalidad de los Uninstall-Module cmdlets y Uninstall-Script de PowerShellGet v2. El cmdlet busca en las rutas de instalación del paquete los recursos que tienen el archivo de metadatos XML de PowerShellGet . Los recursos coincidentes se desinstalan del sistema.

De forma predeterminada, el cmdlet comprueba si el recurso que se va a quitar es una dependencia de otro recurso.

Ejemplos

Ejemplo 1

Desinstale la versión más reciente del módulo Az .

Uninstall-PSResource Az

Ejemplo 2

Desinstale una versión específica del módulo Az .

Uninstall-PSResource -name Az -version "5.0.0"

Ejemplo 3

Desinstala todas las versiones del módulo Az dentro del intervalo de versiones especificado.

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

Ejemplo 4

En este ejemplo se supone que las siguientes versiones del módulo Az ya están instaladas:

  • 4.0.1-preview
  • 4.1.0
  • 4.0.2-preview

El Uninstall-PSResource cmdlet quita la versión estable y preliminar que se encuentra dentro del intervalo de versiones especificado. Según las reglas de NuGetVersion, una versión preliminar es menor que una versión estable, por lo que la versión preliminar 4.0.1 es realmente menor que la versión 4.0.1 del intervalo especificado. Por lo tanto, no se quita la versión preliminar 4.0.1. Las versiones 4.1.0 y 4.0.2-preview se quitan porque están dentro del intervalo.

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

Ejemplo 5

En este ejemplo se supone que las siguientes versiones del módulo Az ya están instaladas:

  • 4.0.1-preview
  • 4.1.0
  • 4.0.2-preview

Este es el mismo que el ejemplo anterior, excepto el parámetro Versión preliminar , lo que significa que solo se quitan las versiones preliminares. Solo se quita la versión 4.0.2-preview porque la versión 4.0.1-preview está fuera del intervalo y la versión 4.1.0 no es una versión preliminar.

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

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-InputObject

Se usa para la entrada de canalización.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Nombre de un recurso o recursos que se van a quitar. Se admiten caracteres comodín, pero NuGet solo acepta el * carácter.

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

-Prerelease

Indica que solo se deben quitar los recursos de versión preliminar.

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

-Scope

Especifica el ámbito del recurso que se va a desinstalar.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

De forma predeterminada, el cmdlet comprueba si el recurso que se va a quitar es una dependencia de otro recurso. El uso de este parámetro omite la prueba de dependencias.

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

-Version

Especifica la versión del recurso que se va a quitar. El valor puede ser una versión exacta o un intervalo de versiones mediante la sintaxis de control de versiones de NuGet.

Para obtener más información sobre los intervalos de versiones de NuGet, consulte Control de versiones de paquetes.

PowerShellGet admite todas las versiones inclusivas mínimas que aparecen en la documentación del intervalo de versiones de NuGet. El uso 1.0.0.0 de como versión no produce las versiones 1.0.0.0 y posteriores (intervalo inclusivo mínimo). En su lugar, el valor se considera la versión necesaria. Para buscar un intervalo inclusivo mínimo, use [1.0.0.0, ] como intervalo de versiones.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Salidas

Object