Get-PSSnapin

参考

模块:: Microsoft.PowerShell.Core

获取计算机上的 Windows PowerShell 管理单元。

语法

Get-PSSnapin
   [[-Name] <String[]>]
   [-Registered]
   [<CommonParameters>]

说明

Get-PSSnapin cmdlet 获取已添加到当前会话或已在系统上注册的Windows PowerShell管理单元。此 cmdlet 按检测到这些管理单元的顺序列出这些管理单元。

Get-PSSnapin 仅获取已注册的管理单元。若要注册Windows PowerShell管理单元，请使用 Microsoft .NET Framework 2.0 附带的 InstallUtil 工具。有关详细信息，请参阅如何在 MSDN 库中注册 Cmdlet、提供程序和主机应用程序。

从 Windows PowerShell 3.0 开始，Windows PowerShell中包含的核心命令打包在模块中。例外情况是 Microsoft.PowerShell.Core，它是一个管理单元 (PSSnapin)。默认情况下，仅将 Microsoft.PowerShell.Core 管理单元添加到会话中。首次使用时自动导入模块，而且可以使用 Import-Module cmdlet 导入它们。

示例

示例 1：获取当前加载的管理单元

PS C:\> Get-PSSnapIn

此命令获取当前在会话中加载的 Windows PowerShell 管理单元。这包括与 Windows PowerShell 一起安装的以及添加到此会话的那些管理单元。

示例 2：获取已注册的管理单元

PS C:\> get-PSSnapIn -Registered

此命令获取已在计算机上注册的 Windows PowerShell 管理单元，包括那些已添加到会话的管理单元。输出不包括与 Windows PowerShell 或 Windows PowerShell 管理单元动态链接库 (DLL) 一起安装的管理单元，它们尚未在系统上注册。

示例 3：获取与字符串匹配的当前管理单元

PS C:\> Get-PSSnapIn -Name smp*

此命令获取当前会话中名称以 smp 开头的Windows PowerShell管理单元。

参数

-Name

指定管理单元名称的数组。此 cmdlet 仅获取指定的Windows PowerShell管理单元。允许使用通配符。

Type:	String[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Registered

指示此 cmdlet 获取已在系统上注册的Windows PowerShell管理单元，即使这些管理单元尚未添加到会话中。

与 Windows PowerShell 一起安装的管理单元不会出现在此列表中。

如果没有此参数，Get-PSSnapin 将获取已添加到会话的Windows PowerShell管理单元。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

不能通过管道将输入传递给此 cmdlet。

输出

PSSnapInInfo

Get-PSSnapin 将返回它所获取的每个管理单元的对象。

备注

从 Windows PowerShell 3.0 开始，随 Windows PowerShell 一起安装的核心命令打包在模块中。在 Windows PowerShell 2.0 中，在更高版本的 Windows PowerShell 中创建旧式会话的主机程序中，核心命令打包在 PSSnapin) (管理单元中。 Microsoft.PowerShell.Core 是例外情况，它始终是一个管理单元。此外，远程会话（如 New-PSSession cmdlet 启动的会话）是包括核心管理单元的旧样式会话。

有关使用核心模块创建较新样式会话的 CreateDefault2 方法的信息，请参阅 MSDN 库中的 CreateDefault2 方法。

通过