ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2009 Microsoft Corporation.
C:\Windows-7>Powershell get-help Remove-Module -full
NAME
Remove-Module
# ÜBERSICHT
Entfernt Module aus der aktuellen Sitzung.
# SYNTAX
Remove-Module [-ModuleInfo
] <PSModuleInfo
[]>
[-Force
] [-Confirm
] [-WhatIf
] [<CommonParameters>
]
Remove-Module [-Name
] <string
[]>
[-Force
] [-Confirm
] [-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 [<SwitchParameter>
]
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
-Confirm [<SwitchParameter>
]
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
Erforderlich? false
Position? named
Standardwert
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
-WhatIf [<SwitchParameter>
]
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 folgende allgemeine Parameter: "Verbose", "Debug",
"ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable",
"OutBuffer" und "OutVariable". Weitere Informationen
erhalten Sie mit dem Befehl "
get-help about_commonparameters".
# EINGABEN
System.String, System.Management.Automation.PSModuleInfo
Sie können Modulnamen
(Zeichenfolgen
) und Modulobjekte über die Pipeline an
Remove-Module übergeben.
# AUSGABEN
Keiner
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.
VERWANDTE LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=141556
(möglicherweise auf Englisch
)
Get-Module
Import-Module
about_modules
C:\Windows>powershell
get-help New-ModuleManifest -full
