Share via

Get-PSSnapin

  • 參考
模組:
Microsoft.PowerShell.Core

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

Syntax

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

Description

Cmdlet Get-PSSnapin 會取得已新增至目前會話或已在系統上註冊的 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 嵌入式管理單元。允許通配符。

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 中建立舊樣式會話的主機程式中，核心命令會封裝在嵌入式管理單元中（PSSnapin）。 例外狀況是 Microsoft.PowerShell.Core，一律是嵌入式管理單元。 此外，遠端會話，例如 Cmdlet 所 New-PSSession 啟動的工作階段，是包含核心嵌入式管理單元的較舊樣式會話。

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