Rimuove i moduli dalla sessione corrente.
Sintassi
Remove-Module [-ModuleInfo] <PSModuleInfo[]> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>] Remove-Module [-Name] <string[]> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet Remove-Module rimuove i membri di un modulo dalla sessione corrente.
Se il modulo include un assembly (.dll), tutti i membri implementati dall'assembly vengono rimossi, ma l'assembly non viene scaricato.
Parametri
-Force
Rimuove i moduli anche quando la modalità di accesso è in sola lettura.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-ModuleInfo <PSModuleInfo[]>
Specifica gli oggetti del modulo da rimuovere. Immettere una variabile che contiene un oggetto modulo (PSModuleInfo) o un comando che ottiene un oggetto modulo, ad esempio un comando Get-Module. È inoltre possibile reindirizzare oggetti modulo a Remove-Module.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue) |
|
Accettare caratteri jolly? |
false |
-Name <string[]>
Specifica i nomi dei moduli da rimuovere. È consentito l'utilizzo di caratteri jolly. È anche possibile reindirizzare stringhe di nomi a Remove-Module.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue) |
|
Accettare caratteri jolly? |
true |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
System.String, System.Management.Automation.PSModuleInfo È anche possibile reindirizzare nomi di moduli (stringhe) e oggetti modulo a Remove-Module. |
|
Output |
Nessuno Remove-Module non genera alcun output. |
Note
È anche possibile fare riferimento a Remove-Module tramite il relativo alias, "rmo". Per ulteriori informazioni, vedere about_Aliases.
Esempio 1
C:\PS>remove-module -name BitsTransfer Descrizione ----------- Questo comando rimuove il modulo BitsTransfer dalla sessione corrente.
Esempio 2
C:\PS>get-module | remove-module Descrizione ----------- Questo comando rimuove tutti i moduli dalla sessione corrente.
Esempio 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')". Descrizione ----------- Questo comando rimuove i moduli FileTransfer e PSDiagnostics dalla sessione corrente. Nel comando viene utilizzato un operatore pipeline (|) per inviare i nomi dei moduli a Remove-Module. Viene utilizzato il parametro comune Verbose per ottenere informazioni dettagliate sui membri rimossi. Nei messaggi Verbose vengono indicati gli elementi rimossi. I messaggi differiscono perché il modulo BitsTransfer include un assembly che implementa i cmdlet e un modulo nidificato con il relativo assembly. Il modulo PSDiagnostics include un file script del modulo (.psm1) che esporta funzioni.
Esempio 4
C:\PS>$a = get-module BitsTransfer C:\PS> remove-module -moduleInfo $a Descrizione ----------- Questo comando utilizza il parametro ModuleInfo per rimuovere il modulo BitsTransfer.
Vedere anche