현재 세션에서 모듈을 제거합니다.
구문
Remove-Module [-ModuleInfo] <PSModuleInfo[]> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>] Remove-Module [-Name] <string[]> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]
설명
Remove-Module cmdlet은 현재 세션에서 모듈의 멤버를 제거합니다.
모듈에 어셈블리(.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 |
-Confirm
명령을 실행하기 전에 확인 메시지를 표시합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-WhatIf
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
|
입력 |
System.String, System.Management.Automation.PSModuleInfo 모듈 이름(문자열)과 모듈 개체를 Remove-Module로 파이프할 수 있습니다. |
|
출력 |
없음 Remove-Module은 출력을 생성하지 않습니다. |
참고
또한 해당 별칭("rmo")으로 Remove-Module을 참조할 수 있습니다. 자세한 내용은 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 일반 매개 변수를 사용하여 제거된 멤버에 대한 자세한 정보를 가져옵니다. 세부 정보 메시지에 제거된 항목이 나와 있습니다. BitsTransfer 모듈에 해당 cmdlet을 구현하는 어셈블리와 자체 어셈블리가 포함된 중첩 모듈이 들어 있기 때문에 이러한 메시지는 서로 다릅니다. PSDiagnostics 모듈에는 함수를 내보내는 모듈 스크립트 파일(.psm1)이 포함되어 있습니다.
예 4
C:\PS>$a = get-module BitsTransfer C:\PS> remove-module -moduleInfo $a 설명 ----------- 이 명령은 ModuleInfo 매개 변수를 사용하여 BitsTransfer 모듈을 제거합니다.
참고 항목