Compartir a través de

Uninstall-PSResource

  • Referencia
Módulo:
Microsoft.PowerShell.PSResourceGet

Desinstala un recurso que se instaló mediante PowerShellGet.

Sintaxis

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.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Se usa para la entrada de canalización.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-Prerelease

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Scope

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

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valores aceptados:CurrentUser, AllUsers
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Salidas

Object