Add-PSSnapin

發行項
10/30/2009

將一個或多個 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 所傳回的物件型別。

輸入

無

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

輸出

無或 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

請參閱

概念

Get-PSSnapin
Remove-PSSnapin
about_Profiles

共用方式為