共用方式為


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

若要使用包含嵌入式管理單元的控制台檔案,請從 命令提示字元或cmd.exe另一個 Windows PowerShell 會話中啟動 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 屬性設定$true,以記錄 Windows PowerShell 模組和嵌入式管理單元中的 Cmdlet 執行事件。 如需詳細資訊,請參閱 about_EventLogs

另請參閱