Disconnect-PSSession
セッションから切断します。
構文
Disconnect-PSSession
[-Session] <PSSession[]>
[-IdleTimeoutSec <Int32>]
[-OutputBufferingMode <OutputBufferingMode>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Disconnect-PSSession
[-IdleTimeoutSec <Int32>]
[-OutputBufferingMode <OutputBufferingMode>]
[-ThrottleLimit <Int32>]
-Name <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]Disconnect-PSSession
[-IdleTimeoutSec <Int32>]
[-OutputBufferingMode <OutputBufferingMode>]
[-ThrottleLimit <Int32>]
-InstanceId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]Disconnect-PSSession
[-IdleTimeoutSec <Int32>]
[-OutputBufferingMode <OutputBufferingMode>]
[-ThrottleLimit <Int32>]
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
コマンドレットはDisconnect-PSSession、コマンドレットを使用してNew-PSSession開始された PowerShell セッション (PSSession など) を現在のセッションから切断します。 その結果、 PSSession は切断状態になります。 現在のセッションまたはローカル コンピューターまたは別のコンピューター上の別のセッションから、切断された PSSession に接続できます。
コマンドレットは Disconnect-PSSession 、現在のセッションに接続されている開いている PSSession のみを切断します。 Disconnect-PSSessionは、壊れた PSSession または閉じた PSSession、またはコマンドレットを使用Enter-PSSessionして開始された対話型 PSSession を切断できず、他のセッションに接続されている PSSession を切断することもできません。
切断された PSSession に再接続するには、コマンドレットをConnect-PSSessionReceive-PSSession使用します。
PSSession が切断されると、PSSession 内のコマンドは、PSSession がタイムアウトするか、PSSession 内のコマンドが完全な出力バッファーによってブロックされない限り、完了するまで引き続き実行されます。 アイドル タイムアウトを変更するには、IdleTimeoutSec パラメーターを使用します。 出力バッファリング モードを変更するには、 OutputBufferingMode パラメーターを 使用します。また、コマンドレットの InDisconnectedSession パラメーターを Invoke-Command 使用して、切断されたセッションでコマンドを実行することもできます。
切断されたセッションの機能の詳細については、「about_Remote_Disconnected_Sessions」を参照してください。
このコマンドレットは、Windows PowerShell 3.0 で導入されました。
例
例 1 - 名前でセッションを切断する
このコマンドは、UpdateSessionServer01 コンピューター上の PSSession を現在のセッションから切断します。 このコマンドは 、Name パラメーターを使用して PSSession を識別します。
PS> Disconnect-PSSession -Name UpdateSession
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 UpdateSession Server01 Disconnected Microsoft.PowerShell None出力には、切断の試行が成功したことが示されます。 セッションの状態とDisconnected可用性は、セッションがNoneビジーでなく、再接続できることを示します。
例 2 - 特定のコンピューターからセッションを切断する
このコマンドは、ITTaskServer12 コンピューター上の PSSession を現在のセッションから切断します。 セッションは ITTask 現在のセッションで作成され、Server12 コンピューターに接続されます。 このコマンドでは、コマンドレットを Get-PSSession 使用してセッションを取得し、コマンドレットを Disconnect-PSSession 使用してセッションを切断します。
PS> Get-PSSession -ComputerName Server12 -Name ITTask |
Disconnect-PSSession -OutputBufferingMode Drop -IdleTimeoutSec 86400
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Server12 Disconnected ITTasks NoneこのコマンドではDisconnect-PSSession、OutputBufferingMode パラメーターを使用して出力モードDropを . この設定により、セッション出力バッファーがいっぱいになった場合でも、セッションで実行されているスクリプトの実行が続行されます。 スクリプトの出力はファイル共有のレポートに書き込まれるため、他の出力は失われる可能性があります。
また、このコマンドでは、IdleTimeoutSec パラメーターを使用して、セッションのアイドル タイムアウトを 24 時間に延長します。 この設定により、この管理者または他の管理者はセッションに再接続し、実行されたスクリプトを検証して、必要に応じてトラブルシューティングを行うための時間を得ることができます。
例 3 - 複数のコンピューターで複数の PSSession を使用する
この一連のコマンドは、エンタープライズ シナリオでのコマンドレットの使用方法を示しています Disconnect-PSSession 。 このケースでは、新しい技術者がリモート コンピューター上のセッションのスクリプトを開始したときに問題が発生したため、 経験豊富なマネージャーによるセッションへの接続および問題解決を依頼できるように、セッションを切断しました。
PS> $s = New-PSSession -ComputerName Srv1, Srv2, Srv30 -Name ITTask
PS> Invoke-Command $s -FilePath \\Server01\Scripts\Get-PatchStatus.ps1
PS> Get-PSSession -Name ITTask -ComputerName Srv1 | Disconnect-PSSession
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Srv1 Disconnected Microsoft.PowerShell None
PS> Get-PSSession -ComputerName Srv1, Srv2, Srv30 -Name ITTask
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Srv1 Disconnected Microsoft.PowerShell None
2 ITTask Srv2 Opened Microsoft.PowerShell Available
3 ITTask Srv30 Opened Microsoft.PowerShell Available
PS> Get-PSSession -ComputerName Srv1 -Name ITTask -Credential Domain01\User01
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Srv1 Disconnected Microsoft.PowerShell None
PS> $s = Connect-PSSession -ComputerName Srv1 -Name ITTask -Credential Domain01\User01
PS> Invoke-Command -Session $s {dir $home\Scripts\PatchStatusOutput.ps1}
PS> Invoke-Command -Session $s {mkdir $home\Scripts\PatchStatusOutput}
PS> Invoke-Command -Session $s -FilePath \\Server01\Scripts\Get-PatchStatus.ps1
PS> Disconnect-PSSession -Session $sこの技術者は、最初に複数のリモート コンピューターでセッションを作成し、各セッションでスクリプトを実行しました。 最初のコマンドでは、コマンドレットを New-PSSession 使用して、3 台の ITTask リモート コンピューターでセッションを作成します。 このコマンドは、セッションを変数に $s 保存します。 2 番目のコマンドでは、コマンドレットの FilePath パラメーターを Invoke-Command 使用して、変数内のセッションでスクリプトを $s 実行します。
Srv1 コンピューターで実行中のスクリプトで、予期しないエラーが生成されました。 技術者はマネージャーに連絡し、サポートを依頼しました。 マネージャーは、調査できるように、技術者にセッションからの切断を指示します。2 番目のコマンドでは、コマンドレットを Get-PSSession 使用して Srv1 コンピューター上のセッションを取得 ITTask し、 Disconnect-PSSession 切断するコマンドレットを使用します。 このコマンドは、他のコンピューター上の ITTask セッションには影響しません。
3 番目のコマンドでは、コマンドレットを Get-PSSession 使用してセッションを ITTask 取得します。 出力は、Srv2 および Srv30 コンピューター上のセッションが切断するコマンドの影響を受けなかったことを ITTask 示しています。
マネージャーは、自宅のコンピューターにログオンし、会社のネットワークに接続し、PowerShell を起動し、コマンドレットを Get-PSSession 使用して Srv1 コンピューターでセッションを取得 ITTask します。 マネージャーは、技術者の資格情報を使用してセッションにアクセスします。
次に、マネージャーはコマンドレットを Connect-PSSession 使用して Srv1 コンピューター上のセッションに接続 ITTask します。 このコマンドでは、セッションが $s 変数に保存されます。
マネージャーは、コマンドレットを Invoke-Command 使用して、変数内のセッションでいくつかの診断コマンドを $s 実行します。 これにより、必要なディレクトリが見つからなかったためにスクリプトが失敗したことが判明しました。
マネージャーは、この関数を MkDir 使用してディレクトリを作成し、スクリプトを Get-PatchStatus.ps1 再起動してセッションから切断します。マネージャーは、技術者に調査結果を報告し、タスクを完了するためにセッションに再接続することを提案し、必要なディレクトリが存在しない場合は作成するコマンドをスクリプトに Get-PatchStatus.ps1 追加するよう求めます。
例 4 - PSSession のタイムアウト値を変更する
この例では、セッションを切断できるように IdleTimeout プロパティの値を修正する方法を示しています。
切断されたセッションが削除されるまでの期間は、セッションのアイドル タイムアウト プロパティで決定されるため、このプロパティは切断するセッションにとって重要です。 アイドル タイムアウト オプションは、セッションの作成時およびセッションの切断時に設定できます。 セッションのアイドル タイムアウトの既定値は、ローカル コンピューターの $PSSessionOption 基本設定変数とリモート コンピューターのセッション構成で設定されます。 セッションに設定された値は、セッション構成に設定された値よりも優先されますが、セッション値はセッション構成で設定されたクォータ (MaxIdleTimeoutMs 値など) を超えることはできません。
PS> $Timeout = New-PSSessionOption -IdleTimeout 172800000
PS> $s = New-PSSession -Computer Server01 -Name ITTask -SessionOption $Timeout
PS> Disconnect-PSSession -Session $s
Disconnect-PSSession : The session ITTask cannot be disconnected because the specified
idle timeout value 172800(seconds) is either greater than the server maximum allowed
43200 (seconds) or less that the minimum allowed60(seconds). Choose an idle time out
value that is within the allowed range and try again.
PS> Invoke-Command -ComputerName Server01 {Get-PSSessionConfiguration Microsoft.PowerShell} |
Format-List -Property *
Architecture : 64
Filename : %windir%\system32\pwrshplugin.dll
ResourceUri : http://schemas.microsoft.com/powershell/microsoft.powershell
MaxConcurrentCommandsPerShell : 1000
UseSharedProcess : false
ProcessIdleTimeoutSec : 0
xmlns : http://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
MaxConcurrentUsers : 5
lang : en-US
SupportsOptions : true
ExactMatch : true
RunAsUser :
IdleTimeoutms : 7200000
PSVersion : 3.0
OutputBufferingMode : Block
AutoRestart : false
SecurityDescriptorSddl : O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GXGW;;;WD)
MaxMemoryPerShellMB : 1024
MaxIdleTimeoutms : 2147483647
Uri : http://schemas.microsoft.com/powershell/microsoft.powershell
SDKVersion : 2
Name : microsoft.powershell
XmlRenderingType : text
Capability : {Shell}
RunAsPassword :
MaxProcessesPerShell : 15
ParentResourceUri : http://schemas.microsoft.com/powershell/microsoft.powershell
Enabled : true
MaxShells : 25
MaxShellsPerUser : 25
Permission : BUILTIN\Administrators AccessAllowed
PSComputerName : localhost
RunspaceId : aea84310-6dbf-4c21-90ac-13980039925a
PSShowComputerName : True
PS> $s.Runspace.ConnectionInfo
ConnectionUri : http://Server01/wsman
ComputerName : Server01
Scheme : http
Port : 80
AppName : /wsman
Credential :
ShellUri : http://schemas.microsoft.com/powershell/Microsoft.PowerShell
AuthenticationMechanism : Default
CertificateThumbprint :
MaximumConnectionRedirectionCount : 5
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize : 209715200
UseCompression : True
NoMachineProfile : False
ProxyAccessType : None
ProxyAuthentication : Negotiate
ProxyCredential :
SkipCACheck : False
SkipCNCheck : False
SkipRevocationCheck : False
NoEncryption : False
UseUTF16 : False
OutputBufferingMode : Drop
IncludePortInSPN : False
Culture : en-US
UICulture : en-US
OpenTimeout : 180000
CancelTimeout : 60000
OperationTimeout : 180000
IdleTimeout : 172800000
PS> Disconnect-PSSession $s -IdleTimeoutSec 43200
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
4 ITTask Server01 Disconnected Microsoft.PowerShell None
PS> $s.Runspace.ConnectionInfo.IdleTimeout
43200000最初のコマンドでは、コマンドレットを New-PSSessionOption 使用してセッション オプション オブジェクトを作成します。 IdleTimeout パラメーターを使用して、アイドル タイムアウトを 48 時間 (172800000ミリ秒) に設定します。 このコマンドは、セッション オプション オブジェクトを変数に $Timeout 保存します。
2 番目のコマンドでは、 New-PSSession このコマンドレットを使用して、Server01 コンピューターでセッションを作成 ITTask します。 このコマンドは、セッションを変数に $s 保存します。 SessionOption パラメーターの値は、変数内の 48 時間のアイドル タイムアウト$Timeoutです。
3 番目のコマンドは、変数内の ITTask セッションを $s 切断します。 セッションのアイドル タイムアウト値がセッション構成の MaxIdleTimeoutMs クォータを超えているため、このコマンドは失敗します。 アイドル タイムアウトはセッションが切断されるまで使用されないため、セッションの使用中にはこの違反が検出されない場合があります。
4 番目のコマンドでは、 Invoke-Command このコマンドレットを使用して、 Get-PSSessionConfiguration Server01 コンピューターでセッション構成のコマンド Microsoft.PowerShell を実行します。 このコマンドは、コマンドレットをFormat-List使用して、セッション構成のすべてのプロパティを一覧に表示します。出力は、セッション構成を使用するセッションで許可される最大 IdleTimeout 値を確立する MaxIdleTimeoutMS プロパティがミリ秒 (12 時間) であることを43200000示しています。
5 番目のコマンドは、変数内のセッションのセッション オプション値を $s 取得します。 多くのセッション オプションの値は、セッションの Runspace プロパティの ConnectionInfo プロパティのプロパティです。出力は、セッションの IdleTimeout プロパティの値がミリ秒 (48 時間) であることを172800000示しています。これは、セッション構成の MaxIdleTimeoutMs クォータ 12 時間に違反しています。この競合を解決するには、ConfigurationName パラメーターを使用して別のセッション構成を選択するか、IdleTimeout パラメーターを使用してセッションのアイドル タイムアウトを減らすことができます。
6 番目のコマンドは、セッションを切断します。 これは IdleTimeoutSec パラメーターを使用して、アイドル タイムアウトを 12 時間に設定します。
7 番目のコマンドは、切断されたセッションのミリ秒で測定された IdleTimeout プロパティの値を取得します。 コマンドが成功したことを出力で確認します。
パラメーター
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
指定されたセッション ID を持つセッションから切断します。 1 つ以上の ID (コンマで区切って) を入力するか、範囲演算子 (..) を使用して ID の範囲を指定します。
セッションの ID を取得するには、コマンドレットを Get-PSSession 使用します。 インスタンス ID は、セッションの ID プロパティに格納されています。
| Type: | Int32[] |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
切断された PSSession のアイドル タイムアウト値を変更します。 値を秒単位で入力します。 最小値は 60 (1 分) です。
アイドル タイムアウトは、切断された PSSession がリモート コンピューターで維持される期間を決定します。 タイムアウトが切れると、 PSSession が削除されます。
切断された PSSession は、切断されたセッションでコマンドが実行されている場合でも、切断された時点からアイドル状態と見なされます。
セッションのアイドル タイムアウトの既定値は、セッション構成の IdleTimeoutMs プロパティにより設定されます。 既定値は 7200000 ミリ秒 (2 時間) です。
このパラメーターの値は、基本設定変数の IdleTimeout プロパティ $PSSessionOption の値と、セッション構成の既定のアイドル タイムアウト値よりも優先されます。 ただし、この値はセッション構成の MaxIdleTimeoutMs プロパティの値を超えることはできません。 MaxIdleTimeoutMs の既定値は 12 時間 (43200000ミリ秒) です。
| Type: | Int32 |
| Position: | Named |
| Default value: | 60 |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
指定されたインスタンス ID を持つセッションから切断します。
インスタンス ID は、ローカル コンピューターまたはリモート コンピューターのセッションを一意に識別する GUID です。 複数のコンピューター上の複数のセッションであっても、インスタンス ID は一意です。
セッションのインスタンス ID を取得するには、コマンドレットを Get-PSSession 使用します。 インスタンス ID は、セッションの InstanceID プロパティに格納されます。
| Type: | Guid[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
指定されたフレンドリ名を持つセッションから切断します。 ワイルドカードを使用できます。
セッションのフレンドリ名を取得するには、コマンドレットを Get-PSSession 使用します。 フレンドリ名は、セッションの Name プロパティに格納されています。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
出力バッファーがいっぱいになったときに切断されたセッションでコマンド出力を管理する方法を決定します。 既定値は Block です。
切断されたセッションのコマンドで出力が返されたが、出力バッファーがいっぱいになっている場合に、コマンドをセッションの切断中に継続して実行するかどうかは、実質的にこのパラメーターの値によって決定されます。 値を指定 Block すると、セッションが再接続されるまでコマンドが中断されます。 値を指定 Drop すると、データが失われる可能性がありますが、コマンドを完了できます。 この値を使用する Drop 場合は、コマンド出力をディスク上のファイルにリダイレクトします。
有効な値は次のとおりです。
Block: 出力バッファーがいっぱいになると、バッファーがクリアされるまで実行が中断されます。Drop: 出力バッファーがいっぱいになると、実行が続行されます。 新しい出力が保存されると、最も古い出力が破棄されます。None: 出力バッファリング モードは指定されません。 セッション構成の OutputBufferingMode プロパティの値は、切断されたセッションに使用されます。
| Type: | OutputBufferingMode |
| Position: | Named |
| Default value: | Block |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
指定した PSSession から切断します。 コマンドレットから返されるものなど、 PSSession オブジェクトを New-PSSession 入力します。 PSSession オブジェクトDisconnect-PSSessionをパイプすることもできます。
このコマンドレットは Get-PSSession 、切断された PSSession や 他のコンピューター上の他のセッションに接続されている PSSession など、リモート コンピューターで終了するすべての PSSession を取得できます。 Disconnect-PSSession は、現在のセッションに接続されている PSSession のみを切断します。 他の PSSession を パイプすると Disconnect-PSSession、コマンドは Disconnect-PSSession 失敗します。
| Type: | PSSession[] |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
コマンドのスロットル制限を Disconnect-PSSession 設定します。
スロットルの制限は、このコマンドを実行するために確立できるコンカレント接続の最大値です。 このパラメーターを省略した場合、または値 0を入力した場合は、 32既定値である 、が使用されます。
スロットル制限は現在のコマンドのみに適用され、セッションまたはコンピューターには適用されません。
| Type: | Int32 |
| Position: | Named |
| Default value: | 32 |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
にセッション Disconnect-PSSessionをパイプできます。
出力
Disconnect-PSSession は、切断されたセッションを表すオブジェクトを返します。
メモ
このコマンドレットは、Windows プラットフォームでのみ使用できます。
このコマンドレットは
Disconnect-PSSession、ローカル コンピューターとリモート コンピューターが PowerShell 3.0 以降を実行している場合にのみ機能します。切断されたセッションでコマンドレットを
Disconnect-PSSession使用する場合、コマンドはセッションに影響を与えません。エラーは生成されません。対話型セキュリティ トークン (EnableNetworkAccess パラメーターにより作成される) を使用しているループバック セッションが切断された場合には、そのセッションを作成したコンピューターからのみ再接続できます。 この制約は、悪意のあるアクセスからコンピューターを保護するためのものです。
PSSession を切断すると、セッション状態は
DisconnectedNone になり、可用性は None になります。State プロパティの値は、現在のセッションに関連付けられています。 したがって、値は
DisconnectedPSSession が現在のセッションに接続されていないことを意味します。 ただし、 PSSession がすべてのセッションから切断されているわけではありません。 別のセッションに接続されている可能性があるためです。 セッションに接続または再接続できるかどうかを確認するには、Availability プロパティを使用します。可用性の値は
None、セッションに接続できることを示します。 値はBusy、PSSession が別のセッションに接続されているため、 PSSession に接続できないことを示します。セッションの State プロパティの値の詳細については、「 RunspaceState 列挙型」を参照してください。
セッションの Availability プロパティの値の詳細については、「 RunspaceAvailability 列挙型」を参照してください。