將一個或多個 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
請參閱