Quita módulos de la sesión actual.
Sintaxis
Remove-Module [-ModuleInfo] <PSModuleInfo[]> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>] Remove-Module [-Name] <string[]> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Remove-Module quita los miembros de un módulo de la sesión actual.
Si el módulo incluye un ensamblado (.dll), se quitan todos los miembros implementados por el ensamblado, pero el ensamblado no se descarga.
Parámetros
-Force
Quita módulos aunque su modo de acceso sea de solo lectura.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-ModuleInfo <PSModuleInfo[]>
Especifica los objetos de módulo que se han de quitar. Escriba una variable que contenga un objeto de módulo (PSModuleInfo) o un comando que lo obtenga, como un comando Get-Module. También se pueden canalizar objetos de módulo a Remove-Module.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue) |
|
¿Aceptar caracteres comodín? |
false |
-Name <string[]>
Especifica los nombres de los módulos que se han de quitar. Se permite el uso de caracteres comodín. También se pueden canalizar cadenas de nombre a Remove-Module.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue) |
|
¿Aceptar caracteres comodín? |
true |
-Confirm
Solicita confirmación antes de ejecutar el comando.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-WhatIf
Describe lo que ocurriría si se ejecutara el comando, sin ejecutarlo realmente.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
System.String, System.Management.Automation.PSModuleInfo Se pueden canalizar nombres de módulo (cadenas) y objetos de módulo a Remove-Module. |
|
Salidas |
Ninguno Remove-Module no genera resultados. |
Notas
También se puede hacer referencia a Remove-Module por su alias, "rmo". Para obtener más información, vea about_Aliases.
Ejemplo 1
C:\PS>remove-module -name BitsTransfer Descripción ----------- Este comando quita el módulo BitsTransfer de la sesión actual.
Ejemplo 2
C:\PS>get-module | remove-module Descripción ----------- Este comando quita todos los módulos de la sesión actual.
Ejemplo 3
C:\PS>"FileTransfer", "PSDiagnostics" | remove-module -verbose VERBOSE: Performing operation "Remove-Module" on Target "filetransfer (Path: 'C:\Windows\system32\WindowsPowerShell\v1.0\Modules\f iletransfer\filetransfer.psd1')". VERBOSE: Performing operation "Remove-Module" on Target "Microsoft.BackgroundIntelligentTransfer.Management (Path: 'C:\Windows\ assembly\GAC_MSIL\Microsoft.BackgroundIntelligentTransfer.Management\1.0.0.0__31bf3856ad364e35\Microsoft.BackgroundIntelligentTransfe r.Management.dll')". VERBOSE: Performing operation "Remove-Module" on Target "psdiagnostics (Path: 'C:\Windows\system32\WindowsPowerShell\v1.0\Modules\ psdiagnostics\psdiagnostics.psd1')". VERBOSE: Removing imported function 'Start-Trace'. VERBOSE: Removing imported function 'Stop-Trace'. VERBOSE: Removing imported function 'Enable-WSManTrace'. VERBOSE: Removing imported function 'Disable-WSManTrace'. VERBOSE: Removing imported function 'Enable-PSWSManCombinedTrace'. VERBOSE: Removing imported function 'Disable-PSWSManCombinedTrace'. VERBOSE: Removing imported function 'Set-LogProperties'. VERBOSE: Removing imported function 'Get-LogProperties'. VERBOSE: Removing imported function 'Enable-PSTrace'. VERBOSE: Removing imported function 'Disable-PSTrace'. VERBOSE: Performing operation "Remove-Module" on Target "PSDiagnostics (Path: 'C:\Windows\system32\WindowsPowerShell\v1.0\Modules\ psdiagnostics\PSDiagnostics.psm1')". Descripción ----------- Este comando quita los módulos FileTransfer y PSDiagnostics de la sesión actual. El comando utiliza un operador de canalización (|) para enviar los nombres de módulo a Remove-Module. Utiliza el parámetro común Verbose para obtener información detallada sobre los miembros que se quitan. Los mensajes Verbose muestran los elementos que se quitan. Los mensajes difieren porque el módulo BitsTransfer incluye un ensamblado que implementa sus cmdlets y un módulo anidado con su propio ensamblado. El módulo PSDiagnostics incluye un archivo de script de módulo (.psm1) que exporta funciones.
Ejemplo 4
C:\PS>$a = get-module BitsTransfer C:\PS> remove-module -moduleInfo $a Descripción ----------- Este comando utiliza el parámetro ModuleInfo para quitar el módulo BitsTransfer.
Vea también