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 工具。有关详细信息，请参阅如何注册 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 管理单元。允许使用通配符。

类型:	String[]
Position:	0
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Registered

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

随 Windows PowerShell 一起安装的管理单元不会在此列表中显示。

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

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

输出

PSSnapInInfo

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

备注

Windows PowerShell 包含以下 Get-PSSnapin别名：

gsnp

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

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

通过