通过

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*

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

参数

-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 包含 Get-PSSnapin 的以下别名：

  • gsnp

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

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