Add-PSSnapin

구문

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

Description

Add-PSSnapin cmdlet은 등록된 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과 Registered 매개 변수를 사용하여 등록된 각 스냅인을 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 결과를 Add-PSSnapin전달하여 세션에 추가합니다. PassThru 매개 변수는 추가된 각 스냅인을 나타내는 개체를 반환합니다.

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

The first command gets snap-ins that have been added to the current session that include the snap-ins that are installed with Windows PowerShell. In this example, ManagementFeatures is not returned. This indicates that it has not been added to the session.
PS C:\> Get-PSSnapin

The second command gets snap-ins that have been registered on your system, which includes those that have already been added to the session. It does not include the snap-ins that are installed with Windows PowerShell. In this case, the command does not return any snap-ins. This indicates that the ManagementFeatures snapin has not been registered on the system.
PS C:\> Get-PSSnapin -Registered

The third command creates an alias, installutil, for the path of the InstallUtil tool in .NET Framework.
PS C:\> Set-Alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe

The fourth command uses the InstallUtil tool to register the snap-in. The command specifies the path of ManagementCmdlets.dll, the file name or module name of the snap-in.
PS C:\> installutil C:\Dev\Management\ManagementCmdlets.dll

The fifth command is the same as the second command. This time, you use it to verify that the ManagementCmdlets snap-in is registered.
PS C:\> Get-PSSnapin -Registered

The sixth command uses the **Add-PSSnapin** cmdlet to add the ManagementFeatures snap-in to the session. It specifies the name of the snap-in, ManagementFeatures, not the file name.
PS C:\> add-pssnapin ManagementFeatures

To verify that the snap-in is added to the session, the seventh command uses the *Module* parameter of the Get-Command cmdlet. It displays the items that were added to the session by a snap-in or module.
PS C:\> Get-Command -Module ManagementFeatures

You can also use the **PSSnapin** property of the object that the **Get-Command** cmdlet returns to find the snap-in or module in which a cmdlet originated. The eighth command uses dot notation to find the value of the PSSnapin property of the Set-Alias cmdlet.
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 3.0부터 Windows PowerShell과 함께 설치된 핵심 명령은 모듈에 패키지됩니다. Windows PowerShell 2.0 및 이후 버전의 Windows PowerShell에서 이전 스타일 세션을 만드는 호스트 프로그램에서 핵심 명령은 스냅인(PSSnapins)으로 패키지됩니다. 예외는 항상 스냅인인 Microsoft.PowerShell.Core. 또한 New-PSSession cmdlet에서 시작하는 것과 같은 원격 세션은 핵심 스냅인을 포함하는 이전 스타일의 세션입니다.

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

• 스냅인에 대한 자세한 내용은 MSDN 라이브러리에서 about_PSSnapins 및 Windows PowerShell 스냅인 만드는 방법을 참조하세요.

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

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

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

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

관련 링크

• Get-PSSnapin
• Remove-PSSnapin
• about_Profiles
• about_PSSnapins