Uninstall-Module
Desinstala un módulo.
Sintaxis
NameParameterSet (valor predeterminado)
Uninstall-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-RequiredVersion <String>]
[-MaximumVersion <String>]
[-AllVersions]
[-Force]
[-AllowPrerelease]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Uninstall-Module
[-InputObject] <PSObject[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Uninstall-Module desinstala un módulo especificado del equipo local. No se puede desinstalar un módulo si otros módulos dependen de él o el módulo no se instaló con el Install-Module cmdlet .
Puede eliminar manualmente los archivos de módulo, pero si lo hace, puede interrumpir los módulos que dependen del módulo eliminado.
Los parámetros que toman números de versión del módulo esperan cadenas con formato de números de versión.
- Los números de versión estándar tienen un formato de
x.y.zdonde x, y y z son números - Las versiones preliminares tienen un formato de
x.y.z-<prerelease_label>donde la<prerelease_label>cadena arbitraria está asignada a esa versión.
Ejemplos
Ejemplo 1: Desinstalar un módulo
En este ejemplo se desinstala un módulo.
Uninstall-Module -Name SpeculationControl
Uninstall-Module usa el parámetro Name para especificar el módulo que se va a desinstalar del equipo local.
Ejemplo 2: Uso de la canalización para desinstalar un módulo
En este ejemplo, la canalización se usa para desinstalar un módulo.
Get-InstalledModule -Name SpeculationControl | Uninstall-Module
Uninstall-Module y se desinstala.
Parámetros
-AllowPrerelease
Permite desinstalar un módulo marcado como versión preliminar.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
NameParameterSet
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-AllVersions
Especifica que desea incluir todas las versiones disponibles de un módulo. No puede usar el parámetro AllVersions con los parámetros MinimumVersion, MaximumVersiono RequiredVersion.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
NameParameterSet
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Le pide confirmación antes de ejecutar el Uninstall-Module.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Force
Fuerza Uninstall-Module a ejecutarse sin pedir confirmación del usuario.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-InputObject
Acepta un objeto de PSRepositoryItemInfo. Por ejemplo, la salida
Propiedades de parámetro
| Tipo: | PSObject[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
InputObject
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-MaximumVersion
Especifica la versión máxima o más reciente del módulo que se va a desinstalar. Los parámetros MaximumVersion y RequiredVersion no se pueden usar en el mismo comando.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
NameParameterSet
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-MinimumVersion
Especifica la versión mínima del módulo que se va a desinstalar. Los parámetros MinimumVersion y RequiredVersion no se pueden usar en el mismo comando.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
NameParameterSet
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Name
Especifica una matriz de nombres de módulo que se van a desinstalar.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
NameParameterSet
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-RequiredVersion
Especifica el número de versión exacto del módulo que se va a desinstalar.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
NameParameterSet
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta Uninstall-Module. El cmdlet no se ejecuta.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
