현재 세션에서 Windows PowerShell 스냅인을 제거합니다.
구문
Remove-PSSnapin [-Name] <string[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
설명
Remove-PSSnapin cmdlet은 현재 세션에서 Windows PowerShell 스냅인을 제거합니다. 이를 통해 Windows PowerShell에 추가된 스냅인은 제거할 수 있지만 Windows PowerShell과 함께 설치된 스냅인은 제거할 수 없습니다.
스냅인은 현재 세션에서 제거된 후 계속 로드되어 있지만 해당 스냅인의 cmdlet 및 공급자는 세션에서 더 이상 사용할 수 없습니다.
매개 변수
-Name <string[]>
현재 세션에서 제거할 Windows PowerShell 스냅인의 이름을 지정합니다. 매개 변수 이름("Name")은 선택 사항이며 와일드카드 문자(*)를 값에 사용할 수 있습니다.
|
필수 여부 |
true |
|
위치 |
1 |
|
기본값 |
없음 |
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
|
와일드카드 문자 적용 여부 |
true |
-PassThru
스냅인을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-Confirm
명령을 실행하기 전에 확인 메시지를 표시합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-WhatIf
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
|
입력 |
System.Management.Automation.PSSnapInInfo 스냅인 개체를 Remove-PSSnapin으로 파이프할 수 있습니다. |
|
출력 |
없음 또는 System.Management.Automation.PSSnapInInfo 기본적으로 Remove-PsSnapin은 출력을 생성하지 않습니다. 그러나 PassThru 매개 변수를 사용하는 경우 스냅인을 나타내는 System.Management.Automation.PSSnapInInfo 개체가 생성됩니다. |
참고
해당 기본 제공 별칭("rsnp")으로 Remove-PSSnapin을 참조할 수도 있습니다. 자세한 내용은 about_Aliases를 참조하십시오.
Remove-PSSnapin은 세션에서 스냅인을 제거하기 전에 Windows PowerShell 버전을 확인하지 않습니다. 스냅인을 제거할 수 없는 경우 경고가 표시되고 명령이 실패합니다.
Remove-PSSnapin는 현재 세션에만 영향을 줍니다. Add-PSSnapin 명령을 Windows PowerShell 프로필에 추가한 경우 이후 세션에서 스냅인을 제거하려면 이 명령을 삭제해야 합니다. 자세한 내용은 about_Profiles를 참조하십시오.
예 1
C:\PS>remove-pssnapin -name Microsoft.Exchange 설명 ----------- 이 명령은 현재 세션에서 Microsoft.Exchange 스냅인을 제거합니다. 명령이 완료되면 스냅인이 지원하는 cmdlet 및 공급자를 세션에서 사용할 수 없습니다.
예 2
C:\PS>get-PSSnapIn smp* | remove-PSSnapIn 설명 ----------- 이 명령은 현재 세션에서 이름이 "smp"로 시작하는 Windows PowerShell 스냅인을 제거합니다. 이 명령은 Get-PSSnapin cmdlet을 사용하여 스냅인을 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 Remove-PSSnapin cmdlet으로 결과를 보냅니다. 이 cmdlet은 받은 결과를 세션에서 제거합니다. 명령이 완료되면 스냅인이 지원하는 cmdlet 및 공급자를 세션에서 더 이상 사용할 수 없습니다. 개체를 Remove-PSSnapin으로 파이프하면 파이프라인에서 Name 속성을 가진 개체를 받아들이는 Name 매개 변수에 개체 이름이 연결됩니다.
예 3
C:\PS>remove-pssnapin -name *event* 설명 ----------- 이 명령은 이름에 "event"가 포함된 모든 Windows PowerShell 스냅인을 제거합니다. 이 명령은 "Name" 매개 변수 이름을 지정하지만 이 매개 변수 이름은 선택 사항이므로 생략할 수 있습니다.
참고 항목