Entfernt Module aus der aktuellen Sitzung.
Syntax
Remove-Module [-ModuleInfo] <PSModuleInfo[]> [-Force] [-Bestätigung] [-WhatIf] [<CommonParameters>] Remove-Module [-Name] <string[]> [-Force] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Remove-Module" werden die Elemente eines Moduls aus der aktuellen Sitzung entfernt.
Wenn das Modul eine Assembly (.dll) enthält, werden alle von der Assembly implementierten Elemente entfernt, die Assembly wird jedoch nicht entladen.
Parameter
-Force
Entfernt Module auch dann, wenn der AccessMode auf ReadOnly festgelegt ist.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-ModuleInfo <PSModuleInfo[]>
Gibt die Modulobjekte an, die entfernt werden sollen. Geben Sie eine Variable ein, die ein Modulobjekt (PSModuleInfo) enthält, oder einen Befehl, mit dem ein Modulobjekt abgerufen wird, beispielsweise den Befehl "Get-Module". Sie können Modulobjekte auch über die Pipeline an Remove-Module übergeben.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
|
Platzhalterzeichen akzeptieren? |
false |
-Name <string[]>
Gibt die Namen der Module an, die entfernt werden sollen. Platzhalter sind zulässig. Namenszeichenfolgen können auch über die Pipeline an Remove-Module übergeben werden.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
|
Platzhalterzeichen akzeptieren? |
true |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.String, System.Management.Automation.PSModuleInfo Sie können Modulnamen (Zeichenfolgen) und Modulobjekte über die Pipeline an Remove-Module übergeben. |
|
Ausgaben |
None Remove-Module generiert keine Ausgabe. |
Hinweise
Sie können auch über den Alias "rmo" auf Remove-Module verweisen. Weitere Informationen finden Sie unter "about_Aliases".
Beispiel 1
C:\PS>remove-module -name BitsTransfer Beschreibung ----------- Mit diesem Befehl wird das BitsTransfer-Modul aus der aktuellen Sitzung entfernt.
Beispiel 2
C:\PS>get-module | remove-module Beschreibung ----------- Mit diesem Befehl werden alle Module aus der aktuellen Sitzung entfernt.
Beispiel 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')".
Beschreibung
-----------
Mit diesem Befehl werden das FileTransfer-Modul und das PSDiagnostics-Modul aus der aktuellen Sitzung entfernt.
Die Modulnamen werden vom Befehl mit einem Pipelineoperator (|) an Remove-Module gesendet. Mit dem allgemeinen Verbose-Parameter werden ausführliche Informationen über die Elemente abgerufen, die entfernt werden.
Die ausführlichen Meldungen geben die Elemente an, die entfernt werden. Die Meldungen unterscheiden sich, da das BitsTransfer-Modul eine Assembly enthält, mit der die Cmdlets sowie ein geschachteltes Modul in einer eigenen Assembly implementiert werden. Das PSDiagnostics-Modul enthält eine Modulskriptdatei (".psm1"), mit der Funktionen exportiert werden.
Beispiel 4
C:\PS>$a = get-module BitsTransfer C:\PS> remove-module -moduleInfo $a Beschreibung ----------- In diesem Befehl wird das BitsTransfer-Modul mit dem ModuleInfo-Parameter entfernt.
Siehe auch