about_Remote_Disconnected_Sessions
簡短描述
說明如何中斷連線並重新連線到 PowerShell 會話 (PSSession) 。
完整描述
從 PowerShell 3.0 開始，您可以從 PSSession 中斷連線，並從同一部電腦或不同的電腦重新連線到 PSSession。 會話狀態會維護，而且 PSSession 中的命令會在會話中斷聯機時繼續執行。
中斷連線的會話功能可讓您關閉建立 PSSession 的會話，並關閉電腦，而不會中斷遠端 PSSession 中執行的命令。 中斷連線的會話適用於執行需要較長時間才能完成的命令。
您無法中斷與使用 Enter-PSSession Cmdlet 啟動的互動式作業階段連線。
您可以使用中斷連線的工作階段來管理因電腦或網路中斷而意外中斷的 PSSession。
已中斷連線的會話 Cmdlet
下列 Cmdlet 支援中斷連線的作業階段功能：
Connect-PSSession：連接到已中斷連線的 PSSession。Disconnect-PSSession：中斷 PSSession 的連線。Get-PSSession：取得本機計算機或遠端電腦上的 PSSession。Receive-PSSession：取得在中斷聯機會話中執行的命令結果。Invoke-Command： InDisconnectedSession 參數會立即建立 PSSession 並中斷連線。
中斷連線的會話功能運作方式
從 PowerShell 3.0 開始，PSSession 與建立它們的會話無關。 作用中的 PSSession 會在連線的遠端電腦或 伺服器端 維護，即使 用戶端電腦 已關閉或中斷網路連線也一樣。
在 PowerShell 2.0 中，當 PSSession 與原始工作階段或建立所在的會話中斷連線時，會從遠端電腦刪除。
當您中斷 PSSession 的連線時，PSSession 會保持作用中狀態，並保留在遠端電腦上。 會話狀態會從 [執行 中] 變更為 [已中斷連線]。 您可以重新連線到中斷連線的 PSSession
- 相同電腦上的目前會話
- 相同電腦上的不同會話
- 從不同電腦上的會話
維護會話的遠端電腦必須執行並連線到網路。
中斷連線 PSSession 中的命令會繼續在遠端電腦上不中斷執行，直到命令完成或輸出緩衝區填滿為止。 若要防止完整輸出緩衝區暫停命令，請使用 、 New-PSSessionOption或 New-PSTransportOption Cmdlet 的 Disconnect-PSSessionOutputBufferingMode 參數。
已中斷連線的會話會維持在遠端電腦上的已中斷連線狀態。 它們可供您重新連線，直到您刪除 PSSession，例如使用 Remove-PSSession Cmdlet，或直到 PSSession 的閒置逾時到期為止。 您可以使用 、 New-PSSessionOption或 New-PSTransportOption Cmdlet 的 IdleTimeoutSec 或 IdleTimeout 參數來調整 PSSession 的Disconnect-PSSession閒置逾時。
另一個使用者可以連線到您所建立的 PSSessions，但只有在它們可以提供用來建立會話的認證，或使用 RunAs 會話設定的認證時。
如何取得 PSSessions
從 PowerShell 3.0 開始， Get-PSSession Cmdlet 會在本機電腦和遠端電腦上取得 PSSession。 它也可以取得在目前會話中建立的 PSSession。
若要取得本機計算機或遠端電腦上的 PSSession，請使用 ComputerName 或 ConnectionUri 參數。 如果沒有參數， Get-PSSession 則取得在本機會話中建立的 PSSession，不論它們終止的位置為何。
下列範例示範如何使用 Get-PSSession。
New-PSSession 會建立 Server01 計算機的工作階段。 會話位於 Server01 計算機上。
New-PSSession -ComputerName Server01
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
2 Session2 Server01 Opened Microsoft.PowerShell Available
若要從 Server01 取得工作階段，請使用 ComputerName 參數來指定 的目標 Get-PSSession。
Get-PSSession -ComputerName Server01
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
2 Session2 Server01 Opened Microsoft.PowerShell Available
如果的 Get-PSSessionComputerName 參數值為 localhost，Get-PSSession則取得在 本機計算機上終止並維護的 PSSession。 即使已在本機計算機上啟動 PSSession，它也不會在 Server01 計算機上取得 PSSession。
Get-PSSession -ComputerName localhost
若要取得在目前會話中建立的會話，請使用不含參數的 Get-PSSession Cmdlet。 在此範例中， Get-PSSession 取得在目前會話中建立並連線到 Server01 計算機的 PSSession。
Get-PSSession
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
2 Session2 Server01 Opened Microsoft.PowerShell Available
如何中斷會話連線
Disconnect-PSSession使用 Cmdlet 來中斷會話的連線。 若要識別 PSSession，請使用 Session 參數，或使用管線將 New-PSSession 或 Get-PSSession Cmdlet 中的 PSSession 物件傳送至 Disconnect-PSSession。
下列命令會將 PSSession 中斷連線到 Server01 計算機。 請注意， State 屬性的值是 Disconnected ， 而 Availability 為 None。
Get-PSSession -ComputerName Server01 | Disconnect-PSSession
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
2 Session2 Server01 Disconnected Microsoft.PowerShell None
若要建立中斷連線的會話，請使用 Cmdlet 的 Invoke-CommandInDisconnectedSession 參數。 它會建立會話、啟動命令，並立即中斷連線，然後命令才能傳回任何輸出。
下列命令會在遠端電腦 Server02 的中斷聯機會話中執行 Get-WinEvent 命令。
Invoke-Command -ComputerName Server02 -InDisconnectedSession -ScriptBlock {
Get-WinEvent -LogName "*PowerShell*" }
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
4 Session3 Server02 Disconnected Microsoft.PowerShell None
如何連線到已中斷連線的會話
若要連接中斷連線的工作階段，請使用 Connect-PSSession Cmdlet 搭配 ComputerName 或 ConnectionUri 參數。 或者，您可以使用管線將 的 Get-PSSession 輸出傳送至 Connect-PSSession。
下列範例會取得 Server02 計算機上的會話。 輸出包含兩個中斷連線的會話。
Get-PSSession -ComputerName Server02
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
2 Session2 juneb-srv8320 Disconnected Microsoft.PowerShell None
4 Session3 juneb-srv8320 Disconnected Microsoft.PowerShell None
下列命令會連線到 Session2。 PSSession 現在已開啟且可供使用。
Connect-PSSession -ComputerName Server02 -Name Session2
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
2 Session2 juneb-srv8320 Opened Microsoft.PowerShell Available
如何取得結果
若要取得在中斷連線 PSSession 中執行的命令結果，請使用 Receive-PSSession Cmdlet。
您可以使用 Receive-PSSession ，而不是使用 Connect-PSSession Cmdlet。 如果會話已經重新連線， Receive-PSSession 取得會話中斷連線時所執行的命令結果。 如果 PSSession 仍然中斷連線， Receive-PSSession 請連線到它，然後取得中斷連線時所執行的命令結果。
Receive-PSSession 可以將作業中的結果以異步方式 (傳回) 或同步 (主機程式) 。 使用 OutTarget 參數來選取 [作業 ] 或 [ 主機]。 預設值為 Host。 不過，如果接收的命令是以 作業的形式在目前會話中啟動，預設會以 作業 的形式傳回。
下列範例會 Receive-PSSession 使用 Cmdlet 重新連線到 Server02 上的會話，並取得命令的結果 Get-WinEvent 。 OutTarget 參數可用來取得作業中的結果。
Receive-PSSession -ComputerName Server02 -Name Session3 -OutTarget Job
Id Name PSJobTypeName State HasMoreData Location
-- ---- ------------- ----- ----------- --------
3 Job3 RemoteJob Running True Server02
若要取得作業的結果，請使用 Receive-Job Cmdlet。
Get-Job | Receive-Job -Keep
ProviderName: PowerShell
TimeCreated Id LevelDisplayName Message PSComputerName
----------- -- ---------------- ------- --------------
5/14/2012 7:26:04 PM 400 Information Engine stat Server02
5/14/2012 7:26:03 PM 600 Information Provider "W Server02
5/14/2012 7:26:03 PM 600 Information Provider "C Server02
5/14/2012 7:26:03 PM 600 Information Provider "V Server02
狀態和可用性屬性
中斷連線之 PSSession 的狀態和可用性屬性會告訴您會話是否可供您重新連線。
當 PSSession 連接到目前的工作階段時，其狀態為 [已開啟 ]，且其可用性為 [可用]。 當您中斷與 PSSession 的連線時，PSSession 狀態為 [已中斷 連線]，且其可用性為 [無]。
State 屬性的值是相對於目前工作階段。 [ 已中斷連線 ] 值表示 PSSession 未連線到目前的會話。 但是，這並不表示 PSSession 與所有會話中斷連線。 它可能連線不同的工作階段。
若要判斷您是否可以連線或重新連線至 PSSession，請使用 Availability 屬性。 [ 無 ] 值表示您可以連線到會話。 [忙碌] 的值表示您無法連線到 PSSession，因為它已連線到另一個會話。
下列範例會在相同電腦上的兩個 PowerShell 工作階段中執行。 請注意每個會話中 狀態 和 可用性 屬性的變更值，因為 PSSession 已中斷連線並重新連線。
# Session 1
New-PSSession -ComputerName Server30 -Name Test
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 Test Server30 Opened Microsoft.PowerShell Available
# Session 2
Get-PSSession -ComputerName Server30 -Name Test
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 Test Server30 Disconnected Microsoft.PowerShell Busy
# Session 1
Get-PSSession -ComputerName Server30 -Name Test | Disconnect-PSSession
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 Test Server30 Disconnected Microsoft.PowerShell None
# Session 2
Get-PSSession -ComputerName Server30
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 Test Server30 Disconnected Microsoft.PowerShell None
# Session 2
Connect-PSSession -ComputerName Server30 -Name Test
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
3 Test Server30 Opened Microsoft.PowerShell Available
# Session 1
Get-PSSession -ComputerName Server30
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 Test Server30 Disconnected Microsoft.PowerShell Busy
中斷連線的會話會保留在遠端電腦上，直到您刪除它們為止，例如使用 Remove-PSSession Cmdlet 或逾時。PSSession 的 IdleTimeout 屬性會決定中斷聯機的會話在刪除前的保留時間長度。
閑置逾時值
當 活動訊號線程 收到沒有回應時，PSSession 會閑置。 中斷會話聯機會讓它閑置並啟動 IdleTimeout 時鐘，即使命令仍在中斷連線的會話中執行也一樣。 PowerShell 會將已中斷連線的會話視為作用中，但閑置。
建立和中斷聯機會話時，請確認 PSSession 中的閑置逾時夠長，足以針對您的需求維護會話，但不夠長，它就會耗用遠端電腦上的不必要的資源。
會話組態的 IdleTimeoutMs 屬性會決定使用會話設定之會話的預設閒置逾時。 您可以覆寫預設值，但該值不能超過會話組態的 MaxIdleTimeoutMs 屬性。
使用下列命令來取得會話組態的 IdleTimeoutMs 和 MaxIdleTimeoutMs 值。
Get-PSSessionConfiguration |
Format-Table Name, IdleTimeoutMs, MaxIdleTimeoutMs
如果您是遠端電腦上的 Administrators 群組成員，您可以在建立工作階段設定時設定這些值。 此外，您也可以在中斷連線時變更值。
會話組態和會話選項的閑置逾時值以毫秒為單位。 工作階段和工作階段組態選項的閒置逾時值為秒。
當您建立 PSSession (New-PSSession時，您可以設定 PSSession 的閒置逾時， Invoke-Command) 和中斷連線 () Disconnect-PSSession 。 不過，當您連線到 PSSession () Connect-PSSession 或取得結果時，您無法變更 IdleTimeout 值 (Receive-PSSession) 。
Connect-PSSession和 Receive-PSSession Cmdlet 具有採用 PSSessionOption 物件的 SessionOption 參數，例如 Cmdlet 所傳回的物件New-PSSessionOption。
SessionOption 物件中的 IdleTimeout 值和喜好設定變數中的 $PSSessionOptionIdleTimeout 值不會在 或 Receive-PSSession 命令中Connect-PSSession變更 IdleTimeout 的值。
若要建立具有特定閑置逾時值的 PSSession，請建立 $PSSessionOption 喜好設定變數。 將 IdleTimeout 屬性的值設定為所需值，以毫秒為單位) (。
當您建立 PSSessions 時，變數中的 $PSSessionOption 值會優先於會話組態中的值。
例如，下列命令會設定閑置逾時 48 小時：
$PSSessionOption = New-PSSessionOption -IdleTimeoutMSec 172800000
若要建立具有特定閑置逾時值的 PSSession，請使用 Cmdlet 的 New-PSSessionOptionIdleTimeoutMSec 參數。 然後，在 或 Invoke-Command Cmdlet 的 SessionOption 參數New-PSSession值中使用會話選項。
建立工作階段時所設定的值優先於喜好設定變數和工作階段組態中 $PSSessionOption 設定的值。
例如：
$o = New-PSSessionOption -IdleTimeoutMSec 172800000
New-PSSession -SessionOption $o
若要在中斷連線時變更 PSSession 的閒置逾時，請使用 Cmdlet 的 Disconnect-PSSessionIdleTimeoutSec 參數。
例如：
Disconnect-PSSession -IdleTimeoutSec 172800
若要建立具有特定閑置逾時和最大閑置逾時的會話組態，請使用 Cmdlet 的 New-PSTransportOptionIdleTimeoutSec 和 MaxIdleTimeoutSec 參數。 然後，在的 Register-PSSessionConfigurationTransportOption 參數值中使用傳輸選項。
例如：
$o = New-PSTransportOption -IdleTimeoutSec 172800 -MaxIdleTimeoutSec 259200
Register-PSSessionConfiguration -Name Test -TransportOption $o
若要變更會話組態的默認閑置逾時和最大閑置逾時，請使用 Cmdlet 的 New-PSTransportOptionIdleTimeoutSec 和 MaxIdleTimeoutSec 參數。 然後，在的 Set-PSSessionConfigurationTransportOption 參數值中使用傳輸選項。
例如：
$o = New-PSTransportOption -IdleTimeoutSec 172800 -MaxIdleTimeoutSec 259200
Set-PSSessionConfiguration -Name Test -TransportOption $o
輸出緩衝模式
PSSession 的輸出緩衝模式會決定當 PSSession 的輸出緩衝區已滿時，命令輸出的管理方式。
在中斷連線的會話中，輸出緩衝模式會有效地判斷命令是否在會話中斷連線時繼續執行。
有效值，如下所示：
Block(預設) - 當輸出緩衝區已滿時，執行會暫停，直到緩衝區清除為止。Block保留數據，但可能會中斷命令。Drop- 當輸出緩衝區已滿時，執行會繼續。 產生新的輸出時，會捨棄最舊的輸出。 使用Drop值時，請將輸出重新導向至檔案。 建議針對已中斷連線的會話使用此值。
會話組態的 OutputBufferingMode 屬性會決定使用工作階段組態之工作階段的預設緩衝模式。
若要尋找 OutputBufferingMode 的工作階段組態值，您可以使用下列其中一種命令格式：
(Get-PSSessionConfiguration <ConfigurationName>).OutputBufferingMode
Get-PSSessionConfiguration | Format-Table Name, OutputBufferingMode
您可以在會話組態中覆寫預設值，並在建立 PSSession、中斷連線時，以及重新連線時設定 PSSession 的輸出緩衝模式。
如果您是遠端電腦上的 Administrators 群組成員，您可以建立和變更工作階段設定的輸出緩衝模式。
若要使用 的輸出緩衝模式 Drop建立 PSSession，請建立 $PSSessionOption 喜好設定變數，其中 OutputBufferingMode 屬性的值為 Drop。
當您建立 PSSessions 時，變數中的 $PSSessionOption 值會優先於會話組態中的值。
例如：
$PSSessionOption = New-PSSessionOption -OutputBufferingMode Drop
使用 Cmdlet 的 New-PSSessionOptionOutputBufferingMode 參數，建立值為 的Drop會話選項。 然後，使用 PSSessionOption 物件做為 或 Invoke-Command Cmdlet 之 SessionOption 參數New-PSSession的值。
建立工作階段時所設定的值優先於喜好設定變數和工作階段組態中 $PSSessionOption 設定的值。
例如：
$o = New-PSSessionOption -OutputBufferingMode Drop
New-PSSession -SessionOption $o
若要在中斷連線時變更 PSSession 的輸出緩衝模式，請使用 Cmdlet 的 Disconnect-PSSessionOutputBufferingMode 參數。
例如：
Disconnect-PSSession -OutputBufferingMode Drop
若要在重新連線時變更 PSSession 的輸出緩衝模式，請使用 Cmdlet 的 New-PSSessionOptionOutputBufferingMode 參數。 然後，在 或Receive-PSSession的 SessionOption 參數Connect-PSSession值中使用會話選項。
例如：
$o = New-PSSessionOption -OutputBufferingMode Drop
Connect-PSSession -ComputerName Server01 -Name Test -SessionOption $o
若要使用的預設輸出緩衝模式Drop建立會話組態，請使用 Cmdlet 的 New-PSTransportOptionOutputBufferingMode 參數來建立具有 值的Drop傳輸選項物件。 然後，在的 Register-PSSessionConfigurationTransportOption 參數值中使用傳輸選項。
例如：
$o = New-PSTransportOption -OutputBufferingMode Drop
Register-PSSessionConfiguration -Name Test -TransportOption $o
若要變更會話組態的默認輸出緩衝模式，請使用 Cmdlet 的 New-PSTransportOptionOutputBufferingMode 參數來建立具有 值的Drop傳輸選項。 然後，在的 SessionOption 參數 Set-PSSessionConfiguration值中使用 Transport 選項。
例如：
$o = New-PSTransportOption -OutputBufferingMode Drop
Set-PSSessionConfiguration -Name Test -TransportOption $o
中斷回送會話的連線
回送會話或本機會話是源自於同一部電腦上的 PSSession。 與其他 PSSession 一樣，使用中的回送會話會在連線的遠端端維護， (本機電腦) ，因此您可以中斷連線並重新連線到回送會話。
根據預設，會使用不允許在會話中執行命令的網路安全性令牌來建立回送會話，以存取其他計算機。 您可以從本機電腦或遠端電腦上的任何會話，重新連線到具有網路安全性令牌的回送會話。
不過，如果您使用 、 Enter-PSSession或 Invoke-Command Cmdlet 的 New-PSSessionEnableNetworkAccess 參數，則會使用互動式安全性令牌來建立回送會話。 互動式令牌可讓在回送會話中執行的命令，以從其他計算機取得數據。
您可以使用互動式令牌中斷回送會話的連線，然後從相同會話或相同電腦上的不同會話重新連線。 不過，若要防止惡意存取，您只能從建立互動式令牌的計算機，重新連線到具有互動式令牌的回送會話。
等候中斷聯機會話中的作業
Cmdlet Wait-Job 會等候作業完成，然後返回命令提示字元或下一個命令。 根據預設，如果正在執行作業的工作階段已中斷連線， Wait-Job 則傳回 。 若要指示 Wait-Job Cmdlet 等到會話重新連線後，請以 Opened 狀態使用 Force 參數。 如需詳細資訊，請參閱 Wait-Job。
強固的會話和意外中斷連線
PSSession 可能會因為電腦失敗或網路中斷而意外中斷。 PowerShell 嘗試復原 PSSession，但其成功取決於原因的嚴重性和持續時間。
意外中斷的 PSSession 狀態可能是 中斷 或 已關閉，但也可能是 [已中斷]。 如果 State 的值是 [已中斷連線]，您可以使用相同的技術來管理 PSSession，就像會話刻意中斷連線時一樣。 例如，您可以使用 Connect-PSSession Cmdlet 重新連線到工作階段，而 Receive-PSSession Cmdlet 可取得作業階段中斷連線時所執行的命令結果。
如果您關閉 (結束) 在命令在 PSSession 中執行命令時建立 PSSession 的會話，PowerShell 會維持遠端電腦上已 中斷 連線狀態的 PSSession。 如果您關閉 (結束) 建立 PSSession 的會話，但 PSSession 中沒有執行任何命令，PowerShell 不會嘗試維護 PSSession。