現在のセッションからモジュールを削除します。
構文
Remove-Module [-ModuleInfo] <PSModuleInfo[]> [-Force] [-確認] [-WhatIf] [<CommonParameters>] Remove-Module [-Name] <string[]> [-Force] [-確認] [-WhatIf] [<CommonParameters>]
説明
Remove-Module コマンドレットは、現在のセッションからモジュールのメンバーを削除します。
モジュールにアセンブリ (.dll) が含まれる場合、アセンブリによって実装されたすべてのメンバーが削除されますが、アセンブリ自体はアンロードされません。
パラメーター
-Force
アクセス モードが読み取り専用であるモジュールも削除します。
必須 |
false |
位置 |
named |
既定値 |
|
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-ModuleInfo <PSModuleInfo[]>
削除するモジュール オブジェクトを指定します。モジュール オブジェクト (PSModuleInfo) を格納する変数を入力するか、Get-Module コマンドなど、モジュール オブジェクトを取得するコマンドを入力します。パイプを使用してモジュール オブジェクトを Remove-Module に渡すこともできます。
必須 |
true |
位置 |
1 |
既定値 |
|
パイプライン入力を許可する |
true (ByValue) |
ワイルドカード文字を許可する |
false |
-Name <string[]>
削除するモジュールの名前を指定します。ワイルドカードを使用できます。パイプを使用して名前文字列を Remove-Module に渡すこともできます。
必須 |
true |
位置 |
1 |
既定値 |
|
パイプライン入力を許可する |
true (ByValue) |
ワイルドカード文字を許可する |
true |
-確認
コマンドを実行する前に確認メッセージを表示します。
必須 |
false |
位置 |
named |
既定値 |
|
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WhatIf
実際にコマンドを実行せずに、コマンドを実行すると何が起きるかを出力します。
必須 |
false |
位置 |
named |
既定値 |
|
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。Ô”¼š¤Ë¤Ä¤¤¤Æ¤Ï¡¢次を参照してください: about_Commonparameters.
入力と出力
入力値の型は、コマンドレットへのパイプが可能なオブジェクトの型です。戻り値の型は、コマンドレットによって返されるオブジェクトの型です。
入力 |
System.String、System.Management.Automation.PSModuleInfo パイプを使用してモジュール名 (文字列) およびモジュール オブジェクトを Remove-Module に渡すことができます。 |
出力 |
None Remove-Module は出力を生成しません。 |
注
Remove-Module をエイリアス "rmo" で参照することもできます。詳細については、「about_Aliases」を参照してください。
例 1
C:\PS>remove-module -name BitsTransfer 説明 ----------- このコマンドは、BitsTransfer モジュールを現在のセッションから削除します。
例 2
C:\PS>get-module | remove-module 説明 ----------- このコマンドは、すべてのモジュールを現在のセッションから削除します。
例 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')". 説明 ----------- このコマンドは、FileTransfer モジュールおよび PSDiagnostics モジュールを現在のセッションから削除します。 このコマンドは、パイプライン演算子 (|) を使用してモジュール名を Remove-Module に送信します。Verbose 共通パラメーターを使用して、削除されるメンバーに関する詳細な情報を取得します。 Verbose メッセージには、削除される項目が表示されます。BitsTransfer モジュールにはコマンドレットを実装するアセンブリ、および独自のアセンブリを持つ入れ子のモジュールが含まれるため、表示されるメッセージは場合によって異なります。PSDiagnostics モジュールには、関数をエクスポートするモジュール スクリプト ファイル (.psm1) が含まれます。
例 4
C:\PS>$a = get-module BitsTransfer C:\PS> remove-module -moduleInfo $a 説明 ----------- このコマンドは、ModuleInfo パラメーターを使用して BitsTransfer モジュールを削除します。
関連項目