about_PSSnapins

简短说明

介绍 Windows PowerShell 管理单元,并演示如何使用和管理它们。

长说明

Windows PowerShell 管理单元是一个 Microsoft .NET Framework 程序集,可以包含 Windows PowerShell 提供程序和 cmdlet。 Windows PowerShell 包含一组基本管理单元,但可以通过添加包含你创建或从其他人获取的提供程序和 cmdlet 的管理单元来扩展 Windows PowerShell 的强大功能和价值。

添加管理单元时,它包含的 cmdlet 和提供程序立即可用于当前会话,但更改仅影响当前会话。

若要将管理单元添加到所有将来的会话,请将它保存在 Windows PowerShell 配置文件中。 还可以使用 Export-Console cmdlet 将管理单元名称保存到控制台文件中,然后在将来的会话中使用该保存的配置。

从 Windows PowerShell 3.0 开始,随 PowerShell 附带的 cmdlet 打包在模块中。 例外是 Microsoft.PowerShell.Core,这是唯一的剩余管理单元。 默认情况下, Microsoft.PowerShell.Core 管理单元在每个会话中加载。 其余模块会在首次使用时自动加载。 有关详细信息,请参阅 about_Modules

查找管理单元

若要获取计算机上的 Windows PowerShell 管理单元列表,请键入:

Get-PSSnapin

若要获取每个 Windows PowerShell 提供程序的管理单元,请键入:

Get-PSProvider | Format-List name, pssnapin

若要获取系统上所有已注册的管理单元或验证是否已注册管理单元,请键入:

Get-PSSnapin -registered

若要获取 Windows PowerShell 管理单元中 cmdlet 的列表,请键入:

Get-Command -Module <snap-in_name>

安装管理单元

内置管理单元在系统中注册,并在启动 Windows PowerShell 时添加到默认会话。 但是,必须注册你创建或从其他人获取的管理单元,然后将管理单元添加到会话。

将管理单元添加到当前会话

若要将已注册管理单元添加到当前会话,请使用 Add-PsSnapin cmdlet。 例如,若要将 Microsoft SQL Server 管理单元添加到会话,请键入:

Add-PSSnapin sql

在命令完成后,管理单元中的提供程序和 cmdlet 可在会话中使用。 但是,除非保存它们,否则它们仅在当前会话中可用。

保存管理单元

若要在未来的 Windows PowerShell 会话中使用管理单元,请将 Add-PsSnapin 该命令添加到 Windows PowerShell 配置文件。 或者,将管理单元名称导出到控制台文件。

如果将命令 Add-PSSnapin 添加到配置文件,它将在所有将来的 Windows PowerShell 会话中可用。 如果在会话中导出管理单元的名称,则仅当需要管理单元时,才能使用导出文件。

若要将 Add-PsSnapin 命令添加到 Windows PowerShell 配置文件,请打开配置文件,粘贴或键入命令,然后保存配置文件。 有关详细信息,请参阅 about_Profiles

若要从控制台文件中的会话保存管理单元(.psc1),请使用 Export-Console cmdlet。 例如,若要将当前会话配置 NewConsole.psc1 中的管理单元保存到当前目录中的文件,请键入:

Export-Console NewConsole

有关详细信息,请参阅 Export-Console

使用控制台文件打开 Windows PowerShell

若要使用包含管理单元的控制台文件,请从命令提示符处或其他 Windows PowerShell 会话中cmd.exe启动 Windows PowerShell(powershell.exe)。 使用 PsConsoleFile 参数指定包含管理单元的控制台文件。 例如,以下命令使用 NewConsole.psc1 控制台文件启动 Windows PowerShell:

PowerShell.exe -psconsolefile NewConsole.psc1

管理单元中的提供程序和 cmdlet 现在可用于会话。

删除管理单元

若要从当前会话中删除 Windows PowerShell 管理单元,请使用 Remove-PsSnapin cmdlet。 例如,若要从当前会话中删除 SQL Server 管理单元,请键入:

Remove-PSSnapin sql

此 cmdlet 将从会话中删除管理单元。 管理单元仍在加载,但它支持的提供程序和 cmdlet 不再可用。

记录管理单元事件

从 Windows PowerShell 3.0 开始,可以通过将模块和管理单元的 LogPipelineExecutionDetails 属性设置为记录 Windows PowerShell 模块和管理单元$true中的 cmdlet 的执行事件。 有关详细信息,请参阅 about_EventLogs

另请参阅