共用方式為

Get-PSSnapin

  • 參考
模組:
Microsoft.PowerShell.Core

取得電腦上的 Windows PowerShell 嵌入式管理單元。

語法

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

Description

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 嵌入式管理單元。允許通配符。

類型: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 3.0 開始，隨 Windows PowerShell 一起安裝的核心命令會封裝在模組中。 在 Windows PowerShell 2.0 和在更新版本的 Windows PowerShell 中建立舊式會話的主機程式中，核心命令會封裝在嵌入式管理單元中（PSSnapin）。 例外狀況是 Microsoft.PowerShell.Core，這一定是嵌入式管理單元。 此外，遠端會話，例如由 New-PSSession Cmdlet 啟動的會話，是包含核心嵌入式管理單元的較舊樣式會話。

    如需使用核心模組建立較新樣式會話 CreateDefault2 方法的相關信息，請參閱 MSDN 連結庫中的 CreateDefault2 方法。