Add-PSSnapin

구문

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

Description

cmdlet은 Add-PSSnapin 현재 세션에 등록된 Windows PowerShell 스냅인을 추가합니다. 스냅인을 추가한 후에는 스냅인에서 현재 세션에서 지원하는 cmdlet 및 공급자를 사용할 수 있습니다.

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

Windows PowerShell 3.0부터 Windows PowerShell에 포함된 핵심 명령은 모듈에 패키지됩니다. 스냅인(PSSnapin)인 Microsoft.PowerShell.Core는 예외입니다. 기본적으로 Microsoft.PowerShell.Core 스냅인만 세션에 추가됩니다. 모듈은 처음 사용할 때 자동으로 가져오며 Import-Module cmdlet을 사용하여 가져올 수 있습니다.

예제

예제 1: 스냅인 추가

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

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

예제 2: 등록된 모든 스냅인 추가

PS C:\> Get-PSSnapin -Registered | Add-PSSnapin -PassThru

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

예제 3: 스냅인 등록 및 추가

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

두 번째 명령은 이미 세션에 추가된 스냅인을 포함하여 시스템에 등록된 스냅인을 가져옵니다. Windows PowerShell과 함께 설치된 스냅인은 포함되지 않습니다. 이 경우 명령은 스냅인을 반환하지 않습니다. 이는 ManagementFeatures 스냅인이 시스템에 등록되지 않음을 나타냅니다.

세 번째 명령은 .NET Framework의 InstallUtil 도구 경로에 대한 별칭인 installutil을 만듭니다.

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

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

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

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

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

PS C:\> Get-PSSnapin
PS C:\> Get-PSSnapin -Registered
PS C:\> Set-Alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe
PS C:\> installutil C:\Dev\Management\ManagementCmdlets.dll
PS C:\> Get-PSSnapin -Registered
PS C:\> add-pssnapin ManagementFeatures
PS C:\> Get-Command -Module ManagementFeatures
PS C:\> (Get-Command Set-Alias).pssnapin

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

매개 변수

-Name

-PassThru

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

None or System.Management.Automation.PSSnapInInfo

이 cmdlet은 PassThru 매개 변수를 지정하는 경우 스냅인을 나타내는 PSSnapInInfo 개체를 반환합니다. 그렇지 않으면 이 cmdlet은 출력을 생성하지 않습니다.

참고

Windows PowerShell에는 다음 별칭이 포함됩니다.Add-PSSnapin

• asnp

Windows PowerShell 3.0부터 Windows PowerShell과 함께 설치된 핵심 명령은 모듈에 패키지됩니다. Windows PowerShell 2.0 및 이후 버전의 Windows PowerShell에서 이전 스타일 세션을 만드는 호스트 프로그램에서 핵심 명령은 스냅인(PSSnapins)으로 패키지됩니다. 예외는 항상 스냅인인 Microsoft.PowerShell.Core입니다. 또한 New-PSSession cmdlet에서 시작한 것과 같은 원격 세션은 핵심 스냅인을 포함하는 이전 스타일의 세션입니다.

핵심 모듈을 사용하여 최신 스타일 세션을 만드는 CreateDefault2 메서드에 대한 자세한 내용은 CreateDefault2 메서드를 참조하세요.

스냅인에 대한 자세한 내용은 about_PSSnapins 및 Windows PowerShell 스냅인을 만드는 방법을 참조하세요.

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

Microsoft .NET Framework 설치 유틸리티를 사용하여 등록된 스냅인을 추가할 수 있습니다. 자세한 내용은 Cmdlet, 공급자 및 호스트 애플리케이션을 등록하는 방법을 참조 하세요.

컴퓨터에 등록된 스냅인 목록을 보려면 다음을 입력 Get-PSSnapin -Registered합니다.

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

관련 링크

• Get-PSSnapin
• Remove-PSSnapin