하나 이상의 Windows PowerShell 스냅인을 현재 세션에 추가합니다.

구문

Add-PSSnapin [-Name] <string[]> [-PassThru] [<CommonParameters>]

설명

Add-PSSnapin cmdlet은 등록된 Windows PowerShell 스냅인을 현재 세션에 추가합니다. 스냅인이 추가되고 나면 현재 세션에서 스냅인이 지원하는 공급자와 cmdlet을 사용할 수 있습니다.

이후의 모든 Windows PowerShell 세션에 스냅인을 추가하려면 Add-PSSnapin 명령을 Windows PowerShell 프로필에 추가합니다. 자세한 내용은 about_Profiles를 참조하십시오.

매개 변수

-Name <string[]>

스냅인의 이름을 지정합니다. 이 이름은 AssemblyName 또는 ModuleName이 아니라 Name입니다.

해당 시스템에서 등록된 스냅인의 이름을 찾으려면 "Get-PSSnapin -registered"를 입력합니다.

필수 여부

true

위치

1

기본값

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-PassThru

추가된 각 스냅인을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

없음

개체를 Add-PSSnapin으로 파이프할 수 없습니다.

출력

없음 또는 System.Management.Automation.PSSnapInInfo

PassThru 매개 변수를 사용할 경우 Add-PSSnapin은 스냅인을 나타내는 PSSnapInInfo 개체를 반환합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다.

참고

Windows PowerShell의 스냅인에 대한 자세한 내용은 about_PSSnapins를 참조하십시오. Windows PowerShell 스냅인을 만드는 방법에 대한 자세한 내용은 MSDN(Microsoft Developer Network) 라이브러리의 "How to Create a Windows PowerShell Snap-in(Windows PowerShell 스냅인을 만드는 방법)"(https://go.microsoft.com/fwlink/?LinkId=144762)을 참조하십시오.

Add-PSSnapin은 현재 세션에만 스냅인을 추가합니다. 모든 Windows PowerShell 세션에 스냅인을 추가하려면 스냅인을 Windows PowerShell 프로필에 추가합니다. 자세한 내용은 about_Profiles를 참조하십시오.

Microsoft .NET Framework 설치 유틸리티를 사용하여 등록한 모든 Windows PowerShell 스냅인을 추가할 수 있습니다. 자세한 내용은 MSDN 라이브러리의 "How to Register Cmdlets, Providers, and Host Applications(cmdlet, 공급자 및 호스트 응용 프로그램을 등록하는 방법)"(https://go.microsoft.com/fwlink/?LinkID=143619)를 참조하십시오.

컴퓨터에 등록되어 있는 스냅인 목록을 가져오려면 "Get-PSSnapin -registered"를 입력하십시오.

Add-PSSnapin은 스냅인을 추가하기 전에 해당 스냅인의 버전이 Windows PowerShell의 현재 버전과 호환되는지 확인합니다. 스냅인이 버전 확인에 실패하면 Windows PowerShell에서 오류를 보고합니다.

예 1

C:\PS>add-PSSnapIn Microsoft.Exchange, Microsoft.Windows.AD

설명
-----------
이 명령은 Microsoft Exchange 및 Active Directory 스냅인을 현재 세션에 추가합니다.






예 2

C:\PS>get-pssnapin -registered | add-pssnapin -passthru

설명
-----------
이 명령은 등록된 모든 Windows PowerShell 스냅인을 세션에 추가합니다. Registered 매개 변수와 함께 Get-PSSnapin cmdlet을 사용하여 등록된 각 스냅인을 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 결과를 세션에 추가하는 명령인 Add-PSSnapin으로 결과를 전달합니다. PassThru 매개 변수는 추가된 각 스냅인을 나타내는 개체를 반환합니다.






예 3

C:\PS>get-pssnapin

설명
-----------
이 예에서는 시스템에서 스냅인을 등록한 다음 세션에 추가하는 프로세스를 보여 줍니다. 여기에서는 ManagementCmdlets.dll 파일에 구현된 가상의 스냅인인 ManagementFeatures를 사용합니다.

첫 번째 명령은 Windows PowerShell과 함께 설치된 스냅인을 비롯하여 현재 세션에 추가된 스냅인을 가져옵니다. 이 예에서 ManagementFeatures는 반환되지 않습니다. 이는 ManagementFeatures가 세션에 추가되지 않았음을 나타냅니다. 

    get-pssnapin


두 번째 명령은 세션에 이미 추가된 스냅인을 비롯하여 시스템에 등록된 스냅인을 가져옵니다. 여기에는 Windows PowerShell과 함께 설치된 스냅인이 포함되지 않습니다.

    get-pssnapin -registered

 
이 경우 이 명령은 스냅인을 반환하지 않습니다. 이는 ManagementFeatures 스냅인이 시스템에 등록되지 않았음을 나타냅니다.

세 번째 명령은 .Net Framework에서 InstallUtil 도구의 경로에 대한 별칭("installutil")을 만듭니다.

    set-alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe


네 번째 명령은 InstallUtil 도구를 사용하여 스냅인을 등록합니다. 이 명령은 스냅인의 파일 이름 또는 "모듈 이름"인 ManagementCmdlets.dll의 경로를 지정합니다.

    installutil C:\Dev\Management\ManagementCmdlets.dll


다섯 번째 명령은 두 번째 명령과 동일합니다. 이번에는 이 명령을 사용하여 ManagementCmdlets 스냅인이 등록되었는지 확인합니다.

    get-pssnapin -registered

여섯 번째 명령은 Add-PSSnapin cmdlet을 사용하여 ManagementFeatures 스냅인을 세션에 추가합니다. 이 명령은 파일 이름이 아니라 스냅인의 이름인 ManagementFeatures를 지정합니다.

    add-pssnapin ManagementFeatures

스냅인이 세션에 추가되었는지 확인하기 위해 일곱 번째 명령은 Get-Command cmdlet의 Module 매개 변수를 사용합니다. 이 명령은 스냅인이나 모듈에서 세션에 추가한 항목을 표시합니다. 

    get-command -module ManagementFeatures

Get-Command가 반환하는 개체의 PSSnapin 속성을 사용하여 cmdlet이 제공된 스냅인이나 모듈을 찾을 수도 있습니다. 여덟 번째 명령은 점 표기법을 사용하여 Set-Alias 명령의 PSSnapin 속성 값을 찾습니다. 

    (get-command set-alias).pssnapin






참고 항목




목차