將一個或多個 Windows PowerShell 嵌入式管理單元新增至目前的工作階段。

語法

Add-PSSnapin [-Name] <string[]> [-PassThru] [<CommonParameters>]

描述

Add-PSSnapin Cmdlet 會將已註冊的 Windows PowerShell 嵌入式管理單元新增至目前的工作階段。新增這些嵌入式管理單元之後,您就可以在目前的工作階段中,使用這些嵌入式管理單元支援的 Cmdlet 和提供者。

若要將嵌入式管理單元新增至未來所有的 Windows PowerShell 工作階段,請將 Add-PSSnapin 命令新增至 Windows PowerShell 設定檔。如需詳細資訊,請參閱 about_Profiles。

參數

-Name <string[]>

指定嵌入式管理單元的名稱 (這是 Name,而不是 AssemblyName 或 ModuleName)。

若要尋找系統上已註冊嵌入式管理單元的名稱,請輸入:"get-pssnapin -registered"。

必要?

true

位置?

1

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

-PassThru

傳回代表每個新增之嵌入式管理單元的物件。根據預設,此 Cmdlet 不會產生任何輸出。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

None

您無法經由管道將物件輸出至 Add-PSSnapin。

輸出

None 或 System.Management.Automation.PSSnapInInfo

當您使用 PassThru 參數時,Add-PSSnapin 會傳回代表嵌入式管理單元的 PSSnapInInfo 物件。否則,這個 Cmdlet 不會產生任何輸出。

附註

如需 Windows PowerShell 中嵌入式管理單元的詳細資訊,請參閱 about_PSSnapins。如需如何建立 Windows PowerShell 嵌入式管理單元的詳細資訊,請參閱 MSDN (Microsoft Developer Network) Library 中的<如何建立 Windows PowerShell 嵌入式管理單元>(英文),網址為:https://go.microsoft.com/fwlink/?LinkId=144762。

Add-PSSnapin 只會在目前的工作階段中新增嵌入式管理單元。若要將嵌入式管理單元新增至所有 Windows PowerShell 工作階段,請將此 Cmdlet 新增至 Windows PowerShell 設定檔。如需詳細資訊,請參閱 about_Profiles。

您可以新增任何已經使用 Microsoft .NET Framework 安裝公用程式完成註冊的 Windows PowerShell 嵌入式管理單元。如需詳細資訊,請參閱 MSDN Library 中的<如何註冊 Cmdlet、提供者和主機應用程式>(英文),網址為:https://go.microsoft.com/fwlink/?LinkID=143619。

若要取得電腦已註冊的嵌入式管理單元清單,請輸入 "Get-PSSnapin -registered"。

在新增嵌入式管理單元之前,Add-PSSnapin 會先檢查嵌入式管理單元的版本,確認是否與目前的 Windows PowerShell 版本相容。如果嵌入式管理單元版本檢查失敗,Windows PowerShell 就會報告錯誤。

範例 1

C:\PS>add-PSSnapIn Microsoft.Exchange, Microsoft.Windows.AD

描述
-----------
這個命令會將 Microsoft Exchange 和 Active Directory 嵌入式管理單元新增至目前的工作階段。






範例 2

C:\PS>get-pssnapin -registered | add-pssnapin -passthru

描述
-----------
這個命令會將所有已註冊的 Windows PowerShell 嵌入式管理單元新增至工作階段。它會使用 Get-PSSnapin Cmdlet 搭配 Registered 參數,取得代表每個已註冊之嵌入式管理單元的物件。管線運算子 (|) 會將結果傳遞到 Add-PSSnapin,並由其將這些物件新增至工作階段。PassThru 參數會傳回代表每個新增之嵌入式管理單元的物件。






範例 3

C:\PS>get-pssnapin

描述
-----------
在這個範例中,會示範在系統上註冊嵌入式管理單元,然後將它新增至工作階段的程序。範例中使用 ManagementFeatures,這是在 ManagementCmdlets.dll 檔案中實作的虛構嵌入式管理單元。

第一個命令會取得已新增至目前工作階段的嵌入式管理單元,包括與 Windows PowerShell 一併安裝的嵌入式管理單元。在這個範例中,不會傳回 ManagementFeatures。這表示此嵌入式管理單元尚未新增至工作階段。

    get-pssnapin


第二個命令會取得在系統上已註冊的嵌入式管理單元 (包括已新增至工作階段的嵌入式管理單元),但不包含與 Windows PowerShell 一併安裝的嵌入式管理單元。

    get-pssnapin -registered

 
在此例中,命令不會傳回任何嵌入式管理單元。這表示 ManagementFeatures 嵌入式管理單元尚未在系統上註冊。

第三個命令會建立別名 "installutil",表示 .NET Framework 工具 InstallUtil 的路徑。

    set-alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe


第四個命令會使用 InstallUtil 工具註冊此嵌入式管理單元,並指定 ManagementCmdlets.dll (此嵌入式管理單元的檔案名稱或「模組名稱」) 的路徑。

    installutil C:\Dev\Management\ManagementCmdlets.dll


第五個命令與第二個命令相同。現在,您可以使用它來確認是否已註冊 ManagementCmdlets 嵌入式管理單元。

    get-pssnapin -registered

第六個命令會使用 Add-PSSnapin Cmdlet 將 ManagementFeatures 嵌入式管理單元新增至工作階段,並指定嵌入式管理單元 ManagementFeatures 的名稱,而不是檔案名稱。

    add-pssnapin ManagementFeatures

第七個命令會使用 Get-Command Cmdlet 的 Module 參數,確認此嵌入式管理單元是否已新增至工作階段。它會依照嵌入式管理單元或模組,顯示已新增至工作階段的項目。

    get-command -module ManagementFeatures

您也可以使用 Get-Command 所傳回物件的 PSSnapin 屬性,尋找 Cmdlet 的來源嵌入式管理單元或模組。第八個命令會使用點標記法,尋找 Set-Alias 命令的 PSSnapin 屬性值。

    (get-command set-alias).pssnapin






請參閱




目錄