共用方式為

Get-PSSnapin

  • 參考
模組:
Microsoft.PowerShell.Core

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

Syntax

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

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 3.0 開始，與 Windows PowerShell 一起安裝的核心命令已經封裝成模組。 在 Windows PowerShell 2.0，以及在較新版本之 Windows PowerShell 中建立舊式工作階段的主機程式中，核心命令是封裝成嵌入式管理單元 (PSSnapin)。 Microsoft.PowerShell.Core 是一個例外，它一律是一個嵌入式管理單元。 此外，遠端工作階段 (例如由 New-PSSession cmdlet 所啟動的遠端工作階段) 都是包含核心嵌入式管理單元的舊式工作階段。

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