Import-PSSession

Import-PSSession [-Session] <PSSession> [[-CommandName] <string[]>] [[-FormatTypeName] <string[]>] [-AllowClobber] [-ArgumentList <Object[]>] [-CommandType {<Alias> | <Function> | <Filter> | <Cmdlet> | <ExternalScript> | <Application> | <Script> | <All>}] [-Module <string[]>] [-Prefix <string>] [<CommonParameters>]

C:\PS>$s = new-pssession -computername Server01

C:\PS> import-pssession -session $s

描述
-----------
這個命令會從 Server01 電腦上的 PSSession 將所有命令匯入目前的工作階段，但與目前工作階段中的命令同名的命令則除外。

因為這個命令不使用 CommandName 參數，所以它也會匯入匯入的命令所需的所有格式化資料。

C:\PS>$s = new-pssession https://ps.testlabs.com/powershell

C:\PS> import-pssession -session $s -commandname *-test -formatTypeName *

C:\PS> new-test -name test1

C:\PS> get-test test1 | run-test

描述
-----------
這些命令會從 PSSession 將名稱結尾為 "-test" 的命令匯入本機工作階段，然後示範如何使用匯入的 Cmdlet。

第一個命令會使用 New-PSSession Cmdlet 建立 PSSession，並將這個 PSSession 儲存在 $s 變數中。

第二個命令會使用 Import-PSSession Cmdlet 從 $s 中的 PSSession 將命令匯入本機工作階段。它會使用 CommandName 參數指定具有 Test 名詞的命令，並使用 FormatTypeName 參數匯入 Test 命令的格式化資料。

第三個和第四個命令會使用目前工作階段中匯入的命令。因為匯入的命令實際上是新增到目前的工作階段，您可以使用本機語法加以執行，並不需要使用 Invoke-Command Cmdlet 執行匯入的命令。

C:\PS>$s1 = new-pssession -computername s1 

C:\PS> $s2 = new-pssession -computername s2

C:\PS> import-pssession -session s1 -type cmdlet -name New-Test, Get-Test -FormatTypeName *

C:\PS> import-pssession -session s2 -type cmdlet -name Set-Test -FormatTypeName *

C:\PS> new-test Test1 | set-test -runtype full

描述
-----------
這個範例示範您可以像使用本機 Cmdlet 一樣使用匯入的 Cmdlet。

這些命令會從 Server01 電腦上的 PSSession 匯入 New-Test 和 Get-Test Cmdlet，以及從 Server02 電腦上的 PSSession 匯入 Set-Test Cmdlet。

雖然這些 Cmdlet 是從不同 PSSession 匯入而得，但您仍可經由管道將物件從一個 Cmdlet 匯入至另一個 Cmdlet，而不會有錯誤產生。

C:\PS>$s = new-pssession -computername Server01

C:\PS> import-pssession -session $s -commandname *-test* -formattypename *

C:\PS> $batch = new-test -name Batch -asjob

C:\PS> receive-job $batch

描述
-----------
這個範例示範如何以背景工作的方式執行匯入的命令。

因為匯入的命令可能要花比本機命令還要久的執行時間，Import-PSSession 會在每個匯入的命令中新增 AsJob 參數。AsJob 參數可讓您以背景工作的方式執行命令。

第一個命令會在 Server01 電腦上建立 PSSession，然後將 PSSession 物件儲存到 $s 變數。

第二個命令會使用 Import-PSSession 從 $s 中的 PSSession 將 Test Cmdlet 匯入目前工作階段。

第三個命令會使用匯入之 New-Test Cmdlet 的 AsJob 參數，以背景工作的方式執行 New-Test 命令，並將 New-Test 所傳回的工作物件儲存在 $batch 變數中。

第四個命令會使用 Receive-Job Cmdlet 取得 $batch 變數中的工作結果。

C:\PS>$s = new-pssession -comp Server01

C:\PS> invoke-command -session $s {import-module TestManagement}

C:\PS> import-pssession -session $s -module TestManagement

描述
-----------
這個範例示範如何從遠端電腦上的 Windows PowerShell 模組將 Cmdlet 和函數匯入目前的工作階段。

第一個命令會在 Server01 電腦上建立 PSSession，然後將其儲存到 $s 變數。

第二個命令會使用 Invoke-Command Cmdlet 在 $s 的 PSSession 中執行 Import-Module 命令。

一般來說，Windows PowerShell 設定檔內的 Import-Module 命令會將模組加入至所有工作階段，但設定檔無法在 PSSessions 中執行。

第三個命令會使用 Import-PSSession 的 Module 參數將模組中的 Cmdlet 和函數匯入目前的工作階段。

C:\PS>import-pssession $s -CommandName Get-Date, SearchHelp  -formatTypeName * -AllowClobber


Name              : tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1zunz.ttf
Path              : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1zunz.ttf\tmp_79468106-4e1d-4d90-af97-1154f9317239_
                    tcw1zunz.ttf.psm1
Description       : Implicit remoting for http://server01.corp.fabrikam.com/wsman
Guid              : 79468106-4e1d-4d90-af97-1154f9317239
Version           : 1.0
ModuleBase        : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1zunz.ttf
ModuleType        : Script
PrivateData       : {ImplicitRemoting}
AccessMode        : ReadWrite
ExportedAliases   : {}
ExportedCmdlets   : {}
ExportedFunctions : {[Get-Date, Get-Date], [SearchHelp, SearchHelp]}
ExportedVariables : {}
NestedModules     : {}

描述
-----------
這個範例示範 Import-PSSession 在磁碟上的暫存檔中建立模組，也示範所有命令都會轉換成函數，然後再將其匯入目前工作階段。

此命令會使用 Import-PSSession Cmdlet 將 Get-Date Cmdlet 和 SearchHelp 函數匯入目前工作階段中。

Import-PSSession Cmdlet 會傳回代表暫時性模組的 PSModuleInfo 物件。Path 屬性值顯示 Import-PSSession 已經在暫存位置建立指令碼模組 (.psm1) 檔案。ExportedFunctions 屬性顯示 Get-Date Cmdlet 和 SearchHelp 函數兩者都當做函數匯入。

C:\PS>import-pssession $s -CommandName Get-Date -formatTypeName * -AllowClobber

C:\PS> get-command get-date

CommandType   Name       Definition
-----------   ----       ----------
Function      Get-Date   ...
Cmdlet        Get-Date   Get-Date [[-Date] <DateTime>] [-Year <Int32>] [-Month <Int32>]

C:\PS> Get-Date
09074   

C:\PS> (get-command -type cmdlet -name get-date).pssnapin.name
Microsoft.PowerShell.Utility

C:\PS> Microsoft.PowerShell.Utility\get-date

Sunday, March 15, 2009 2:08:26 PM

描述
-----------
這個範例會示範如何執行匯入之命令所隱藏的命令。

第一個命令會從 $s 變數中的 PSSession 匯入 Get-Date Cmdlet。因為目前工作階段包含 Get-Date Cmdlet，所以此命令中需要 AllowClobber 參數。

第二個命令會使用 Get-Command Cmdlet 取得目前工作階段中的 Get-Date 命令。輸出顯示此工作階段包含原始 Get-Date Cmdlet 和 Get-Date 函數。Get-Date 函數會在 $s 的 PSSession 中執行匯入的 Get-Date Cmdlet。

第三個命令會執行 Get-Date 命令。因為函數優先於 Cmdlet，所以 Windows PowerShell 會執行匯入的 Get-Date 函數，此函數會傳回凱撒日 (Julian Date)。

第四和第五個命令會示範如何使用合格的名稱來執行匯入的命令所隱藏的命令。

第四個命令會取得將原始 Get-Date Cmdlet 加入至目前工作階段的 Windows PowerShell 嵌入式管理單元名稱。

第五個命令會使用 Get-Date Cmdlet 的嵌入式管理單元限定名稱來執行 Get-Date 命令。

如需命令優先順序和隱藏命令的詳細資訊，請參閱 about_Command_Precedence。

C:\PS>import-pssession -session $s -commandName *Item* -AllowClobber

描述
-----------
這個命令會從 $s 的 PSSession 匯入名稱包含 "Item" 的命令。因為此命令包含 CommandName 參數，而不包含 FormatTypeData 參數，所以只會匯入此命令。

當您在遠端電腦上使用 Import-PSSession 執行命令，而且您在目前工作階段中已經有此命令的格式化資料時，請使用這個命令。

C:\PS>$m = import-pssession -session $s -CommandName *bits* -formattypename *bits*

C:\PS> get-command -module $m

CommandType     Name
-----------     ----
Function        Add-BitsFile
Function        Complete-BitsTransfer
Function        Get-BitsTransfer
Function        Remove-BitsTransfer
Function        Resume-BitsTransfer
Function        Set-BitsTransfer
Function        Start-BitsTransfer
Function        Suspend-BitsTransfer

描述
-----------
這個命令示範如何使用 Get-Command 的 Module 參數來查明 Import-PSSession 命令將哪一個命令匯入工作階段。

第一個命令會使用 Import-PSSession Cmdlet，從 $s 變數中的 PSSession 匯入名稱包含 "bits" 的命令。Import-PSSession 命令會傳回暫時性模組，並將此模組儲存在 $m 變數中。

第二個命令會使用 Get-Command Cmdlet 取得 $m 變數中的模組所匯出的命令。

Module 參數會採用字串值，這個值是針對模組名稱所設計。但是，當您提交模組物件時，Windows PowerShell 會使用模組物件上的 ToString 方法，該物件會傳回模組名稱。

Get-Command 命令相當於 "get-command $m.name"。